https://github.com/thanospan/ngsiv2-sdk-java
NGSI v2 SDK for Java
https://github.com/thanospan/ngsiv2-sdk-java
api client fiware fiware-ngsi java ngsi sdk sdk-java v2
Last synced: 17 days ago
JSON representation
NGSI v2 SDK for Java
- Host: GitHub
- URL: https://github.com/thanospan/ngsiv2-sdk-java
- Owner: thanospan
- Created: 2020-05-19T16:07:16.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-24T16:30:18.000Z (almost 5 years ago)
- Last Synced: 2024-11-01T04:35:03.183Z (6 months ago)
- Topics: api, client, fiware, fiware-ngsi, java, ngsi, sdk, sdk-java, v2
- Language: Java
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome - NGSI v2 SDK for Java - NGSI v2 SDK for Java (Open-Source FIWARE from third parties / Processing)
README
# [NGSI v2](https://fiware.github.io/specifications/ngsiv2/stable/) SDK for Java
## Documentation for API Endpoints
All URIs are relative to *http://localhost:1026/v2*
Class | Method | HTTP request
------------ | ------------- | -------------
ApiEntryPointApi | retrieveApiResources | **GET** /
AttributeValueApi | getAttributeValue | **GET** /entities/{entityId}/attrs/{attrName}/value
AttributeValueApi | updateAttributeValue | **PUT** /entities/{entityId}/attrs/{attrName}/value
AttributesApi | getAttributeData | **GET** /entities/{entityId}/attrs/{attrName}
AttributesApi | removeASingleAttribute | **DELETE** /entities/{entityId}/attrs/{attrName}
AttributesApi | updateAttributeData | **PUT** /entities/{entityId}/attrs/{attrName}
BatchOperationsApi | notify | **POST** /op/notify
BatchOperationsApi | query | **POST** /op/query
BatchOperationsApi | update | **POST** /op/update
EntitiesApi | createEntity | **POST** /entities
EntitiesApi | listEntities | **GET** /entities
EntitiesApi | removeEntity | **DELETE** /entities/{entityId}
EntitiesApi | replaceAllEntityAttributes | **PUT** /entities/{entityId}/attrs
EntitiesApi | retrieveEntity | **GET** /entities/{entityId}
EntitiesApi | retrieveEntityAttributes | **GET** /entities/{entityId}/attrs
EntitiesApi | updateExistingEntityAttributes | **PATCH** /entities/{entityId}/attrs
EntitiesApi | updateOrAppendEntityAttributes | **POST** /entities/{entityId}/attrs
RegistrationsApi | createRegistration | **POST** /registrations
RegistrationsApi | deleteRegistration | **DELETE** /registrations/{registrationId}
RegistrationsApi | listRegistrations | **GET** /registrations
RegistrationsApi | retrieveRegistration | **GET** /registrations/{registrationId}
RegistrationsApi | updateRegistration | **PATCH** /registrations/{registrationId}
SubscriptionsApi | createSubscription | **POST** /subscriptions
SubscriptionsApi | deleteSubscription | **DELETE** /subscriptions/{subscriptionId}
SubscriptionsApi | listSubscriptions | **GET** /subscriptions
SubscriptionsApi | retrieveSubscription | **GET** /subscriptions/{subscriptionId}
SubscriptionsApi | updateSubscription | **PATCH** /subscriptions/{subscriptionId}
TypesApi | listEntityTypes | **GET** /types
TypesApi | retrieveEntityType | **GET** /types/{entityType}
## Known Issues
* **PATCH** /registrations/{registrationId} returns **405 Method Not Allowed**.
According to the [NGSIv2 Implementation Notes](https://github.com/telefonicaid/fiware-orion/blob/master/doc/manuals/user/ngsiv2_implementation_notes.md#registrations):
`PATCH /v2/registration/` is not implemented. Thus, registrations cannot be updated directly. I.e., updates must be done deleting and re-creating the registration. Please see [this issue](https://github.com/telefonicaid/fiware-orion/issues/3007) about this.
* **204 No Content** responses cause `java.io.IOException: unexpected content length header with 204 response`
[This bug](https://bugs.openjdk.java.net/browse/JDK-8218662) has been fixed in jdk-11.0.7
## Additional Resources
* An introductory tutorial to the FIWARE Platform can be found [here](https://github.com/FIWARE/tutorials.Getting-Started).
* The official docker image of the Orion Context Broker can be found [here](https://hub.docker.com/r/fiware/orion).