com.sun.star.uno

Interface IBridge

public interface IBridge

This is abstract interface for bridges.

Bridges are able to map one object from one UNO environment to another and vice versa.

See Also:
IBridge, IQueryInterface, UnoRuntime

Method Summary

void
acquire()
Increases the life count.
void
dispose()
Disposes the bridge.
IEnvironment
getSourceEnvironment()
Returns the source environment.
IEnvironment
getTargetEnvironment()
Returns the destination environment.
Object
mapInterfaceFrom(Object object, Type type)
Maps an object from the destination environment to the source environment.
Object
mapInterfaceTo(Object object, Type type)
Maps an object from the source environment to the destination environment.
void
release()
Decreases the life count.

Method Details

acquire

public void acquire()
Increases the life count.

dispose

public void dispose()
            throws InterruptedException,
                   IOException
Disposes the bridge.

Sends involved threads an InterruptedException. Releases mapped objects.


getSourceEnvironment

public IEnvironment getSourceEnvironment()
Returns the source environment.
Returns:
the source environment of this bridge

getTargetEnvironment

public IEnvironment getTargetEnvironment()
Returns the destination environment.
Returns:
the destination environment of this bridge

mapInterfaceFrom

public Object mapInterfaceFrom(Object object,
                               Type type)
Maps an object from the destination environment to the source environment.
Parameters:
object - the object to map
type - the type of the interface that shall be mapped
Returns:
the object in the source environment

mapInterfaceTo

public Object mapInterfaceTo(Object object,
                             Type type)
Maps an object from the source environment to the destination environment.
Parameters:
object - the object to map
type - the type of the interface that shall be mapped
Returns:
the object in the destination environment

release

public void release()
Decreases the life count.

If the life count drops to zero, the bridge disposes itself.