Module wicket.bootstrap.core

Package de.agilecoders.wicket.core

Class Bootstrap

java.lang.Object

de.agilecoders.wicket.core.Bootstrap

public final class Bootstrap
extends Object

#### Description

This is the bootstrap initializer class, you've to call `install` (with or without custom settings) to enable wicket-bootstrap in your project. wicket-bootstrap sets some wicket settings depending on your custom settings or if non provided depending on default settings. These are: `setStripWicketTags(true)` (always), `getPackageResourceGuard().addPattern(...)` (if `settings.updateSecurityManager()` is true) and `getComponentInstantiationListeners().add(new BootstrapResourceAppender())` (if `settings.autoAppendResources()` is true). `Bootstrap` initializes and uses wicket-webjars to load its web resources, therefor wicket-webjars will be initialized when calling `install` too (only if `settings.useWebjars()` returns true). If you use your own resources or the cdn resources, wicket-webjars won't be initialized. wicket-webjars can be initialized by calling `WicketWebjars.install(yourWicketApplication)` manually if needed.

#### Usage

minimal version:

```java Bootstrap.install(yourWicketApplication); ```

with custom settings:

```java final IBootstrapSettings settings = new BootstrapSettings(); settings.useCdnResources(true); Bootstrap.install(yourWicketApplication, settings); ```

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Bootstrap.Builder

Method Summary

Modifier and Type	Method	Description
static Bootstrap.Builder	builder()
static IBootstrapSettings	getSettings()	returns the IBootstrapSettings which are assigned to current application
static IBootstrapSettings	getSettings(Application app)	returns the IBootstrapSettings which are assigned to given application
static void	install(Application app)	Installs default bootstrap settings to given application.
static void	install(Application app, IBootstrapSettings settings)	Installs given settings to given application.
static void	renderHead(Component component, IHeaderResponse response)	renders all core bootstrap resource references
static void	renderHead(IHeaderResponse response)	renders all core bootstrap resource references

Methods inherited from class java.lang.Object

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

Method Details

builder

public static Bootstrap.Builder builder()

install

public static void install(Application app,
 IBootstrapSettings settings)

Installs given settings to given application. Duplicated calls to `install` will be ignored.

Parameters:

app - The current application

settings - The settings to use

Throws:

IllegalArgumentException - if given application is null

install

public static void install(Application app)

Installs default bootstrap settings to given application. Duplicated calls to `install` will be ignored.

Parameters:

app - The current application

Throws:

IllegalArgumentException - if given application is null

getSettings

public static IBootstrapSettings getSettings(Application app)

returns the IBootstrapSettings which are assigned to given application

Parameters:

app - The current application

Returns:

assigned IBootstrapSettings

Throws:

IllegalArgumentException - if given application is null

getSettings

public static IBootstrapSettings getSettings()

returns the IBootstrapSettings which are assigned to current application

Returns:

assigned IBootstrapSettings

Throws:

IllegalStateException - if there's no application bound to current thread

renderHead

public static void renderHead(Component component,
 IHeaderResponse response)

renders all core bootstrap resource references

Parameters:

component - current component

response - The current IHeaderResponse

Throws:

IllegalArgumentException - if given component or response is null.

IllegalStateException - if there's no application bound to current thread

renderHead

public static void renderHead(IHeaderResponse response)

renders all core bootstrap resource references

Parameters:

response - The current IHeaderResponse

Throws:

IllegalArgumentException - if given response is null

IllegalStateException - if there's no application bound to current thread