|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Thread
gr.uoa.di.madgik.grs.proxy.http.mirror.HTTPWriterMirror
public class HTTPWriterMirror
This implementation of the IMirror
interface specializes the
mirroring procedure that needs to be performed from the writer side of the
mirroring procedure. The technology employed is communication over HTTP connections.
The communication protocol is coupled with the one implemented by
the HTTPReaderMirror
which is the writer side counterpart of this
class
Nested Class Summary |
---|
Nested classes/interfaces inherited from class java.lang.Thread |
---|
java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler |
Nested classes/interfaces inherited from interface gr.uoa.di.madgik.grs.proxy.mirror.IMirror |
---|
IMirror.MirroringState |
Field Summary | |
---|---|
static int |
dataformat
|
Fields inherited from class java.lang.Thread |
---|
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY |
Constructor Summary | |
---|---|
HTTPWriterMirror()
|
Method Summary | |
---|---|
void |
dispose()
Dispose the resources employed by the mirroring implementations |
void |
dispose(boolean purge)
This method disposes the resources that are used by the instance but does so in two phases. |
IBuffer |
getBuffer()
Retrieves the IBuffer that is managed by the IMirror implementation. |
void |
handle(java.lang.String request,
java.net.Socket socket,
java.io.BufferedOutputStream out)
This invocation of this method starts a new execution thread where the mirroring procedure is executed. |
boolean |
pollPartial(long recordIndex,
int fieldIndex)
|
long |
requestPartial(long recordIndex,
int fieldIndex,
IBuffer.TransportOverride override,
java.lang.Object notify)
This method is used by the reader side mirror to request payload that belongs to an IBuffer
item that has been transfered only partially and more data is requested by the reader client |
void |
run()
|
void |
setKey(java.lang.String key)
Sets the local GRSRegistry key associated with the
IBuffer that needs to be mirrored |
Methods inherited from class java.lang.Thread |
---|
activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int dataformat
Constructor Detail |
---|
public HTTPWriterMirror()
Method Detail |
---|
public void setKey(java.lang.String key)
GRSRegistry
key associated with the
IBuffer
that needs to be mirrored
key
- the key associated with the served IBuffer
public IBuffer getBuffer()
IBuffer
that is managed by the IMirror
implementation. Depending
on the mirror side, this instance is either the one the writer is authoring, or the one the reader
is accessing.
getBuffer
in interface IMirror
IBuffer
that is managed by the IMirror
implementationIMirror.getBuffer()
public void handle(java.lang.String request, java.net.Socket socket, java.io.BufferedOutputStream out) throws GRS2ProxyMirrorInvalidOperationException
HTTPWriterMirror.run
GRS2ProxyMirrorInvalidOperationException
- if the mirroring state does not allow the operation to be
executedpublic void dispose()
This method actually invokes the respective
dispose(boolean)
with an argument of false. This
is because the actual disposing needs to take place when the mirroring
thread is prepared to gracefully exit its execution
dispose
in interface IMirror
IMirror.dispose()
public void dispose(boolean purge)
false
which puts the mirroring thread in a state where the
needed actions are taken to gracefully exit this part of the protocol but
also notify the respective HTTPReaderMirror
to stop the mirroring
procedure gracefully. When the method in again invoked with a
true
argument from the protocol implementing thread, all
resources are disposed.
purge
- whether the resources need to be immediately disposed, or this
need to wait until the protocol thread is ready to purge the
involved resourcespublic boolean pollPartial(long recordIndex, int fieldIndex) throws GRS2ProxyMirrorInvalidOperationException
This method is not supported in the HTTPWriterMirror
pollPartial
in interface IMirror
recordIndex
- The record index / id, for which the requester has requested data to be deliveredfieldIndex
- The field index of the specific record for which data are requested
GRS2ProxyMirrorInvalidOperationException
- if the method is invokedIMirror.pollPartial(long, int)
public long requestPartial(long recordIndex, int fieldIndex, IBuffer.TransportOverride override, java.lang.Object notify) throws GRS2ProxyMirrorInvalidOperationException
IBuffer
item that has been transfered only partially and more data is requested by the reader client
This method is not supported in the HTTPWriterMirror
requestPartial
in interface IMirror
recordIndex
- The index of the record whose payload is requested. As described in Record
, this index coincides with the record id.fieldIndex
- The index of the field belonging to the defined record for which additional data is requestedoverride
- whether or not the field's IBuffer.TransportDirective
should be overridden as explained in IBuffer
notify
- A synchronization object that can be used for the requester to block on until the required data is provided
IMirror.pollPartial(long, int)
should be used
GRS2ProxyMirrorInvalidOperationException
- if the method is invokedIMirror.requestPartial(long, int,
gr.uoa.di.madgik.grs.buffer.IBuffer.TransportOverride,
java.lang.Object)
public void run()
run
in interface java.lang.Runnable
run
in class java.lang.Thread
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |