org.onosproject.cli

Class AbstractShellCommand

java.lang.Object

org.onosproject.cli.AbstractShellCommand

All Implemented Interfaces:

org.apache.karaf.shell.api.action.Action, org.onosproject.codec.CodecContext

Direct Known Subclasses:

AddProtectedTransportIntentCommand, AddTestFlowsCommand, AllocationsCommand, AnnotateDeviceCommand, AnnotateHostCommand, AnnotateLinkCommand, AnnotatePortCommand, ApplicationCommand, ApplicationIdListCommand, ApplicationsListCommand, BalanceMastersCommand, ComponentConfigCommand, ConfigureLinkCommand, ConnectivityIntentCommand, CounterCommand, CountersListCommand, DeviceControllersCommand, DeviceInterfaceAddCommand, DeviceInterfaceRemoveCommand, DeviceKeyAddCommand, DeviceKeyListCommand, DeviceKeyRemoveCommand, DevicePortStateCommand, DevicePortStatsCommand, DeviceRebootCommand, DeviceRemoveCommand, DeviceRoleCommand, DeviceSetControllersCommand, DevicesListCommand, DeviceTimeCommand, DriverProvidersListCommand, DriversListCommand, EdgePortsListCommand, FlowObjectiveCompositionCommand, FlowObjectiveNextListCommand, FlowObjectivePendingNextCommand, FlowObjectiveQueueClearCommand, FlowObjectiveQueueListCommand, FlowsListCommand, GetDomainsCommand, GetFlowStatisticsCommand, GetStatisticsCommand, GroupsListCommand, HostRemoveCommand, HostsListCommand, IntentCycleCommand, IntentDetailsCommand, IntentListCompilers, IntentListInstallers, IntentPurgeCommand, IntentPushTestCommand, IntentRemoveCommand, IntentsDiagnosisCommand, IntentsListCommand, InterfaceAddCommand, InterfaceRemoveCommand, InterfacesListCommand, IssuCommand, LayoutAddCommand, LayoutListCommand, LeaderCommand, LinksListCommand, MapsListCommand, MarkCommand, MastersListCommand, McastDeleteCommand, McastJoinCommand, McastRoutesListCommand, McastShowCommand, MembershipsListCommand, MeterAddCommand, MeterRemoveCommand, MetersListCommand, MetricsListCommand, NeighbourHandlersListCommand, NetworkConfigCommand, NetworkConfigRegistryCommand, NodesListCommand, PacketProcessorsListCommand, PacketRequestsListCommand, PartitionsListCommand, PipeconfCommand, PortQueryVlansCommand, PrettyJson, PrettyXml, QueuesListCommand, RandomIntentCommand, RegionAddCommand, RegionAddDevicesCommand, RegionAddPeerLocCommand, RegionListCommand, RegionRemoveCommand, RegionRemoveDevicesCommand, RegionUpdateCommand, ResourcesCommand, ReviewCommand, RolesCommand, ScrListCommand, StorageNodesListCommand, SummaryCommand, TableStatisticsCommand, TestAllocateResource, TestProtectionEndpointIntentCommand, TopologyCommand, TransactionsCommand, WipeOutCommand

public abstract class AbstractShellCommand
extends Object
implements org.apache.karaf.shell.api.action.Action, org.onosproject.codec.CodecContext

Base abstraction of Karaf shell commands.

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
AbstractShellCommand()

Method Summary

