Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Copyright (c) OSGi Alliance (2002, 2010). All Rights Reserved.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 package org.osgi.service.upnp;
 
A UPnP action. Each UPnP service contains zero or more actions. Each action may have zero or more UPnP state variables as arguments.

Version:
$Id: 2db11f45a7dd2f34775d673355095ad3037821db $
 
 public interface UPnPAction {
Returns the action name. The action name corresponds to the name field in the actionList of the service description.
  • For standard actions defined by a UPnP Forum working committee, action names must not begin with X_ nor A_.
  • For non-standard actions specified by a UPnP vendor and added to a standard service, action names must begin with X_.

This method must continue to return the action name after the UPnP action has been removed from the network.

Returns:
Name of action, must not contain a hyphen character or a hash character
 
Returns the name of the designated return argument.

One of the output arguments can be flagged as a designated return argument.

This method must continue to return the action return argument name after the UPnP action has been removed from the network.

Returns:
The name of the designated return argument or null if none is marked.
 
Lists all input arguments for this action.

Each action may have zero or more input arguments.

This method must continue to return the action input argument names after the UPnP action has been removed from the network.

Returns:
Array of input argument names or null if no input arguments.
See also:
UPnPStateVariable
 
List all output arguments for this action.

This method must continue to return the action output argument names after the UPnP action has been removed from the network.

Returns:
Array of output argument names or null if there are no output arguments.
See also:
UPnPStateVariable
 
Finds the state variable associated with an argument name. Helps to resolve the association of state variables with argument names in UPnP actions.

Parameters:
argumentName The name of the UPnP action argument.
Returns:
State variable associated with the named argument or null if there is no such argument.
Throws:
java.lang.IllegalStateException if the UPnP action has been removed from the network.
See also:
UPnPStateVariable
Invokes the action. The input and output arguments are both passed as Dictionary objects. Each entry in the Dictionary object has a String object as key representing the argument name and the value is the argument itself. The class of an argument value must be assignable from the class of the associated UPnP state variable. The input argument Dictionary object must contain exactly those arguments listed by getInputArguments method. The output argument Dictionary object will contain exactly those arguments listed by getOutputArguments method.

Parameters:
args A Dictionary of arguments. Must contain the correct set and type of arguments for this action. May be null if no input arguments exist.
Returns:
A Dictionary with the output arguments. null if the action has no output arguments.
Throws:
UPnPException A UPnP error has occurred.
java.lang.IllegalStateException if the UPnP action has been removed from the network.
java.lang.Exception The execution fails for some reason.
See also:
UPnPStateVariable
New to GrepCode? Check out our FAQ X