Package org.gnome.soup

Interface AuthDomainBasicAuthCallback

All Superinterfaces:

FunctionPointer

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
@Generated("io.github.jwharm.JavaGI")
public interface AuthDomainBasicAuthCallback
extends FunctionPointer

Functional interface declaration of the AuthDomainBasicAuthCallback callback.

See Also:

• run(org.gnome.soup.AuthDomainBasic, org.gnome.soup.ServerMessage, java.lang.String, java.lang.String)

Method Summary

Modifier and Type	Method	Description
boolean	run(AuthDomainBasic domain, ServerMessage msg, String username, String password)	Callback used by SoupAuthDomainBasic for authentication purposes.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment) method.
default int	upcall(MemorySegment domain, MemorySegment msg, MemorySegment username, MemorySegment password, MemorySegment userData)	The upcall method is called from native code.

Method Details

run

boolean run(AuthDomainBasic domain,
 ServerMessage msg,
 String username,
 String password)

Callback used by SoupAuthDomainBasic for authentication purposes.

The application should verify that username and password and valid and return true or false.

If you are maintaining your own password database (rather than using the password to authenticate against some other system like PAM or a remote server), you should make sure you know what you are doing. In particular, don't store cleartext passwords, or easily-computed hashes of cleartext passwords, even if you don't care that much about the security of your server, because users will frequently use the same password for multiple sites, and so compromising any site with a cleartext (or easily-cracked) password database may give attackers access to other more-interesting sites as well.

upcall

default int upcall(MemorySegment domain,
 MemorySegment msg,
 MemorySegment username,
 MemorySegment password,
 MemorySegment userData)

The upcall method is called from native code. The parameters are marshaled and run(org.gnome.soup.AuthDomainBasic, org.gnome.soup.ServerMessage, java.lang.String, java.lang.String) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment) method.

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the function pointer will be allocated in this arena

Returns:

the native function pointer