В примере рассмотрен процесс загрузки нескольких ресурсов с помощью API Java.
package com.ibm.ram.client.test;
import org.apache.log4j.Logger;
import com.ibm.ram.client.LocalFileArtifact;
import com.ibm.ram.client.RAMAsset;
import com.ibm.ram.client.RAMCategory;
import com.ibm.ram.client.RAMCategorySchema;
import com.ibm.ram.client.RAMFolderArtifact;
import com.ibm.ram.client.RAMSession;
import com.ibm.ram.client.RAMSubCategory;
import com.ibm.ram.client.status.RAMStatus;
import com.ibm.ram.client.status.RAMStatusMonitor;
import com.ibm.ram.common.data.Asset;
/**
* Пример программы загрузки ресурсов в пакетном режиме
*
*/
public class BatchUploadAssets {
private static String URL = "http://localhost:8080/ram.ws";
private static String USERID = "userid";
private static String PASS = "password";
//Вместо Logger можно указать другую функцию описания состояния
private static final Logger logger = Logger.getLogger(BatchUploadAssets.class.getName());
/**
* Метод Main, с которого начинается выполнение программы
* @param args
*/
public static void main(String[] args) {
RAMSession session = null;
try{
//Создание сеанса
session = new RAMSession(URL, USERID, PASS);
//Создание объектов RAMAsset для каждого локального ресурса
loadAssets(session);
//Загрузка ресурсов на сервер
RAMStatus finalStatus = session.putAssets(getStatusMonitor());
//Регистрация результата
reportStatusMessage(finalStatus.getSeverity(), finalStatus.getException(), finalStatus.getMessage());
}
catch (Exception e) {
logger.error("Unexpected Error : " + e.getLocalizedMessage(), e);
}
finally{
if(session != null){
session.release();
}
}
}
/**
* Настройте этот метод для чтения и локальных ресурсов
* и преобразуйте их в RAMAssets для загрузки в
* Rational Asset Manager
*/
private static void loadAssets(RAMSession session){
//Поиск локальных ресурсов в локальных данных
Asset[] localAssets = null;
//Для каждого локального ресурса создается RAMAsset, который
//заполняется локальными данными.
for(int i = 0; i < localAssets.length;i++){
//Создание ресурса - Лучше всего извлечь глобально уникальный ИД из локального ресурса,
//- это более эффективный способ получения. Или можно просто указать версию,
//и RAM создаст новый GUID.
RAMAsset newAsset = session.createAsset(localAssets[i].getGUID(), localAssets[i].getVersion());
//Для каждого ресурса необходимо указать Community, Type, Name и краткое описание.
newAsset.setCommunityName(localAssets[i].getCommunityName());
newAsset.setTypeName(localAssets[i].getTypeName());
newAsset.setName(localAssets[i].getName());
newAsset.setShortDescription(localAssets[i].getShortDescription());
//При необходимости можно указать полное описание
newAsset.setDescription(localAssets[i].getDescription());
//При необходимости можно указать артефакты
((RAMFolderArtifact)newAsset.getArtifactsRoot()).addArtifact("sample.txt", new LocalFileArtifact(localfile));
//При необходимости можно указать атрибуты
newAsset.getAssetAttribute("namespace").setValues(new String[]{"com.ibm.sampple"});
//При необходимости можно указать категории
RAMCategorySchema schema = session.getCategorySchema("Development");
RAMCategory category = (RAMCategory)schema.getCategory("Languages");
RAMSubCategory subCategory = (RAMSubCategory)category.getSubCategory("Java");
newAsset.categorize(subCategory);
//При необходимости можно указать отношения
newAsset.addRelatedAsset(someOtherAsset, session.getRelationshipType("Dependency"));
//И так далее ...
//После завершения добавьте ресурс в очередь сеанса для передачи в пакетном режиме.
//Если созданы взаимосвязи, укажите принудительный режим (True) во избежание конфликтов.
session.queueAssetForPut(newAsset, true);
}
}
/**
* В ходе загрузки ресурсов на сервер монитор состояния отображает состояние выполнения.
*/
private static RAMStatusMonitor getStatusMonitor(){
return new RAMStatusMonitor(){
@Override
public void appendStatus(Object targetObject, int severity, int code, String message, Throwable exception) {
super.appendStatus(targetObject, severity, code, message, exception);
reportStatusMessage(severity, exception, message);
}
};
}
/**
* Выдача сообщения о состоянии
* @param severity
* @param exception
* @param message
*/
private static void reportStatusMessage(int severity, Throwable exception, String message) {
if(severity == RAMStatus.OK || severity == RAMStatus.INFO){
logger.info(message);
}
else if(severity == RAMStatus.WARNING){
if(exception == null)logger.warn(message);
else logger.warn(message, exception);
}
else if(severity == RAMStatus.ERROR){
if(exception == null)logger.error(message);
else logger.error(message, exception);
}
}
}