Modifier and Type	Method and Description
static String	annotations(org.onosproject.net.Annotations annotations) Produces a string image of the specified key/value annotations.
static String	annotations(org.onosproject.net.Annotations annotations, Set<String> excludedKeys) Produces a string image of the specified key/value annotations.
static com.fasterxml.jackson.databind.node.ObjectNode	annotations(com.fasterxml.jackson.databind.ObjectMapper mapper, org.onosproject.net.Annotations annotations) Produces a JSON object from the specified key/value annotations.
protected org.onosproject.core.ApplicationId	appId() Returns application ID for the CLI.
<T> org.onosproject.codec.JsonCodec<T>	codec(Class<T> entityClass)
protected abstract void	doExecute() Body of the shell command.
void	error(String format, Object... args) Prints the arguments using the specified format to error stream.
Object	execute()
static <T> T	get(Class<T> serviceClass) Returns the reference to the implementation of the specified service.
<T> T	getService(Class<T> serviceClass)
<T> com.fasterxml.jackson.databind.node.ObjectNode	jsonForEntity(T entity, Class<T> entityClass) Generates a Json representation of an object.
com.fasterxml.jackson.databind.ObjectMapper	mapper()
protected boolean	outputJson() Indicates whether JSON format should be output.
void	print(String format, Object... args) Prints the arguments using the specified format.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.onosproject.codec.CodecContext

decode, encode

Field Detail

log

protected static final org.slf4j.Logger log

Constructor Detail

AbstractShellCommand

public AbstractShellCommand()

Method Detail

get

public static <T> T get(Class<T> serviceClass)

Returns the reference to the implementation of the specified service.

Type Parameters:

T - type of service

Parameters:

serviceClass - service class

Returns:

service implementation

Throws:

org.onlab.osgi.ServiceNotFoundException - if service is unavailable

appId

protected org.onosproject.core.ApplicationId appId()

Returns application ID for the CLI.

Returns:

command-line application identifier

print

public void print(String format,
                  Object... args)

Prints the arguments using the specified format.

Parameters:

format - format string; see String.format(java.lang.String, java.lang.Object...)

args - arguments

error

public void error(String format,
                  Object... args)

Prints the arguments using the specified format to error stream.

Parameters:

format - format string; see String.format(java.lang.String, java.lang.Object...)

args - arguments

annotations

public static String annotations(org.onosproject.net.Annotations annotations)

Produces a string image of the specified key/value annotations.

Parameters:

annotations - key/value annotations

Returns:

string image with ", k1=v1, k2=v2, ..." pairs

annotations

public static String annotations(org.onosproject.net.Annotations annotations,
                                 Set<String> excludedKeys)

Produces a string image of the specified key/value annotations. Excludes the keys in the given Set.

Parameters:

annotations - key/value annotations

excludedKeys - keys not to add in the resulting string

Returns:

string image with ", k1=v1, k2=v2, ..." pairs

annotations

public static com.fasterxml.jackson.databind.node.ObjectNode annotations(com.fasterxml.jackson.databind.ObjectMapper mapper,
                                                                         org.onosproject.net.Annotations annotations)

Produces a JSON object from the specified key/value annotations.

Parameters:

mapper - ObjectMapper to use while converting to JSON

annotations - key/value annotations

Returns:

JSON object

outputJson

protected boolean outputJson()

Indicates whether JSON format should be output.

Returns:

true if JSON is requested

execute

public final Object execute()
                     throws Exception

Specified by:

execute in interface org.apache.karaf.shell.api.action.Action

Throws:

Exception

doExecute

protected abstract void doExecute()
                           throws Exception

Body of the shell command.

Throws:

Exception - thrown when problem is encountered

mapper

public com.fasterxml.jackson.databind.ObjectMapper mapper()

Specified by:

mapper in interface org.onosproject.codec.CodecContext

codec

public <T> org.onosproject.codec.JsonCodec<T> codec(Class<T> entityClass)

Specified by:

codec in interface org.onosproject.codec.CodecContext

getService

public <T> T getService(Class<T> serviceClass)

Specified by:

getService in interface org.onosproject.codec.CodecContext

jsonForEntity

public <T> com.fasterxml.jackson.databind.node.ObjectNode jsonForEntity(T entity,
                                                                        Class<T> entityClass)

Generates a Json representation of an object.

Type Parameters:

T - Type of the object being formatted

Parameters:

entity - object to generate JSON for

entityClass - class to format with - this chooses which codec to use

Returns:

JSON object representation