com.sun.jini.lease

Class BasicRenewalFailureEvent

java.lang.Object

java.util.EventObject

net.jini.core.event.RemoteEvent

net.jini.lease.RenewalFailureEvent

com.sun.jini.lease.BasicRenewalFailureEvent

All Implemented Interfaces:

Serializable

public class BasicRenewalFailureEvent
extends RenewalFailureEvent

Basic implementation of RenewalFailureEvent that defers unmarshalling.

The Lease that could not be renewed and any accompanying Throwable will not be deserialized until the appropriate accessor is called.

Author:

Sun Microsystems, Inc.

See Also:

LeaseRenewalSet, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private Lease	lease Transient cache of lease returned by getLease method.
private MarshalledInstance	marshalledLease Lease, in marshalled form, returned by getLease method.
private MarshalledInstance	marshalledThrowable Exception, in marshalled form, returned by getThrowable method.
private static long	serialVersionUID
private Throwable	throwable Transient cache of exception returned by getThrowable method.
private boolean	verifyCodebaseIntegrity Whether to verify codebase integrity.

Fields inherited from class net.jini.core.event.RemoteEvent

eventID, handback, seqNum, source

Constructor Summary

Constructors

Constructor and Description
BasicRenewalFailureEvent(LeaseRenewalSet source, long seqNum, MarshalledObject handback, MarshalledInstance marshalledLease, MarshalledInstance marshalledThrowable) Simple constructor.

Method Summary

Methods

Modifier and Type	Method and Description
Lease	getLease() Returns the lease that could not be renewed.
Throwable	getThrowable() Returns the exception (if any) that was thrown by the last renewal attempt.
private void	readObject(ObjectInputStream in)

Methods inherited from class net.jini.core.event.RemoteEvent

getID, getRegistrationObject, getSequenceNumber

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

marshalledThrowable

private MarshalledInstance marshalledThrowable

Exception, in marshalled form, returned by getThrowable method. May be null.

marshalledLease

private MarshalledInstance marshalledLease

Lease, in marshalled form, returned by getLease method.

lease

private transient Lease lease

Transient cache of lease returned by getLease method.

throwable

private transient Throwable throwable

Transient cache of exception returned by getThrowable method.

verifyCodebaseIntegrity

private transient boolean verifyCodebaseIntegrity

Whether to verify codebase integrity.

Constructor Detail

BasicRenewalFailureEvent

public BasicRenewalFailureEvent(LeaseRenewalSet source,
                        long seqNum,
                        MarshalledObject handback,
                        MarshalledInstance marshalledLease,
                        MarshalledInstance marshalledThrowable)

Simple constructor. Note event id is fixed to LeaseRenewalSet.RENEWAL_FAILURE_EVENT_ID.

Parameters:

source - the LeaseRenewalSet that generated the event

seqNum - the sequence number of this event

handback - the client handback

marshalledLease - the lease which could not be renewed, in marshalled form

marshalledThrowable - the first exception that was thrown in the last chain of renewal failures, in marshalled form. May be null in which case getThrowable will return null.

Method Detail

getLease

public Lease getLease()
               throws IOException,
                      ClassNotFoundException

Returns the lease that could not be renewed. When the event is deserialized, the lease is left in marshalled form. It is only unmarshalled when this call is made. If a call to this method fails, future calls will attempt to re-unmarshal the lease. Once the lease is successfully unmarshalled it is cached in a transient field so future calls will not result in IOException or ClassNotFoundException.

Specified by:

getLease in class RenewalFailureEvent

Returns:

the unmarshalled lease

Throws:

IOException - if there are problems unmarshalling the lease, usually because of some sort of class mismatch

ClassNotFoundException - if there are problems unmarshalling the lease, usually because one of the classes associated with the lease's implementation could not be loaded

SecurityException - if this object was unmarshalled from a stream that required codebase integrity, and the integrity of the lease's codebase could not be verified

getThrowable

public Throwable getThrowable()
                       throws IOException,
                              ClassNotFoundException

Returns the exception (if any) that was thrown by the last renewal attempt.

When the event is deserialized, the exception is left in marshalled form. It is only unmarshalled when this call is made. If a call to this method fails, future calls will attempt to re-unmarshal the exception. Once the exception is successfully unmarshalled it is cached in a transient field so future calls will not result in IOException or ClassNotFoundException.

Specified by:

getThrowable in class RenewalFailureEvent

Returns:

the unmarshalled exception

Throws:

IOException - if there are problems unmarshalling the exception, usually because of some sort of class mismatch

ClassNotFoundException - if there are problems unmarshalling the exception, usually because one of the classes associated with the exception's implementation could not be loaded

SecurityException - if this object was unmarshalled from a stream that required codebase integrity, and the integrity of the exception's codebase could not be verified

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
                        ClassNotFoundException

Throws:

IOException

ClassNotFoundException