ca.weblite.objc

Class Proxy

java.lang.Object

ca.weblite.objc.Proxy

All Implemented Interfaces:

Peerable

Direct Known Subclasses:

NSObject

public class Proxy
extends java.lang.Object
implements Peerable

A wrapper around a native (Objective-C) object that allows for sending messages from Java.

Example Wrapping NSMutableArray Object

The following snippet is taken from a unit test, to give you an idea of how to use the Proxy class to wrap an Objective-C object.

The NSRange object is a structure that we define in Java to correspond with the NSRange objective-c structure according to JNA conventions. It's implementation (for your reference) was:

See Also:

JavaNativeAccess On GitHub

Constructor Summary

Constructors

Constructor and Description
Proxy() Creates a proxy for a Null pointer.
Proxy(Client client) Creates a proxy for a Null pointer using the specified Client object.
Proxy(Client client, com.sun.jna.Pointer peer) Creates a proxy for the specified peer Objective-C object, using the specified client to send messages to the peer.
Proxy(com.sun.jna.Pointer peer) Creates a proxy for the specified peer Objective-C object.

Method Summary

Methods

Modifier and Type	Method and Description
Proxy	chain(Message... msgs) Deprecated.
Proxy	chain(com.sun.jna.Pointer selector, java.lang.Object... args) Deprecated.
Proxy	chain(java.lang.String selector, java.lang.Object... args) Deprecated.
void	dispose(boolean sendDeallocMessage) Removes the proxy from the proxy cache, and optionally sends a dealloc message to the peer.
boolean	equals(java.lang.Object o) Compares this object to another Peerable object.
java.lang.Object	get(java.lang.String key) Wrapper for key-value coding.
boolean	getBoolean(java.lang.String key) Returns the KVC coded value for the specified key as a boolean.
Client	getClient() Returns the client that is used by this Proxy object.
double	getDouble(java.lang.String key) Returns the KVC coded value for the specified key as a double.
int	getInt(java.lang.String key) Returns the KVC coded value for the specified key as an int.
com.sun.jna.Pointer	getPeer() Returns the Pointer to the native peer object.
com.sun.jna.Pointer	getPointer(java.lang.String key) Returns the KVC coded value for the specified key as a Pointer.
Proxy	getProxy(java.lang.String key) Returns the KVC coded value for the specified key as a Proxy.
int	hashCode()
static Proxy	load(com.sun.jna.Pointer peer) Loads a proxy object for the specified pointer to an objective-c object.
java.lang.Object	send(Message... msgs) Sends a message to the peer.
java.lang.Object	send(com.sun.jna.Pointer selector, java.lang.Object... args) Sends a message to the peer.
java.lang.Object	send(java.lang.String selector, java.lang.Object... args) Sends a message to the peer.
boolean	sendBoolean(com.sun.jna.Pointer selector, java.lang.Object... args) A wrapper for the send() method, that returns a boolean.
boolean	sendBoolean(java.lang.String selector, java.lang.Object... args) A wrapper for the send() method, that returns a boolean.
double	sendDouble(com.sun.jna.Pointer selector, java.lang.Object... args) A wrapper for the send() method, that returns a double.
double	sendDouble(java.lang.String selector, java.lang.Object... args) A wrapper for the send() method, that returns a double.
int	sendInt(com.sun.jna.Pointer selector, java.lang.Object... args) A wrapper for the send() method, that returns an int.
int	sendInt(java.lang.String selector, java.lang.Object... args) A wrapper for the send() method, that returns an int.
com.sun.jna.Pointer	sendPointer(com.sun.jna.Pointer selector, java.lang.Object... args) A wrapper for the send() method, that returns a Pointer.
com.sun.jna.Pointer	sendPointer(java.lang.String selector, java.lang.Object... args) A wrapper for the send() method, that returns a Pointer.
Proxy	sendProxy(com.sun.jna.Pointer selector, java.lang.Object... args) A wrapper for the send() method, that returns a Pointer.
Proxy	sendProxy(java.lang.String selector, java.lang.Object... args) A wrapper for the send() method, that returns a Pointer.
java.lang.Object	sendRaw(Message... msgs) Sends a message to the peer without performing any type coercion to the inputs or outputs.
java.lang.Object	sendRaw(com.sun.jna.Pointer selector, java.lang.Object... args) Sends a message to the peer.
java.lang.Object	sendRaw(java.lang.String selector, java.lang.Object... args) Sends a message to the peer without performing any type coercion to the inputs or outputs.
java.lang.String	sendString(com.sun.jna.Pointer selector, java.lang.Object... args)
java.lang.String	sendString(java.lang.String selector, java.lang.Object... args)
void	set(java.lang.String key, java.lang.Object value) Wrapper for Key-Value coding.
Proxy	setClient(Client client) Sets the client that should be used for sending messages to the peer object.
void	setPeer(com.sun.jna.Pointer peer) Sets the pointer to the native peer object.
java.lang.String	toString() Outputs the object as a string.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Proxy

