content: /*
   *  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.apache.causeway.viewer.restfulobjects.client;
  
  import java.util.concurrent.TimeUnit;
  
  import jakarta.ws.rs.client.Invocation;
  import jakarta.ws.rs.core.Response;
  
  import org.apache.causeway.viewer.restfulobjects.client.auth.AuthorizationHeaderFactory;
  
  @SuppressWarnings("unused")
  class RestfulClient_Examples {
  
      void basic_auth() {
  
          RestfulClient restfulClient = RestfulClient.ofConfig(
                  RestfulClientConfig.builder()
                      .restfulBaseUrl("localhost:8080")
                      .authenticationMode(AuthenticationMode.BASIC)
                      .basicAuthUser("sven")
                      .basicAuthPassword("pass")
                      .build());
  
          Invocation.Builder request = restfulClient.request("services/customers.CustomerApi/actions/findAll/invoke");
  
          Response response = request.get();
  //        Response response = request.put(...);
  //        Response response = request.post(...);
  //        Response response = request.delete();
  
      }
  
      void oauth2_auth() {
  
          RestfulClient restfulClient = RestfulClient.ofConfig(
                  RestfulClientConfig.builder()
                      .restfulBaseUrl("localhost:8080")
                      .authenticationMode(AuthenticationMode.OAUTH2_AZURE)
                      .oauthTenantId("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
                      .oauthClientId("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
                      .oauthClientSecret("xxXXx~XXxxXx-XxXX.XxXX.XxxXX-XxxXX~XxxXX")
                      .build());
  
          Invocation.Builder request = restfulClient.request("services/customers.CustomerApi/actions/findAll/invoke");
  
          Response response = request.get();
  //        Response response = request.put(...);
  //        Response response = request.post(...);
  //        Response response = request.delete();
  
      }
  
      void auth_other() {
  
          RestfulClient restfulClient = RestfulClient.ofConfig(
                  RestfulClientConfig.builder()
                          .restfulBaseUrl("localhost:8080")
                          .build(),
                          (AuthorizationHeaderFactory) () -> "some authorization header");
      }
  
      void usage() {
  
          RestfulClient restfulClient = RestfulClient.ofConfig(
                  RestfulClientConfig.builder()
                          .restfulBaseUrl("localhost:8080")
                          //...
                          .build());
  
          Invocation.Builder request = restfulClient.request("services/customers.CustomerApi/actions/findAll/invoke");
  
          Response response = request.get();
  //        Response response = request.put(...);
  //        Response response = request.post(...);
  //        Response response = request.delete();
  
      }
  
      // jakarta.ws.rs.client.ClientBuilder
      void refiner() {
  
          RestfulClient restfulClient = RestfulClient.ofConfig(
                  RestfulClientConfig.builder()
                          .restfulBaseUrl("localhost:8080")
                          //...
                          .build(),
                  clientBuilder ->
                          clientBuilder.connectTimeout(5, TimeUnit.SECONDS)
                                  .readTimeout(2, TimeUnit.SECONDS)
          );
      }
  
  }
  