apache/cloudstack
1
0
Fork 0
mirror of https://github.com/apache/cloudstack.git synced 2025-12-17 11:04:00 +01:00
Code Issues Packages Projects Releases Wiki Activity

bug 9026: added ability to turn off apiCommand/commandParameter for docGeneration

Browse Source 
status 9026: resolved fixed

1) Don't expose following commands in doc:

* registerSSHKeyPair
* createSSHKeyPair
* deleteSSHKeyPair
* listSSHKeyPairs

2) Don't show "sshKeyPairName" parameter for deployVm command
This commit is contained in:
alena 2011-03-23 12:54:21 -07:00
parent b3d6130bae
commit 8de3bacd2b
9 changed files with 54 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
api/src/com/cloud/api/Implementation.java
View File

@ -11,4 +11,5 @@ import java.lang.annotation.Target;
public @interface Implementation {
Class<?> responseObject();
String description() default "";
boolean includeInApiDoc() default true;
}

1
api/src/com/cloud/api/Parameter.java
View File

@ -35,5 +35,6 @@ public @interface Parameter {
CommandType type() default CommandType.OBJECT;
CommandType collectionType() default CommandType.OBJECT;
boolean expose() default true;
boolean includeInApiDoc() default true;
}

2
api/src/com/cloud/api/commands/CreateSSHKeyPairCmd.java
View File

@ -11,7 +11,7 @@ import com.cloud.user.Account;
import com.cloud.user.SSHKeyPair;
import com.cloud.user.UserContext;
@Implementation(description="Create a new keypair and returns the private key", responseObject=SSHKeyPairResponse.class)
@Implementation(description="Create a new keypair and returns the private key", responseObject=SSHKeyPairResponse.class, includeInApiDoc=false)
public class CreateSSHKeyPairCmd extends BaseCmd {
public static final Logger s_logger = Logger.getLogger(CreateSSHKeyPairCmd.class.getName());
private static final String s_name = "createkeypairresponse";

2
api/src/com/cloud/api/commands/DeleteSSHKeyPairCmd.java
View File

@ -10,7 +10,7 @@ import com.cloud.api.response.SuccessResponse;
import com.cloud.user.Account;
import com.cloud.user.UserContext;
@Implementation(description="Deletes a keypair by name", responseObject=SuccessResponse.class)
@Implementation(description="Deletes a keypair by name", responseObject=SuccessResponse.class, includeInApiDoc=false)
public class DeleteSSHKeyPairCmd extends BaseCmd {
public static final Logger s_logger = Logger.getLogger(CreateSSHKeyPairCmd.class.getName());
private static final String s_name = "deletekeypairresponse";

2
api/src/com/cloud/api/commands/DeployVMCmd.java
View File

@ -100,7 +100,7 @@ public class DeployVMCmd extends BaseAsyncCreateCmd {
@Parameter(name=ApiConstants.USER_DATA, type=CommandType.STRING, description="an optional binary data that can be sent to the virtual machine upon a successful deployment. This binary data must be base64 encoded before adding it to the request. Currently only HTTP GET is supported. Using HTTP GET (via querystring), you can send up to 2KB of data after base64 encoding.")
private String userData;
@Parameter(name=ApiConstants.SSH_KEYPAIR, type=CommandType.STRING, description="name of the ssh key pair used to login to the virtual machine")
@Parameter(name=ApiConstants.SSH_KEYPAIR, type=CommandType.STRING, description="name of the ssh key pair used to login to the virtual machine", includeInApiDoc=false)
private String sshKeyPairName;
/////////////////////////////////////////////////////

2
api/src/com/cloud/api/commands/GetVMPasswordCmd.java
View File

@ -12,7 +12,7 @@ import com.cloud.api.response.GetVMPasswordResponse;
import com.cloud.user.Account;
import com.cloud.uservm.UserVm;
@Implementation(responseObject=GetVMPasswordResponse.class, description="Returns an encrypted password for the VM")
@Implementation(responseObject=GetVMPasswordResponse.class, description="Returns an encrypted password for the VM", includeInApiDoc=false)
public class GetVMPasswordCmd extends BaseCmd {
public static final Logger s_logger = Logger.getLogger(GetVMPasswordCmd.class.getName());
private static final String s_name = "getvmpasswordresponse";

2
api/src/com/cloud/api/commands/ListSSHKeyPairsCmd.java
View File

@ -13,7 +13,7 @@ import com.cloud.api.response.ListResponse;
import com.cloud.api.response.SSHKeyPairResponse;
import com.cloud.user.SSHKeyPair;
@Implementation(description="List registered keypairs", responseObject=SSHKeyPairResponse.class)
@Implementation(description="List registered keypairs", responseObject=SSHKeyPairResponse.class, includeInApiDoc=false)
public class ListSSHKeyPairsCmd extends BaseListCmd {
public static final Logger s_logger = Logger.getLogger(ListSSHKeyPairsCmd.class.getName());
private static final String s_name = "listsshkeypairsresponse";

2
api/src/com/cloud/api/commands/RegisterSSHKeyPairCmd.java
View File

@ -11,7 +11,7 @@ import com.cloud.user.Account;
import com.cloud.user.SSHKeyPair;
import com.cloud.user.UserContext;
@Implementation(description="Register a public key in a keypair under a certain name", responseObject=SSHKeyPairResponse.class)
@Implementation(description="Register a public key in a keypair under a certain name", responseObject=SSHKeyPairResponse.class, includeInApiDoc=false)
public class RegisterSSHKeyPairCmd extends BaseCmd {
public static final Logger s_logger = Logger.getLogger(RegisterSSHKeyPairCmd.class.getName());
private static final String s_name = "registerkeypairresponse";

10
server/src/com/cloud/api/doc/ApiXmlDocWriter.java
View File

@ -287,8 +287,11 @@ public class ApiXmlDocWriter {
apiCommand.setName(command);
Implementation impl = (Implementation)clas.getAnnotation(Implementation.class);
if (impl == null)
if (impl == null) {
impl = (Implementation)clas.getSuperclass().getAnnotation(Implementation.class);
}
if (impl.includeInApiDoc()) {
String commandDescription = impl.description();
if (commandDescription != null)
apiCommand.setDescription(commandDescription);
@ -330,6 +333,9 @@ public class ApiXmlDocWriter {
apiCommand.setResponse(response);
out.writeObject(apiCommand);
} else {
s_logger.debug("Command " + command + " is not exposed in api doc");
}
}
private static void writeLoginCommand(ObjectOutputStream out) throws ClassNotFoundException, IOException{
@ -394,7 +400,7 @@ public class ApiXmlDocWriter {
Argument id = null;
for (Field f : fields) {
Parameter parameterAnnotation = f.getAnnotation(Parameter.class);
if (parameterAnnotation != null && parameterAnnotation.expose()) {
if (parameterAnnotation != null && parameterAnnotation.expose() && parameterAnnotation.includeInApiDoc()) {
Argument reqArg = new Argument(parameterAnnotation.name());
reqArg.setRequired(parameterAnnotation.required());
if (!parameterAnnotation.description().isEmpty()) {