Package org.gnome.soup

Interface Server.RequestStartedCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

Server

Functional Interface:

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

@FunctionalInterface
public static interface Server.RequestStartedCallback
extends FunctionPointer

Functional interface declaration of the RequestStartedCallback callback.

See Also:

• run(org.gnome.soup.ServerMessage)

Method Summary

Modifier and Type	Method	Description
void	run(@Nullable ServerMessage message)	Emitted when the server has started reading a new request.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment) method.
default void	upcall(MemorySegment sourceServer, MemorySegment message)	The upcall method is called from native code.

Method Details

run

void run(@Nullable ServerMessage message)

Emitted when the server has started reading a new request.

message will be completely blank; not even the Request-Line will have been read yet. About the only thing you can usefully do with it is connect to its signals.

If the request is read successfully, this will eventually be followed by a Server::request_read signal. If a response is then sent, the request processing will end with a Server::request-finished signal. If a network error occurs, the processing will instead end with Server::request-aborted.

upcall

default void upcall(MemorySegment sourceServer,
 MemorySegment message)

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

toCallback

default MemorySegment toCallback(Arena arena)

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

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the arena in which the function pointer is allocated

Returns:

the native function pointer