| /* |
| * 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.ec2; |
| |
| import static org.jclouds.aws.reference.AWSConstants.PROPERTY_AUTH_TAG; |
| import static org.jclouds.aws.reference.AWSConstants.PROPERTY_HEADER_TAG; |
| import static org.jclouds.compute.config.ComputeServiceProperties.RESOURCENAME_DELIMITER; |
| import static org.jclouds.ec2.reference.EC2Constants.PROPERTY_EC2_AMI_OWNERS; |
| import static org.jclouds.ec2.reference.EC2Constants.PROPERTY_EC2_AUTO_ALLOCATE_ELASTIC_IPS; |
| import static org.jclouds.ec2.reference.EC2Constants.PROPERTY_EC2_GENERATE_INSTANCE_NAMES; |
| import static org.jclouds.ec2.reference.EC2Constants.PROPERTY_EC2_TIMEOUT_SECURITYGROUP_PRESENT; |
| |
| import java.net.URI; |
| import java.util.Properties; |
| |
| import org.jclouds.apis.ApiMetadata; |
| import org.jclouds.ec2.compute.EC2ComputeServiceContext; |
| import org.jclouds.ec2.compute.config.EC2ComputeServiceContextModule; |
| import org.jclouds.ec2.compute.config.EC2ResolveImagesModule; |
| import org.jclouds.ec2.config.EC2RestClientModule; |
| import org.jclouds.rest.internal.BaseRestApiMetadata; |
| |
| import com.google.common.collect.ImmutableSet; |
| import com.google.common.reflect.TypeToken; |
| import com.google.inject.Module; |
| |
| /** |
| * Implementation of {@link ApiMetadata} for Amazon's EC2 api. |
| * |
| * <h3>note</h3> |
| * <p/> |
| * This class allows overriding of types {@code S}(client) and {@code A} |
| * (asyncClient), so that children can add additional methods not declared here, |
| * such as new features from AWS. |
| * <p/> |
| * |
| * As this is a popular api, we also allow overrides for type {@code C} |
| * (context). This allows subtypes to add in new feature groups or extensions, |
| * not present in the base api. For example, you could make a subtype for |
| * context, that exposes admin operations. |
| * |
| * @author Adrian Cole |
| */ |
| public class EC2ApiMetadata extends BaseRestApiMetadata { |
| |
| /** |
| * @deprecated please use {@code org.jclouds.ContextBuilder#buildApi(EC2Api.class)} as |
| * {@link EC2AsyncClient} interface will be removed and {@link EC2Client} will be |
| * moved into {@link EC2Api} in jclouds 1.7 |
| */ |
| @Deprecated |
| public static final TypeToken<org.jclouds.rest.RestContext<? extends EC2Client, ? extends EC2AsyncClient>> CONTEXT_TOKEN = new TypeToken<org.jclouds.rest.RestContext<? extends EC2Client, ? extends EC2AsyncClient>>() { |
| private static final long serialVersionUID = 1L; |
| }; |
| |
| @Override |
| public Builder<?> toBuilder() { |
| return new ConcreteBuilder().fromApiMetadata(this); |
| } |
| |
| public EC2ApiMetadata() { |
| this(new ConcreteBuilder()); |
| } |
| |
| protected EC2ApiMetadata(Builder<?> builder) { |
| super(builder); |
| } |
| |
| public static Properties defaultProperties() { |
| Properties properties = BaseRestApiMetadata.defaultProperties(); |
| properties.setProperty(PROPERTY_AUTH_TAG, "AWS"); |
| properties.setProperty(PROPERTY_HEADER_TAG, "amz"); |
| properties.setProperty(PROPERTY_EC2_AMI_OWNERS, "*"); |
| properties.setProperty(PROPERTY_EC2_TIMEOUT_SECURITYGROUP_PRESENT, "500"); |
| properties.setProperty(PROPERTY_EC2_AUTO_ALLOCATE_ELASTIC_IPS, "false"); |
| properties.setProperty(RESOURCENAME_DELIMITER, "#"); |
| properties.setProperty(PROPERTY_EC2_GENERATE_INSTANCE_NAMES, "true"); |
| return properties; |
| } |
| |
| public abstract static class Builder<T extends Builder<T>> extends BaseRestApiMetadata.Builder<T> { |
| @SuppressWarnings("deprecation") |
| protected Builder() { |
| this(EC2Client.class, EC2AsyncClient.class); |
| } |
| |
| protected Builder(Class<?> syncClient, Class<?> asyncClient) { |
| super(syncClient, asyncClient); |
| id("ec2") |
| .name("Amazon Elastic Compute Cloud (EC2) API") |
| .identityName("Access Key ID") |
| .credentialName("Secret Access Key") |
| .defaultEndpoint("https://ec2.us-east-1.amazonaws.com") |
| .documentation(URI.create("http://docs.amazonwebservices.com/AWSEC2/latest/APIReference")) |
| .version("2010-06-15") |
| .defaultProperties(EC2ApiMetadata.defaultProperties()) |
| .context(CONTEXT_TOKEN) |
| .view(EC2ComputeServiceContext.class) |
| .defaultModules(ImmutableSet.<Class<? extends Module>>of(EC2RestClientModule.class, EC2ResolveImagesModule.class, EC2ComputeServiceContextModule.class)); |
| } |
| |
| @Override |
| public ApiMetadata build() { |
| return new EC2ApiMetadata(this); |
| } |
| } |
| |
| private static class ConcreteBuilder extends Builder<ConcreteBuilder> { |
| @Override |
| protected ConcreteBuilder self() { |
| return this; |
| } |
| } |
| } |