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, org.onosproject.codec.CodecContext

Direct Known Subclasses:

AddMeterCommand, AddTestFlowsCommand, AddTunnelCommand, AllocationsCommand, AnnotateDeviceCommand, ApplicationCommand, ApplicationIdListCommand, ApplicationsListCommand, BalanceMastersCommand, ComponentConfigCommand, ConnectivityIntentCommand, CounterCommand, CountersListCommand, DeviceConfigGetterCommand, DeviceConfigSetterCommand, DeviceControllersCommand, DeviceInterfaceAddCommand, DeviceInterfaceRemoveCommand, DeviceKeyAddCommand, DeviceKeyListCommand, DeviceKeyRemoveCommand, DevicePortGetterCommand, DevicePortStateCommand, DeviceRemoveCommand, DeviceRoleCommand, DeviceSetControllersCommand, DevicesListCommand, DpisListCommand, DriversListCommand, EdgePortsListCommand, FlowObjectiveCompositionCommand, FlowObjectiveNextListCommand, FlowObjectivePendingNextCommand, FlowsListCommand, GetFlowStatisticsCommand, GetStatisticsCommand, GlobalLabelApplyCommand, GlobalLabelCommand, GlobalLabelPoolCreateCommand, GlobalLabelPoolDestoryCommand, GlobalLabelReleaseCommand, GroupsListCommand, HostRemoveCommand, HostsListCommand, IntentCycleCommand, IntentEventsListCommand, IntentEventsMetricsCommand, IntentListCompilers, IntentPurgeCommand, IntentPushTestCommand, IntentRemoveCommand, IntentsListCommand, InterfaceAddCommand, InterfaceRemoveCommand, InterfacesListCommand, LabelApplyCommand, LabelPoolCreateCommand, LabelPoolDestroyCommand, LabelReleaseCommand, LabelResourceCommand, LayoutAddCommand, LayoutListCommand, LeaderCommand, LinksListCommand, MapsListCommand, MastersListCommand, McastDeleteCommand, McastJoinCommand, McastShowCommand, MetersListCommand, MetricsListCommand, NeighbourHandlersListCommand, NetworkConfigCommand, NetworkConfigRegistryCommand, NextHopsListCommand, NodeAddCommand, NodeRemoveCommand, NodesListCommand, PacketProcessorsListCommand, PacketRequestsListCommand, PartitionsListCommand, PortQueryVlansCommand, QueuesListCommand, RandomIntentCommand, RegionAddCommand, RegionAddDevicesCommand, RegionListCommand, RegionRemoveCommand, RegionRemoveDevicesCommand, RegionUpdateCommand, ResourcesCommand, ReviewCommand, RolesCommand, RouteAddCommand, RouteRemoveCommand, RoutesListCommand, SummaryCommand, TableStatisticsCommand, TenantAddCommand, TenantListCommand, TenantRemoveCommand, TestAllocateResource, TopologyCommand, TopologyEventsListCommand, TopologyEventsMetricsCommand, TransactionsCommand, TunnelBorrowCommand, TunnelCreateCommand, TunnelQueryCommand, TunnelQuerySubscriptionCommand, TunnelRemoveCommand, TunnelReturnCommand, TunnelUpdateCommand, UiViewListCommand, VirtualDeviceCreateCommand, VirtualDeviceListCommand, VirtualDeviceRemoveCommand, VirtualHostCreateCommand, VirtualHostListCommand, VirtualHostRemoveCommand, VirtualLinkCreateCommand, VirtualLinkListCommand, VirtualLinkRemoveCommand, VirtualNetworkCreateCommand, VirtualNetworkIntentRemoveCommand, VirtualNetworkListCommand, VirtualNetworkRemoveCommand, VirtualPortCreateCommand, VirtualPortListCommand, VirtualPortRemoveCommand

public abstract class AbstractShellCommand
extends org.apache.karaf.shell.console.AbstractAction
implements org.onosproject.codec.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(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 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)
<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 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

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

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()

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