csbase.logic

Class Platform

java.lang.Object

csbase.logic.Platform

All Implemented Interfaces:

Serializable

public class Platform
extends Object
implements Serializable

A classe Platform representa uma Plataforma de Execução. A classe Platform mantém uma cache dos objetos Platform instanciados localmente.

Version:

$Revision$

Author:

$Author$

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Platform(Object id, PlatformInfo info) Constrói uma Platforma de Execução.

Method Summary

Modifier and Type	Method and Description
static void	addObserver(Observer obs) Adiciona um observador local da classe.
static Platform	createPlatform(PlatformInfo info) Criação de uma nova plataforma.
static void	deleteObserver(Observer obs) Remove um observador local da classe Platform.
static void	deletePlatform(Object id) Remoção de uma plataforma.
boolean	equalContents(Object obj)
boolean	equals(Object obj) Verifica se duas plataformas são iguais.
static List<Platform>	getAllPlatforms() Obtem todas as plataformas cadastradas.
static List<Platform>	getAllPlatforms(boolean sortByName) Obtem todas as plataformas cadastradas
static Comparator	getDescrComparator() Obtém um comparator de Platform pelo critério de ordem alfabética da descrição da plataforma
String	getDescription() Obtém a descrição da plataforma
static Getter	getDescriptionGetter() Obtém um getter para a descrição de Platform.
Object	getId() Obtém o identificador da plataforma
static Getter	getIdGetter() Obtém um getter para o identificador de Platform.
String	getName() Obtém o nome da plataforma
static Comparator<Platform>	getNameComparator() Obtém um comparator de Platform pelo critério de ordem alfabética do nome da plataforma
static Getter	getNameGetter() Obtém um getter para o nome de Platform.
static Platform	getPlatform(Object id) Obtem a plataforma que possui o identificador especificado.
static Platform	getPlatformByName(String name) Obtem a plataforma que possui o nome especificado.
PlatformInfo	getPlatformInfo() Obtém uma cópia do PlatformInfo desta plataforma.
int	hashCode() Calcula o código hash do objeto.
static Platform	modifyPlatform(Object id, PlatformInfo info) Modificação de uma plataforma.
static void	update(AdministrationEvent event) Esse método é chamado quando um serviço de administração sofre alguma alteração relativa a plataformas.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Platform

public Platform(Object id,
                PlatformInfo info)

Constrói uma Platforma de Execução. Somente o servidor pode construir um objeto Platform, pois é quem é capaz de gerar identificadores.

Parameters:

id - identificador da plataforma

info - informações da plataforma

Method Detail

equals

public boolean equals(Object obj)

Verifica se duas plataformas são iguais. Uma plataforma é igual a outra se ambas possuem o mesmo identificador.

Overrides:

equals in class Object

Parameters:

obj - plataforma com a qual a comparação deve ser realizada

Returns:

.

hashCode

public int hashCode()

Calcula o código hash do objeto.

Overrides:

hashCode in class Object

Returns:

Inteiro que representa o código hash do objeto.

equalContents

public boolean equalContents(Object obj)

getPlatform

public static Platform getPlatform(Object id)
                            throws RemoteException

Obtem a plataforma que possui o identificador especificado.

Parameters:

id - identificador da plataforma

Returns:

plataforma que possui o identificador ou null caso essa plataforma não exista

Throws:

RemoteException - falha de rmi

getPlatformByName

public static Platform getPlatformByName(String name)
                                  throws Exception

Obtem a plataforma que possui o nome especificado.

Parameters:

name - nome da plataforma procurada

Returns:

plataforma que possui o nome procurado ou null caso essa plataforma não exista

Throws:

Exception - .

getAllPlatforms

public static List<Platform> getAllPlatforms()
                                      throws Exception

Obtem todas as plataformas cadastradas.

Returns:

vetor com as plataformas

Throws:

Exception - .

getAllPlatforms

public static List<Platform> getAllPlatforms(boolean sortByName)
                                      throws Exception

Obtem todas as plataformas cadastradas

Parameters:

sortByName - true se as plataformas deverão estar ordenadas alfabeticamente pelo nome e false se a ordenação não é necessária

Returns:

vetor com as plataformas

Throws:

Exception - .

createPlatform

public static Platform createPlatform(PlatformInfo info)
                               throws Exception

Criação de uma nova plataforma. A plataforma criada é inserida na cache local.

Parameters:

info - as informações da nova plataforma

Returns:

plataforma criada ou null caso já exista uma plataforma com o mesmo nome

Throws:

Exception - .

modifyPlatform

public static Platform modifyPlatform(Object id,
                                      PlatformInfo info)
                               throws Exception

Modificação de uma plataforma. Não é permitido alterar o nome da plataforma, pois o mesmo é usado na configuração dos SGAs e no Repositório de Algoritmos.

Parameters:

id - identificador da platforma a ser modificada

info - novas informações da plataforma

Returns:

plataforma modificada ou null se a modificação não pode ser realizada (modificação de nome) ou se não existe plataforma com o identificador especificado

Throws:

Exception - .

deletePlatform

public static void deletePlatform(Object id)
                           throws Exception

Remoção de uma plataforma.

Parameters:

id - identificador da plataforma a ser removida

Throws:

Exception - .

getId

public Object getId()

Obtém o identificador da plataforma

Returns:

identificador da plataforma

getName

public String getName()

Obtém o nome da plataforma

Returns:

nome da plataforma

getDescription

public String getDescription()

Obtém a descrição da plataforma

Returns:

descrição da plataforma

getPlatformInfo

public PlatformInfo getPlatformInfo()

Obtém uma cópia do PlatformInfo desta plataforma.

Returns:

a cópia do PlatformInfo

getNameComparator

public static Comparator<Platform> getNameComparator()

Obtém um comparator de Platform pelo critério de ordem alfabética do nome da plataforma

Returns:

comparador por nome

getDescrComparator

public static Comparator getDescrComparator()

Obtém um comparator de Platform pelo critério de ordem alfabética da descrição da plataforma

Returns:

comparador por descrição

getNameGetter

public static Getter getNameGetter()

Obtém um getter para o nome de Platform.

Returns:

getter para o nome

getIdGetter

public static Getter getIdGetter()

Obtém um getter para o identificador de Platform.

Returns:

getter para o identificador

getDescriptionGetter

public static Getter getDescriptionGetter()

Obtém um getter para a descrição de Platform.

Returns:

getter para o descrição

addObserver

public static void addObserver(Observer obs)

Adiciona um observador local da classe. Sempre que a classe é avisada pelo serviço de administração de que alguma mudança ocorreu, os observadores locais também são notificados.

Parameters:

obs - um observador local

deleteObserver

public static void deleteObserver(Observer obs)

Remove um observador local da classe Platform.

Parameters:

obs - o observador a ser removido

update

public static void update(AdministrationEvent event)

Esse método é chamado quando um serviço de administração sofre alguma alteração relativa a plataformas. Atualiza o cache de plataformas e notifica seus observadores locais.

Parameters:

event - a ação que ocorreu no serviço de administração