org.jclouds.openstack.services.Extension Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of openstack-common Show documentation

jclouds Core components to access OpenStack apis

There is a newer version: 2.6.0

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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.jclouds.openstack.services;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import javax.inject.Qualifier;

/**
 * An extension of a {@link ServiceType service}. In order for us to understand
 * the context of the extension, we must consider the extensions call.
 * 
 * 

 * For our purposes, the minimal context of an extension is the type of the
 * service it extends ex. {@link ServiceType#COMPUTE}, and its namespace ex. http://docs.openstack.org
 * /ext/keypairs/api/v1.1.
 * 
 * @author Adrian Cole
 * 
 * @see ServiceType
 * @see 
 * @see 
 * @see 
 */
@Retention(value = RetentionPolicy.RUNTIME)
@Target(value = { ElementType.TYPE, ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD })
@Qualifier
public @interface Extension {

   /**
    * the service type this is an extension of.
    * 
    * note
    * 
    * This isn't necessarily one of the built-in {@link ServiceType services},
    * it could be an extension of a custom service.
    * 
    * @return the service type this is an extension of.
    * 
    */
   String of();

   /**
    * namespace ex. http
    * ://docs.openstack.org /ext/keypairs/api/v1.1.
    * 
    * @return the namespace of the extension
    */
   String namespace();

}