/*
 * 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.juneau.http.part;

import static org.apache.juneau.commons.utils.ThrowableUtils.*;
import static org.apache.juneau.commons.utils.Utils.*;

import java.lang.reflect.*;
import java.util.concurrent.*;

import org.apache.juneau.commons.reflect.*;
import org.apache.juneau.http.annotation.*;
import org.apache.juneau.httppart.*;

/**
 * Holds metadata about http part beans (POJOs that get serialized as HTTP parts such as form data or query parameters).
 *
 * <p>
 * HTTP part beans are typically annotated with {@link Query @Query}, {@link FormData @FormData}, or {@link Path @Path}
 * although it's not an absolute requirement.
 *
 * <p>
 * HTTP part beans must have one of the following public constructors:
 * <ul>
 *    <li><c><jk>public</jk> X(String <jv>partValue</jv>)</c>
 *    <li><c><jk>public</jk> X(Object <jv>partValue</jv>)</c>
 *    <li><c><jk>public</jk> X(String <jv>partName</jv>, String <jv>partValue</jv>)</c>
 *    <li><c><jk>public</jk> X(String <jv>partName</jv>, Object <jv>partValue</jv>)</c>
 * </ul>
 *
 * <p>
 * <h5 class='figure'>Example</h5>
 * <p class='bjava'>
 *    <jc>// Our part bean.</jc>
 *    <ja>@Query</ja>(<js>"foo"</js>)
 *    <jk>public class</jk> FooPart <jk>extends</jk> BasicStringPart {
 *
 *       <jk>public</jk> FooPart(String <jv>partValue</jv>) {
 *          <jk>super</jk>(<js>"foo"</js>, <jv>partValue</jv>);
 *       }
 *  }
 *
 *  <jc>// Code to retrieve a part bean from a part list in a request.</jc>
 *  PartList <jv>parts</jv> = <jv>httpRequest</jv>.getFormDataList();
 *  FooPart <jv>foo</jv> = <jv>parts</jv>.get(FooPart.<jk>class</jk>);
 * </p>
 *
 * <h5 class='section'>See Also:</h5><ul>
 *    <li class='link'><a class="doclink" href="https://juneau.apache.org/docs/topics/JuneauRestCommonBasics">juneau-rest-common Basics</a>
 * </ul>
 *
 * @param <T> The HTTP part bean type.
 */
public class PartBeanMeta<T> {

   private static final ConcurrentHashMap<Class<?>,PartBeanMeta<?>> CACHE = new ConcurrentHashMap<>();

   /**
    * Finds the part bean meta for the specified type.
    *
    * @param <T> The part bean type.
    * @param type The part bean type.
    * @return The metadata, or <jk>null</jk> if a valid constructor could not be found.
    */
   @SuppressWarnings("unchecked")
   public static <T> PartBeanMeta<T> of(Class<T> type) {
      PartBeanMeta<?> m = CACHE.get(type);
      if (m == null) {
         m = new PartBeanMeta<>(type);
         CACHE.put(type, m);
      }
      return (PartBeanMeta<T>)m;
   }

   private final Class<T> type;
   private final Constructor<T> constructor;

   private final HttpPartSchema schema;

   private PartBeanMeta(Class<T> type) {
      this.type = type;

      var ci = ClassInfo.of(type);

      // @formatter:off
      constructor = ci.getPublicConstructor(x -> x.hasParameterTypes(String.class))
         .or(() -> ci.getPublicConstructor(x -> x.hasParameterTypes(Object.class)))
         .or(() -> ci.getPublicConstructor(x -> x.hasParameterTypes(String.class, String.class)))
         .or(() -> ci.getPublicConstructor(x -> x.hasParameterTypes(String.class, Object.class)))
         .map(x -> x.<T>inner())
         .orElse(null);
      // @formatter:on

      if (ci.hasAnnotation(Query.class))
         this.schema = HttpPartSchema.create(Query.class, type);
      else if (ci.hasAnnotation(FormData.class))
         this.schema = HttpPartSchema.create(FormData.class, type);
      else if (ci.hasAnnotation(Path.class))
         this.schema = HttpPartSchema.create(Path.class, type);
      else
         this.schema = HttpPartSchema.create(org.apache.juneau.http.annotation.Header.class, type);
   }

   /**
    * Constructs a part bean with the specified name or value.
    *
    * <p>
    * Can only be used on beans where the part name is known.
    *
    * @param value
    *    The part value.
    * @return A newly constructed bean.
    */
   public T construct(Object value) {
      return construct(null, value);
   }

   /**
    * Constructs a part bean with the specified name or value.
    *
    * @param name
    *    The part name.
    *    <br>If <jk>null</jk>, uses the value pulled from the {@link org.apache.juneau.http.annotation.Header#name() @Header(name)} or
    *    {@link org.apache.juneau.http.annotation.Header#value() @Header(value)} annotations.
    * @param value
    *    The part value.
    * @return A newly constructed bean.
    * @throws UnsupportedOperationException If bean could not be constructed (e.g. couldn't find a constructor).
    */
   public T construct(String name, Object value) {

      if (constructor == null)
         throw unsupportedOp("Constructor for type {0} could not be found.", cn(type));

      if (name == null)
         name = schema.getName();

      var pt = constructor.getParameterTypes();
      var args = new Object[pt.length];
      if (pt.length == 1) {
         args[0] = pt[0] == String.class ? s(value) : value;
      } else {
         if (name == null)
            throw unsupportedOp("Constructor for type {0} requires a name as the first argument.", cn(type));
         args[0] = name;
         args[1] = pt[1] == String.class ? s(value) : value;
      }

      try {
         return constructor.newInstance(args);
      } catch (Exception e) {
         throw toRex(e);
      }
   }

   /**
    * Returns schema information about this part.
    *
    * <p>
    * This is information pulled from {@link Query @Query}, {@link FormData @FormData}, or {@link Path @Path} annotations
    * on the class.
    *
    * @return The schema information.
    */
   public HttpPartSchema getSchema() { return schema; }
}