AppModule Class Reference

This module is automatically included as part of the Tapestry IoC Registry, it's a good place to configure and extend Tapestry, or to place your own service definitions. More...

List of all members.

Public Member Functions
void	contributeHibernateSessionSource (Configuration< String > cfg)
RequestFilter	buildTimingFilter (final Log log)
	This is a service definition, the service will be named "TimingFilter".
void	contributeRequestHandler (OrderedConfiguration< RequestFilter > configuration,@InjectService("TimingFilter") RequestFilter filter)
	This is a contribution to the RequestHandler service configuration.
Static Public Member Functions
static void	contributeApplicationDefaults (MappedConfiguration< String, String > configuration)

---

Detailed Description

This module is automatically included as part of the Tapestry IoC Registry, it's a good place to configure and extend Tapestry, or to place your own service definitions.

Definition at line 20 of file AppModule.java.

---

Member Function Documentation

void contributeHibernateSessionSource

(

Configuration< String >

cfg

)

Definition at line 23 of file AppModule.java.

                                                                            {
        cfg.add("cedar.hepdata.model");
    }

static void contributeApplicationDefaults

(

MappedConfiguration< String, String >

configuration

)

[static]

Definition at line 40 of file AppModule.java.

    {
        // Contributions to ApplicationDefaults will override any contributions to
        // FactoryDefaults (with the same key). Here we're restricting the supported
        // locales to just "en" (English). As you add localised message catalogs and other assets,
        // you can extend this list of locales (it's a comma seperated series of locale names;
        // the first locale name is the default when there's no reasonable match).

        configuration.add("tapestry.supported-locales", "en");
    }

RequestFilter buildTimingFilter

(

final Log

log

)

This is a service definition, the service will be named "TimingFilter".

The interface, RequestFilter, is used within the RequestHandler service pipeline, which is built from the RequestHandler service configuration. Tapestry IoC is responsible for passing in an appropriate Log instance. Requests for static resources are handled at a higher level, so this filter will only be invoked for Tapestry related requests.

Service builder methods are useful when the implementation is inline as an inner class (as here) or require some other kind of special initialization. In most cases, use the static bind() method instead.

If this method was named "build", then the service id would be taken from the service interface and would be "RequestFilter". Since Tapestry already defines a service named "RequestFilter" we use an explicit service id that we can reference inside the contribution method.

Definition at line 71 of file AppModule.java.

    {
        return new RequestFilter()
        {
            public boolean service(Request request, Response response, RequestHandler handler)
                    throws IOException
            {
                long startTime = System.currentTimeMillis();

                try
                {
                    // The reponsibility of a filter is to invoke the corresponding method
                    // in the handler. When you chain multiple filters together, each filter
                    // received a handler that is a bridge to the next filter.

                    return handler.service(request, response);
                }
                finally
                {
                    long elapsed = System.currentTimeMillis() - startTime;

                    log.info(String.format("Request time: %d ms", elapsed));
                }
            }
        };
    }

void contributeRequestHandler	(	OrderedConfiguration< RequestFilter >	configuration,
		@InjectService("TimingFilter") RequestFilter	filter
	)

This is a contribution to the RequestHandler service configuration.

This is how we extend Tapestry using the timing filter. A common use for this kind of filter is transaction management or security.

Definition at line 103 of file AppModule.java.

    {
        // Each contribution to an ordered configuration has a name, When necessary, you may
        // set constraints to precisely control the invocation order of the contributed filter
        // within the pipeline.

        configuration.add("Timing", filter);
    }

---

The documentation for this class was generated from the following file:

• /home/buckley/hepdata/codedocs/src/hepdata/hepdata-webapp/src/main/java/cedar/hepdata/webapp/services/AppModule.java