Package org.gnome.soup

Class CookieJar.Builder<B extends CookieJar.Builder<B>>

java.lang.Object

io.github.jwharm.javagi.gobject.Builder<B>

org.gnome.gobject.GObject.Builder<B>

org.gnome.soup.CookieJar.Builder<B>

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

BuilderInterface

Direct Known Subclasses:

CookieJarDB.Builder, CookieJarText.Builder

Enclosing class:

CookieJar

public static class CookieJar.Builder<B extends CookieJar.Builder<B>>
extends GObject.Builder<B>

Inner class implementing a builder pattern to construct a GObject with properties.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder()	Default constructor for a Builder object.

Method Summary

Modifier and Type	Method	Description
CookieJar	build()	Finish building the CookieJar object.
B	onChanged(CookieJar.ChangedCallback handler)	Emitted when jar changes.
B	setAcceptPolicy(CookieJarAcceptPolicy acceptPolicy)	The policy the jar should follow to accept or reject cookies.
B	setReadOnly(boolean readOnly)	Whether or not the cookie jar is read-only.

Methods inherited from class org.gnome.gobject.GObject.Builder

onNotify

Methods inherited from class io.github.jwharm.javagi.gobject.Builder

addBuilderProperty, connect, connect, connectSignals, getArena, getNames, getValues

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Builder

protected Builder()

Default constructor for a Builder object.

Method Details

build

public CookieJar build()
                throws UnsupportedPlatformException

Finish building the CookieJar object. This will call GObject.withProperties(org.gnome.glib.Type, java.lang.String[], org.gnome.gobject.Value[]) to create a new GObject instance, which is then cast to CookieJar.

Overrides:

build in class GObject.Builder<B extends CookieJar.Builder<B>>

Returns:

a new instance of CookieJar with the properties that were set in the Builder object.

Throws:

UnsupportedPlatformException - when run on an unsupported platform

setAcceptPolicy

public B setAcceptPolicy(CookieJarAcceptPolicy acceptPolicy)

The policy the jar should follow to accept or reject cookies.

Parameters:

acceptPolicy - the value for the accept-policy property

Returns:

the Builder instance is returned, to allow method chaining

setReadOnly

public B setReadOnly(boolean readOnly)

Whether or not the cookie jar is read-only.

Parameters:

readOnly - the value for the read-only property

Returns:

the Builder instance is returned, to allow method chaining

onChanged

public B onChanged(CookieJar.ChangedCallback handler)

Emitted when jar changes.

If a cookie has been added, newCookie will contain the newly-added cookie and oldCookie will be null. If a cookie has been deleted, oldCookie will contain the to-be-deleted cookie and newCookie will be null. If a cookie has been changed, oldCookie will contain its old value, and newCookie its new value.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• CookieJar.ChangedCallback.run(org.gnome.soup.Cookie, org.gnome.soup.Cookie)