content: /*
   * Copyright 2013 Agorava
   *
   * 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.agorava.spi;
  
  import org.agorava.api.extractor.TokenExtractor;
  import org.agorava.api.oauth.OAuth;
  import org.agorava.api.oauth.application.OAuthAppSettings;
  import org.agorava.api.rest.Verb;
  
  import javax.inject.Inject;
  
  import static org.agorava.api.oauth.OAuth.OAuthVersion;
  import static org.agorava.api.oauth.OAuth.OAuthVersion.TWO_DRAFT_11;
  
  /**
   * Default Provider configuration implementing the OAuth protocol, version 2.0 (draft 11)
   * <p>
   * This class is meant to be extended by concrete implementations of the API,
   * providing the endpoints and endpoint-http-verbs.
   * <p>
   * If your Api adheres to the 2.0 (draft 11) protocol correctly, you just need to extend
   * this class and define the getters for your endpoints.
   * <p>
   * If your Api does something a bit different, you can override the different
   * extractors or services, in order to fine-tune the process.
   *
   * @author Diego Silveira
   * @author Antoine Sabot-Durand
   */
  public abstract class ProviderConfigOauth20 extends ProviderConfigOauth {
  
  
      @Inject
      @OAuth(TWO_DRAFT_11)
      TokenExtractor AccessTokenExtractor;
  
      /**
       * {@inheritDoc}
       */
      @Override
      public TokenExtractor getAccessTokenExtractor() {
          return AccessTokenExtractor;
      }
  
      /**
       * Returns the verb for the access token endpoint (defaults to GET)
       *
       * @return access token endpoint verb
       */
      public Verb getAccessTokenVerb() {
          return Verb.GET;
      }
  
      /**
       * Returns the URL that receives the access token requests.
       *
       * @return access token URL
       */
      public abstract String getAccessTokenEndpoint();
  
      /**
       * Returns the URL where you should redirect your users to authenticate
       * your application.
       *
       * @param config OAuth 2.0 configuration param object
       * @return the URL where you should redirect your users
       */
      public abstract String getAuthorizationUrl(OAuthAppSettings config);
  
      /**
       * {@inheritDoc}
       */
      @Override
      public OAuthVersion getOAuthVersion() {
          return TWO_DRAFT_11;
      }
  
  }
  