sysml-v2-api-client

SysML v2 API and Services

• API version: 1.0.0

REST/HTTP binding (PSM) for the SysML v2 standard API.

Automatically generated by the OpenAPI Generator

Requirements

Building the API client library requires:

1. Java 1.7+
2. Maven/Gradle

Installation

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
<groupId>org.omg.sysml</groupId>
<artifactId>sysml-v2-api-client</artifactId>
<version>2020-09</version>
<scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "org.omg.sysml:sysml-v2-api-client:2020-09"

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

• target/sysml-v2-api-client-2020-09.jar
• target/lib/*.jar

Getting Started

Please follow the installation instruction and execute the following Java code:

// Import classes:importorg.omg.sysml.ApiClient;
importorg.omg.sysml.ApiException;
importorg.omg.sysml.Configuration;
importorg.omg.sysml.models.*;
importorg.omg.sysml.api.CommitApi;
publicclassExample {
publicstaticvoidmain(String[] args) {
ApiClientdefaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("http://localhost");
CommitApiapiInstance = newCommitApi(defaultClient);
UUIDprojectId = newUUID(); // UUID | ID of the projectUUIDcommitId = newUUID(); // UUID | ID of the committry {
Commitresult = apiInstance.getCommitByProjectAndId(projectId, commitId);
System.out.println(result);
} catch (ApiExceptione) {
System.err.println("Exception when calling CommitApi#getCommitByProjectAndId");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}

Documentation for API Endpoints

All URIs are relative to http://localhost

Class	Method	HTTP request	Description
CommitApi	getCommitByProjectAndId	GET /projects/{projectId}/commits/{commitId}	Get commit by project and ID
CommitApi	getCommitsByProject	GET /projects/{projectId}/commits	Get commits by project
CommitApi	getHeadCommitByProject	GET /projects/{projectId}/head	Get head commit by project
CommitApi	postCommitByProject	POST /projects/{projectId}/commits	Create commit by project
ElementApi	getElementByProjectCommitId	GET /projects/{projectId}/commits/{commitId}/elements/{elementId}	Get element by project, commit and ID
ElementApi	getElementsByProjectCommit	GET /projects/{projectId}/commits/{commitId}/elements	Get elements by project and commit
ElementApi	getRootsByProjectCommit	GET /projects/{projectId}/commits/{commitId}/roots	Get root elements by project and commit
ProjectApi	getProjectById	GET /projects/{projectId}	Get project by ID
ProjectApi	getProjects	GET /projects	Get projects
ProjectApi	postProject	POST /projects	Create project
QueryApi	getQueriesByProject	GET /projects/{projectId}/queries	Get queries by project
QueryApi	getQueryByProjectAndId	GET /projects/{projectId}/queries/{queryId}	Get query by project and ID
QueryApi	getQueryResultsByProjectIdQuery	GET /projects/{projectId}/query-results	Get query results by project and query definition
QueryApi	getQueryResultsByProjectIdQueryId	GET /projects/{projectId}/queries/{queryId}/results	Get query results by project and query
QueryApi	getQueryResultsByProjectIdQueryPost	POST /projects/{projectId}/query-results	Get query results by project and query definition via POST
QueryApi	postQueryByProject	POST /projects/{projectId}/queries	Create query by project
RelationshipApi	getRelationshipsByProjectCommitRelatedElement	GET /projects/{projectId}/commits/{commitId}/elements/{relatedElementId}/relationships	Get relationships by project, commit, and related element

Documentation for Models

• Commit
• CommitContainingProject
• CompositeConstraint
• Constraint
• Element
• ElementIdentity
• ElementVersion
• Error
• Identified
• PrimitiveConstraint
• Project
• Query
• Record
• Relationship

Documentation for Authorization

All endpoints do not require authorization. Authentication schemes defined for the API:

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Author