From 780b92ada9afcf1d58085a83a0b9e6bc982203d1 Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Tue, 17 Feb 2015 17:25:57 +0000 Subject: Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz. --- .../sleepycat/persist/model/PersistentProxy.html | 450 ++++++++++----------- 1 file changed, 224 insertions(+), 226 deletions(-) (limited to 'docs/java/com/sleepycat/persist/model/PersistentProxy.html') diff --git a/docs/java/com/sleepycat/persist/model/PersistentProxy.html b/docs/java/com/sleepycat/persist/model/PersistentProxy.html index 0a536b85..5782b0e3 100644 --- a/docs/java/com/sleepycat/persist/model/PersistentProxy.html +++ b/docs/java/com/sleepycat/persist/model/PersistentProxy.html @@ -1,103 +1,96 @@ - - - - - -PersistentProxy (Oracle - Berkeley DB Java API) - - - - - - - - - - - - -
- - +//--> + + - - - - - - - - - - - - - - - - -
-Berkeley DB
version 5.3.21
-
- + + +
+ + +
+ + + - -
-

- -com.sleepycat.persist.model -
-Interface PersistentProxy<T>

-
-
-
public interface PersistentProxy<T>
- - -

-Implemented by a proxy class to represent the persistent state of a +

+
com.sleepycat.persist.model
+

Interface PersistentProxy<T>

+
+
+
+
    +
  • +
    +
    +
    public interface PersistentProxy<T>
    +
    Implemented by a proxy class to represent the persistent state of a (non-persistent) proxied class. Normally classes that are outside the scope of the developer's control must be proxied since they cannot be annotated, and because it is desirable to insulate the stored format from changes to @@ -111,21 +104,21 @@ Implemented by a proxy class to represent the persistent state of a
    1. It must implement the PersistentProxy interface.
    2. It must be specified as a persistent proxy class in the entity model. - When using the AnnotationModel, a proxy class is indicated by the - Persistent annotation with the Persistent.proxyFor() + When using the AnnotationModel, a proxy class is indicated by the + Persistent annotation with the Persistent.proxyFor() property.
    3. -
    4. It must be explicitly registered by calling EntityModel.registerClass(java.lang.Class) before opening the store.
    5. +
    6. It must be explicitly registered by calling EntityModel.registerClass(java.lang.Class) before opening the store.

    In order to serialize an instance of the proxied class before it is stored, an instance of the proxy class is created. The proxied instance is - then passed to the proxy's initializeProxy method. + then passed to the proxy's initializeProxy method. When this method returns, the proxy instance contains the state of the proxied instance. The proxy instance is then serialized and stored in the same way as for any persistent object.

    When an instance of the proxy object is deserialized after it is - retrieved from storage, its convertProxy() method is called. The + retrieved from storage, its convertProxy() method is called. The instance of the proxied class returned by this method is then returned as a field in the persistent instance.

    @@ -178,7 +171,7 @@ Implemented by a proxy class to represent the persistent state of a built-in proxy, if both exist for the same proxied class.

    With respect to class evolution, a proxy instance is no different than - any other persistent instance. When using a RawStore or Converter, only the raw data of the proxy instance will be visible. Raw + any other persistent instance. When using a RawStore or Converter, only the raw data of the proxy instance will be visible. Raw data for the proxied instance never exists.

    Currently a proxied object may not contain a reference to itself. For @@ -189,141 +182,146 @@ Implemented by a proxy class to represent the persistent state of a store such an object is made, an IllegalArgumentException will be thrown.

    -

    Note that a proxy class may not be a subclass of an entity class.

    -

    - -

    -


    - -

    - +

    Note that a proxy class may not be a subclass of an entity class.

    +
  • +
+
+
+
    +
  • - - - - - - - - - - - - - - -
    -Method Summary
    - TconvertProxy() - -
    -          Returns a new proxied class instance to which the state of this proxy - instance has been copied.
    - voidinitializeProxy(T object) - -
    -          Copies the state of a given proxied class instance to this proxy - instance.
    -  -

    - +

      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + +
      Methods 
      Modifier and TypeMethod and Description
      TconvertProxy() +
      Returns a new proxied class instance to which the state of this proxy + instance has been copied.
      +
      voidinitializeProxy(T object) +
      Copies the state of a given proxied class instance to this proxy + instance.
      +
      +
    • +
    +
  • +
+
+
+
    +
  • - - - - - - -
    -Method Detail
    - -

    -initializeProxy

    -
    -void initializeProxy(T object)
    -
    -
    Copies the state of a given proxied class instance to this proxy - instance. -

    -

    -
    -
    -
    -
    - -

    -convertProxy

    -
    -T convertProxy()
    -
    -
    Returns a new proxied class instance to which the state of this proxy - instance has been copied. -

    -

    -
    -
    -
    +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        initializeProxy

        +
        void initializeProxy(T object)
        +
        Copies the state of a given proxied class instance to this proxy + instance.
        +
      • +
      + + + +
        +
      • +

        convertProxy

        +
        T convertProxy()
        +
        Returns a new proxied class instance to which the state of this proxy + instance has been copied.
        +
      • +
      +
    • +
    +
  • +
+
+
-
- - - - - - - - - - - - - - - - - - -
-Berkeley DB
version 5.3.21
-
- + + +
+ + +
+ + + - -
-Copyright (c) 1996, 2012 Oracle and/or its affiliates. All rights reserved. - - +

Copyright (c) 1996, 2015 Oracle and/or its affiliates. All rights reserved.

+ + -- cgit v1.2.1