public Proxy()

Creates a proxy for a Null pointer.

Proxy

public Proxy(Client client)

Creates a proxy for a Null pointer using the specified Client object.

Parameters:

client -

Proxy

public Proxy(Client client,
     com.sun.jna.Pointer peer)

Creates a proxy for the specified peer Objective-C object, using the specified client to send messages to the peer.

Parameters:

client -

peer -

Proxy

public Proxy(com.sun.jna.Pointer peer)

Creates a proxy for the specified peer Objective-C object.

Parameters:

peer -

Method Detail

load

public static Proxy load(com.sun.jna.Pointer peer)

Loads a proxy object for the specified pointer to an objective-c object. If a Proxy has previously been created for this pointer, this same proxy object will be loaded from the cache.

Parameters:

peer - The objective-c peer object.

Returns:

A proxy that wraps the provided peer object.

dispose

public void dispose(boolean sendDeallocMessage)

Removes the proxy from the proxy cache, and optionally sends a dealloc message to the peer.

Parameters:

sendDeallocMessage - IF true, then this will also send a dealloc message to the peer. If false, then it will simply remove from the Proxy cache, but leave the Objective-C object intact.

sendPointer

public com.sun.jna.Pointer sendPointer(com.sun.jna.Pointer selector,
                              java.lang.Object... args)

A wrapper for the send() method, that returns a Pointer.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a Pointer.

sendPointer

public com.sun.jna.Pointer sendPointer(java.lang.String selector,
                              java.lang.Object... args)

A wrapper for the send() method, that returns a Pointer.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a Pointer.

sendProxy

public Proxy sendProxy(java.lang.String selector,
              java.lang.Object... args)

A wrapper for the send() method, that returns a Pointer.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a Pointer.

sendProxy

public Proxy sendProxy(com.sun.jna.Pointer selector,
              java.lang.Object... args)

A wrapper for the send() method, that returns a Pointer.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a Pointer.

sendString

public java.lang.String sendString(com.sun.jna.Pointer selector,
                          java.lang.Object... args)

sendString

public java.lang.String sendString(java.lang.String selector,
                          java.lang.Object... args)

sendInt

public int sendInt(com.sun.jna.Pointer selector,
          java.lang.Object... args)

A wrapper for the send() method, that returns an int.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as an int.

sendInt

public int sendInt(java.lang.String selector,
          java.lang.Object... args)

A wrapper for the send() method, that returns an int.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as an int.

sendDouble

public double sendDouble(com.sun.jna.Pointer selector,
                java.lang.Object... args)

A wrapper for the send() method, that returns a double.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a double.

sendDouble

public double sendDouble(java.lang.String selector,
                java.lang.Object... args)

A wrapper for the send() method, that returns a double.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a double.

sendBoolean

public boolean sendBoolean(com.sun.jna.Pointer selector,
                  java.lang.Object... args)

A wrapper for the send() method, that returns a boolean.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a boolean.

sendBoolean

public boolean sendBoolean(java.lang.String selector,
                  java.lang.Object... args)

A wrapper for the send() method, that returns a boolean.

