<!--

 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.

-->

$Id$


= 1.2 =

== Backwards Compatibility ==

This release is backwards-compatible for normal use of Orchestra, but does make
one incompatible change in a core classes that will affect people who have modified
the internal implementation of Orchestra.

Method AbstractOrchestraScope.getConversationNameForBean was protected, and is now
public. That breaks any existing subclasses that override it and declare it protected,
as that is now a "weakening of access" which is not permitted. However it is pretty
rare for applications to customise the AbstractOrchestraScope.
 
== Bugfixes

 * ORCHESTRA-21: error encoding unusual urls generated by Trinidad
 * ORCHESTRA-23: "entity closed" or "transaction already started" when there are concurrent
    requests for the same user (ajax, double-clicks, etc). Thanks to Dan Tran for the fix.

 * A ConversationContext is no longer created just in order to lock it on request start.
   This avoids creating useless contexts for non-jsf requests (eg weblet requests).

 * Fixed an error with request locking which triggers when a thread is blocked for more
    than 30 seconds

== Known Issues

 * Orchestra still does not work with Portlets (ORCHESTRA-17, ORCHESTRA-22)

== New Features

* The ability to create "child" ConversationContexts, and set a ConversationContext
  name has been added. This is really just a foundation for enhancements intended in
  future versions, but it is available in the trunk release now.

* Improvements to serializability, though some work still remains needed on this.

* Added SpringBasicFrameworkAdapter, which allows spring beans to be looked up by
  Orchestra even when a ServletContext or FacesContext is not available (ORCHESTRA-18)

=== History

1.0 release based on r583187
Branched for 1.1 release on r634925
Branched for 1.2 release on r671173