true
if the device supports all protocols required for the implementation, otherwise false
.
*/
boolean isDeviceSupported(String connection);
/**
* @param connection for creation a {@link AbstractGraphicsDevice} instance.
* @return A new shared resource instance
*/
Resource createSharedResource(String connection);
void releaseSharedResource(Resource shared);
void clear();
Resource mapPut(String connection, Resource resource);
Resource mapGet(String connection);
Collection* Validate the thread upfront and release all related resource if it was killed. *
* * @return the shared resource runner thread. */ public Thread start() { if(null != thread && !thread.isAlive()) { // thread was killed unrecognized .. if (DEBUG) { System.err.println("SharedResourceRunner.start() - dead-old-thread cleanup - "+getThreadName()); } releaseSharedResources(); thread = null; } if(null == thread) { if (DEBUG) { System.err.println("SharedResourceRunner.start() - start new Thread - "+getThreadName()); } resetState(); thread = new Thread(this, getThreadName()+"-SharedResourceRunner"); thread.setDaemon(true); // Allow JVM to exit, even if this one is running thread.start(); } return thread; } public void stop() { if(null != thread) { if (DEBUG) { System.err.println("SharedResourceRunner.stop() - "+getThreadName()); } synchronized (this) { shouldRelease = true; this.notifyAll(); while (!released) { try { this.wait(); } catch (InterruptedException ex) { } } } } } public SharedResourceRunner.Resource getOrCreateShared(AbstractGraphicsDevice device) { SharedResourceRunner.Resource sr = null; if(null != device) { start(); final String connection = device.getConnection(); sr = impl.mapGet(connection); if (null == sr && !getDeviceTried(connection)) { addDeviceTried(connection); if (DEBUG) { System.err.println("SharedResourceRunner.getOrCreateShared() " + connection + ": trying - "+getThreadName()); } if ( impl.isDeviceSupported(connection) ) { doAndWait(connection, null); sr = impl.mapGet(connection); } if (DEBUG) { System.err.println("SharedResourceRunner.getOrCreateShared() " + connection + ": "+ ( ( null != sr ) ? "success" : "failed" ) +" - "+getThreadName()); } } } return sr; } public SharedResourceRunner.Resource releaseShared(AbstractGraphicsDevice device) { SharedResourceRunner.Resource sr = null; if(null != device) { String connection = device.getConnection(); sr = impl.mapGet(connection); if (null != sr) { removeDeviceTried(connection); if (DEBUG) { System.err.println("SharedResourceRunner.releaseShared() " + connection + ": trying - "+getThreadName()); } doAndWait(null, connection); if (DEBUG) { System.err.println("SharedResourceRunner.releaseShared() " + connection + ": done - "+getThreadName()); } } } return sr; } private final void doAndWait(String initConnection, String releaseConnection) { // wait until thread becomes ready to init new device, // pass the device and release the sync final String threadName = getThreadName(); if (DEBUG) { System.err.println("SharedResourceRunner.doAndWait() START init: " + initConnection + ", release: "+releaseConnection+" - "+threadName); } synchronized (this) { while (!ready) { try { this.wait(); } catch (InterruptedException ex) { } } if (DEBUG) { System.err.println("SharedResourceRunner.doAndWait() set command: " + initConnection + ", release: "+releaseConnection+" - "+threadName); } this.initConnection = initConnection; this.releaseConnection = releaseConnection; this.notifyAll(); // wait until thread has init/released the device while (!ready || null != this.initConnection || null != this.releaseConnection) { try { this.wait(); } catch (InterruptedException ex) { } } if (DEBUG) { System.err.println("SharedResourceRunner.initializeAndWait END init: " + initConnection + ", release: "+releaseConnection+" - "+threadName); } } // done } public final void run() { final String threadName = getThreadName(); if (DEBUG) { System.err.println("SharedResourceRunner.run(): STARTED - " + threadName); } synchronized (this) { while (!shouldRelease) { try { // wait for stop or init ready = true; if (DEBUG) { System.err.println("SharedResourceRunner.run(): READY - " + threadName); } notifyAll(); this.wait(); } catch (InterruptedException ex) { shouldRelease = true; if(DEBUG) { System.err.println("SharedResourceRunner.run(): INTERRUPTED - "+threadName); ex.printStackTrace(); } } ready = false; if (!shouldRelease) { if (DEBUG) { System.err.println("SharedResourceRunner.run(): WOKE UP for device connection init: " + initConnection + ", release: " + releaseConnection + " - " + threadName); } if(null != initConnection) { if (DEBUG) { System.err.println("SharedResourceRunner.run(): create Shared for: " + initConnection + " - " + threadName); } Resource sr = null; try { sr = impl.createSharedResource(initConnection); } catch (Exception e) { e.printStackTrace(); } if (null != sr) { impl.mapPut(initConnection, sr); } } if(null != releaseConnection) { if (DEBUG) { System.err.println("SharedResourceRunner.run(): release Shared for: " + releaseConnection + " - " + threadName); } Resource sr = impl.mapGet(releaseConnection); if (null != sr) { try { impl.releaseSharedResource(sr); impl.mapPut(releaseConnection, null); } catch (Exception e) { e.printStackTrace(); } } } } initConnection = null; releaseConnection = null; } if (DEBUG) { System.err.println("SharedResourceRunner.run(): RELEASE START - " + threadName); } releaseSharedResources(); if (DEBUG) { System.err.println("SharedResourceRunner.run(): RELEASE END - " + threadName); } shouldRelease = false; released = true; thread = null; notifyAll(); } } private void releaseSharedResources() { synchronized (devicesTried) { devicesTried.clear(); } Collection