Parameters:

selector - The selector to call on the peer.

args - Variable argument list.

Returns:

The result of the message call as a boolean.

send

public java.lang.Object send(com.sun.jna.Pointer selector,
                    java.lang.Object... args)

Sends a message to the peer.

Parameters:

selector - The selector to send to.

args - Variable argument list.

Returns:

The result of the message call.

send

public java.lang.Object send(java.lang.String selector,
                    java.lang.Object... args)

Sends a message to the peer.

Parameters:

selector - The selector to send to.

args - Variable argument list.

Returns:

The result of the message call.

send

public java.lang.Object send(Message... msgs)

Sends a message to the peer.

Parameters:

selector - The selector to send to.

args - Variable argument list.

Returns:

The result of the message call.

sendRaw

public java.lang.Object sendRaw(com.sun.jna.Pointer selector,
                       java.lang.Object... args)

Sends a message to the peer.

Parameters:

selector - The selector to send to.

args - Variable argument list.

Returns:

The result of the message call.

sendRaw

public java.lang.Object sendRaw(java.lang.String selector,
                       java.lang.Object... args)

Sends a message to the peer without performing any type coercion to the inputs or outputs.

Parameters:

selector - The selector to send to.

args - Variable argument list.

Returns:

The result of the message call.

sendRaw

public java.lang.Object sendRaw(Message... msgs)

Sends a message to the peer without performing any type coercion to the inputs or outputs.

Parameters:

selector - The selector to send to.

args - Variable argument list.

Returns:

The result of the message call.

chain

public Proxy chain(com.sun.jna.Pointer selector,
          java.lang.Object... args)

Deprecated.

Parameters:

selector -

args -

Returns:

chain

public Proxy chain(java.lang.String selector,
          java.lang.Object... args)

Deprecated.

Parameters:

selector -

args -

Returns:

chain

public Proxy chain(Message... msgs)

Deprecated.

Parameters:

msgs -

Returns:

getClient

public Client getClient()

Returns the client that is used by this Proxy object.

Returns:

setClient

public Proxy setClient(Client client)

Sets the client that should be used for sending messages to the peer object.

Parameters:

client -

Returns:

getPeer

public com.sun.jna.Pointer getPeer()

Returns the Pointer to the native peer object.

Specified by:

getPeer in interface Peerable

Returns:

setPeer

public void setPeer(com.sun.jna.Pointer peer)

Sets the pointer to the native peer object.

Specified by:

setPeer in interface Peerable

Parameters:

peer -

toString

public java.lang.String toString()

Outputs the object as a string. This is a wrapper around the "description" method of NSObject.

Overrides:

toString in class java.lang.Object

Returns:

equals

public boolean equals(java.lang.Object o)

Compares this object to another Peerable object. This effectively says that the objects are equal if their peer objects are equal.

Overrides:

equals in class java.lang.Object

Parameters:

o -

Returns:

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

set

public void set(java.lang.String key,
       java.lang.Object value)

Wrapper for Key-Value coding. I.e. a wrapper for the setValue:forKey: message of NSObject.

Parameters:

key -

value -

get

public java.lang.Object get(java.lang.String key)

Wrapper for key-value coding. I.e a wrapper for the valueForKey: method of NSObject.

Parameters:

key -

Returns:

getInt

public int getInt(java.lang.String key)

Returns the KVC coded value for the specified key as an int.

Parameters:

key -

Returns:

getBoolean

public boolean getBoolean(java.lang.String key)

Returns the KVC coded value for the specified key as a boolean.

Parameters:

key -

Returns:

getProxy

public Proxy getProxy(java.lang.String key)

Returns the KVC coded value for the specified key as a Proxy.

Parameters:

key -

Returns:

getDouble

public double getDouble(java.lang.String key)

Returns the KVC coded value for the specified key as a double.

Parameters:

key -

Returns:

getPointer

public com.sun.jna.Pointer getPointer(java.lang.String key)

Returns the KVC coded value for the specified key as a Pointer.

Parameters:

key -

Returns: