Class CocoaJavaBridge

java.lang.Object

com.biglybt.platform.macosx.NativeInvocationBridge

com.biglybt.platform.macosx.access.cocoa.CocoaJavaBridge

public final class CocoaJavaBridge
extends NativeInvocationBridge

NOTE: This is only used for OSX 10.4 and non-up-to-date 10.5,10.6. OSX 10.5 Update 6 and OSX 10.6 Update 1 provides revealInFinder and moveToTrash functionality.

Performs PlatformManager tasks using Cocoa-Java (FoundationKit only)

For now, operations are performed using NSAppleScript, rather than using NSWorkspace. This is still significantly faster than calling the cmd-line osascript.

Version:

2.1 Apr 2, 2005

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	CocoaJavaBridge.RunnableDispatcher	A dispatch object to help facilitate asychronous script execution (from the main thread) in a more predictable fashion.

Field Summary

Fields

Modifier and Type	Field	Description
private Class	claNSAppleEventDescriptor
private Class<?>	claNSAppleScript
private Class<?>	claNSAutoreleasePool
private Class<?>	claNSMutableDictionary
protected static final String	CLASS_PATH	The path the Cocoa-Java class files are located at
protected AEMonitor	classMon
private static final String	DEL_SCRIPT_FORMAT
protected boolean	isDisposed
private int	mainPool	Main NSAutoreleasePool
private Method	methNSAppleEventDescriptor_descriptorWithBoolean
private Method	methNSAppleScript_execute
private Method	methNSMutableDictionary_objectForKey
private Method	methPop
private Method	methPush
private String	NSAppleScript_AppleScriptErrorMessage
private static final String	REVEAL_SCRIPT_FORMAT
protected CocoaJavaBridge.RunnableDispatcher	scriptDispatcher
private AEMonitor	scriptMon

Constructor Summary

Constructors

Constructor	Description
CocoaJavaBridge()

Method Summary

Modifier and Type	Method	Description
protected void	dispose()	Disposes system resources
protected final Object	executeScript(String scriptFormat, Object[] params)	Executes a new instance of NSAppleScript
protected final Object	executeScriptWithAsync(String scriptFormat, Object[] params)	Asynchronously executes a new instance of NSAppleScript
protected final Object	executeScriptWithNewThread(String scriptFormat, Object[] params)	Executes a new instance of NSAppleScript in a forked AEThread
protected void	finalize()
protected boolean	isEnabled()	Gets whether the invocation bridge is available for use
private void	logWarning(String message)	Logs a warning message to Logger.
private Object	new_NSAppleScript(String s)
private Object	new_NSMutableDictionary()
private Object	NSAppleScript_execute(Object NSAppleScript, Object NSMutableDictionary)
private void	NSAutoreleasePool_pop(int i)
private int	NSAutoreleasePool_push()
private Object	NSMutableDictionary_objectForKey(Object NSMutableDictionary, String s)
protected boolean	performRecoverableFileDelete(File path)
protected boolean	showInFinder(File path, String fileBrowserApp)

Methods inherited from class NativeInvocationBridge

hasSharedInstance, sharedInstance

Methods inherited from class Object

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

Field Details

CLASS_PATH

protected static final String CLASS_PATH

The path the Cocoa-Java class files are located at

See Also:

• Constant Field Values

REVEAL_SCRIPT_FORMAT

private static final String REVEAL_SCRIPT_FORMAT

See Also:

• Constant Field Values

DEL_SCRIPT_FORMAT

private static final String DEL_SCRIPT_FORMAT

See Also:

• Constant Field Values

mainPool

private int mainPool

Main NSAutoreleasePool

classMon

protected AEMonitor classMon

scriptMon

private AEMonitor scriptMon

isDisposed

protected boolean isDisposed

scriptDispatcher

protected CocoaJavaBridge.RunnableDispatcher scriptDispatcher

claNSAppleEventDescriptor

private Class claNSAppleEventDescriptor

claNSAutoreleasePool

private Class<?> claNSAutoreleasePool

methPush

private Method methPush

methPop

private Method methPop

methNSAppleEventDescriptor_descriptorWithBoolean

private Method methNSAppleEventDescriptor_descriptorWithBoolean

claNSAppleScript

private Class<?> claNSAppleScript

claNSMutableDictionary

private Class<?> claNSMutableDictionary

methNSAppleScript_execute

private Method methNSAppleScript_execute

