Files
Marc Schier 4756e7c245 DI (OPC 10000-100) with samples (Pump, SW Update), fluent API gap closures and model dependency implementation (#3808)
This PR implements the **OPC UA Device Integration (DI, OPC 10000-100)**
companion-spec library trio (`Opc.Ua.Di` / `Opc.Ua.Di.Server` /
`Opc.Ua.Di.Client`) plus a worked example
(`Applications/MinimalPumpServer`) demonstrating the OPC 40223 Pumps
companion specification end-to-end with full simulation. It also closes
11 fluent-API gaps in `Opc.Ua.Server.Fluent`, three source-generator
bugs, integrates the DI layer into the unified `services.AddOpcUa()`
Microsoft.Extensions DI hosting pattern, and adds 250+ new tests.

**Worked example — `Applications/MinimalPumpServer/`**
- AOT-compatible console host using `Host.CreateApplicationBuilder` +
`AddOpcUa()`.
- `PumpNodeManager` inherits from `DiNodeManager`; multi-namespace (DI +
Machinery + Pumps) via runtime NodeSet2 loading and
`ModelLoaderBuilder`.
- Demonstrates declarative second-pump creation via
`.ConfigureDevicesFor<PumpNodeManager>(...)` and software-package
seeding from the same configurator.
- Full simulation: pressure, temperatures, power, flow, efficiency,
level, cavitation/overheat fault injection, alarm setup, NAMUR-style
supervision.

**Documentation**
- `Docs/Opc.Ua.Di/` — README, DeviceBuilder, Hosting, LockService,
SoftwareUpdate, ClientHelpers (6 new developer guides).
- `Docs/Opc.Ua.Di/ComplianceMatrix.md` — every DI declaration mapped to
In-v1 / Generated / Deferred / Excluded.
- `Docs/CompanionSpecLibraries.md` — packaging guide for new
companion-spec libraries.
- `Docs/FluentApiGaps.md` — historical record of G1–G11.
- `Docs/SourceGeneratedNodeManagers.md` updated for richer node
managers.
- `Docs/plans/StateMachineBuilder.md` — deferred state-machine builder
design.
2026-06-04 05:57:57 +02:00

235 lines
16 KiB
C#

/* ========================================================================
* Copyright (c) 2005-2025 The OPC Foundation, Inc. All rights reserved.
*
* OPC Foundation MIT License 1.00
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* The complete license agreement can be found here:
* http://opcfoundation.org/License/MIT/1.00/
* ======================================================================*/
namespace Opc.Ua.SourceGeneration
{
internal static class Tokens
{
public static string ArrayDimensions => nameof(ArrayDimensions);
public static string BaseClassName => nameof(BaseClassName);
public static string BaseInterfaces => nameof(BaseInterfaces);
public static string BaseType => nameof(BaseType);
public static string BaseTypeNamespacePrefix => nameof(BaseTypeNamespacePrefix);
public static string BaseTypeNamespaceUri => nameof(BaseTypeNamespaceUri);
public static string BinaryEncodingId => nameof(BinaryEncodingId);
public static string BrowseName => nameof(BrowseName);
public static string BrowseNameNamespacePrefix => nameof(BrowseNameNamespacePrefix);
public static string BrowseNameNamespaceUri => nameof(BrowseNameNamespaceUri);
public static string BrowseNameSymbol => nameof(BrowseNameSymbol);
public static string SymbolicNameSymbol => nameof(SymbolicNameSymbol);
public static string BuiltInTypes => nameof(BuiltInTypes);
public static string ChildDataType => nameof(ChildDataType);
public static string ValueWrite => nameof(ValueWrite);
public static string ValueComparison => nameof(ValueComparison);
public static string ChildName => nameof(ChildName);
public static string ChildBrowseName => nameof(ChildBrowseName);
public static string ChildPath => nameof(ChildPath);
public static string ClassName => nameof(ClassName);
public static string ClassFactory => nameof(ClassFactory);
public static string ClientApi => nameof(ClientApi);
public static string ClientMethod => nameof(ClientMethod);
public static string CodeName => nameof(CodeName);
public static string CollectionType => nameof(CollectionType);
public static string DataType => nameof(DataType);
public static string StructureType => nameof(StructureType);
public static string FirstExplicitFieldIndex => nameof(FirstExplicitFieldIndex);
public static string DataTypeNamespacePrefix => nameof(DataTypeNamespacePrefix);
public static string DataTypeNamespaceUri => nameof(DataTypeNamespaceUri);
public static string DefaultValue => nameof(DefaultValue);
public static string Description => nameof(Description);
public static string DictionaryUri => nameof(DictionaryUri);
public static string Documentation => nameof(Documentation);
public static string EmitDefaultValue => nameof(EmitDefaultValue);
public static string EncodingMaskModifier => nameof(EncodingMaskModifier);
public static string EnumerationName => nameof(EnumerationName);
public static string EventNotifier => nameof(EventNotifier);
public static string FieldIndex => nameof(FieldIndex);
public static string ExtraInterfaces => nameof(ExtraInterfaces);
public static string FieldName => nameof(FieldName);
public static string ListOfChildOperations => nameof(ListOfChildOperations);
public static string Historizing => nameof(Historizing);
public static string Identifier => nameof(Identifier);
public static string IdType => nameof(IdType);
public static string Imports => nameof(Imports);
public static string InitializeOptionalChildren => nameof(InitializeOptionalChildren);
public static string InvokeServiceAsync => nameof(InvokeServiceAsync);
public static string Purpose => nameof(Purpose);
public static string IsAbstract => nameof(IsAbstract);
public static string IsOptionSet => nameof(IsOptionSet);
public static string IsRequired => nameof(IsRequired);
public static string LengthInBits => nameof(LengthInBits);
public static string ListOfBrowseNames => nameof(ListOfBrowseNames);
public static string ListOfChildInitializers => nameof(ListOfChildInitializers);
public static string ListOfChildMethods => nameof(ListOfChildMethods);
public static string ListOfClonedFields => nameof(ListOfClonedFields);
public static string ListOfAppendStringFields => nameof(ListOfAppendStringFields);
public static string ListOfComparedFields => nameof(ListOfComparedFields);
public static string ListOfDecodedFields => nameof(ListOfDecodedFields);
public static string ListOfEncodedFields => nameof(ListOfEncodedFields);
public static string ListOfEncodingMaskFields => nameof(ListOfEncodingMaskFields);
public static string ListOfFieldInitializers => nameof(ListOfFieldInitializers);
public static string ListOfFields => nameof(ListOfFields);
public static string ListOfSwitchFieldNames => nameof(ListOfSwitchFieldNames);
public static string ListOfEncodingMaskFieldNames => nameof(ListOfEncodingMaskFieldNames);
public static string ListOfFindChildCase => nameof(ListOfFindChildCase);
public static string ListOfFindChildren => nameof(ListOfFindChildren);
public static string ListOfIdentifiers => nameof(ListOfIdentifiers);
public static string ListOfIdentifersToNames => nameof(ListOfIdentifersToNames);
public static string ListOfNamesToIdentifiers => nameof(ListOfNamesToIdentifiers);
public static string ListOfImports => nameof(ListOfImports);
public static string ListOfInputArguments => nameof(ListOfInputArguments);
public static string ListOfNamespaceUris => nameof(ListOfNamespaceUris);
public static string ListOfNodeIds => nameof(ListOfNodeIds);
public static string ListOfOutputArguments => nameof(ListOfOutputArguments);
public static string ListOfOutputArgumentsFromResult => nameof(ListOfOutputArgumentsFromResult);
public static string ListOfOutputDeclarations => nameof(ListOfOutputDeclarations);
public static string ListOfProperties => nameof(ListOfProperties);
public static string ListOfNonMandatoryChildren => nameof(ListOfNonMandatoryChildren);
public static string ListOfRemoveChild => nameof(ListOfRemoveChild);
public static string ListOfChildCopies => nameof(ListOfChildCopies);
public static string ListOfChildHashes => nameof(ListOfChildHashes);
public static string ListOfEqualityComparers => nameof(ListOfEqualityComparers);
public static string ListOfCreateOrReplaceChild => nameof(ListOfCreateOrReplaceChild);
public static string ListOfResultProperties => nameof(ListOfResultProperties);
public static string ListOfSwitchFields => nameof(ListOfSwitchFields);
public static string ListOfTypes => nameof(ListOfTypes);
public static string ListOfTypeActivators => nameof(ListOfTypeActivators);
public static string ListOfDataTypeDefinitions => nameof(ListOfDataTypeDefinitions);
public static string ListOfUpdateChildrenChangeMasks => nameof(ListOfUpdateChildrenChangeMasks);
public static string ListOfValues => nameof(ListOfValues);
public static string ListOfActivatorRegistrations => nameof(ListOfActivatorRegistrations);
public static string ListOfChildren => nameof(ListOfChildren);
public static string MethodList => nameof(MethodList);
public static string Name => nameof(Name);
public static string IsOptional => nameof(IsOptional);
public static string Namespace => nameof(Namespace);
public static string NamespacePrefix => nameof(NamespacePrefix);
public static string NamespaceUri => nameof(NamespaceUri);
public static string NodeManagerClassName => nameof(NodeManagerClassName);
public static string NodeManagerFactoryClassName => nameof(NodeManagerFactoryClassName);
public static string Nillable => nameof(Nillable);
public static string NodeClass => nameof(NodeClass);
public static string OnCallAsyncDeclaration => nameof(OnCallAsyncDeclaration);
public static string OnCallAsyncImplementation => nameof(OnCallAsyncImplementation);
public static string OnCallDeclaration => nameof(OnCallDeclaration);
public static string OnCallImplementation => nameof(OnCallImplementation);
public static string Prefix => nameof(Prefix);
public static string PropertyName => nameof(PropertyName);
public static string RequestParameters => nameof(RequestParameters);
public static string ResponseParameters => nameof(ResponseParameters);
public static string ServerApi => nameof(ServerApi);
public static string ServerStubs => nameof(ServerStubs);
public static string ServiceSet => nameof(ServiceSet);
public static string ServiceSets => nameof(ServiceSets);
public static string SymbolicId => nameof(SymbolicId);
public static string SymbolicName => nameof(SymbolicName);
public static string TypedVariableType => nameof(TypedVariableType);
public static string TypeName => nameof(TypeName);
public static string ValueRank => nameof(ValueRank);
public static string VariableTypeValue => nameof(VariableTypeValue);
public static string Version => nameof(Version);
public static string Tool => nameof(Tool);
public static string XmlEncodingId => nameof(XmlEncodingId);
public static string VariantFrom => nameof(VariantFrom);
public static string VariantTryGet => nameof(VariantTryGet);
public static string XmlIdentifier => nameof(XmlIdentifier);
public static string XmlNamespaceUri => nameof(XmlNamespaceUri);
public static string XmlnsS0ListOfNamespaces => nameof(XmlnsS0ListOfNamespaces);
public static string TypeList => nameof(TypeList);
public static string BasicType => nameof(BasicType);
public static string Flags => nameof(Flags);
public static string AddKnownType => nameof(AddKnownType);
public static string ModelUri => nameof(ModelUri);
public static string TargetPublicationDate => nameof(TargetPublicationDate);
public static string TargetVersion => nameof(TargetVersion);
public static string BaseT => nameof(BaseT);
public static string XsRestrictionBaseType => nameof(XsRestrictionBaseType);
public static string AccessorSymbol => nameof(AccessorSymbol);
public static string ServerMethodAsync => nameof(ServerMethodAsync);
public static string ClientMethodAsync => nameof(ClientMethodAsync);
public static string ClientMethodSync => nameof(ClientMethodSync);
public static string ClientMethodBegin => nameof(ClientMethodBegin);
public static string ClientMethodEnd => nameof(ClientMethodEnd);
public static string CodeHeader => nameof(CodeHeader);
public static string XmlHeader => nameof(XmlHeader);
public static string ResourceName => nameof(ResourceName);
public static string Resource => nameof(Resource);
public static string ListOfResourceGroups => nameof(ListOfResourceGroups);
public static string ListOfResourceDeclarations => nameof(ListOfResourceDeclarations);
public static string ListOfModelDependencies => nameof(ListOfModelDependencies);
public static string ModelVersion => nameof(ModelVersion);
public static string ModelPublicationDate => nameof(ModelPublicationDate);
public static string ModelName => nameof(ModelName);
public static string ModelPayload => nameof(ModelPayload);
public static string AccessModifier => nameof(AccessModifier);
public static string IdentifierReflection => nameof(IdentifierReflection);
public static string ListOfNodeStateInitializers => nameof(ListOfNodeStateInitializers);
public static string ListOfNodeStateTypeFactories => nameof(ListOfNodeStateTypeFactories);
public static string ListOfNodeStateInstanceFactories => nameof(ListOfNodeStateInstanceFactories);
public static string ListOfChildNodeStates => nameof(ListOfChildNodeStates);
public static string ListOfOptionalChildNodeStates => nameof(ListOfOptionalChildNodeStates);
public static string ListOfReferences => nameof(ListOfReferences);
public static string NodeIdConstant => nameof(NodeIdConstant);
public static string SuperTypeId => nameof(SuperTypeId);
public static string TypeDefinitionId => nameof(TypeDefinitionId);
public static string ReferenceTypeId => nameof(ReferenceTypeId);
public static string ModellingRuleId => nameof(ModellingRuleId);
public static string StateClassName => nameof(StateClassName);
public static string StateClassFactory => nameof(StateClassFactory);
public static string DisplayName => nameof(DisplayName);
public static string DataTypeDefinition => nameof(DataTypeDefinition);
public static string DescriptionValue => nameof(DescriptionValue);
public static string ValueCode => nameof(ValueCode);
public static string DataTypeIdConstant => nameof(DataTypeIdConstant);
public static string InverseNameValue => nameof(InverseNameValue);
public static string SymmetricValue => nameof(SymmetricValue);
public static string ReleaseStatusValue => nameof(ReleaseStatusValue);
public static string CategoriesValue => nameof(CategoriesValue);
public static string SpecificationValue => nameof(SpecificationValue);
public static string WriteMaskValue => nameof(WriteMaskValue);
public static string UserWriteMaskValue => nameof(UserWriteMaskValue);
public static string NumericIdValue => nameof(NumericIdValue);
public static string AccessRestrictionsValue => nameof(AccessRestrictionsValue);
public static string ListOfRolePermissions => nameof(ListOfRolePermissions);
public static string RoleIdConstant => nameof(RoleIdConstant);
public static string PermissionsValue => nameof(PermissionsValue);
public static string ContainsNoLoopsValue => nameof(ContainsNoLoopsValue);
public static string ExecutableValue => nameof(ExecutableValue);
public static string MethodDeclarationId => nameof(MethodDeclarationId);
public static string MinimumSamplingIntervalValue => nameof(MinimumSamplingIntervalValue);
public static string HistorizingValue => nameof(HistorizingValue);
public static string AccessLevelValue => nameof(AccessLevelValue);
public static string UserAccessLevelValue => nameof(UserAccessLevelValue);
public static string ListOfInitOnlyBackingFields => nameof(ListOfInitOnlyBackingFields);
public static string ListOfPooledExtensions => nameof(ListOfPooledExtensions);
public static string ListOfFieldResets => nameof(ListOfFieldResets);
}
}