Changes between Version 18 and Version 19 of GROUP_RESOURCE_R0

Timestamp:

04/04/09 13:33:43 (16 years ago)

Author:

meddle

Comment:

--

GROUP_RESOURCE_R0

@@ -104 +104 @@
   * If there are important actions that must be executed when the resource is created and cached they must be put in the initialized method.
   * All the meta information providing fields in a resource must be annotated with the @ResourceMeta annotation.
-  * Two Resources are equal if their entity id and location are the same.
+  * Two Resources are equal if their entity id and location are equal.
   * The entity id and the location of a Resource are held in the ResourceSpace of the Resource.
   * All the ProObjects, which state is important for the state and the reconstruction of a Resource must be annotated with the annotation @Own
@@ -126 +126 @@
 [[BR]]
 [[BR]]
-
+Locating a Resource is hard task, a Resource can be cached in a cache in the application or can be contained/persisted on a given URL (server/file system). The ResourceRef is smart immutable object that has all the information needed to find a Resource.
+ * ResourceRef
+  * It can be constructed in four ways :
+   * By an absolute path, that can be used for searching a Resource on a distant location.
+   * By entity id and location, can be used for searching an unknown resource on a distant location or to copy a Reference.
+   * By a Resource and Resource source of the Resource, so it can be used for smart finding of a Resource by other in a Resource tree.
+   * By generating child Reference from a parent Resource (something like ./name as location)
+  * Two ResourceRefs are equal if the entity id's and the locations they are pointing to are the equal.
+  * The ResourceRef is can determine whether the Resource it's pointing to is available.
+  * The ResourceRef can retrieve it's Resource in two ways :
+   * By it's class, if the Resource is top level.
+   * By it's locating Resource (i.e. where the ResourceRef is held) and the class of the Resource that is searched.
+  * The ResourceRef can determine if it points to a Resource. 
 
 = Implementation =