SMom.ObjectOriented
Class CProcedure

java.lang.Object
  |
  +--SMom.ObjectOriented.CProcedure

public class CProcedure

extends java.lang.Object

Oggetto Funzione utile per incapsulare chiamate a procedura remote.

Creare la procedura o funzione aggiungendo parametri e impostando il nome. In fase di costruzione viene automaticamente impostato un InstanceID di default (che si consiglia di non modificare).

Version:

0.1 - Settembre 2004

Author:

Giorgio Bernardi.
E-Mail: Giorgio.Bernardi@studio.unibo.it

Field Summary

protected static java.lang.String

CharDelimiter Carattere delimitatore utilizzato

Constructor Summary

CProcedure()
Costruisce una nuova procedura vuota

CProcedure(CEnvelope Env)
Costruisce una nuova procedura indicando già il nome

CProcedure(java.lang.String Name)
Costruisce una nuova procedura indicando già il nome

Method Summary

void	AddParam(CValue newParam) Permette di aggiungere un parametro alla procedura
protected boolean	fromEnvelope(CEnvelope Env) Tenta di ricostruire la procedura dalla sua rappresentazione in forma di stringa contenuta nella busta.
java.lang.String	getInstanceID() Accesso alla proprietà InstanceID dell'istanza
java.lang.String	getName() Accesso alla proprietà Name dell'istanza
CValue	GetParam(int Index) Permette di recuperare il parametro all'indice indicato della procedura Restituisce null se all'indice non corrisponde alcun parametro
java.lang.Object[]	GetParams() Restituisce un array degli oggetti parametri della procedura.
java.lang.Class[]	GetParamsClass() Restituisce un array di oggetti di tipo Class in Java avendo in ingresso una procedura.
int	GetParamsCount() Indica il numero di parametri attualmente memorizzati per la procedura
CFunctionResult	getResponseMessage(boolean IsValid, CValue ResultValue) Restituisce un oggetto CFunctionResult pronto per essere restituito al mittente E' necessario indicare se il risultato è valido e l'eventuale risultato della funzione
protected static CValue	parseFromString(java.lang.String params) Esegue il parsing di un valore da una stringa
protected void	setInstanceID(java.lang.String newValue) Accesso alla proprietà InstanceID dell'istanza
void	setName(java.lang.String newValue) Accesso alla proprietà Name dell'istanza
CEnvelope	toEnvelope(ISender Sender, java.lang.String ReceiverObjID) Rappresentazione della procedura per essere inviata.
java.lang.String	toString() Rappresentazione semplice in forma di stringa della procedura

Methods inherited from class java.lang.Object

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

Field Detail

CharDelimiter

protected static java.lang.String CharDelimiter

Carattere delimitatore utilizzato

Constructor Detail

CProcedure

public CProcedure()

Costruisce una nuova procedura vuota

CProcedure

public CProcedure(java.lang.String Name)

Costruisce una nuova procedura indicando già il nome

CProcedure

public CProcedure(CEnvelope Env)
           throws CCannotConvertEnvelopeToCProcedureException

Costruisce una nuova procedura indicando già il nome

Method Detail

AddParam

public void AddParam(CValue newParam)

Permette di aggiungere un parametro alla procedura

GetParam

public CValue GetParam(int Index)

Permette di recuperare il parametro all'indice indicato della procedura Restituisce null se all'indice non corrisponde alcun parametro

GetParamsCount

public int GetParamsCount()

Indica il numero di parametri attualmente memorizzati per la procedura

GetParamsClass

public java.lang.Class[] GetParamsClass()

Restituisce un array di oggetti di tipo Class in Java avendo in ingresso una procedura. Se la procedura non ha argomenti restituisce null.

GetParams

public java.lang.Object[] GetParams()

Restituisce un array degli oggetti parametri della procedura. Se la procedura non ha argomenti restituisce null.

setName

public void setName(java.lang.String newValue)

Accesso alla proprietà Name dell'istanza

getName

public java.lang.String getName()

Accesso alla proprietà Name dell'istanza

getInstanceID

public java.lang.String getInstanceID()

Accesso alla proprietà InstanceID dell'istanza

setInstanceID

protected void setInstanceID(java.lang.String newValue)

Accesso alla proprietà InstanceID dell'istanza

toString

public java.lang.String toString()

Rappresentazione semplice in forma di stringa della procedura

Overrides:

toString in class java.lang.Object

toEnvelope

public CEnvelope toEnvelope(ISender Sender,
                            java.lang.String ReceiverObjID)

Rappresentazione della procedura per essere inviata. Il messaggio ha la seguente rappresentazione []

fromEnvelope

protected boolean fromEnvelope(CEnvelope Env)

Tenta di ricostruire la procedura dalla sua rappresentazione in forma di stringa contenuta nella busta. Restituisce False in caso di errore nella costruzione.

parseFromString

protected static CValue parseFromString(java.lang.String params)

Esegue il parsing di un valore da una stringa

getResponseMessage

public CFunctionResult getResponseMessage(boolean IsValid,
                                          CValue ResultValue)

Restituisce un oggetto CFunctionResult pronto per essere restituito al mittente E' necessario indicare se il risultato è valido e l'eventuale risultato della funzione