Package com.yahoo.jdisc

Class NoopSharedResource

java.lang.Object

com.yahoo.jdisc.NoopSharedResource

All Implemented Interfaces:

SharedResource

Direct Known Subclasses:

NonWorkingClientProvider, NonWorkingRequestHandler, NonWorkingServerProvider

public class NoopSharedResource
extends Object
implements SharedResource

An implementation of SharedResource that does not do anything. Useful base class for e.g. mocks of SharedResource sub-interfaces, where reference counting is not the focus.

Author:

bakksjo

Nested Class Summary

Nested classes/interfaces inherited from interface com.yahoo.jdisc.SharedResource

SharedResource.Debug

Field Summary

Fields inherited from interface com.yahoo.jdisc.SharedResource

DEBUG, SYSTEM_PROPERTY_NAME_DEBUG

Constructor Summary

Constructors

Constructor	Description
NoopSharedResource()

Method Summary

Modifier and Type	Method	Description
final ResourceReference	refer()	Creates a reference to this resource.
final ResourceReference	refer(Object context)	Creates a reference to this resource.
final void	release()	Releases the "main" reference to this resource (the implicit reference due to creation of the object).

Methods inherited from class java.lang.Object

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

Constructor Details

NoopSharedResource

public NoopSharedResource()

Method Details

refer

public final ResourceReference refer()

Description copied from interface: SharedResource

Creates a reference to this resource. You call this method to prevent an object from being destroyed until you have finished using it.

You MUST keep the returned ResourceReference object and release the reference by calling ResourceReference.close() on it. A reference created by this method can NOT be released by calling SharedResource.release().

Specified by:

refer in interface SharedResource

See Also:

• ResourceReference.close()

refer

public final ResourceReference refer(Object context)

Description copied from interface: SharedResource

Creates a reference to this resource. You call this method to prevent an object from being destroyed until you have finished using it. You can attach a context that will live as long as the reference.

Specified by:

refer in interface SharedResource

Parameters:

context - A context to be associated with the reference. It should give some clue as to who referenced it.

You MUST keep the returned ResourceReference object and release the reference by calling ResourceReference.close() on it. A reference created by this method can NOT be released by calling SharedResource.release().

See Also:

• ResourceReference.close()

release

public final void release()

Description copied from interface: SharedResource

Releases the "main" reference to this resource (the implicit reference due to creation of the object).

References obtained by calling SharedResource.refer() must be released by calling ResourceReference.close() on the ResourceReference returned from SharedResource.refer(), NOT by calling this method. You call this method once you are done using an object that you have previously caused instantiation of.

Specified by:

release in interface SharedResource

See Also:

• ResourceReference