/// <summary> /// Register structure info (used when file is not being read) /// </summary> /// <param name="structure">Structure info</param> internal void RegisterStructure(StructureInfo structure) { // crawl all sections foreach (var section in structure.Sections) { // Create section and extract comment var newSection = new InnerSection(section.Name, section.DefaultComment); knownSections.Add(section.Name, newSection); // crawl all options foreach (var option in section.Options) { // Skip optional options if (option.IsOptional) { continue; } // Create option and extract comment var newOption = new InnerOption(option.Name, null); newOption.Comment = option.DefaultComment; newSection.Options.Add(option.Name, newOption); } } }
/// <summary> /// Set option info and it's value. /// NOTE: Only options which are set via this call can be ADDED into output (readed options are included automatically). /// </summary> /// <param name="info">Structure describing option format</param> /// <param name="value">Structure wearing option value</param> internal void SetOption(OptionInfo info, OptionValue value) { // Check inner constraints checkValidity(info, value); // obtain qNames QualifiedSectionName qSect = value.Name.Section; QualifiedOptionName qOpt = value.Name; // Check that section exists if (!knownSections.ContainsKey(qSect)) { throw new ParserException( userMsg: "error, unknown section", developerMsg: "tried to set option in unknown section, sections needs to be retrieved from RegisterStructure() or from the actual file"); } // Ensure option exists if (!knownSections[qSect].Options.ContainsKey(qOpt)) { InnerOption newOpt = new InnerOption(qOpt, null); knownSections[qSect].Options.Add(qOpt, newOpt); newOpt.Comment = info.DefaultComment; } // along the way, check the comment checkOptionCommentAndSeen(info, knownSections); // Pass value into option InnerOption curOpt = knownSections[qSect].Options[qOpt]; IValueConverter converter; try { converter = Converters.ConfigConverters.getConverter(info); } catch (Exception ex) { throw new ParserException(userMsg: "Error when deserializing value", developerMsg: "Unsupported value tried to be deserialized", inner: ex); } if (info.IsContainer) { curOpt.strValues.Clear(); foreach (var elem in ConfigRW.ConfigCreation.StructureFactory.GetContainerElements(value.ConvertedValue)) { curOpt.strValues.Add(converter.Serialize(elem)); } } else { curOpt.strValues.Clear(); curOpt.strValues.Add(converter.Serialize(value.ConvertedValue)); } }
/// <summary> /// Parsing process, processing single trimmed FULL-line as option /// </summary> /// <param name="oneLine">Line to be processed</param> /// <param name="curLine">Current line number, for when exception occurs</param> /// <param name="curSection">Currently processed section</param> /// <param name="knownSections">Dictionary of all pre-parsed sections</param> internal static void processSingleLineAsOption(string oneLine, uint curLine, QualifiedSectionName curSection, Dictionary <QualifiedSectionName, InnerSection> knownSections) { // no section started yet if (curSection == null) { throw new ParserExceptionWithinConfig( userMsg: "Error when parsing file on line " + curLine + " unexpected element outside of section", developerMsg: "Unexpected start of the file on line " + curLine + ", option with no section", line: curLine, section: curSection.ID); } try { Lexer lineLexer = new Lexer(oneLine, knownSections); var lexes = lineLexer.GetLexes(); var lxName = lexes[0]; lexes.RemoveAt(0); if (lxName.Item1 != Lexer.Lexes.T_Identifier) { throw new ParserExceptionWithinConfig( userMsg: "Error when parsing file on line " + curLine, developerMsg: "Lexer process does not provided option identifier", line: curLine, section: curSection.ID); } QualifiedOptionName qName = new QualifiedOptionName(curSection, lxName.Item2); if (knownSections[curSection].Options.ContainsKey(qName)) { throw new ParserExceptionWithinConfig( userMsg: "Error when parsing file on line " + curLine + ", duplicit option", developerMsg: "Duplicit option ID occurred inside this section", line: curLine, section: curSection.ID, option: qName.ID); } InnerOption newOpt = new InnerOption(qName, curLine); knownSections[curSection].Options.Add(qName, newOpt); foreach (var lexeme in lexes) { if (lexeme.Item1 == Lexer.Lexes.T_Comment && lexeme == lexes[lexes.Count - 1]) { newOpt.Comment = lexeme.Item2; } else if (lexeme.Item1 == Lexer.Lexes.T_ValuePart) { newOpt.strValues.Add(lexeme.Item2); } else { throw new ParserExceptionWithinConfig( userMsg: "Error when parsing file on line " + curLine, developerMsg: "unexpected lexeme pop off the lexer", line: curLine, section: curSection.ID, option: qName.ID); } } } catch (ParserException ex) { throw new ParserExceptionWithinConfig( userMsg: "Error when parsing file on line " + curLine, developerMsg: "Exception ocurred in Lexer process", line: curLine, section: curSection.ID, inner: ex); } catch (Exception ex) { throw new ParserExceptionWithinConfig( userMsg: "Error when parsing file on line " + curLine, developerMsg: "Unexpected exception ocurred in Lexer process", line: curLine, section: curSection.ID, inner: ex); } }
/// <summary> /// Extracts value from internal representation into final form /// internal representation existent and provided to the method /// </summary> /// <param name="info">Option for which to extract the value</param> /// <param name="opt">Inner representaiton of desired option with desired value</param> /// <returns>Value in expected format</returns> private static object extractValue(OptionInfo info, InnerOption opt) { // Check container/singleUnit consistenci if (!info.IsContainer && opt.strValues.Count > 1) { throw new ParserExceptionWithinConfig( userMsg: "Error when retrieving expected value for option '{1}::{2}' at line {0}", developerMsg: "internal representation contains more values, while desired is only one for option '{1}::{2}' at line {0}", line: opt.Line, option: info.Name.ID, section: info.Name.Section.ID ); } // Obtain converter IValueConverter convertor; try { convertor = Converters.ConfigConverters.getConverter(info); } catch (Exception ex) { throw new ParserExceptionWithinConfig( userMsg: "Cannot find convertor, possibly due to invalid type specified for option '{1}::{2}' at line {0}", developerMsg: "Convertor retrieving method thrown an exception, possibly due to invalid type specified for option '{1}::{2}' at line {0}", line: opt.Line, option: info.Name.ID, section: info.Name.Section.ID, inner: ex); } // Value extraction try { // Container if (info.IsContainer) { List <object> outElements = new List <object>(); foreach (string value in opt.strValues) { outElements.Add(convertor.Deserialize(value)); } return(ConfigRW.ConfigCreation.StructureFactory.CreateContainer(info, outElements)); } // Single value else { return(convertor.Deserialize(opt.strValues.Count > 0 ? opt.strValues[0] : "")); } } catch (Exception ex) { throw new ParserExceptionWithinConfig( userMsg: "Type conversion failed for container option '{1}::{2}' at line {0}", developerMsg: "An exception occurred during extraction of value from inner representaion for container option '{1}::{2}' at line {0}", line: opt.Line, option: info.Name.ID, section: info.Name.Section.ID, inner: ex); } }