Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.myfaces.orchestra
Class CoreConfig

    java.lang.Object
      org.apache.myfaces.orchestra.CoreConfig

    public final class CoreConfig

extends Object

A place to define all the configuration constants that can be used to configure parts of Orchestra core.

Since:
  1.1

Field Summary
`static String` | `CLEANUP_CONNECTIONS` Value "org.apache.myfaces.orchestra.CoreConfig:CLEANUP_CONNECTIONS".
`static String` | `CONVERSATION_MESSAGER` Value "org.apache.myfaces.orchestra.CoreConfig:CONVERSATION_MESSAGER".
`static String` | `SERIALIZE_REQUESTS` Value "org.apache.myfaces.orchestra.CoreConfig:SERIALIZE_REQUESTS".

Constructor Summary
`CoreConfig()`

Method Summary

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### SERIALIZE_REQUESTS

    public static final String SERIALIZE_REQUESTS

  Value "org.apache.myfaces.orchestra.CoreConfig:SERIALIZE_REQUESTS".

  Controls whether two threads are prevented from accessing the same ConversationContext concurrently, or not. This is generally a bad idea as it can lead to ugly race conditions, so it is TRUE by default.

  It is possible for multiple requests associated with the same http session to be received concurrently. By default, a servlet engine simply processes all requests concurrently in different threads. However that can cause all sorts of unexpected problems with objects in scopes that are visible to both threads (session-scoped and conversation-scoped objects).

  When enabled, this option will block the thread for any request which will access the same Orchestra ConversationContext as a thread that is already running, and release it only when the earlier request has completed. This protects all orchestra conversation-scoped objects from concurrent access, but does not protect any session-scoped objects.

  When using Orchestra, it is recommended that session-scoped objects are avoided conversation-scoped beans used instead. If there is no session-scoped data in use by an application then it is safe to allow concurrent requests to the same http session. If you do wish to protect normal session-scoped objects as well, then the standard solution is to write a filter that uses standard java synchronisation on a session-scoped object, taking the lock on request entry and releasing it on request exit.

  Note that the expression "serialize requests" as used here means requests are processed serially, ie one after the other rather than concurrently. This has nothing to do with java.io.Serializable.

### CLEANUP_CONNECTIONS

    public static final String CLEANUP_CONNECTIONS

  Value "org.apache.myfaces.orchestra.CoreConfig:CLEANUP_CONNECTIONS".

  Controls whether Orchestra should monitor the set of JDBC connections borrowed during a request, and clean up any that are still open at the end of the request.

  Orchestra provides a special DataSource wrapper that can be configured for any datasource used by the application. The datasource simply wraps all real Connection objects it returns in a proxy, and keeps track of them. At the end of each request, any connections borrowed by this thread but not returned can be returned automatically. See ConnectionManagerDataSource for more details.

  If this special DataSource is not configured, then checking for unreleased connections is harmless, and always finds nothing. Therefore this option is enabled by default.

### CONVERSATION_MESSAGER

    public static final String CONVERSATION_MESSAGER

  Value "org.apache.myfaces.orchestra.CoreConfig:CONVERSATION_MESSAGER".

  Controls what class is used to present Orchestra-related error messages to the user. When not specified, the default implementation for the current FrameworkAdapter (eg JsfFrameworkAdapter) is used.

  See class ConversationMessager for further details.

Constructor Detail

### CoreConfig

    public CoreConfig()

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2012 The Apache Software Foundation. All Rights Reserved.