/**************************************************************
 * 
 * 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 com.sun.star.uno;

/**
 * The <code>ITypeDescription</code> allows to examine a type
 * in detail (e.g. it is used for marshaling/unmarshaling).
 *
 * @deprecated This interface does not cover all the features supported by the
 * corresponding (unpublished) implementation.  But no client code should need
 * to access this functionality, anyway.
 */
public interface ITypeDescription {
	/**
	 * Gets the <code>ITypeDescription</code> of the
	 * super, if it exists.
	 * <p>
	 * @return  the <code>ITypeDescription</code>.
	 */
	ITypeDescription getSuperType();

	/**
	 * Gets the <code>IMethodDescription</code> for every
	 * method, if this type is an interface. Otherwise 
	 * returns <code>null</code>.
	 * <p>
	 * @return  the <code>IMethodDescription[]</code>.
	 */
	IMethodDescription []getMethodDescriptions();

	/**
	 * Gets the <code>IMethodDescription</code> for the
	 * method with index methodId, if it exists, otherwise
	 * returns <code>null</code>.
	 * <p>
	 * @return  the <code>IMethodDescription</code>.
	 */
	IMethodDescription getMethodDescription(int methodId);

	/**
	 * Gets the <code>IMethodDescription</code> for the
	 * method with the name <code>name</code>, if it exists, 
	 * otherwise returns <code>null</code>.
	 * <p>
	 * @return  the <code>IMethodDescription</code>.
	 */
	IMethodDescription getMethodDescription(String name);

	/**
	 * Gets the <code>IFieldDescription</code> for every
	 * field, if this type is an interface. Otherwise 
	 * returns <code>null</code>.
	 * <p>
	 * @return  the <code>IFieldDescription[]</code>.
	 */
  	IFieldDescription []getFieldDescriptions();

	/**
	 * Gets the <code>IFieldDescription</code> for the
	 * field with the name <code>name</code>, if it exists, 
	 * otherwise returns <code>null</code>.
	 * <p>
	 * @return  the <code>IFieldDescription</code>.
	 */
  	IFieldDescription getFieldDescription(String name);

	/**
	 * Gets the IDL <code>TypeClass</code> of the type.
	 * <p>
	 * @return  the <code>TypeClass</code>.
	 */
	TypeClass getTypeClass();

	/**
	 * Gets the component <code>ITypeDescription</code> if
	 * this is an array type, otherwise returns <code>null</code>.
	 * <p>
	 * @return the <code>ITypeDescription</code>
	 */
	ITypeDescription getComponentType();

	/**
	 * Gets the (UNO) type name.
     *
     * <table>
     *   <caption>The following table lists how UNO types map to type names:</caption>
     *   <thead>
     *     <tr><th>UNO type</th><th>type name</th></tr>
     *   </thead>
     *   <tbody>
     *     <tr><td>VOID</td><td><code>"void"</code></td></tr>
     *     <tr><td>BOOLEAN</td><td><code>"boolean"</code></td></tr>
     *     <tr><td>CHAR</td><td><code>"char"</code></td></tr>
     *     <tr><td>BYTE</td><td><code>"byte"</code></td></tr>
     *     <tr><td>SHORT</td><td><code>"short"</code></td></tr>
     *     <tr>
     *       <td>UNSIGNED SHORT</td><td><code>"unsigned short"</code></td>
     *     </tr>
     *     <tr><td>LONG</td><td><code>"long"</code></td></tr>
     *     <tr><td>UNSIGNED LONG</td><td><code>"unsigned long"</code></td></tr>
     *     <tr><td>HYPER</td><td><code>"hyper"</code></td></tr>
     *     <tr>
     *       <td>UNSIGNED HYPER</td><td><code>"unsigned hyper"</code></td>
     *     </tr>
     *     <tr><td>FLOAT</td><td><code>"float"</code></td></tr>
     *     <tr><td>DOUBLE</td><td><code>"double"</code></td></tr>
     *     <tr><td>STRING</td><td><code>"string"</code></td></tr>
     *     <tr><td>TYPE</td><td><code>"type"</code></td></tr>
     *     <tr><td>ANY</td><td><code>"any"</code></td></tr>
     *     <tr>
     *       <td>sequence type of base type <var>T</var></td>
     *       <td><code>"[]"</code> followed by type name for <var>T</var></td>
     *     </tr>
     *     <tr>
     *       <td>enum type named <var>N</var></td>
     *       <td><var>N</var> (see below)</td>
     *     </tr>
     *     <tr>
     *       <td>struct type named <var>N</var></td>
     *       <td><var>N</var> (see below)</td>
     *     </tr>
     *     <tr>
     *       <td>exception type named <var>N</var>
     *       </td><td><var>N</var> (see below)</td>
     *     </tr>
     *     <tr>
     *       <td>interface type named <var>N</var></td>
     *       <td><var>N</var> (see below)</td>
     *     </tr>
     *   </tbody>
     * </table>
     * <p>For a UNO type named <var>N</var>, consisting of a sequence of module
     * names <var>M<sub>1</sub></var>, ..., <var>M<sub>n</sub></var> followed by
     * a simple name <var>S</var>, the corresponding type name consists of the
     * same sequence of module names and simple name, with <code>"."</code>
     * seperating the individual elements.</p>
     *
	 * @return the type name.
	 */
	String getTypeName();
	
	/**
	 * Gets the (Java) array type name.
     *
	 * <p>The array type name is defined to be the Java class name (as returned
     * by <code>Class.forName</code>) of the Java array class that corresponds
     * to the UNO sequence type with this type (the UNO type represented by this
     * <code>ITypeDescription</code> instance) as base type.  For an
     * <code>ITypeDescription</code> instance representing the UNO type VOID,
     * the array type name is defined to be
     * <code>"[Ljava.lang.Void;"</code>.</p>
     *
	 * @return the array type name.
	 */
	String getArrayTypeName();
	
	/**
	 * Gets the corresponding java class for the type.
	 * <p>
	 * @return   the corresponding java class.
	 */
	Class getZClass();
}