org.apache.tapestry5.ioc.services
Class TapestryIOCModule

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

@Marker(value=Builtin.class)
public final class TapestryIOCModule
extends java.lang.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(java.util.Map<java.lang.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	provideBasicTypeCoercions(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)
static void	providePerthreadScope(MappedConfiguration<java.lang.String,ServiceLifecycle> configuration) Contributes the "perthread" scope.
static void	setupDefaultSymbols(MappedConfiguration<java.lang.String,java.lang.String> configuration)
static void	setupObjectProviders(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	setupStandardSymbolProviders(OrderedConfiguration<SymbolProvider> configuration, SymbolProvider applicationDefaults, SymbolProvider factoryDefaults)

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

@PreventServiceDecoration
public static ServiceLifecycleSource build(java.util.Map<java.lang.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.

providePerthreadScope

@Contribute(value=ServiceLifecycleSource.class)
public static void providePerthreadScope(MappedConfiguration<java.lang.String,ServiceLifecycle> configuration)

Contributes the "perthread" scope.

setupObjectProviders

@Contribute(value=MasterObjectProvider.class)
public static void setupObjectProviders(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)

provideBasicTypeCoercions

@Contribute(value=TypeCoercer.class)
public static void provideBasicTypeCoercions(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)

setupStandardSymbolProviders

@Contribute(value=SymbolSource.class)
public static void setupStandardSymbolProviders(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)

setupDefaultSymbols

@Contribute(value=SymbolProvider.class)
@FactoryDefaults
public static void setupDefaultSymbols(MappedConfiguration<java.lang.String,java.lang.String> configuration)