// // System.Xml.Serialization.MapCodeGenerator // // Author: // Lluis Sanchez Gual (lluis@ximian.com) // // Copyright (C) Ximian, Inc., 2003 // using System.CodeDom; using System.Collections; using System.Xml.Schema; namespace System.Xml.Serialization { internal class MapCodeGenerator { CodeNamespace codeNamespace; CodeCompileUnit codeCompileUnit; CodeAttributeDeclarationCollection includeMetadata; bool encodedFormat; Hashtable exportedMaps = new Hashtable (); public MapCodeGenerator (CodeNamespace codeNamespace, CodeCompileUnit codeCompileUnit) { this.codeCompileUnit = codeCompileUnit; this.codeNamespace = codeNamespace; } #region Code generation methods public void ExportMembersMapping (XmlMembersMapping xmlMembersMapping) { CodeTypeDeclaration dummyClass = new CodeTypeDeclaration (); ExportMembersMapCode (dummyClass, (ClassMap)xmlMembersMapping.ObjectMap, xmlMembersMapping.Namespace, null); } public void ExportTypeMapping (XmlTypeMapping xmlTypeMapping) { ExportMapCode (xmlTypeMapping); } void ExportMapCode (XmlTypeMapping map) { switch (map.TypeData.SchemaType) { case SchemaTypes.Enum: ExportEnumCode (map); break; case SchemaTypes.Array: ExportArrayCode (map); break; case SchemaTypes.Class: ExportClassCode (map); break; case SchemaTypes.XmlSerializable: case SchemaTypes.XmlNode: case SchemaTypes.Primitive: // Ignore break; } } void ExportClassCode (XmlTypeMapping map) { if (IsMapExported (map)) return; SetMapExported (map); CodeTypeDeclaration codeClass = new CodeTypeDeclaration (map.TypeData.TypeName); AddCodeType (codeClass, map.Documentation); codeClass.Attributes = MemberAttributes.Public; GenerateClass (map, codeClass); ExportMembersMapCode (codeClass, (ClassMap)map.ObjectMap, map.Namespace, map.BaseMap); if (map.BaseMap != null) { CodeTypeReference ctr = new CodeTypeReference (map.BaseMap.TypeData.FullTypeName); codeClass.BaseTypes.Add (ctr); ExportMapCode (map.BaseMap); } ExportDerivedTypes (map, codeClass); } void ExportDerivedTypes (XmlTypeMapping map, CodeTypeDeclaration codeClass) { foreach (XmlTypeMapping tm in map.DerivedTypes) { GenerateClassInclude (codeClass, tm); ExportMapCode (tm); ExportDerivedTypes (tm, codeClass); } } void ExportMembersMapCode (CodeTypeDeclaration codeClass, ClassMap map, string defaultNamespace, XmlTypeMapping baseMap) { ICollection members = map.ElementMembers; if (members != null) { foreach (XmlTypeMapMemberElement member in members) { if (baseMap != null && DefinedInBaseMap (baseMap, member)) continue; Type memType = member.GetType(); if (memType == typeof(XmlTypeMapMemberList)) { AddArrayElementFieldMember (codeClass, (XmlTypeMapMemberList) member, defaultNamespace); } else if (memType == typeof(XmlTypeMapMemberFlatList)) { AddElementFieldMember (codeClass, member, defaultNamespace); } else if (memType == typeof(XmlTypeMapMemberAnyElement)) { AddAnyElementFieldMember (codeClass, member, defaultNamespace); } else if (memType == typeof(XmlTypeMapMemberElement)) { AddElementFieldMember (codeClass, member, defaultNamespace); } else { throw new InvalidOperationException ("Member type " + memType + " not supported"); } } } // Write attributes ICollection attributes = map.AttributeMembers; if (attributes != null) { foreach (XmlTypeMapMemberAttribute attr in attributes) { if (baseMap != null && DefinedInBaseMap (baseMap, attr)) continue; AddAttributeFieldMember (codeClass, attr, defaultNamespace); } } XmlTypeMapMember anyAttrMember = map.DefaultAnyAttributeMember; if (anyAttrMember != null) { CodeMemberField codeField = new CodeMemberField (anyAttrMember.TypeData.FullTypeName, anyAttrMember.Name); AddComments (codeField, anyAttrMember.Documentation); codeField.Attributes = MemberAttributes.Public; GenerateAnyAttribute (codeField); codeClass.Members.Add (codeField); } } CodeMemberField CreateFieldMember (string type, string name, object defaultValue, string comments) { CodeMemberField codeField = new CodeMemberField (type, name); codeField.Attributes = MemberAttributes.Public; AddComments (codeField, comments); if (defaultValue != System.DBNull.Value) GenerateDefaultAttribute (codeField, defaultValue); return codeField; } void AddAttributeFieldMember (CodeTypeDeclaration codeClass, XmlTypeMapMemberAttribute attinfo, string defaultNamespace) { CodeMemberField codeField = CreateFieldMember (attinfo.TypeData.FullTypeName, attinfo.Name, attinfo.DefaultValue, attinfo.Documentation); codeClass.Members.Add (codeField); GenerateAttributeMember (codeField, attinfo, defaultNamespace); if (attinfo.MappedType != null) ExportMapCode (attinfo.MappedType); } void AddElementFieldMember (CodeTypeDeclaration codeClass, XmlTypeMapMemberElement member, string defaultNamespace) { CodeMemberField codeField = CreateFieldMember (member.TypeData.FullTypeName, member.Name, member.DefaultValue, member.Documentation); codeClass.Members.Add (codeField); TypeData defaultType = member.TypeData; bool addAlwaysAttr = false; if (member is XmlTypeMapMemberFlatList) { defaultType = defaultType.ListItemTypeData; addAlwaysAttr = true; } foreach (XmlTypeMapElementInfo einfo in member.ElementInfo) { if (ExportExtraElementAttributes (codeField, einfo, defaultNamespace, defaultType)) continue; GenerateElementInfoMember (codeField, member, einfo, defaultType, defaultNamespace, addAlwaysAttr); if (einfo.MappedType != null) ExportMapCode (einfo.MappedType); } GenerateElementMember (codeField, member); } void AddAnyElementFieldMember (CodeTypeDeclaration codeClass, XmlTypeMapMemberElement member, string defaultNamespace) { CodeMemberField codeField = CreateFieldMember (member.TypeData.FullTypeName, member.Name, member.DefaultValue, member.Documentation); codeClass.Members.Add (codeField); foreach (XmlTypeMapElementInfo einfo in member.ElementInfo) { ExportExtraElementAttributes (codeField, einfo, defaultNamespace, einfo.TypeData); } } bool DefinedInBaseMap (XmlTypeMapping map, XmlTypeMapMember member) { if (((ClassMap)map.ObjectMap).FindMember (member.Name) != null) return true; else if (map.BaseMap != null) return DefinedInBaseMap (map.BaseMap, member); else return false; } void AddArrayElementFieldMember (CodeTypeDeclaration codeClass, XmlTypeMapMemberList member, string defaultNamespace) { CodeMemberField codeField = new CodeMemberField (member.TypeData.FullTypeName, member.Name); AddComments (codeField, member.Documentation); codeField.Attributes = MemberAttributes.Public; codeClass.Members.Add (codeField); GenerateArrayElement (codeField, member, defaultNamespace); ListMap listMap = (ListMap) member.ListTypeMapping.ObjectMap; AddArrayItemAttributes (codeField, listMap, member.TypeData.ListItemTypeData, defaultNamespace, 0); } void AddArrayItemAttributes (CodeMemberField codeField, ListMap listMap, TypeData type, string defaultNamespace, int nestingLevel) { foreach (XmlTypeMapElementInfo ainfo in listMap.ItemInfo) { string defaultName; if (ainfo.MappedType != null) defaultName = ainfo.MappedType.ElementName; else defaultName = ainfo.TypeData.XmlType; GenerateArrayItemAttributes (codeField, listMap, type, ainfo, defaultName, defaultNamespace, nestingLevel); if (ainfo.MappedType != null) ExportMapCode (ainfo.MappedType); } if (listMap.IsMultiArray) { XmlTypeMapping nmap = listMap.NestedArrayMapping; AddArrayItemAttributes (codeField, (ListMap) nmap.ObjectMap, nmap.TypeData.ListItemTypeData, defaultNamespace, nestingLevel + 1); } } void ExportArrayCode (XmlTypeMapping map) { ListMap listMap = (ListMap) map.ObjectMap; foreach (XmlTypeMapElementInfo ainfo in listMap.ItemInfo) { if (ainfo.MappedType != null) ExportMapCode (ainfo.MappedType); } } bool ExportExtraElementAttributes (CodeMemberField codeField, XmlTypeMapElementInfo einfo, string defaultNamespace, TypeData defaultType) { if (einfo.IsTextElement) { GenerateTextElementAttribute (codeField, einfo, defaultType); return true; } else if (einfo.IsUnnamedAnyElement) { GenerateUnnamedAnyElementAttribute (codeField, einfo, defaultNamespace); return true; } return false; } void ExportEnumCode (XmlTypeMapping map) { if (IsMapExported (map)) return; SetMapExported (map); CodeTypeDeclaration codeEnum = new CodeTypeDeclaration (map.TypeData.TypeName); codeEnum.Attributes = MemberAttributes.Public; codeEnum.IsEnum = true; AddCodeType (codeEnum, map.Documentation); GenerateEnum (map, codeEnum); EnumMap emap = (EnumMap) map.ObjectMap; foreach (EnumMap.EnumMapMember emem in emap.Members) { CodeMemberField codeField = new CodeMemberField ("", emem.EnumName); AddComments (codeField, emem.Documentation); GenerateEnumItem (codeField, emem); codeEnum.Members.Add (codeField); } } #endregion #region Helper methods bool IsMapExported (XmlTypeMapping map) { if (exportedMaps.Contains (map)) return true; if (map.TypeData.Type == typeof(object)) return true; if (!map.IncludeInSchema) return true; return false; } void SetMapExported (XmlTypeMapping map) { exportedMaps.Add (map,map); } public static void AddCustomAttribute (CodeTypeMember ctm, CodeAttributeDeclaration att, bool addIfNoParams) { if (att.Arguments.Count == 0 && !addIfNoParams) return; if (ctm.CustomAttributes == null) ctm.CustomAttributes = new CodeAttributeDeclarationCollection (); ctm.CustomAttributes.Add (att); } public static void AddCustomAttribute (CodeTypeMember ctm, string name, params CodeAttributeArgument[] args) { if (ctm.CustomAttributes == null) ctm.CustomAttributes = new CodeAttributeDeclarationCollection (); ctm.CustomAttributes.Add (new CodeAttributeDeclaration (name, args)); } public static CodeAttributeArgument GetArg (string name, object value) { return new CodeAttributeArgument (name, new CodePrimitiveExpression(value)); } public static CodeAttributeArgument GetArg (object value) { return new CodeAttributeArgument (new CodePrimitiveExpression(value)); } public static CodeAttributeArgument GetTypeArg (string name, string typeName) { return new CodeAttributeArgument (name, new CodeTypeOfExpression(typeName)); } public static void AddComments (CodeTypeMember member, string comments) { if (comments == null || comments == "") member.Comments.Add (new CodeCommentStatement ("", true)); else member.Comments.Add (new CodeCommentStatement ("\n" + comments + "\n", true)); } void AddCodeType (CodeTypeDeclaration type, string comments) { AddComments (type, comments); codeNamespace.Types.Add (type); } #endregion #region Overridable methods protected virtual void GenerateClass (XmlTypeMapping map, CodeTypeDeclaration codeClass) { } protected virtual void GenerateClassInclude (CodeTypeDeclaration codeClass, XmlTypeMapping map) { } protected virtual void GenerateAnyAttribute (CodeMemberField codeField) { } protected virtual void GenerateDefaultAttribute (CodeMemberField codeField, object defaultValue) { } protected virtual void GenerateAttributeMember (CodeMemberField codeField, XmlTypeMapMemberAttribute attinfo, string defaultNamespace) { } protected virtual void GenerateElementInfoMember (CodeMemberField codeField, XmlTypeMapMemberElement member, XmlTypeMapElementInfo einfo, TypeData defaultType, string defaultNamespace, bool addAlwaysAttr) { } protected virtual void GenerateElementMember (CodeMemberField codeField, XmlTypeMapMemberElement member) { } protected virtual void GenerateArrayElement (CodeMemberField codeField, XmlTypeMapMemberElement member, string defaultNamespace) { } protected virtual void GenerateArrayItemAttributes (CodeMemberField codeField, ListMap listMap, TypeData type, XmlTypeMapElementInfo ainfo, string defaultName, string defaultNamespace, int nestingLevel) { } protected virtual void GenerateTextElementAttribute (CodeMemberField codeField, XmlTypeMapElementInfo einfo, TypeData defaultType) { } protected virtual void GenerateUnnamedAnyElementAttribute (CodeMemberField codeField, XmlTypeMapElementInfo einfo, string defaultNamespace) { } protected virtual void GenerateEnum (XmlTypeMapping map, CodeTypeDeclaration codeEnum) { } protected virtual void GenerateEnumItem (CodeMemberField codeField, EnumMap.EnumMapMember emem) { } #endregion } }