private void WriteConstructorsAndCloneMethod(CodeWriter writer, Schema schema) { WriteSummaryText(writer, "Initializes a new instance."); writer.WriteLine("public {0}CesiumWriter(string propertyName)", schema.NameWithPascalCase); writer.WriteLine(" : base(propertyName)"); writer.OpenScope(); WriteAsTypeLazyInitialization(writer, schema); writer.CloseScope(); writer.WriteLine(); WriteSummaryText(writer, "Initializes a new instance as a copy of an existing instance."); WriteParameterText(writer, "existingInstance", "The existing instance to copy."); writer.WriteLine("protected {0}CesiumWriter({0}CesiumWriter existingInstance)", schema.NameWithPascalCase); writer.WriteLine(" : base(existingInstance)"); writer.OpenScope(); WriteAsTypeLazyInitialization(writer, schema); writer.CloseScope(); writer.WriteLine(); WriteInheritDoc(writer); writer.WriteLine("public override {0}CesiumWriter Clone()", schema.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("return new {0}CesiumWriter(this);", schema.NameWithPascalCase); writer.CloseScope(); writer.WriteLine(); }
private void GeneratePacketWriter(Schema packetSchema) { string packetWriterFilename = Path.Combine(m_outputDirectory, "PacketCesiumWriter.cs"); using (CodeWriter writer = new CodeWriter(packetWriterFilename)) { WriteGeneratedWarning(writer); writer.WriteLine(); WriteNamespaces(writer, packetSchema); writer.WriteLine(); writer.WriteLine("namespace {0}", m_configuration.Namespace); writer.OpenScope(); WriteDescriptionAsClassSummary(writer, packetSchema); writer.WriteLine(m_configuration.Access + " class PacketCesiumWriter : CesiumElementWriter"); writer.OpenScope(); WritePropertyNameConstants(writer, packetSchema); WritePropertyLazyFields(writer, packetSchema); WritePacketOpenClose(writer); WriteProperties(writer, packetSchema); writer.CloseScope(); writer.CloseScope(); } }
private void GenerateWriterClass(Schema schema) { if (m_writtenSchemas.Contains(schema)) return; m_writtenSchemas.Add(schema); string writerFilename = Path.Combine(m_outputDirectory, schema.NameWithPascalCase + "CesiumWriter.cs"); using (CodeWriter writer = new CodeWriter(writerFilename)) { WriteGeneratedWarning(writer); writer.WriteLine(); WriteNamespaces(writer, schema); writer.WriteLine(); writer.WriteLine("namespace {0}", m_configuration.Namespace); writer.OpenScope(); WriteDescriptionAsClassSummary(writer, schema); string defaultValueType = GetDefaultValueType(schema); if (defaultValueType != null) { bool isInterpolatable = schema.Extends != null && schema.Extends.Name == "InterpolatableProperty"; if (isInterpolatable) writer.WriteLine("public class {0}CesiumWriter : CesiumInterpolatableValuePropertyWriter<{1}, {0}CesiumWriter>", schema.NameWithPascalCase, defaultValueType); else writer.WriteLine("public class {0}CesiumWriter : CesiumValuePropertyWriter<{1}, {0}CesiumWriter>", schema.NameWithPascalCase, defaultValueType); } else { writer.WriteLine("public class {0}CesiumWriter : CesiumPropertyWriter<{0}CesiumWriter>", schema.NameWithPascalCase); } writer.OpenScope(); WritePropertyNameConstants(writer, schema); WritePropertyLazyFields(writer, schema); WriteConstructorsAndCloneMethod(writer, schema); WriteProperties(writer, schema); writer.CloseScope(); writer.CloseScope(); } }
private void GenerateWriterClass(Schema schema) { if (m_writtenSchemas.Contains(schema)) { return; } m_writtenSchemas.Add(schema); string writerFilename = Path.Combine(m_outputDirectory, schema.NameWithPascalCase + "CesiumWriter.cs"); using (CodeWriter writer = new CodeWriter(writerFilename)) { WriteGeneratedWarning(writer); writer.WriteLine(); WriteNamespaces(writer, schema); writer.WriteLine(); writer.WriteLine("namespace {0}", m_configuration.Namespace); writer.OpenScope(); WriteDescriptionAsClassSummary(writer, schema); bool isInterpolatable = schema.Extends != null && schema.Extends.Name == "InterpolatableProperty"; if (isInterpolatable) { writer.WriteLine(m_configuration.Access + " class {0}CesiumWriter : CesiumInterpolatablePropertyWriter<{0}CesiumWriter>", schema.NameWithPascalCase); } else { writer.WriteLine(m_configuration.Access + " class {0}CesiumWriter : CesiumPropertyWriter<{0}CesiumWriter>", schema.NameWithPascalCase); } writer.OpenScope(); WritePropertyNameConstants(writer, schema); WritePropertyLazyFields(writer, schema); WriteConstructorsAndCloneMethod(writer, schema); WriteProperties(writer, schema); WriteAsTypeMethods(writer, schema); writer.CloseScope(); writer.CloseScope(); } }
private static void WritePacketOpenClose(CodeWriter writer) { WriteSummaryText(writer, "Writes the start of a new JSON object representing the packet."); writer.WriteLine("protected override void OnOpen()"); writer.OpenScope(); writer.WriteLine("Output.WriteStartObject();"); writer.CloseScope(); writer.WriteLine(); WriteSummaryText(writer, "Writes the end of the JSON object representing the packet."); writer.WriteLine("protected override void OnClose()"); writer.OpenScope(); writer.WriteLine("Output.WriteEndObject();"); writer.CloseScope(); writer.WriteLine(); }
private void WriteLeafProperty(CodeWriter writer, Schema schema, Property property, bool isFirstValueProperty) { OverloadInfo[] overloads = GetOverloadsForProperty(property); foreach (OverloadInfo overload in overloads) { WriteSummaryText(writer, string.Format("Writes the <code>{0}</code> property. The <code>{0}</code> property specifies {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); foreach (ParameterInfo parameter in overload.Parameters) { if (string.IsNullOrEmpty(parameter.Description)) { continue; } WriteParameterText(writer, parameter.Name, parameter.Description); } writer.WriteLine("public void Write{0}({1})", property.NameWithPascalCase, overload.FormattedParameters); writer.OpenScope(); if (overload.CallOverload != null) { writer.WriteLine("Write{0}({1});", property.NameWithPascalCase, overload.CallOverload); } else { writer.WriteLine("const string PropertyName = {0}PropertyName;", property.NameWithPascalCase); if (schema.Name == "Packet") { writer.WriteLine("Output.WritePropertyName(PropertyName);"); } else if (isFirstValueProperty && !overload.NeedsInterval) { // For the first value property only, if an overload is marked // as not needing an interval, because it writes a simple JSON // type (string, number, boolean), we can skip opening an interval // and just write the property value directly. writer.WriteLine("if (IsInterval)"); writer.WriteLine(" Output.WritePropertyName(PropertyName);"); } else { writer.WriteLine("OpenIntervalIfNecessary();"); if (overload.WritePropertyName) { writer.WriteLine("Output.WritePropertyName(PropertyName);"); } } writer.WriteLine(overload.WriteValue); } writer.CloseScope(); writer.WriteLine(); } }
private static void WritePacketOpenClose(CodeWriter writer) { WriteSummaryText(writer, "Writes the start of a new JSON object representing the packet."); writer.WriteLine("protected override void OnOpen()"); writer.OpenScope(); writer.WriteLine("Output.WriteStartObject();"); writer.CloseScope(); writer.WriteLine(); WriteSummaryText(writer, "Writes the end of the JSON object representing the packet."); writer.WriteLine("protected override void OnClose()"); writer.OpenScope(); writer.WriteLine("Output.WriteEndObject();"); writer.CloseScope(); writer.WriteLine(); }
private void GeneratePacketWriter(Schema packetSchema) { string packetWriterFilename = Path.Combine(m_outputDirectory, "PacketCesiumWriter.cs"); using (CodeWriter writer = new CodeWriter(packetWriterFilename)) { WriteGeneratedWarning(writer); writer.WriteLine(); WriteNamespaces(writer, packetSchema); writer.WriteLine(); writer.WriteLine("namespace {0}", m_configuration.Namespace); writer.OpenScope(); WriteDescriptionAsClassSummary(writer, packetSchema); writer.WriteLine("public class PacketCesiumWriter : CesiumElementWriter"); writer.OpenScope(); WritePropertyNameConstants(writer, packetSchema); WritePropertyLazyFields(writer, packetSchema); WritePacketOpenClose(writer); WriteProperties(writer, packetSchema); writer.CloseScope(); writer.CloseScope(); } }
private void WriteAsTypeMethods(CodeWriter writer, Schema schema) { if (schema.Properties == null) return; foreach (Property property in schema.Properties) { if (!property.IsValue) continue; if (PropertyValueIsIntervals(property)) continue; OverloadInfo[] overloads = GetOverloadsForProperty(property); if (overloads[0].Parameters.Length != 1) continue; OverloadInfo sampleOverload = FindSampledDataOverload(overloads); string interfaceName = "ICesiumValuePropertyWriter"; if (sampleOverload != null) interfaceName = "ICesiumInterpolatableValuePropertyWriter"; WriteSummaryText(writer, string.Format("Returns a wrapper for this instance that implements <see cref=\"{0}{{T}}\" /> to write a value in <code>{1}</code> format. Because the returned instance is a wrapper for this instance, you may call <see cref=\"ICesiumElementWriter.Close\" /> on either this instance or the wrapper, but you must not call it on both.", interfaceName, property.NameWithPascalCase)); writer.WriteLine("/// <returns>The wrapper.</returns>"); writer.WriteLine("public {0}<{1}> As{2}()", interfaceName, overloads[0].Parameters[0].Type, property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("return m_as{0}.Value;", property.NameWithPascalCase); writer.CloseScope(); writer.WriteLine(); string adaptorName = "CesiumWriterAdaptor"; if (sampleOverload != null) adaptorName = "CesiumInterpolatableWriterAdaptor"; writer.WriteLine("private {0}<{1}> Create{2}Adaptor()", interfaceName, overloads[0].Parameters[0].Type, property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("return new {0}<{1}CesiumWriter, {2}>(", adaptorName, schema.NameWithPascalCase, overloads[0].Parameters[0].Type); if (sampleOverload != null) { writer.WriteLine(" this, (me, value) => me.Write{0}(value), ({1}CesiumWriter me, IList<JulianDate> dates, IList<{2}> values, int startIndex, int length) => me.Write{0}(dates, values, startIndex, length));", property.NameWithPascalCase, schema.NameWithPascalCase, overloads[0].Parameters[0].Type); } else { writer.WriteLine(" this, (me, value) => me.Write{0}(value));", property.NameWithPascalCase); } writer.CloseScope(); writer.WriteLine(); } }
private void WriteConstructorsAndCloneMethod(CodeWriter writer, Schema schema) { WriteSummaryText(writer, "Initializes a new instance."); writer.WriteLine("public {0}CesiumWriter(string propertyName)", schema.NameWithPascalCase); writer.WriteLine(" : base(propertyName)"); writer.OpenScope(); WriteAsTypeLazyInitialization(writer, schema); writer.CloseScope(); writer.WriteLine(); WriteSummaryText(writer, "Initializes a new instance as a copy of an existing instance."); writer.WriteLine("/// <param name=\"existingInstance\">The existing instance to copy.</param> "); writer.WriteLine("protected {0}CesiumWriter({0}CesiumWriter existingInstance)", schema.NameWithPascalCase); writer.WriteLine(" : base(existingInstance)"); writer.OpenScope(); WriteAsTypeLazyInitialization(writer, schema); writer.CloseScope(); writer.WriteLine(); writer.WriteLine("/// <inheritdoc />"); writer.WriteLine("public override {0}CesiumWriter Clone()", schema.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("return new {0}CesiumWriter(this);", schema.NameWithPascalCase); writer.CloseScope(); writer.WriteLine(); }
private void WriteLeafProperty(CodeWriter writer, Schema schema, Property property, bool isFirstValueProperty) { OverloadInfo[] overloads = GetOverloadsForProperty(property); foreach (OverloadInfo overload in overloads) { WriteSummaryText(writer, string.Format("Writes the <code>{0}</code> property. The <code>{0}</code> property specifies {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); foreach (ParameterInfo parameter in overload.Parameters) { if (string.IsNullOrEmpty(parameter.Description)) continue; WriteParameterText(writer, parameter.Name, parameter.Description); } writer.WriteLine("public void Write{0}({1})", property.NameWithPascalCase, overload.FormattedParameters); writer.OpenScope(); if (overload.CallOverload != null) { writer.WriteLine("Write{0}({1});", property.NameWithPascalCase, overload.CallOverload); } else { writer.WriteLine("const string PropertyName = {0}PropertyName;", property.NameWithPascalCase); if (schema.Name == "Packet") { writer.WriteLine("Output.WritePropertyName(PropertyName);"); } else if (isFirstValueProperty && !overload.NeedsInterval) { // For the first value property only, if an overload is marked // as not needing an interval, because it writes a simple JSON // type (string, number, boolean), we can skip opening an interval // and just write the property value directly. writer.WriteLine("if (IsInterval)"); writer.WriteLine(" Output.WritePropertyName(PropertyName);"); } else { writer.WriteLine("OpenIntervalIfNecessary();"); if (overload.WritePropertyName) writer.WriteLine("Output.WritePropertyName(PropertyName);"); } writer.WriteLine(overload.WriteValue); } writer.CloseScope(); writer.WriteLine(); } }
private void WriteIntervalsProperty(CodeWriter writer, Schema schema, Property property) { GenerateWriterClass(property.ValueType); WriteSummaryText(writer, string.Format("Gets the writer for the <code>{0}</code> property. The returned instance must be opened by calling the <see cref=\"CesiumElementWriter.Open\"/> method before it can be used for writing. The <code>{0}</code> property defines {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); writer.WriteLine("public {0}CesiumWriter {1}Writer", property.ValueType.NameWithPascalCase, property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("get {{ return m_{0}.Value; }}", property.Name); writer.CloseScope(); writer.WriteLine(); WriteSummaryText(writer, string.Format("Opens and returns the writer for the <code>{0}</code> property. The <code>{0}</code> property defines {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); writer.WriteLine("public {0}CesiumWriter Open{1}Property()", property.ValueType.NameWithPascalCase, property.NameWithPascalCase); writer.OpenScope(); if (schema.Name != "Packet") writer.WriteLine("OpenIntervalIfNecessary();"); writer.WriteLine("return OpenAndReturn({0}Writer);", property.NameWithPascalCase); writer.CloseScope(); writer.WriteLine(); if (property.ValueType.Properties != null) { bool isFirstValueProperty = true; foreach (Property nestedProperty in property.ValueType.Properties) { if (!nestedProperty.IsValue) continue; OverloadInfo[] overloads = GetOverloadsForProperty(nestedProperty); foreach (OverloadInfo overload in overloads) { WriteSummaryText(writer, string.Format("Writes a value for the <code>{0}</code> property as a <code>{1}</code> value. The <code>{0}</code> property specifies {2}", property.Name, nestedProperty.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); foreach (ParameterInfo parameter in overload.Parameters) { if (string.IsNullOrEmpty(parameter.Description)) continue; WriteParameterText(writer, parameter.Name, parameter.Description); } string subPropertyName = nestedProperty.NameWithPascalCase; if (subPropertyName == property.NameWithPascalCase || isFirstValueProperty) subPropertyName = ""; writer.WriteLine("public void Write{0}Property{1}({2})", property.NameWithPascalCase, subPropertyName, overload.FormattedParameters); writer.OpenScope(); writer.WriteLine("using (var writer = Open{0}Property())", property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("writer.Write{0}({1});", nestedProperty.NameWithPascalCase, string.Join(", ", Array.ConvertAll(overload.Parameters, p => p.Name))); writer.CloseScope(); writer.CloseScope(); writer.WriteLine(); } isFirstValueProperty = false; } } }
private void WriteAsTypeMethods(CodeWriter writer, Schema schema) { if (schema.Properties == null) { return; } foreach (Property property in schema.Properties) { if (!property.IsValue) { continue; } if (PropertyValueIsIntervals(property)) { continue; } OverloadInfo[] overloads = GetOverloadsForProperty(property); if (overloads[0].Parameters.Length != 1) { continue; } OverloadInfo sampleOverload = FindSampledDataOverload(overloads); string interfaceName = "ICesiumValuePropertyWriter"; if (sampleOverload != null) { interfaceName = "ICesiumInterpolatableValuePropertyWriter"; } WriteSummaryText(writer, string.Format("Returns a wrapper for this instance that implements <see cref=\"{0}{{T}}\" /> to write a value in <code>{1}</code> format. Because the returned instance is a wrapper for this instance, you may call <see cref=\"ICesiumElementWriter.Close\" /> on either this instance or the wrapper, but you must not call it on both.", interfaceName, property.NameWithPascalCase)); WriteReturnsText(writer, "The wrapper."); writer.WriteLine("public {0}<{1}> As{2}()", interfaceName, overloads[0].Parameters[0].Type, property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("return m_as{0}.Value;", property.NameWithPascalCase); writer.CloseScope(); writer.WriteLine(); string adaptorName = "CesiumWriterAdaptor"; if (sampleOverload != null) { adaptorName = "CesiumInterpolatableWriterAdaptor"; } writer.WriteLine("private {0}<{1}> Create{2}Adaptor()", interfaceName, overloads[0].Parameters[0].Type, property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("return new {0}<{1}CesiumWriter, {2}>(", adaptorName, schema.NameWithPascalCase, overloads[0].Parameters[0].Type); if (sampleOverload != null) { writer.WriteLine(" this, (me, value) => me.Write{0}(value), ({1}CesiumWriter me, IList<JulianDate> dates, IList<{2}> values, int startIndex, int length) => me.Write{0}(dates, values, startIndex, length));", property.NameWithPascalCase, schema.NameWithPascalCase, overloads[0].Parameters[0].Type); } else { writer.WriteLine(" this, (me, value) => me.Write{0}(value));", property.NameWithPascalCase); } writer.CloseScope(); writer.WriteLine(); } }
private void WriteIntervalsProperty(CodeWriter writer, Schema schema, Property property) { GenerateWriterClass(property.ValueType); WriteSummaryText(writer, string.Format("Gets the writer for the <code>{0}</code> property. The returned instance must be opened by calling the <see cref=\"CesiumElementWriter.Open\"/> method before it can be used for writing. The <code>{0}</code> property defines {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); writer.WriteLine("public {0}CesiumWriter {1}Writer", property.ValueType.NameWithPascalCase, property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("get {{ return m_{0}.Value; }}", property.Name); writer.CloseScope(); writer.WriteLine(); WriteSummaryText(writer, string.Format("Opens and returns the writer for the <code>{0}</code> property. The <code>{0}</code> property defines {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); writer.WriteLine("public {0}CesiumWriter Open{1}Property()", property.ValueType.NameWithPascalCase, property.NameWithPascalCase); writer.OpenScope(); if (schema.Name != "Packet") { writer.WriteLine("OpenIntervalIfNecessary();"); } writer.WriteLine("return OpenAndReturn({0}Writer);", property.NameWithPascalCase); writer.CloseScope(); writer.WriteLine(); if (property.ValueType.Properties != null) { bool isFirstValueProperty = true; foreach (Property nestedProperty in property.ValueType.Properties) { if (!nestedProperty.IsValue) { continue; } OverloadInfo[] overloads = GetOverloadsForProperty(nestedProperty); foreach (OverloadInfo overload in overloads) { WriteSummaryText(writer, string.Format("Writes a value for the <code>{0}</code> property as a <code>{1}</code> value. The <code>{0}</code> property specifies {2}", property.Name, nestedProperty.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); foreach (ParameterInfo parameter in overload.Parameters) { if (string.IsNullOrEmpty(parameter.Description)) { continue; } WriteParameterText(writer, parameter.Name, parameter.Description); } string subPropertyName = nestedProperty.NameWithPascalCase; if (subPropertyName == property.NameWithPascalCase || isFirstValueProperty) { subPropertyName = ""; } writer.WriteLine("public void Write{0}Property{1}({2})", property.NameWithPascalCase, subPropertyName, overload.FormattedParameters); writer.OpenScope(); writer.WriteLine("using (var writer = Open{0}Property())", property.NameWithPascalCase); writer.OpenScope(); writer.WriteLine("writer.Write{0}({1});", nestedProperty.NameWithPascalCase, string.Join(", ", Array.ConvertAll(overload.Parameters, p => p.Name))); writer.CloseScope(); writer.CloseScope(); writer.WriteLine(); } isFirstValueProperty = false; } } }
public void Dispose() { m_codeWriter.CloseScope(); }
private void WriteLeafProperty(CodeWriter writer, Schema schema, Property property, bool isFirstValueProperty) { OverloadInfo[] overloads = GetOverloadsForProperty(property); foreach (OverloadInfo overload in overloads) { WriteSummaryText(writer, string.Format("Writes the <code>{0}</code> property. The <code>{0}</code> property specifies {1}", property.Name, StringHelper.UncapitalizeFirstLetter(property.Description))); foreach (ParameterInfo parameter in overload.Parameters) { if (string.IsNullOrEmpty(parameter.Description)) continue; WriteParameterText(writer, parameter.Name, parameter.Description); } writer.WriteLine("public void Write{0}({1})", isFirstValueProperty ? "Value" : property.NameWithPascalCase, overload.FormattedParameters); writer.OpenScope(); if (overload.CallOverload != null) { writer.WriteLine("Write{0}({1});", isFirstValueProperty ? "Value" : property.NameWithPascalCase, overload.CallOverload); } else { // First the first value property only, if an overload has one parameter and that // parameter is a simple JSON type (string, number, boolean), we can skip opening an // interval and just write the property value directly. if (isFirstValueProperty && overload.Parameters.Length == 1 && (overload.Parameters[0].Type == "string" || overload.Parameters[0].Type == "double" || overload.Parameters[0].Type == "int" || overload.Parameters[0].Type == "bool")) { writer.WriteLine("if (IsInterval)"); writer.WriteLine(" Output.WritePropertyName({0}PropertyName);", property.NameWithPascalCase); } else { writer.WriteLine("OpenIntervalIfNecessary();"); writer.WriteLine("Output.WritePropertyName({0}PropertyName);", property.NameWithPascalCase); } writer.WriteLine(overload.WriteValue); } writer.CloseScope(); writer.WriteLine(); } }