org.apache.bsf.debug.util: abstract public class: StubTable

org.apache.bsf.debug.util
abstract public class: StubTable [javadoc | source]

java.lang.Object
   org.apache.bsf.debug.util.StubTable

Direct Known Subclasses:
ServerStubTable, ClientStubTable

This class provides the resident object table for the mirrors. A Stub represents a remote JavaScript object or any remote concept that needs to be identified such engines or contexts which are not JavaScript objects. A Stub has a unique identifier allocated on the server. This is called its oid, for object identifier. The oid is not only carrying the identity but also the type of the remote object. Knowing the type is essential when a Stub has to be created. For instance, it is important to know if a remote object is just an object or a reified code as a script or a function. The oid is a long, the high word is the type (tid), the low word is the unique identifier (uid). The unique identifier is globally unique across all types. This class also acts as the factory for Stub objects. When a Stub is created, it is remembered in the resident object table for later rebinding from its uid.

Field Summary
protected IntHashtable	m_stubs
protected SocketConnection	m_con

Constructor:
public StubTable(SocketConnection con) { m_con = con; m_stubs = new IntHashtable(); }

Method from org.apache.bsf.debug.util.StubTable Summary:
disconnectNotify, factory, swizzle

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.apache.bsf.debug.util.StubTable Detail:
public void disconnectNotify() { Enumeration e; Stub s; DebugLog.stdoutPrintln("Revoking stubs...", DebugLog.BSF_LOG_L3); e = m_stubs.elements(); while (e.hasMoreElements()) { s = (Stub)e.nextElement(); s.revoked(); } m_stubs = new IntHashtable(); }
abstract protected Stub factory(int tid, int uid)
public synchronized Stub swizzle(int tid, int uid) { Stub Stub=null; if (uid== DebugConstants.NOT_FOUND_UID) return Stub.NOT_FOUND; if (uid== DebugConstants.UNDEFINED_UID) return Stub.UNDEFINED; Stub = (Stub)m_stubs.get(uid); if (Stub==null) { Stub = factory(tid,uid); m_stubs.put(uid,Stub); } return Stub; }

Method from org.apache.bsf.debug.util.StubTable Detail:

 public  void disconnectNotify() {
		Enumeration e;
		Stub s;
		DebugLog.stdoutPrintln("Revoking stubs...", 
                                       DebugLog.BSF_LOG_L3);
		e = m_stubs.elements();
		while (e.hasMoreElements()) {
			s = (Stub)e.nextElement();
			s.revoked();
		}
		m_stubs = new IntHashtable();
}

 abstract protected Stub factory(int tid,
    int uid)

 public synchronized Stub swizzle(int tid,
    int uid) {
		Stub Stub=null;
		if (uid== DebugConstants.NOT_FOUND_UID) 
			return Stub.NOT_FOUND;
		if (uid== DebugConstants.UNDEFINED_UID)
			return Stub.UNDEFINED;
		Stub = (Stub)m_stubs.get(uid);	
		if (Stub==null) {
			Stub = factory(tid,uid);
			m_stubs.put(uid,Stub);
		}
		return Stub;
}