Skip to content

Commit 6a0c4bd

Browse files
Ashfaqul HaqueFrankSchnicke
authored andcommitted
Adds javadoc in Basyx.SDK project
Signed-off-by: Ashfaqul Haque <ashfaqul.haque@iese.fraunhofer.de> Change-Id: I4048df3ee472234c52cb59869cae13d78434991d
1 parent a118499 commit 6a0c4bd

115 files changed

Lines changed: 266 additions & 288 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

pom.xml

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,24 @@
113113
</execution>
114114
</executions>
115115
</plugin>
116+
117+
<plugin>
118+
<groupId>org.apache.maven.plugins</groupId>
119+
<artifactId>maven-javadoc-plugin</artifactId>
120+
<version>3.2.0</version>
121+
<configuration>
122+
<source>8</source>
123+
</configuration>
124+
<executions>
125+
<execution>
126+
<goals>
127+
<goal>javadoc</goal>
128+
</goals>
129+
<id>generate-javadoc</id>
130+
<phase>package</phase>
131+
</execution>
132+
</executions>
133+
</plugin>
116134
</plugins>
117135
</build>
118136

src/main/java/org/eclipse/basyx/aas/aggregator/api/IAASAggregator.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919

2020

2121
/**
22-
* Interface for the Asset Administration Shell Aggregator API <br />
22+
* Interface for the Asset Administration Shell Aggregator API <br>
2323
* It is used to manage multiple AASs at the same endpoint
2424
*
2525
* @author conradi

src/main/java/org/eclipse/basyx/aas/aggregator/restapi/AASAggregatorProvider.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ private String stripPrefix(String path) throws MalformedRequestException {
6060
}
6161

6262
/**
63-
* Makes sure, that given Object is an AAS by checking its ModelType<br />
63+
* Makes sure, that given Object is an AAS by checking its ModelType<br>
6464
* Creates a new AAS with the content of the given Map
6565
*
6666
* @param value

src/main/java/org/eclipse/basyx/aas/factory/xml/XMLToMetamodelConverter.java

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -92,9 +92,6 @@ public List<IAsset> parseAssets() throws ParserConfigurationException, SAXExcept
9292
* Parses the Submodels form the XML
9393
*
9494
* @return the Submodels parsed form the XML
95-
* @throws ParserConfigurationException
96-
* @throws SAXException
97-
* @throws IOException
9895
*/
9996
@SuppressWarnings("unchecked")
10097
public List<ISubmodel> parseSubmodels() {
@@ -107,9 +104,6 @@ public List<ISubmodel> parseSubmodels() {
107104
* Parses the ConceptDescriptions form the XML
108105
*
109106
* @return the ConceptDescriptions parsed form the XML
110-
* @throws ParserConfigurationException
111-
* @throws SAXException
112-
* @throws IOException
113107
*/
114108
@SuppressWarnings("unchecked")
115109
public List<IConceptDescription> parseConceptDescriptions() {

src/main/java/org/eclipse/basyx/aas/manager/ConnectedAssetAdministrationShellManager.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,8 @@
3232
import org.eclipse.basyx.vab.protocol.http.connector.HTTPConnectorFactory;
3333

3434
/**
35-
* Implement a AAS manager backend that communicates via HTTP/REST<br />
36-
* <br />
35+
* Implement a AAS manager backend that communicates via HTTP/REST<br>
36+
* <br>
3737
*
3838
* @author kuhn, schnicke
3939
*
@@ -54,8 +54,8 @@ public ConnectedAssetAdministrationShellManager(IAASRegistry directory) {
5454
}
5555

5656
/**
57-
* @param networkDirectoryService
58-
* @param providerProvider
57+
* @param directory
58+
* @param provider
5959
*/
6060
public ConnectedAssetAdministrationShellManager(IAASRegistry directory,
6161
IConnectorFactory provider) {

src/main/java/org/eclipse/basyx/aas/manager/api/IAssetAdministrationShellManager.java

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,6 @@ public interface IAssetAdministrationShellManager {
4141
* Creates an AAS on a remote server
4242
*
4343
* @param aas
44-
* @param aasId
4544
* @param endpoint
4645
*/
4746
void createAAS(AssetAdministrationShell aas, String endpoint);

src/main/java/org/eclipse/basyx/aas/metamodel/api/IAssetAdministrationShell.java

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ public interface IAssetAdministrationShell extends IElement, IIdentifiable, IHas
3535
/**
3636
* Return all registered submodels of this AAS
3737
*
38-
* @return IdShort -> ISubmodel
38+
* @return {@literal IdShort -> ISubmodel}
3939
*/
4040
public Map<String, ISubmodel> getSubmodels();
4141

@@ -98,7 +98,7 @@ public interface IAssetAdministrationShell extends IElement, IIdentifiable, IHas
9898

9999

100100
/**
101-
* Gets the views associated with the AAS. <br/>
101+
* Gets the views associated with the AAS. <br>
102102
* If needed stakeholder specific views can be defined on the elements of the
103103
* AAS.
104104
*
@@ -107,7 +107,7 @@ public interface IAssetAdministrationShell extends IElement, IIdentifiable, IHas
107107
public Collection<IView> getViews();
108108

109109
/**
110-
* Gets the concept dictionaries associated with the AAS. <br/>
110+
* Gets the concept dictionaries associated with the AAS. <br>
111111
* An AAS may have one or more concept dictionaries assigned to it. The concept
112112
* dictionaries typically contain only descriptions for elements that are also
113113
* used within the AAS (via HasSemantics).

src/main/java/org/eclipse/basyx/aas/metamodel/api/parts/IConceptDictionary.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,10 @@
1616
import org.eclipse.basyx.submodel.metamodel.api.reference.IReference;
1717

1818
/**
19-
* A dictionary contains elements that can be reused. <br />
20-
* <br />
21-
* The concept dictionary contains concept descriptions. <br />
22-
* <br />
19+
* A dictionary contains elements that can be reused. <br>
20+
* <br>
21+
* The concept dictionary contains concept descriptions. <br>
22+
* <br>
2323
* Typically a concept description dictionary of an AAS contains only concept
2424
* descriptions of elements used within submodels of the AAS.
2525
*

src/main/java/org/eclipse/basyx/aas/metamodel/api/parts/asset/AssetKind.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
import org.eclipse.basyx.submodel.metamodel.enumhelper.StandardizedLiteralEnumHelper;
1414

1515
/**
16-
* AssetKind enum as defined by DAAS document<br />
16+
* AssetKind enum as defined by DAAS document<br>
1717
* Enumeration for denoting whether an element is a type or an instance.
1818
*
1919
* @author schnicke

src/main/java/org/eclipse/basyx/aas/metamodel/map/AasEnv.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ public AasEnv(Collection<IAssetAdministrationShell> aasList, Collection<IAsset>
5757
/**
5858
* Creates a AssetAdministrationShell object from a map
5959
*
60-
* @param obj
60+
* @param map
6161
* a AssetAdministrationShell object as raw map
6262
* @return a AssetAdministrationShell object, that behaves like a facade for the
6363
* given map

0 commit comments

Comments
 (0)