org.vishia.zbnf

Class GenZbnfJavaData

java.lang.Object

org.vishia.zbnf.GenZbnfJavaData

public class GenZbnfJavaData
extends java.lang.Object

This class is used to generate two Java source files as container for parsed data derived from the zbnf syntax script.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	GenZbnfJavaData.CmdLine The inner class CmdLine helps to evaluate the command line arguments and show help messages on command line.
(package private) static class	GenZbnfJavaData.SubClassZbnf Instances of this class describe a sub class in generated code.
private class	GenZbnfJavaData.WrClassZbnf

Field Summary

Fields

Modifier and Type	Field and Description
private GenJavaOutClass.CmdArgs	cmdArgs Command line args
private GenJavaOutClass	genClass
protected java.util.TreeMap<java.lang.String,ZbnfSyntaxPrescript>	idxSubSyntax All parsed components from ZbnfParser.listSubPrescript.
private MainCmdLogging_ifc	log
static java.lang.String	sVersion Version, history and license.

Constructor Summary

Constructors

Constructor and Description
GenZbnfJavaData(GenJavaOutClass.CmdArgs cmdArgs, MainCmdLogging_ifc log)

Method Summary

Modifier and Type	Method and Description
private void	evaluateSyntax(ZbnfSyntaxPrescript mainScript)
private void	genCmpnClass(GenZbnfJavaData.SubClassZbnf classData) Generate the content of a dst class from a syntax component.
static void	main(java.lang.String[] sArgs) main started from java
void	setAndEvaluateSyntax()
static java.lang.String	smain(java.lang.String[] sArgs) Invocation from another java program without exit the JVM
private static java.lang.String	smain(java.lang.String[] sArgs, boolean shouldExitVM)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

sVersion

public static final java.lang.String sVersion

Version, history and license.

• 2024-05-08 Only adapted changes in GenJavaOutClass
• 2022-06-06 Argument for typeNs prepared, due to GenJavaOutClass change.
• 2022-05-13 Hartmut new: regards #bOnlyOneEach ?& to prevent a container for parse result, only one element.
• 2022-04-30 Hartmut: {<?*semantic>... is a component, on calling WrClassZbnf#wrVariable(SubClassZbnf, String, String, String, String, ZbnfSyntaxPrescript, boolean, boolean, List) called in WrClassZbnf#evaluateChildSyntax(List, SubClassZbnf, boolean, int). There also: regarded there: ZbnfSyntaxPrescript.EType.kStoreSrc
• 2022-02-18 Hartmut: Improvements for basic types, now proper without manual corrections: The typeNs argument should be null for basic types. It is tested. The value of typeNs is yet not used, here some improvement opportunities TODO.
• 2022-02-11 Hartmut only adaptions to changed GenJavaOutClass
• 2022-02-07 Hartmut chg WrClassZbnf#evaluateChildSyntax(List, boolean, int):
  • If ZbnfSyntaxPrescript.bAssignIntoNextComponent is set, this element must not placed in the current class.
  • Instead, in the syntax.zbnf an element <...?+!...> should be defined, not for parsing, only for generating here. See kOnlyMarker
  • semantic = "@", this marker is used to set the semantic from ZbnfSyntaxPrescript.sDefinitionIdent, must regard here, not done in past...?
  • Now ZbnfSyntaxPrescript.RepetitionSyntax.bOnlyOneEachOption is regarded to prevent producing a List for the elements.
• 2022-02-07 Hartmut chg WrClassZbnf#wrVariable(String, String, ZbnfSyntaxPrescript, boolean, boolean, List): better error report.
• 2021-11-25 Hartmut chg {@link CmdLine}: Argument -dirJava:$(ENV)/... can contain now environment variables which are resolved using {@link Arguments#replaceEnv(String)}.
• 2021-11-25 Hartmut chg {@link #evaluateSyntax(ZbnfSyntaxPrescript)} better error message, write what is faulty.
• 2021-11-25 Hartmut chg #evaluateChildSyntax(...) argument item in the moment bad commented.
• 2020-07-16 Hartmut chg using LinkedList instead ArrayList. Question of philosophy.
• 2020-07-16 Hartmut new regard <...?""...> store as String and as parsed data.
• 2019-12-08 new control of class name with component::=<name>
• 2019-12-08 Hartmut only formally gardening (prevent warnings)
• 2019-08-17 Hartmut divided in 2 classes, the {@link GenJavaOutClass} has gotten most content from here, but that class is used from {@link org.vishia.xmlReader.GenXmlCfgJavaData} too with common approaches.
• 2019-05-14 Hartmut creation

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

idxSubSyntax

protected java.util.TreeMap<java.lang.String,ZbnfSyntaxPrescript> idxSubSyntax

All parsed components from ZbnfParser.listSubPrescript.

cmdArgs

private final GenJavaOutClass.CmdArgs cmdArgs

Command line args

log

private final MainCmdLogging_ifc log

genClass

private final GenJavaOutClass genClass

Constructor Detail

GenZbnfJavaData

public GenZbnfJavaData(GenJavaOutClass.CmdArgs cmdArgs,
                       MainCmdLogging_ifc log)

Method Detail

setAndEvaluateSyntax

public void setAndEvaluateSyntax()

evaluateSyntax

private void evaluateSyntax(ZbnfSyntaxPrescript mainScript)

genCmpnClass

private void genCmpnClass(GenZbnfJavaData.SubClassZbnf classData)
                   throws java.lang.Exception

Generate the content of a dst class from a syntax component.

Parameters:

classData - contains syntax

Throws:

java.lang.Exception

main

public static void main(java.lang.String[] sArgs)

main started from java

smain

public static java.lang.String smain(java.lang.String[] sArgs)

Invocation from another java program without exit the JVM

Parameters:

sArgs - same like main(String[])

Returns:

"" or an error String

smain

private static java.lang.String smain(java.lang.String[] sArgs,
                                      boolean shouldExitVM)