Documentation Comments
Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.
Reality V15.2 Online Documentation (MoTW) Revision 3
Reality Interface Classes: Class RealWeb (JReal) (realweb.html)
|
Reality Interface Classes | ||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||
java.lang.Object
|
+--java.util.Observable
|
+--com.northgateis.reality.rsc.RSCConnection
|
+--com.northgateis.realweb.RealWeb
This class is used by a servlet to cache RSC connections to Reality databases.
Connections can be cached in one of two ways. Pooled connections are usually short lived. These are added to a pool when finnished with and are then available for any browser to use.
Persistent connections usually have a longer life. A browser can access a persistent connection repeatedly from a sequence of web pages. This enables the server to maintain context information about the sequence; for example, item locks, transactions and DataBasic common variables.
In addition persistent connections may be secure. ie a user must logon with a userID, password and optionally account and password before he can access the database.
Connections are destroyed when they time out. The DataBasic subroutine may modify the timeout via an API call. When a persistant server has finished a task it can set the timeout to zero to force disconnection.
To get a RealWeb connection to a database use:
connection = RealWeb.getConnection(req, res);
This will either return a current connection, or create a new one.
| Field Summary | |
static char
|
AM
|
static java.lang.String
|
NL
|
static char
|
VM
|
| Method Summary | |
static java.lang.String | AMtoNL(java.lang.String s)Convert all attribute marks in the given string to HTML break tags |
static boolean | debugOn()Return true if RealWeb debugging enabled |
static RealWeb | getConnection(javax.servlet.http.HttpServletRequest req,
javax.servlet.http.HttpServletResponse res)Get a RealWeb connection (current or new ) |
static RealWeb | getConnection(javax.servlet.http.HttpServletRequest req,
javax.servlet.http.HttpServletResponse res,
RealWebUrl URL)Get a RealWeb connection (current or new ) |
static RealWeb | getConnection(javax.servlet.http.HttpServletRequest req,
javax.servlet.http.HttpServletResponse res,
java.lang.String section)Get a RealWeb connection (current or new ) |
static void | init()Start a thread to timeout our connections |
void | run()Background thread used to timeout connections |
void | setAvailable()Clear the busy flag |
void | setTimeout(javax.servlet.http.HttpServletResponse res,
int tmo)Sets the connections timeout value (in seconds) and updates the connections end time |
java.lang.String | toString() |
| Methods inherited from class com.northgateis.reality.rsc.RSCConnection |
connect,
disconnect,
doItAll,
execute,
getParam,
prepare,
release,
releaseData,
releaseSubroutine,
sendParam,
setServer |
| Methods inherited from class java.util.Observable |
addObserver,
countObservers,
deleteObserver,
deleteObservers,
hasChanged,
notifyObservers,
notifyObservers |
| Methods inherited from class java.lang.Object |
equals,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
| Field Detail |
public static final char AM
public static final char VM
public static final java.lang.String NL
| Method Detail |
public static void init()
public void run()
public static RealWebgetConnection(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res) throws RealWebException, java.io.IOException
public static RealWebgetConnection(javax.servlet.http.HttpServletRequest req,
javax.servlet.http.HttpServletResponse res,
RealWebUrl URL)
throws RealWebException,
java.io.IOExceptionpublic static RealWebgetConnection(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, java.lang.String section) throws RealWebException, java.io.IOException
public void setTimeout(javax.servlet.http.HttpServletResponse res, int tmo)
public static java.lang.String AMtoNL(java.lang.String s)
public void setAvailable()
public java.lang.String toString()
public static boolean debugOn()
| Reality Interface Classes | ||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||