[mirror_edk2.git] / Tools / Source / GenBuild / org / tianocore / build / global / Spd.java

/** @file\r
 Spd class.\r
\r
 This class is to generate a global table for the content of spd file.\r
 \r
 Copyright (c) 2006, Intel Corporation\r
 All rights reserved. This program and the accompanying materials\r
 are licensed and made available under the terms and conditions of the BSD License\r
 which accompanies this distribution.  The full text of the license may be found at\r
 http://opensource.org/licenses/bsd-license.php\r
 \r
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
 **/\r
package org.tianocore.build.global;\r
\r
import java.io.File;\r
import java.util.HashMap;\r
import java.util.Iterator;\r
import java.util.Map;\r
import java.util.Set;\r
\r
import org.apache.tools.ant.BuildException;\r
import org.apache.xmlbeans.XmlObject;\r
import org.tianocore.build.id.ModuleIdentification;\r
import org.tianocore.build.id.PackageIdentification;\r
\r
/**\r
 \r
 This class is to generate a global table for the content of spd file.\r
 \r
 **/\r
public class Spd {\r
    ///\r
    ///\r
    ///\r
    Map<ModuleIdentification, File> msaInfo = new HashMap<ModuleIdentification, File>();\r
\r
    ///\r
    /// Map of module info. \r
    /// Key : moduletype\r
    /// Value: moduletype related include file\r
    ///\r
    Map<String, String> packageHeaderInfo = new HashMap<String, String>();\r
\r
    ///\r
    /// Map of PPI info.\r
    /// Key : PPI name\r
    /// value: String[] a. PPI C_NAME; b. PPI GUID;\r
    ///\r
    Map<String, String[]> ppiInfo = new HashMap<String, String[]>();\r
\r
    ///\r
    /// Map of Protocol info.\r
    /// Key : Protocol name\r
    /// value: String[] a. Protocol C_NAME; b. Protocol GUID;\r
    ///\r
    Map<String, String[]> protocolInfo = new HashMap<String, String[]>();\r
\r
    ///\r
    /// Map of Guid info.\r
    /// Key : Guid name\r
    /// value: String[] a. Guid C_NAME; b. Guid's GUID;\r
    ///\r
    Map<String, String[]> guidInfo = new HashMap<String, String[]>();\r
\r
    ///\r
    /// Map of Guid info\r
    /// Key: GuidCName\r
    /// value: String Guid's GUID\r
    ///\r
    Map<String, String> guidCnameInfo = new HashMap<String, String>();\r
    \r
    /// Map of library class and its exposed header file.\r
    /// Key : library class name\r
    /// value : library class corresponding header file\r
    ///\r
    Map<String, String[]> libClassHeaderList = new HashMap<String, String[]>();\r
\r
    ///\r
    /// Package path.\r
    ///\r
    PackageIdentification packageId;\r
\r
    /**\r
     Constructor function\r
     \r
     This function mainly initialize some member variables. \r
    **/\r
    Spd(File packageFile) throws BuildException {\r
        //\r
        // If specified package file not exists\r
        //\r
        if ( ! packageFile.exists()) {\r
            throw new BuildException("Package file [" + packageFile.getPath() + "] does not exist!");\r
        }\r
        try {\r
            XmlObject spdDoc = XmlObject.Factory.parse(packageFile);\r
            //\r
            // Verify SPD file, if is invalid, throw Exception\r
            //\r
            if (! spdDoc.validate()) {\r
                throw new BuildException("Package Surface Area file [" + packageFile.getPath() + "] format is invalid!");\r
            }\r
            // We can change Map to XmlObject\r
            Map<String, XmlObject> spdDocMap = new HashMap<String, XmlObject>();\r
            spdDocMap.put("PackageSurfaceArea", spdDoc);\r
            SurfaceAreaQuery.setDoc(spdDocMap);\r
            //\r
            //\r
            //\r
            packageId = SurfaceAreaQuery.getSpdHeader();\r
            packageId.setSpdFile(packageFile);\r
            \r
            //\r
            // initialize Msa Files\r
            // MSA file is absolute file path\r
            //\r
            String[] msaFilenames = SurfaceAreaQuery.getSpdMsaFile();\r
            for (int i = 0; i < msaFilenames.length; i++){\r
                File msaFile = new File(packageId.getPackageDir() + File.separatorChar + msaFilenames[i]);\r
                Map<String, XmlObject> msaDoc = GlobalData.getNativeMsa( msaFile );\r
                SurfaceAreaQuery.push(msaDoc);\r
                ModuleIdentification moduleId = SurfaceAreaQuery.getMsaHeader();\r
                SurfaceAreaQuery.pop();\r
                moduleId.setPackage(packageId);\r
                moduleId.setMsaFile(msaFile);\r
                if (msaInfo.containsKey(moduleId)) {\r
                    throw new BuildException("Found two modules with the same GUID and Version in package " + packageId + ".\nThey are  module [" + msaInfo.get(moduleId) + "] and MSA file [" + msaFile + "]!");\r
                }\r
                msaInfo.put(moduleId, msaFile);\r
            }\r
            \r
            //\r
            // initialize Package header files\r
            //\r
            Map<String, String> packageHeaders = SurfaceAreaQuery.getSpdPackageHeaderFiles();\r
            Set keys = packageHeaders.keySet();\r
            Iterator iter = keys.iterator();\r
            while (iter.hasNext()){\r
                String moduleType = (String)iter.next();\r
                String header = packageId.getPackageRelativeDir() + File.separatorChar + packageHeaders.get(moduleType);\r
                \r
                //\r
                // Change path seperator to system-dependent path separator\r
                //\r
                File file = new File (header);\r
                header = file.getPath();\r
                packageHeaderInfo.put(moduleType, header);\r
            }\r
            \r
            //\r
            // initialize Guid Info\r
            //\r
            guidInfo.putAll(SurfaceAreaQuery.getSpdGuid());\r
            \r
            //\r
            // For Pcd get TokenSpaceGuid\r
            //\r
            Set<String> key = guidInfo.keySet();\r
            Iterator item = key.iterator();\r
            String [] nameValue = new String[2];\r
            while(item.hasNext()){\r
                nameValue = guidInfo.get(item.next());\r
                guidCnameInfo.put(nameValue[0], nameValue[1]);\r
            }\r
            \r
            //\r
            // initialize PPI info\r
            //\r
            ppiInfo.putAll(SurfaceAreaQuery.getSpdPpi());\r
            \r
            //\r
            // initialize Protocol info\r
            //\r
            protocolInfo.putAll(SurfaceAreaQuery.getSpdProtocol());\r
            \r
            //\r
            // initialize library class declaration\r
            //\r
            Map<String, String[]> libraryClassHeaders = SurfaceAreaQuery.getSpdLibraryClasses();\r
            keys = libraryClassHeaders.keySet();\r
            iter = keys.iterator();\r
            while (iter.hasNext()){\r
                String libraryClassName = (String)iter.next();\r
                String[] headerFiles = libraryClassHeaders.get(libraryClassName);\r
                for (int i = 0; i < headerFiles.length; i++){\r
                    headerFiles[i] = packageId.getPackageRelativeDir() + File.separatorChar + headerFiles[i];\r
                    \r
                    //\r
                    // Change path separator to system system-dependent path separator. \r
                    //\r
                    File file = new File (headerFiles[i]);\r
                    headerFiles[i] = file.getPath();\r
                }\r
                libClassHeaderList.put(libraryClassName, headerFiles);\r
            }\r
        }\r
        catch (Exception e) {\r
            throw new BuildException("Parse of the package description file [" + packageFile.getPath() + "] failed!\n"\r
                                     + e.getMessage());\r
        }\r
    }\r
\r
    public PackageIdentification getPackageId() {\r
        return packageId;\r
    }\r
\r
    public File getModuleFile(ModuleIdentification moduleId) {\r
        return msaInfo.get(moduleId);\r
    }\r
    \r
    public Set<ModuleIdentification> getModules(){\r
        return msaInfo.keySet();\r
    }\r
\r
    /**\r
       return two value {CName, Guid}. If not found, return null.\r
     **/\r
    public String[] getPpi(String ppiName) {\r
        return ppiInfo.get(ppiName);\r
    }\r
\r
    /**\r
        return two value {CName, Guid}. If not found, return null.\r
    **/\r
    public String[] getProtocol(String protocolName) {\r
        return protocolInfo.get(protocolName);\r
    }\r
\r
    /**\r
      return two value {CName, Guid}. If not found, return null.\r
    **/\r
    public String[] getGuid(String guidName) {\r
        return guidInfo.get(guidName);\r
    }\r
\r
    /**\r
     * return Guid Value. \r
     */\r
    public String getGuidFromCname(String cName){\r
        return guidCnameInfo.get(cName);\r
    }\r
    \r
    /**\r
     getLibClassInclude \r
     \r
     This function is to get the library exposed header file name according \r
     library class name.\r
     \r
     @param     libName    Name of library class   \r
     @return               Name of header file\r
    **/\r
    String[] getLibClassIncluder(String libName) {\r
        return libClassHeaderList.get(libName);\r
    }\r
\r
    /**\r
      getModuleTypeIncluder\r
    \r
      This function is to get the header file name from module info map \r
      according to module type.\r
    \r
      @param   moduleType    Module type.\r
      @return                Name of header file.\r
    **/\r
    String getPackageIncluder(String moduleType) {\r
        return packageHeaderInfo.get(moduleType);\r
    }\r
    \r
\r
}\r
Commit	Line	Data
	1	/** @file\r
	2	Spd class.\r
	3	\r
	4	This class is to generate a global table for the content of spd file.\r
	5	\r
	6	Copyright (c) 2006, Intel Corporation\r
	7	All rights reserved. This program and the accompanying materials\r
	8	are licensed and made available under the terms and conditions of the BSD License\r
	9	which accompanies this distribution. The full text of the license may be found at\r
	10	http://opensource.org/licenses/bsd-license.php\r
	11	\r
	12	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	13	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	14	\r
	15	**/\r
	16	package org.tianocore.build.global;\r
	17	\r
	18	import java.io.File;\r
	19	import java.util.HashMap;\r
	20	import java.util.Iterator;\r
	21	import java.util.Map;\r
	22	import java.util.Set;\r
	23	\r
	24	import org.apache.tools.ant.BuildException;\r
	25	import org.apache.xmlbeans.XmlObject;\r
	26	import org.tianocore.build.id.ModuleIdentification;\r
	27	import org.tianocore.build.id.PackageIdentification;\r
	28	\r
	29	/**\r
	30	\r
	31	This class is to generate a global table for the content of spd file.\r
	32	\r
	33	**/\r
	34	public class Spd {\r
	35	///\r
	36	///\r
	37	///\r
	38	Map<ModuleIdentification, File> msaInfo = new HashMap<ModuleIdentification, File>();\r
	39	\r
	40	///\r
	41	/// Map of module info. \r
	42	/// Key : moduletype\r
	43	/// Value: moduletype related include file\r
	44	///\r
	45	Map<String, String> packageHeaderInfo = new HashMap<String, String>();\r
	46	\r
	47	///\r
	48	/// Map of PPI info.\r
	49	/// Key : PPI name\r
	50	/// value: String[] a. PPI C_NAME; b. PPI GUID;\r
	51	///\r
	52	Map<String, String[]> ppiInfo = new HashMap<String, String[]>();\r
	53	\r
	54	///\r
	55	/// Map of Protocol info.\r
	56	/// Key : Protocol name\r
	57	/// value: String[] a. Protocol C_NAME; b. Protocol GUID;\r
	58	///\r
	59	Map<String, String[]> protocolInfo = new HashMap<String, String[]>();\r
	60	\r
	61	///\r
	62	/// Map of Guid info.\r
	63	/// Key : Guid name\r
	64	/// value: String[] a. Guid C_NAME; b. Guid's GUID;\r
	65	///\r
	66	Map<String, String[]> guidInfo = new HashMap<String, String[]>();\r
	67	\r
	68	///\r
	69	/// Map of Guid info\r
	70	/// Key: GuidCName\r
	71	/// value: String Guid's GUID\r
	72	///\r
	73	Map<String, String> guidCnameInfo = new HashMap<String, String>();\r
	74	\r
	75	/// Map of library class and its exposed header file.\r
	76	/// Key : library class name\r
	77	/// value : library class corresponding header file\r
	78	///\r
	79	Map<String, String[]> libClassHeaderList = new HashMap<String, String[]>();\r
	80	\r
	81	///\r
	82	/// Package path.\r
	83	///\r
	84	PackageIdentification packageId;\r
	85	\r
	86	/**\r
	87	Constructor function\r
	88	\r
	89	This function mainly initialize some member variables. \r
	90	**/\r
	91	Spd(File packageFile) throws BuildException {\r
	92	//\r
	93	// If specified package file not exists\r
	94	//\r
	95	if ( ! packageFile.exists()) {\r
	96	throw new BuildException("Package file [" + packageFile.getPath() + "] does not exist!");\r
	97	}\r
	98	try {\r
	99	XmlObject spdDoc = XmlObject.Factory.parse(packageFile);\r
	100	//\r
	101	// Verify SPD file, if is invalid, throw Exception\r
	102	//\r
	103	if (! spdDoc.validate()) {\r
	104	throw new BuildException("Package Surface Area file [" + packageFile.getPath() + "] format is invalid!");\r
	105	}\r
	106	// We can change Map to XmlObject\r
	107	Map<String, XmlObject> spdDocMap = new HashMap<String, XmlObject>();\r
	108	spdDocMap.put("PackageSurfaceArea", spdDoc);\r
	109	SurfaceAreaQuery.setDoc(spdDocMap);\r
	110	//\r
	111	//\r
	112	//\r
	113	packageId = SurfaceAreaQuery.getSpdHeader();\r
	114	packageId.setSpdFile(packageFile);\r
	115	\r
	116	//\r
	117	// initialize Msa Files\r
	118	// MSA file is absolute file path\r
	119	//\r
	120	String[] msaFilenames = SurfaceAreaQuery.getSpdMsaFile();\r
	121	for (int i = 0; i < msaFilenames.length; i++){\r
	122	File msaFile = new File(packageId.getPackageDir() + File.separatorChar + msaFilenames[i]);\r
	123	Map<String, XmlObject> msaDoc = GlobalData.getNativeMsa( msaFile );\r
	124	SurfaceAreaQuery.push(msaDoc);\r
	125	ModuleIdentification moduleId = SurfaceAreaQuery.getMsaHeader();\r
	126	SurfaceAreaQuery.pop();\r
	127	moduleId.setPackage(packageId);\r
	128	moduleId.setMsaFile(msaFile);\r
	129	if (msaInfo.containsKey(moduleId)) {\r
	130	throw new BuildException("Found two modules with the same GUID and Version in package " + packageId + ".\nThey are module [" + msaInfo.get(moduleId) + "] and MSA file [" + msaFile + "]!");\r
	131	}\r
	132	msaInfo.put(moduleId, msaFile);\r
	133	}\r
	134	\r
	135	//\r
	136	// initialize Package header files\r
	137	//\r
	138	Map<String, String> packageHeaders = SurfaceAreaQuery.getSpdPackageHeaderFiles();\r
	139	Set keys = packageHeaders.keySet();\r
	140	Iterator iter = keys.iterator();\r
	141	while (iter.hasNext()){\r
	142	String moduleType = (String)iter.next();\r
	143	String header = packageId.getPackageRelativeDir() + File.separatorChar + packageHeaders.get(moduleType);\r
	144	\r
	145	//\r
	146	// Change path seperator to system-dependent path separator\r
	147	//\r
	148	File file = new File (header);\r
	149	header = file.getPath();\r
	150	packageHeaderInfo.put(moduleType, header);\r
	151	}\r
	152	\r
	153	//\r
	154	// initialize Guid Info\r
	155	//\r
	156	guidInfo.putAll(SurfaceAreaQuery.getSpdGuid());\r
	157	\r
	158	//\r
	159	// For Pcd get TokenSpaceGuid\r
	160	//\r
	161	Set<String> key = guidInfo.keySet();\r
	162	Iterator item = key.iterator();\r
	163	String [] nameValue = new String[2];\r
	164	while(item.hasNext()){\r
	165	nameValue = guidInfo.get(item.next());\r
	166	guidCnameInfo.put(nameValue[0], nameValue[1]);\r
	167	}\r
	168	\r
	169	//\r
	170	// initialize PPI info\r
	171	//\r
	172	ppiInfo.putAll(SurfaceAreaQuery.getSpdPpi());\r
	173	\r
	174	//\r
	175	// initialize Protocol info\r
	176	//\r
	177	protocolInfo.putAll(SurfaceAreaQuery.getSpdProtocol());\r
	178	\r
	179	//\r
	180	// initialize library class declaration\r
	181	//\r
	182	Map<String, String[]> libraryClassHeaders = SurfaceAreaQuery.getSpdLibraryClasses();\r
	183	keys = libraryClassHeaders.keySet();\r
	184	iter = keys.iterator();\r
	185	while (iter.hasNext()){\r
	186	String libraryClassName = (String)iter.next();\r
	187	String[] headerFiles = libraryClassHeaders.get(libraryClassName);\r
	188	for (int i = 0; i < headerFiles.length; i++){\r
	189	headerFiles[i] = packageId.getPackageRelativeDir() + File.separatorChar + headerFiles[i];\r
	190	\r
	191	//\r
	192	// Change path separator to system system-dependent path separator. \r
	193	//\r
	194	File file = new File (headerFiles[i]);\r
	195	headerFiles[i] = file.getPath();\r
	196	}\r
	197	libClassHeaderList.put(libraryClassName, headerFiles);\r
	198	}\r
	199	}\r
	200	catch (Exception e) {\r
	201	throw new BuildException("Parse of the package description file [" + packageFile.getPath() + "] failed!\n"\r
	202	+ e.getMessage());\r
	203	}\r
	204	}\r
	205	\r
	206	public PackageIdentification getPackageId() {\r
	207	return packageId;\r
	208	}\r
	209	\r
	210	public File getModuleFile(ModuleIdentification moduleId) {\r
	211	return msaInfo.get(moduleId);\r
	212	}\r
	213	\r
	214	public Set<ModuleIdentification> getModules(){\r
	215	return msaInfo.keySet();\r
	216	}\r
	217	\r
	218	/**\r
	219	return two value {CName, Guid}. If not found, return null.\r
	220	**/\r
	221	public String[] getPpi(String ppiName) {\r
	222	return ppiInfo.get(ppiName);\r
	223	}\r
	224	\r
	225	/**\r
	226	return two value {CName, Guid}. If not found, return null.\r
	227	**/\r
	228	public String[] getProtocol(String protocolName) {\r
	229	return protocolInfo.get(protocolName);\r
	230	}\r
	231	\r
	232	/**\r
	233	return two value {CName, Guid}. If not found, return null.\r
	234	**/\r
	235	public String[] getGuid(String guidName) {\r
	236	return guidInfo.get(guidName);\r
	237	}\r
	238	\r
	239	/**\r
	240	* return Guid Value. \r
	241	*/\r
	242	public String getGuidFromCname(String cName){\r
	243	return guidCnameInfo.get(cName);\r
	244	}\r
	245	\r
	246	/**\r
	247	getLibClassInclude \r
	248	\r
	249	This function is to get the library exposed header file name according \r
	250	library class name.\r
	251	\r
	252	@param libName Name of library class \r
	253	@return Name of header file\r
	254	**/\r
	255	String[] getLibClassIncluder(String libName) {\r
	256	return libClassHeaderList.get(libName);\r
	257	}\r
	258	\r
	259	/**\r
	260	getModuleTypeIncluder\r
	261	\r
	262	This function is to get the header file name from module info map \r
	263	according to module type.\r
	264	\r
	265	@param moduleType Module type.\r
	266	@return Name of header file.\r
	267	**/\r
	268	String getPackageIncluder(String moduleType) {\r
	269	return packageHeaderInfo.get(moduleType);\r
	270	}\r
	271	\r
	272	\r
	273	}\r