org.onosproject.cli

Class AbstractShellCommand

java.lang.Object

org.apache.karaf.shell.console.AbstractAction

org.onosproject.cli.AbstractShellCommand

All Implemented Interfaces:

org.apache.felix.gogo.commands.Action, CodecContext

Direct Known Subclasses:

AddProtectedTransportIntentCommand, AddTestFlowsCommand, AddTunnelCommand, AllocationsCommand, AnnotateDeviceCommand, AnnotateLinkCommand, AnnotatePortCommand, ApplicationCommand, ApplicationIdListCommand, ApplicationsListCommand, BalanceMastersCommand, ComponentConfigCommand, ConfigureLinkCommand, ConnectivityIntentCommand, CounterCommand, CountersListCommand, DeviceControllersCommand, DeviceInterfaceAddCommand, DeviceInterfaceRemoveCommand, DeviceKeyAddCommand, DeviceKeyListCommand, DeviceKeyRemoveCommand, DevicePortStateCommand, DevicePortStatsCommand, DeviceRemoveCommand, DeviceRoleCommand, DeviceSetControllersCommand, DevicesListCommand, DpisListCommand, DriverProvidersListCommand, DriversListCommand, EdgePortsListCommand, FlowObjectiveCompositionCommand, FlowObjectiveNextListCommand, FlowObjectivePendingNextCommand, FlowObjectiveQueueClearCommand, FlowObjectiveQueueListCommand, FlowsListCommand, GetDomainsCommand, GetFlowStatisticsCommand, GetStatisticsCommand, GlobalLabelApplyCommand, GlobalLabelCommand, GlobalLabelPoolCreateCommand, GlobalLabelPoolDestroyCommand, GlobalLabelReleaseCommand, GroupsListCommand, HostRemoveCommand, HostsListCommand, IntentCycleCommand, IntentDetailsCommand, IntentListCompilers, IntentListInstallers, IntentPurgeCommand, IntentPushTestCommand, IntentRemoveCommand, IntentsDiagnosisCommand, IntentsListCommand, InterfaceAddCommand, InterfaceRemoveCommand, InterfacesListCommand, IssuCommand, LabelApplyCommand, LabelPoolCreateCommand, LabelPoolDestroyCommand, LabelReleaseCommand, LabelResourceCommand, LayoutAddCommand, LayoutListCommand, LeaderCommand, LinksListCommand, MapsListCommand, MarkCommand, MastersListCommand, McastDeleteCommand, McastJoinCommand, McastRoutesListCommand, McastShowCommand, MembershipsListCommand, MeterAddCommand, MeterRemoveCommand, MetersListCommand, MetricsListCommand, NeighbourHandlersListCommand, NetworkConfigCommand, NetworkConfigRegistryCommand, NodeAddCommand, NodeRemoveCommand, NodesListCommand, PacketProcessorsListCommand, PacketRequestsListCommand, PartitionsListCommand, PipeconfCommand, PortQueryVlansCommand, PrettyJson, PrettyXml, QueuesListCommand, RandomIntentCommand, RegionAddCommand, RegionAddDevicesCommand, RegionAddPeerLocCommand, RegionListCommand, RegionRemoveCommand, RegionRemoveDevicesCommand, RegionUpdateCommand, ResourcesCommand, ReviewCommand, RolesCommand, StorageNodesListCommand, SummaryCommand, TableStatisticsCommand, TenantAddCommand, TenantListCommand, TenantRemoveCommand, TestAllocateResource, TestProtectionEndpointIntentCommand, TopologyCommand, TransactionsCommand, TunnelBorrowCommand, TunnelCreateCommand, TunnelQueryCommand, TunnelQuerySubscriptionCommand, TunnelRemoveCommand, TunnelReturnCommand, TunnelUpdateCommand, VirtualDeviceCreateCommand, VirtualDeviceListCommand, VirtualDeviceRemoveCommand, VirtualFlowsListCommand, VirtualHostCreateCommand, VirtualHostListCommand, VirtualHostRemoveCommand, VirtualLinkCreateCommand, VirtualLinkListCommand, VirtualLinkRemoveCommand, VirtualNetworkBalanceMastersCommand, VirtualNetworkCreateCommand, VirtualNetworkIntentRemoveCommand, VirtualNetworkListCommand, VirtualNetworkPacketRequestCommand, VirtualNetworkRemoveCommand, VirtualPortBindCommand, VirtualPortCreateCommand, VirtualPortListCommand, VirtualPortRemoveCommand, VirtualPortStateCommand, WipeOutCommand

public abstract class AbstractShellCommand
extends org.apache.karaf.shell.console.AbstractAction
implements CodecContext

Base abstraction of Karaf shell commands.

Field Summary

Fields inherited from class org.apache.karaf.shell.console.AbstractAction

log, session

Constructor Summary

Constructors

Constructor and Description
AbstractShellCommand()

Method Summary

Modifier and Type	Method and Description
static String	annotations(Annotations annotations) Produces a string image of the specified key/value annotations.
static String	annotations(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, Annotations annotations) Produces a JSON object from the specified key/value annotations.
protected ApplicationId	appId() Returns application ID for the CLI.
<T> JsonCodec<T>	codec(Class<T> entityClass) Returns the JSON codec for the specified entity class.
protected Object	doExecute()
void	error(String format, Object... args) Prints the arguments using the specified format to error stream.
protected abstract void	execute() Executes this command.
static <T> T	get(Class<T> serviceClass) Returns the reference to the implementation of the specified service.
<T> T	getService(Class<T> serviceClass) Returns reference to the specified service implementation.
<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() Returns the JSON object 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 org.apache.karaf.shell.console.AbstractAction

checkInterrupted, execute

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

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:

ServiceNotFoundException - if service is unavailable

appId

protected 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(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(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,
                                                                         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

execute

protected abstract void execute()

Executes this command.

outputJson

protected boolean outputJson()

Indicates whether JSON format should be output.

Returns:

true if JSON is requested

doExecute

protected Object doExecute()
                    throws Exception

Specified by:

doExecute in class org.apache.karaf.shell.console.AbstractAction

Throws:

Exception

mapper

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

Description copied from interface: CodecContext

Returns the JSON object mapper.

Specified by:

mapper in interface CodecContext

Returns:

object mapper

codec

public <T> JsonCodec<T> codec(Class<T> entityClass)

Description copied from interface: CodecContext

Returns the JSON codec for the specified entity class.

Specified by:

codec in interface CodecContext

Type Parameters:

T - entity type

Parameters:

entityClass - entity class

Returns:

JSON codec; null if no codec available for the class

getService

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

Description copied from interface: CodecContext

Returns reference to the specified service implementation.

Specified by:

getService in interface CodecContext

Type Parameters:

T - service type

Parameters:

serviceClass - service class

Returns:

service implementation; null if no implementation available for the class

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