NSAppleScript_AppleScriptErrorMessage

private String NSAppleScript_AppleScriptErrorMessage

methNSMutableDictionary_objectForKey

private Method methNSMutableDictionary_objectForKey

Constructor Details

CocoaJavaBridge

public CocoaJavaBridge()
                throws Throwable

Throws:

Throwable

Method Details

NSAutoreleasePool_push

private int NSAutoreleasePool_push()
                            throws Throwable

Throws:

Throwable

NSAutoreleasePool_pop

private void NSAutoreleasePool_pop(int i)
                            throws Throwable

Throws:

Throwable

new_NSAppleScript

private Object new_NSAppleScript(String s)
                          throws Throwable

Throws:

Throwable

NSAppleScript_execute

private Object NSAppleScript_execute(Object NSAppleScript,
 Object NSMutableDictionary)
                              throws Throwable

Throws:

Throwable

new_NSMutableDictionary

private Object new_NSMutableDictionary()
                                throws Throwable

Throws:

Throwable

NSMutableDictionary_objectForKey

private Object NSMutableDictionary_objectForKey(Object NSMutableDictionary,
 String s)
                                         throws Throwable

Throws:

Throwable

performRecoverableFileDelete

protected boolean performRecoverableFileDelete(File path)

Overrides:

performRecoverableFileDelete in class NativeInvocationBridge

See Also:

• invalid reference

  PlatformManager#performRecoverableFileDelete(java.io.File)

showInFinder

protected boolean showInFinder(File path,
 String fileBrowserApp)

Overrides:

showInFinder in class NativeInvocationBridge

See Also:

• PlatformManagerImpl.showInFinder(java.io.File)

isEnabled

protected boolean isEnabled()

Gets whether the invocation bridge is available for use

This method is used to anticipate scenarios such as where the bridge will fail due to missing classpaths

Specified by:

isEnabled in class NativeInvocationBridge

executeScript

protected final Object executeScript(String scriptFormat,
 Object[] params)
                              throws Throwable

Executes a new instance of NSAppleScript

The method is wrapped in an autorelease pool and an AEMonitor. If there are no format parameters, MessageFormat is not used to parse the format string, and the format string will be treated as the source itself.

Throws:

Throwable

See Also:

• MessageFormat.format(String, Object...)
• invalid reference

  NSAppleScript#execute(com.apple.cocoa.foundation.NSMutableDictionary)

executeScriptWithNewThread

protected final Object executeScriptWithNewThread(String scriptFormat,
 Object[] params)
                                           throws IllegalArgumentException,
IllegalAccessException,
InvocationTargetException

Executes a new instance of NSAppleScript in a forked AEThread

This method always returns a "true" event descriptor. Callbacks are currently unsupported , so in the event of an error, the logger is autuomatically notified.

The thread's runSupport method is wrapped in an autorelease pool. If there are no format parameters, MessageFormat is not used to parse the format string, and the format string will be treated as the source itself.

Returns:

NSAppleEventDescriptor.descriptorWithBoolean(true)

Throws:

InvocationTargetException

IllegalAccessException

IllegalArgumentException

See Also:

• AEThread.runSupport()
• MessageFormat.format(String, Object...)
• invalid reference

  NSAppleScript#execute(com.apple.cocoa.foundation.NSMutableDictionary)

executeScriptWithAsync

protected final Object executeScriptWithAsync(String scriptFormat,
 Object[] params)
                                       throws IllegalArgumentException,
IllegalAccessException,
InvocationTargetException

Asynchronously executes a new instance of NSAppleScript

This method always returns a "true" event descriptor. Callbacks are currently unsupported , so in the event of an error, the logger is autuomatically notified.

The thread's runSupport method is wrapped in an autorelease pool. If there are no format parameters, MessageFormat is not used to parse the format string, and the format string will be treated as the source itself.

Returns:

NSAppleEventDescriptor.descriptorWithBoolean(true)

Throws:

InvocationTargetException

IllegalAccessException

IllegalArgumentException

See Also:

• AEThread.runSupport()
• MessageFormat.format(String, Object...)
• invalid reference

  NSAppleScript#execute(com.apple.cocoa.foundation.NSMutableDictionary)

logWarning

private void logWarning(String message)

Logs a warning message to Logger. The class monitor is used.

Parameters:

message - A warning message

dispose

protected void dispose()

Disposes system resources

Overrides:

dispose in class NativeInvocationBridge

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable