Modifier and Type	Class and Description
private static class	java_environment.Registry

Modifier and Type	Field and Description
private final Object	context
private static final java_environment.Registry	localObjects
private final java_environment.Registry	proxies

Access	Constructor and Description
public	java_environment(Object context)

Method Summary

Modifier and Type	Method and Description
public boolean	equals(Object obj) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public Object	getContext() Implements com.sun.star.uno.IEnvironment.getContext. Gets the context of this environment.
public String	getName() Implements com.sun.star.uno.IEnvironment.getName. Gets the name of this environment.
public Object	getRegisteredInterface(String object id of interface to be retrieved. oid, Type the type description of the interface to be retrieved. type) Implements com.sun.star.uno.IEnvironment.getRegisteredInterface. Retrieves an interface identified by its object id and type from this environment.
public String	getRegisteredObjectIdentifier(Object a registered interface. object) Implements com.sun.star.uno.IEnvironment.getRegisteredObjectIdentifier. Retrieves the object identifier for a registered interface from this environment.
private boolean	isProxy(Object object)
public void	list() Implements com.sun.star.uno.IEnvironment.list. Lists the registered objects to `System.out`.
public Object	registerInterface(Object object, String[] oid, Type type) Implements com.sun.star.uno.IEnvironment.registerInterface. Registers one UNO interface facet of an object.
public void	revokeAllProxies() Revokes all registered proxy interfaces.
public void	revokeInterface(String object id of interface to be revoked. oid, Type the type description of the interface. type) Implements com.sun.star.uno.IEnvironment.revokeInterface. You have to revoke ANY interface that has been registered via this method.

Inherited from java.lang.Object:: clone finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

context	back to summary
private final Object context

localObjects	back to summary
private static final java_environment.Registry localObjects

proxies	back to summary
private final java_environment.Registry proxies

Constructor Detail

java_environment	back to summary
public java_environment(Object context)

Method Detail

equals back to summary

equals	back to summary
public boolean equals(Object obj) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Annotations @Override

public boolean equals(Object obj)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Annotations

@Override

getContext back to summary

getContext	back to summary
public Object getContext() Implements com.sun.star.uno.IEnvironment.getContext. Doc from com.sun.star.uno.IEnvironment.getContext. Gets the context of this environment. See Also `com.sun.star.uno.IEnvironment#getContext`

public Object getContext()

Implements com.sun.star.uno.IEnvironment.getContext.

Doc from com.sun.star.uno.IEnvironment.getContext.

Gets the context of this environment.

See Also: com.sun.star.uno.IEnvironment#getContext

getName back to summary

getName	back to summary
public String getName() Implements com.sun.star.uno.IEnvironment.getName. Doc from com.sun.star.uno.IEnvironment.getName. Gets the name of this environment. See Also `com.sun.star.uno.IEnvironment#getName`

public String getName()

Implements com.sun.star.uno.IEnvironment.getName.

Doc from com.sun.star.uno.IEnvironment.getName.

Gets the name of this environment.

See Also: com.sun.star.uno.IEnvironment#getName

getRegisteredInterface back to summary

getRegisteredInterface	back to summary
public Object getRegisteredInterface(String oid, Type type) Implements com.sun.star.uno.IEnvironment.getRegisteredInterface. Retrieves an interface identified by its object id and type from this environment. Parameters oid:String object id of interface to be retrieved. type:Type the type description of the interface to be retrieved. See Also `com.sun.star.uno.IEnvironment#getRegisteredInterface`

public Object getRegisteredInterface(String oid, Type type)

Implements com.sun.star.uno.IEnvironment.getRegisteredInterface.

Retrieves an interface identified by its object id and type from this environment.

Parameters

oid:String: object id of interface to be retrieved.
type:Type: the type description of the interface to be retrieved.

getRegisteredObjectIdentifier back to summary

getRegisteredObjectIdentifier	back to summary
public String getRegisteredObjectIdentifier(Object object) Implements com.sun.star.uno.IEnvironment.getRegisteredObjectIdentifier. Retrieves the object identifier for a registered interface from this environment. Parameters object:Object a registered interface. See Also `com.sun.star.uno.IEnvironment#getRegisteredObjectIdentifier`

public String getRegisteredObjectIdentifier(Object object)

Implements com.sun.star.uno.IEnvironment.getRegisteredObjectIdentifier.

Retrieves the object identifier for a registered interface from this environment.

Parameters

object:Object: a registered interface.

isProxy	back to summary
private boolean isProxy(Object object)

list back to summary

list	back to summary
public void list() Implements com.sun.star.uno.IEnvironment.list. Doc from com.sun.star.uno.IEnvironment.list. Lists the registered objects to `System.out`. This is for debug purposes. See Also `com.sun.star.uno.IEnvironment#list`

public void list()

Implements com.sun.star.uno.IEnvironment.list.

Doc from com.sun.star.uno.IEnvironment.list.

Lists the registered objects to System.out.

This is for debug purposes.

See Also: com.sun.star.uno.IEnvironment#list

registerInterface back to summary

registerInterface	back to summary
public Object registerInterface(Object object, String[] oid, Type type) Implements com.sun.star.uno.IEnvironment.registerInterface. Doc from com.sun.star.uno.IEnvironment.registerInterface. Registers one UNO interface facet of an object. Such an object will typically be one of three things: A local Java object, to be mapped out of this environment via a given bridge. A proxy object, mapped into this environment via some bridge `B1`, and now to be mapped out of this environment via a given bridge `B2`. A proxy object, created as a remote object is mapped into this environment via a given bridge. The object actually registered may differ from the specified `object` that is passed as an argument. This enables an environment to work in a multi-threaded scenario, where two threads can call `registerInterface` for the same combination of `oid` and `type` at the same time; the race condition is solved by letting one of the calls register its argument `object`, ignoring the argument `object` of the other call, and letting both calls return the same `object`. The registered object is held only weakly by the environment. After a call to `registerInterface`, a call to `getRegisteredInterface` only succeeds as long as the registered object is still strongly reachable, and the registered object has not been explicitly revoked by calling `revokeInterface`. See Also `com.sun.star.uno.IEnvironment#registerInterface`

public Object registerInterface(Object object, String[] oid, Type type)

Implements com.sun.star.uno.IEnvironment.registerInterface.

Doc from com.sun.star.uno.IEnvironment.registerInterface.

Registers one UNO interface facet of an object.

Such an object will typically be one of three things:

A local Java object, to be mapped out of this environment via a given bridge.
A proxy object, mapped into this environment via some bridge B1, and now to be mapped out of this environment via a given bridge B2.
A proxy object, created as a remote object is mapped into this environment via a given bridge.

The object actually registered may differ from the specified object that is passed as an argument. This enables an environment to work in a multi-threaded scenario, where two threads can call registerInterface for the same combination of oid and type at the same time; the race condition is solved by letting one of the calls register its argument object, ignoring the argument object of the other call, and letting both calls return the same object.

The registered object is held only weakly by the environment. After a call to registerInterface, a call to getRegisteredInterface only succeeds as long as the registered object is still strongly reachable, and the registered object has not been explicitly revoked by calling revokeInterface.

See Also: com.sun.star.uno.IEnvironment#registerInterface

revokeAllProxies back to summary

revokeAllProxies	back to summary
public void revokeAllProxies() Revokes all registered proxy interfaces. This method should be part of `IEnvironment`. It is called from `com.sun.star.lib.uno.bridges.java_remote.java_remote_bridge.dispose`.

public void revokeAllProxies()

Revokes all registered proxy interfaces.

This method should be part of IEnvironment. It is called from com.sun.star.lib.uno.bridges.java_remote.java_remote_bridge.dispose.

revokeInterface back to summary

revokeInterface	back to summary
public void revokeInterface(String oid, Type type) Implements com.sun.star.uno.IEnvironment.revokeInterface. You have to revoke ANY interface that has been registered via this method. Parameters oid:String object id of interface to be revoked. type:Type the type description of the interface. See Also `com.sun.star.uno.IEnvironment#revokeInterface`

public void revokeInterface(String oid, Type type)

Implements com.sun.star.uno.IEnvironment.revokeInterface.

You have to revoke ANY interface that has been registered via this method.

Parameters

oid:String: object id of interface to be revoked.
type:Type: the type description of the interface.

com.sun.star.lib.uno.environments.java back to summary

private final Class java_environment.Registry

Class Inheritance

extends Object

java.lang.Object
com.sun.star.lib.uno.environments.java.java_environment.Registry

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	java_environment.Registry.Level1Entry
private static class	java_environment.Registry.Level2Entry

Field Summary

Modifier and Type	Field and Description
private final HashMap<String, java_environment.Registry.Level1Entry>	level1map
private final ReferenceQueue<Object>	queue

Constructor Summary

Access	Constructor and Description
private	Registry()

Method Summary

Modifier and Type	Method and Description
private void	cleanUp()
public synchronized void	clear()
public synchronized Object	get(String oid, Type type)
public synchronized Object	register(Object object, String oid, Type type)
private void	removeLevel2Entry(java_environment.Registry.Level1Entry l1, String oid, Type type)
public synchronized boolean	revoke(String oid, Type type)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

level1map	back to summary
private final HashMap<String, java_environment.Registry.Level1Entry> level1map

queue	back to summary
private final ReferenceQueue<Object> queue

Constructor Detail

Registry	back to summary
private Registry()

Method Detail

cleanUp	back to summary
private void cleanUp()

clear	back to summary
public synchronized void clear()

get	back to summary
public synchronized Object get(String oid, Type type)

register	back to summary
public synchronized Object register(Object object, String oid, Type type)

removeLevel2Entry	back to summary
private void removeLevel2Entry(java_environment.Registry.Level1Entry l1, String oid, Type type)

revoke	back to summary
public synchronized boolean revoke(String oid, Type type)

com.sun.star.lib.uno.environments.java back to summary

private final Class java_environment.Registry.Level1Entry

Class Inheritance

extends Object

java.lang.Object
com.sun.star.lib.uno.environments.java.java_environment.Registry.Level1Entry

Field Summary

Modifier and Type	Field and Description
public final HashMap<Type, java_environment.Registry.Level2Entry>	level2map

Constructor Summary

Access	Constructor and Description
private	Level1Entry()

Method Summary

Modifier and Type	Method and Description
public Object	find(Type type)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

level2map	back to summary
public final HashMap<Type, java_environment.Registry.Level2Entry> level2map

Constructor Detail

Level1Entry	back to summary
private Level1Entry()

Method Detail

find	back to summary
public Object find(Type type)

com.sun.star.lib.uno.environments.java back to summary

private final Class java_environment.Registry.Level2Entry

Class Inheritance

extends WeakReference<Object>

java.lang.Object
java.lang.ref.Reference
java.lang.ref.WeakReference
com.sun.star.lib.uno.environments.java.java_environment.Registry.Level2Entry

Field Summary

Modifier and Type	Field and Description
private int	count
public final String	oid
public final Type	type

Constructor Summary

Access	Constructor and Description
public	Level2Entry(String oid, Type type, Object object, ReferenceQueue<Object> queue)

Method Summary

Modifier and Type	Method and Description
public void	acquire()
public boolean	release()

Field Detail

count	back to summary
private int count

oid	back to summary
public final String oid

type	back to summary
public final Type type

Constructor Detail

Level2Entry	back to summary
public Level2Entry(String oid, Type type, Object object, ReferenceQueue<Object> queue)

Method Detail

acquire	back to summary
public void acquire()

release	back to summary
public boolean release()

public final Class java_environment

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class java_environment.Registry

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class java_environment.Registry.Level1Entry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class java_environment.Registry.Level2Entry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail