Выполнение команд с помощью Обработчика управления устройством

Материал из BiTel WiKi

Перейти к: навигация, поиск

В контекстном меню дерева устройств доступен пункт выполнить команду. Данный пункт вызывает метод у Обработчика управления устройством (DeviceManager), указанном в типе устройства. Таким методом, например, является uptime() из ru.bitel.bgbilling.modules.inet.dyn.device.snmp.SnmpDeviceManager, хотя нужен он не для ручного вызова из контекстного меню.

	@Override
	public Object uptime()
	        throws Exception
	{
		return snmpClient.get( uptimeOid, -1, Long.class );
	}

Команды-методы можно именовать с помощью аннотации ru.bitel.oss.systems.inventory.resource.server.DeviceManagerMethod, в этом случае они будут сразу доступны в контекстном меню:

import ru.bitel.oss.systems.inventory.resource.server.DeviceManagerMethod;

	@DeviceManagerMethod(title = "Перезагрузить")
	public Object reboot()
		throws Exception
	{
		return return snmpClient.set( new AsnObjectId( "1.2.3.4.5.6.7.8.9"  ).getOid(), -1, Long.class );
	}

После выполнения можно вернуть строку определенного вида, чтобы клиент биллинга попытался открыть браузер с указанным URL:

	@DeviceManagerMethod(title = "Статус")
	public Object status()
		throws Exception
	{
		return "browse:http://google.ru";
	}

Или telnet:

	@DeviceManagerMethod(title = "Telnet")
	public Object telnet()
		throws Exception
	{
		return "telnet:google.ru 80";
	}

Как аргумент в методе можно указать ru.bitel.bgbilling.modules.inet.access.manage.event.InetDeviceManageEvent, чтобы узнать, например, userId пользователя, выполняющего команду:

import ru.bitel.bgbilling.modules.inet.access.manage.event.InetDeviceManageEvent;

	@DeviceManagerMethod(title = "Telnet")
	public Object telnet2( InetDeviceManageEvent e )
		throws Exception
	{
		logger.info( e.getUserId() );
		return "telnet:google.ru 80";
	}

Пример:

package ru.provider.bgbilling.modules.inet.dyn.device;
 
import ru.bitel.bgbilling.server.util.Setup;
import ru.bitel.common.ParameterMap;
import ru.bitel.oss.systems.inventory.resource.common.DeviceManagerMethodType;
import ru.bitel.oss.systems.inventory.resource.common.bean.Device;
import ru.bitel.oss.systems.inventory.resource.common.bean.DeviceType;
import ru.bitel.oss.systems.inventory.resource.server.DeviceManagerMethod;
 
public class SnmpDeviceManager
	extends ru.bitel.bgbilling.modules.inet.dyn.device.snmp.SnmpDeviceManager
{
	protected ParameterMap deviceConfig;
 
	@Override
	public Object init( Setup setup, int moduleId, Device<?, ?> device, DeviceType deviceType, ParameterMap deviceConfig )
	{
		super.init( setup, moduleId, device, deviceType, deviceConfig );
 
		this.deviceConfig = deviceConfig;
 
		return null;
	}
 
	@DeviceManagerMethod(title = "Монитор", types = { DeviceManagerMethodType.DEVICE, DeviceManagerMethodType.ACCOUNT })
	public Object monitor()
	{
		return "browse:" + deviceConfig.get( "monitor.url", "http://zabbix.intranet.provider.ru/latest.php?hostid=$monitorHostId" ).replaceAll( "\\$monitorHostId", deviceConfig.get( "monitor.hostId", "" ) );
	}
 
	@DeviceManagerMethod(title = "Telnet")
	public Object telnet()
	{
		return "telnet:" + deviceConfig.get( "telnet.host", this.host ) + " " + deviceConfig.getInt( "telnet.port", 23 );
	}
}

Без SNMP/uptime:

package ru.provider.bgbilling.modules.inet.dyn.device;
 
import java.util.List;
 
import ru.bitel.bgbilling.server.util.Setup;
import ru.bitel.common.ParameterMap;
import ru.bitel.oss.systems.inventory.resource.common.DeviceManagerMethodType;
import ru.bitel.oss.systems.inventory.resource.common.bean.Device;
import ru.bitel.oss.systems.inventory.resource.common.bean.DeviceType;
import ru.bitel.oss.systems.inventory.resource.server.DeviceManagerAdapter;
import ru.bitel.oss.systems.inventory.resource.server.DeviceManagerMethod;
 
public class DeviceManager
	extends DeviceManagerAdapter
	implements ru.bitel.oss.systems.inventory.resource.server.DeviceManager
{
	protected ParameterMap deviceConfig;
 
	protected String host;
 
	@Override
	public Object init( Setup setup, int moduleId, Device<?, ?> device, DeviceType deviceType, ParameterMap deviceConfig )
		throws Exception
	{
		super.init( setup, moduleId, device, deviceType, deviceConfig );
 
		this.deviceConfig = deviceConfig;
 
		final List<String[]> hosts = device.getHostsAsString();
		final String[] host = (hosts != null && hosts.size() > 0) ? hosts.get( 0 ) : null;
 
		this.host = deviceConfig.get( "snmp.host", host != null ? host[0] : device.getHost() );
 
		return null;
	}
 
	@DeviceManagerMethod(title = "Монитор", types = { DeviceManagerMethodType.DEVICE, DeviceManagerMethodType.ACCOUNT })
	public Object monitor()
	{
		return "browse:" + deviceConfig.get( "monitor.url", "http://zabbix.intranet.provider.ru/latest.php?hostid=$monitorHostId" ).replaceAll( "\\$monitorHostId", deviceConfig.get( "monitor.hostId", "" ) );
	}
 
	@DeviceManagerMethod(title = "Telnet")
	public Object telnet()
	{
		return "telnet:" + deviceConfig.get( "telnet.host", this.host ) + " " + deviceConfig.getInt( "telnet.port", 23 );
	}
}

DeviceManagerMethodType.ACCOUNT - означает, что пункт будет доступен на вкладке сервисов договора, в контестном меню сервиса, если в нем установлено устройство этого типа.

Личные инструменты