ILinkableObjectWithNewProperties now receives notifications when a

session state contains properties that no longer exist in the current
implementation.

WeaveAPI/src/weave/api/core/ILinkableObjectWithNewProperties.as

@@ -16,18 +16,15 @@
 package weave.api.core
 {
 	/**
-	 * Implement this interface to detect when properties are missing from a full session state.
+	 * Implement this interface to detect when a full session state is missing properties or a session state contains extra properties.
 	 */
 	public interface ILinkableObjectWithNewProperties extends ILinkableObject
 	{
 		/**
-		 * This function will be called by SessionManager.setSessionState()
-		 * to give this object a chance to determine if a missing property
-		 * should be derived using backwards compatibility code for old
-		 * session states from when the property did not exist.
+		 * This function will be called by SessionManager.setSessionState() when a full session state is missing properties or a session state contains extra properties.
 		 * @param newState The new session state for this object.
-		 * @param missingProperty The name of the missing property.
+		 * @param missingProperty The name of the property, whether it is missing from the newState or this ILinkableObject.
 		 */
-		function handleMissingSessionStateProperty(newState:Object, missingProperty:String):void;
+		function handleMissingSessionStateProperty(newState:Object, property:String):void;
 	}
 }

WeaveCore/src/weave/core/SessionManager.as

@@ -442,6 +442,12 @@ package weave.core
 				setSessionState(property, newState[name], removeMissingDynamicObjects);
 			}
 
+			// handle properties appearing in session state that do not appear in the linkableObject 
+			if (linkableObject is ILinkableObjectWithNewProperties)
+				for each (name in newState)
+					if (!deprecatedLookup.hasOwnProperty(name))
+						(linkableObject as ILinkableObjectWithNewProperties).handleMissingSessionStateProperty(newState, name);
+
 			// handle properties missing from absolute session state
 			if (foundMissingProperty)
 				for each (name in classNameToSessionedPropertyNames[classQName])
@@ -580,7 +586,7 @@ package weave.core
 		 */
 		private const classNameToDeprecatedSetterNames:Object = new Object();
 		/**
-		 * This maps a qualified class name to an Object mapping deprecated sessioned property names to true.
+		 * This maps a qualified class name to an Object mapping sessioned property names to booleans indicating if they are implemented as deprecated getters.
 		 */
 		private const classNameToDeprecatedGetterLookup:Object = new Object();
 
@@ -615,8 +621,7 @@ package weave.core
 					}
 					else if (ClassUtils.classImplements(variable.type, ILinkableObjectQualifiedClassName))
 					{
-						if (deprecated)
-							deprecatedGetterLookup[variable.name] = true;
+						deprecatedGetterLookup[variable.name] = deprecated;
 						propertyNames.push(variable.name);
 					}
 				}