/*

 * Copyright (C) 2010 The Android Open Source Project

 *

 * Licensed under the Eclipse Public License, Version 1.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.eclipse.org/org/documents/epl-v10.php

 *

 * 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.android.sdklib.repository;



import java.io.InputStream;







/**

 * Public constants common to the sdk-repository and sdk-addon XML Schemas.

 */

public class RepoConstants {



    /** An extra package. */

    public static final String NODE_EXTRA           = "extra";                //$NON-NLS-1$



    /** The license definition. */

    public static final String NODE_LICENSE       = "license";                  //$NON-NLS-1$

    /** The optional uses-license for all packages or for a lib. */

    public static final String NODE_USES_LICENSE  = "uses-license";             //$NON-NLS-1$

    /** The revision, an int > 0, for all packages. */

    public static final String NODE_REVISION      = "revision";                 //$NON-NLS-1$

    /** The optional description for all packages or for a lib. */

    public static final String NODE_DESCRIPTION   = "description";              //$NON-NLS-1$

    /** The optional description URL for all packages. */

    public static final String NODE_DESC_URL      = "desc-url";                 //$NON-NLS-1$

    /** The optional release note for all packages. */

    public static final String NODE_RELEASE_NOTE  = "release-note";             //$NON-NLS-1$

    /** The optional release note URL for all packages. */

    public static final String NODE_RELEASE_URL   = "release-url";              //$NON-NLS-1$

    /** The optional obsolete qualifier for all packages. */

    public static final String NODE_OBSOLETE      = "obsolete";                 //$NON-NLS-1$

    /** The optional project-files provided by extra packages. */

    public static final String NODE_PROJECT_FILES = "project-files";            //$NON-NLS-1$



    /** The optional minimal tools revision required by platform & extra packages. */

    public static final String NODE_MIN_TOOLS_REV = "min-tools-rev";            //$NON-NLS-1$

    /** The optional minimal platform-tools revision required by tool packages. */

    public static final String NODE_MIN_PLATFORM_TOOLS_REV = "min-platform-tools-rev"; //$NON-NLS-1$

    /** The optional minimal API level required by extra packages. */

    public static final String NODE_MIN_API_LEVEL = "min-api-level";            //$NON-NLS-1$



    /** The version, a string, for platform packages. */

    public static final String NODE_VERSION   = "version";                      //$NON-NLS-1$

    /** The api-level, an int > 0, for platform, add-on and doc packages. */

    public static final String NODE_API_LEVEL = "api-level";                    //$NON-NLS-1$

    /** The codename, a string, for platform packages. */

    public static final String NODE_CODENAME = "codename";                      //$NON-NLS-1$

    /** The vendor, a string, for add-on and extra packages. */

    public static final String NODE_VENDOR    = "vendor";                       //$NON-NLS-1$

    /** The name, a string, for add-on packages or for libraries. */

    public static final String NODE_NAME      = "name";                         //$NON-NLS-1$





    /** A layoutlib package. */

    public static final String NODE_LAYOUT_LIB      = "layoutlib";              //$NON-NLS-1$

    /** The API integer for a layoutlib element. */

    public static final String NODE_API             = "api";                    //$NON-NLS-1$



    /** The libs container, optional for an add-on. */

    public static final String NODE_LIBS      = "libs";                         //$NON-NLS-1$

    /** A lib element in a libs container. */

    public static final String NODE_LIB       = "lib";                          //$NON-NLS-1$



    /** The path segment, a string, for extra packages. */

    public static final String NODE_PATH      = "path";                         //$NON-NLS-1$



    /** The archives container, for all packages. */

    public static final String NODE_ARCHIVES = "archives";                      //$NON-NLS-1$

    /** An archive element, for the archives container. */

    public static final String NODE_ARCHIVE  = "archive";                       //$NON-NLS-1$



    /** An archive size, an int > 0. */

    public static final String NODE_SIZE     = "size";                          //$NON-NLS-1$

    /** A sha1 archive checksum, as a 40-char hex. */

    public static final String NODE_CHECKSUM = "checksum";                      //$NON-NLS-1$

    /** A download archive URL, either absolute or relative to the repository xml. */

    public static final String NODE_URL      = "url";                           //$NON-NLS-1$



    /** An archive checksum type, mandatory. */

    public static final String ATTR_TYPE = "type";                              //$NON-NLS-1$

    /** An archive OS attribute, mandatory. */

    public static final String ATTR_OS   = "os";                                //$NON-NLS-1$

    /** An optional archive Architecture attribute. */

    public static final String ATTR_ARCH = "arch";                              //$NON-NLS-1$



    /** A license definition ID. */

    public static final String ATTR_ID = "id";                                  //$NON-NLS-1$

    /** A license reference. */

    public static final String ATTR_REF = "ref";                                //$NON-NLS-1$



    /** Type of a sha1 checksum. */

    public static final String SHA1_TYPE = "sha1";                              //$NON-NLS-1$



    /** Length of a string representing a SHA1 checksum; always 40 characters long. */

    public static final int SHA1_CHECKSUM_LEN = 40;



    /**

     * Temporary folder used to hold downloads and extract archives during installation.

     * This folder will be located in the SDK.

     */

    public static final String FD_TEMP = "temp";     //$NON-NLS-1$



    /**

     * Returns a stream to the requested XML Schema.

     * This is an internal helper. Users of the library should call

     * {@link SdkRepoConstants#getXsdStream(String, int)} or

     * {@link SdkAddonConstants#getXsdStream(String, int)}.

     *

     * @param rootElement The root of the filename of the XML schema.

     *   This is by convention the same as the root element declared by the schema.

     * @param version The XML schema revision number, an integer >= 1.

     * @return An {@link InputStream} object for the local XSD file or

     *         null if there is no schema for the requested version.

     * @see SdkRepoConstants#getXsdStream(int)

     * @see SdkAddonConstants#getXsdStream(int)

     */

    protected static InputStream getXsdStream(String rootElement, int version) {

        String filename = String.format("%1$s-%2$d.xsd", rootElement, version);      //$NON-NLS-1$



        InputStream stream = null;

        try {

            stream = RepoConstants.class.getResourceAsStream(filename);

        } catch (Exception e) {

            // Some implementations seem to return null on failure,

            // others throw an exception. We want to return null.

        }

        if (stream == null) {

            // Try the alternate schemas that are not published yet.

            // This allows us to internally test with new schemas before the

            // public repository uses it.

            filename = String.format("-%1$s-%2$d.xsd", rootElement, version);      //$NON-NLS-1$

            try {

                stream = RepoConstants.class.getResourceAsStream(filename);

            } catch (Exception e) {

                // Some implementations seem to return null on failure,

                // others throw an exception. We want to return null.

            }

        }



        return stream;

    }



}