Package org.eclipse.persistence.internal.sessions.remote

Class RemoteValueHolder

    • Field Detail

      • id

        protected java.rmi.server.ObjID id

      • targetObjectPrimaryKeys

        protected java.lang.Object targetObjectPrimaryKeys

      • serverIndirectionObject

        protected transient java.lang.Object serverIndirectionObject

    • Constructor Detail

      • RemoteValueHolder

        public RemoteValueHolder()

      • RemoteValueHolder

        public RemoteValueHolder​(java.rmi.server.ObjID id)

    • Method Detail

      • canDoCacheCheck

        protected boolean canDoCacheCheck()
        If the reference object is mapped thru one to one mapping and the object derives its primary key value from this relationship then remote value holder has a primary key row for.

      • equals

        public boolean equals​(java.lang.Object object)
        Only the id is checked for equality check.
        Overrides:
        equals in class java.lang.Object

      • finalize

        public void finalize()
        This method is used to remove the RemoteValueHolder from the dispatcher on Garbage collection from the client
        Overrides:
        finalize in class java.lang.Object

      • getID

        public java.rmi.server.ObjID getID()
        Return the unique id.

      • getMapping

        public DatabaseMapping getMapping()
        Return the associated mapping.

      • getObjectFromCache

        protected java.lang.Object getObjectFromCache()
        Get object from the cache if there is one.

      • getServerIndirectionObject

        public java.lang.Object getServerIndirectionObject()
        Return the object on the server that holds on to the remote value holder. Currently used only by TransparentIndirection so we can get back to the original IndirectContainer.

      • getTargetObjectPrimaryKeys

        protected java.lang.Object getTargetObjectPrimaryKeys()
        Get target object primary key row.

      • getWrappedServerValueHolder

        public ValueHolderInterface getWrappedServerValueHolder()
        Return the original value holder. This is null on the client side because it is tagged transient. This is how we know whether the remote value holder is being invoked on the client or on the server.

      • hashCode

        public int hashCode()
        Return the hashcode for id, because it is unqiue.
        Overrides:
        hashCode in class java.lang.Object

      • isEasilyInstantiated

        public boolean isEasilyInstantiated()
        INTERNAL: Answers if this valueholder is easy to instantiate.
        Overrides:
        isEasilyInstantiated in class DatabaseValueHolder
        Returns:
        true if getValue() won't trigger a database read.

      • isPessimisticLockingValueHolder

        public boolean isPessimisticLockingValueHolder()
        INTERNAL: Answers if this valueholder is a pessimistic locking one. Such valueholders are special in that they can be triggered multiple times by different UnitsOfWork. Each time a lock query will be issued. Hence even if instantiated it may have to be instantiated again, and once instantatiated all fields can not be reset. Note: This method is not thread-safe. It must be used in a synchronizaed manner
        Specified by:
        isPessimisticLockingValueHolder in class DatabaseValueHolder

      • instantiateForUnitOfWorkValueHolder

        public java.lang.Object instantiateForUnitOfWorkValueHolder​(UnitOfWorkValueHolder unitOfWorkValueHolder)
        Triggers UnitOfWork valueholders directly without triggering the wrapped valueholder (this).

        When in transaction and/or for pessimistic locking the UnitOfWorkValueHolder needs to be triggered directly without triggering the wrapped valueholder. However only the wrapped valueholder knows how to trigger the indirection, i.e. it may be a batchValueHolder, and it stores all the info like the row and the query. Note: This method is not thread-safe. It must be used in a synchronizaed manner

        Specified by:
        instantiateForUnitOfWorkValueHolder in class DatabaseValueHolder

      • readExternal

        public void readExternal​(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException
        Override the default serialization for a remote valueholder so as not to serialize the value Note: Changed for bug 3145211. We used to use the java.io.Serializable interface, but need to convert to Externalizable interface to avoid sending extra data through the superclass's serialization
        Specified by:
        readExternal in interface java.io.Externalizable
        Throws:
        java.io.IOException
        java.lang.ClassNotFoundException

      • setID

        protected void setID​(java.rmi.server.ObjID anID)
        Set the unique id.

      • setMapping

        public void setMapping​(DatabaseMapping mapping)
        Set mapping

      • setServerIndirectionObject

        public void setServerIndirectionObject​(java.lang.Object serverIndirectionObject)
        Set the object on the server that holds on to the remote value holder. Currently used only by TransparentIndirection so we can get back to the original IndirectContainer.

      • setTargetObjectPrimaryKeys

        public void setTargetObjectPrimaryKeys​(java.lang.Object primaryKeys)
        Set target object primary keys.

      • setWrappedServerValueHolder

        public void setWrappedServerValueHolder​(ValueHolderInterface wrappedServerValueHolder)
        Set the original value holder.

      • writeExternal

        public void writeExternal​(java.io.ObjectOutput out)
                   throws java.io.IOException
        Override the default serialization for a remote valueholder so as not to serialize the value Note: Changed for bug 3145211. We used to use the java.io.Serializable interface, but need to convert to Externalizable interface to avoid sending extra data through the superclass's serialization
        Specified by:
        writeExternal in interface java.io.Externalizable
        Throws:
        java.io.IOException