org.apache.tapestry5.ioc.services
Class TapestryIOCModule

java.lang.Object
  org.apache.tapestry5.ioc.services.TapestryIOCModule

@Marker(value=Builtin.class)
@PreventServiceDecoration
public final class TapestryIOCModule
extends Object

Defines the base set of services for the Tapestry IOC container.

Constructor Summary

TapestryIOCModule()

Method Summary

static void	bind(ServiceBinder binder)
static ServiceLifecycleSource	build(Map<String,ServiceLifecycle> configuration) Provides access to additional service lifecycles.
static ParallelExecutor	buildDeferredExecution(int coreSize, int maxSize, int keepAliveMillis, boolean threadPoolEnabled, PerthreadManager perthreadManager, RegistryShutdownHub shutdownHub, ThunkCreator thunkCreator)
static void	contributeFactoryDefaults(MappedConfiguration<String,String> configuration)
static void	contributeMasterObjectProvider(OrderedConfiguration<ObjectProvider> configuration, ServiceOverride serviceOverride) AnnotationBasedContributions Empty placeholder used to seperate annotation-based ObjectProvider contributions (which come before) from non-annotation based (ServiceOverride here, Alias in tapestry-core) which come after.
static void	contributeServiceLifecycleSource(MappedConfiguration<String,ServiceLifecycle> configuration) Contributes the "perthread" scope.
static void	contributeSymbolSource(OrderedConfiguration<SymbolProvider> configuration, SymbolProvider applicationDefaults, SymbolProvider factoryDefaults)
static void	contributeTypeCoercer(Configuration<CoercionTuple> configuration) Contributes a set of standard type coercions to the TypeCoercer service: Object to String String to Double String to BigDecimal BigDecimal to Double Double to BigDecimal String to BigInteger BigInteger to Long String to Long Long to Byte Long to Short Long to Integer Double to Long Double to Float Float to Double Long to Double String to Boolean ("false" is always false, other non-blank strings are true) Long to Boolean (true if long value is non zero) Null to Boolean (always false) Collection to Boolean (false if empty) Object[] to List primitive[] to List Object to List (by wrapping as a singleton list) String to File String to TimeInterval TimeInterval to Long Object to Object[] (wrapping the object as an array) Collection to Object[] (via the toArray() method)

Methods inherited from class java.lang.Object

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

Constructor Detail

TapestryIOCModule

public TapestryIOCModule()

Method Detail

bind

public static void bind(ServiceBinder binder)

build

public static ServiceLifecycleSource build(Map<String,ServiceLifecycle> configuration)

Provides access to additional service lifecycles. One lifecycle is built in ("singleton") but additional ones are accessed via this service (and its mapped configuration). Only proxiable services (those with explicit service interfaces) can be managed in terms of a lifecycle.

contributeServiceLifecycleSource

public static void contributeServiceLifecycleSource(MappedConfiguration<String,ServiceLifecycle> configuration)

Contributes the "perthread" scope.

contributeMasterObjectProvider

public static void contributeMasterObjectProvider(OrderedConfiguration<ObjectProvider> configuration,
                                                  @Local
                                                  ServiceOverride serviceOverride)

AnnotationBasedContributions

Empty placeholder used to seperate annotation-based ObjectProvider contributions (which come before) from non-annotation based (ServiceOverride here, Alias in tapestry-core) which come after.

Value

Supports the Value annotation

Symbol

Supports the Symbol annotations

Autobuild

Supports the Autobuild annotation

ServiceOverride

Allows simple service overrides via the ServiceOverride service (and its configuration)

contributeTypeCoercer

public static void contributeTypeCoercer(Configuration<CoercionTuple> configuration)

Contributes a set of standard type coercions to the TypeCoercer service:

• Object to String
• String to Double
• String to BigDecimal
• BigDecimal to Double
• Double to BigDecimal
• String to BigInteger
• BigInteger to Long
• String to Long
• Long to Byte
• Long to Short
• Long to Integer
• Double to Long
• Double to Float
• Float to Double
• Long to Double
• String to Boolean ("false" is always false, other non-blank strings are true)
• Long to Boolean (true if long value is non zero)
• Null to Boolean (always false)
• Collection to Boolean (false if empty)
• Object[] to List
• primitive[] to List
• Object to List (by wrapping as a singleton list)
• String to File
• String to TimeInterval
• TimeInterval to Long
• Object to Object[] (wrapping the object as an array)
• Collection to Object[] (via the toArray() method)

contributeSymbolSource

public static void contributeSymbolSource(OrderedConfiguration<SymbolProvider> configuration,
                                          @ApplicationDefaults
                                          SymbolProvider applicationDefaults,
                                          @FactoryDefaults
                                          SymbolProvider factoryDefaults)

buildDeferredExecution

public static ParallelExecutor buildDeferredExecution(@Symbol(value="tapestry.thread-pool.core-pool-size")
                                                      int coreSize,
                                                      @Symbol(value="tapestry.thread-pool.max-pool-size")
                                                      int maxSize,
                                                      @Symbol(value="tapestry.thread-pool.keep-alive")@IntermediateType(value=TimeInterval.class)
                                                      int keepAliveMillis,
                                                      @Symbol(value="tapestry.thread-pool-enabled")
                                                      boolean threadPoolEnabled,
                                                      PerthreadManager perthreadManager,
                                                      RegistryShutdownHub shutdownHub,
                                                      ThunkCreator thunkCreator)

contributeFactoryDefaults

public static void contributeFactoryDefaults(MappedConfiguration<String,String> configuration)