| /** |
| * Licensed to jclouds, Inc. (jclouds) under one or more |
| * contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. jclouds 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_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.RestContext; |
| 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 { |
| |
| /** The serialVersionUID */ |
| private static final long serialVersionUID = 4424763314988423886L; |
| |
| public static final TypeToken<RestContext<? extends EC2Client, ? extends EC2AsyncClient>> CONTEXT_TOKEN = new TypeToken<RestContext<? extends EC2Client, ? extends EC2AsyncClient>>() { |
| private static final long serialVersionUID = -5070937833892503232L; |
| }; |
| |
| @Override |
| public Builder toBuilder() { |
| return (Builder) new Builder(getApi(), getAsyncApi()).fromApiMetadata(this); |
| } |
| |
| public EC2ApiMetadata() { |
| this(new Builder(EC2Client.class, EC2AsyncClient.class)); |
| } |
| |
| 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, "#"); |
| return properties; |
| } |
| |
| public static class Builder |
| extends BaseRestApiMetadata.Builder { |
| |
| 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(EC2AsyncClient.VERSION) |
| .defaultProperties(EC2ApiMetadata.defaultProperties()) |
| .context(CONTEXT_TOKEN) |
| .wrapper(EC2ComputeServiceContext.class) |
| .defaultModules(ImmutableSet.<Class<? extends Module>>of(EC2RestClientModule.class, EC2ResolveImagesModule.class, EC2ComputeServiceContextModule.class)); |
| } |
| |
| @Override |
| public ApiMetadata build() { |
| return new EC2ApiMetadata(this); |
| } |
| |
| @Override |
| public Builder fromApiMetadata(ApiMetadata in) { |
| super.fromApiMetadata(in); |
| return this; |
| } |
| |
| } |
| |
| } |