Risultati query

Una serie di risultati query contiene i risultati di una query.

Gli elementi della serie di risultati sono oggetti che il chiamante è autorizzato a visualizzare. Gli elementi possono essere letti in modo relativo mediante il metodo next o in modo assoluto mediante i metodi first e last. Poiché il cursore implicito di una serie di risultati query viene posizionato inizialmente davanti al primo elemento, è necessario richiamare il metodo first o next prima di leggere un elemento. È possibile utilizzare il metodo size per stabilire il numero di elementi nella serie.

Un elemento della serie di risultati query comprende gli attributi selezionati degli elementi di lavoro e i relativi oggetti di riferimento associati, come ad esempio le istanze attività e le istanze del processo. Il primo attributo (colonna) di un elemento QueryResultSet indica il valore del primo attributo specificato nella clausola select della richiesta di query. Il secondo attributo (colonna) di un elemento QueryResultSet indica il valore del secondo attributo specificato nella clausola select della richiesta di query, e così via.

È possibile richiamare i valori degli attributi chiamando un metodo che sia compatibile con il tipo di attributo e specificando l'indice della colonna appropriata. La numerazione degli indici di colonna inizia da 1.

Tipo di attributo Metodo
String

getString

OID

getOID

Data/ora

getTimestamp
getString

Numero intero

getInteger
getShort
getLong
getString
getBoolean

Booleano

getBoolean
getShort
getInteger
getLong
getString

byte[] getBinary

Esempio:

Viene eseguita la seguente query:
QueryResultSet resultSet =
process.query("ACTIVITY.STARTED, 
                                          ACTIVITY.TEMPLATE_NAME AS NAME, 
                                          WORK_ITEM.WIID, WORK_ITEM.REASON",
                                          (String)null, (String)null, 
                                          (Integer)null, (TimeZone)null);

La serie di risultati query restituita ha quattro colonne:

È possibile utilizzare i seguenti metodi per richiamare i valori attributo:
while (resultSet.next())
{
	java.util.Calendar activityStarted = resultSet.getTimestamp(1);
	String templateName = resultSet.getString(2);
	WIID wiid = (WIID) resultSet.getOID(3);
	Integer reason = resultSet.getInteger(4);
}
È possibile utilizzare i nomi visualizzati della serie di risultati, ad esempio, come le intestazioni della tabella stampata. Questi nomi rappresentano i nomi colonna della vista o il nome definito dalla clausola AS nella query. È possibile utilizzare il seguente metodo per richiamare i nomi visualizzati nell'esempio:
resultSet.getColumnDisplayName(1) returns "STARTED"
resultSet.getColumnDisplayName(2) returns "NAME"
resultSet.getColumnDisplayName(3) returns "WIID"
resultSet.getColumnDisplayName(4) returns "REASON"

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)