https://github.com/digitalheir/java-rechtspraak-library
Java library for consuming the Rechtspraak.nl API
https://github.com/digitalheir/java-rechtspraak-library
court-judgment open-data rechtspraak
Last synced: about 1 year ago
JSON representation
Java library for consuming the Rechtspraak.nl API
- Host: GitHub
- URL: https://github.com/digitalheir/java-rechtspraak-library
- Owner: digitalheir
- License: mit
- Created: 2015-09-12T14:13:09.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2023-06-14T22:52:35.000Z (about 3 years ago)
- Last Synced: 2025-04-14T20:12:00.368Z (about 1 year ago)
- Topics: court-judgment, open-data, rechtspraak
- Language: Java
- Homepage: https://digitalheir.github.io/java-rechtspraak-library/
- Size: 12.4 MB
- Stars: 4
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
### ⚠ This library mostly superseded by [Rechtspraak.js](https://github.com/digitalheir/rechtspraak-js) and no longer actively maintained
It may still be of use for XSD files and Java bindings to the Rechtspraak.nl API
# Rechtspraak.nl library
[](http://badge.fury.io/gh/digitalheir%2Fjava-rechtspraak-library)
[](https://travis-ci.org/digitalheir/java-rechtspraak-library)
A Java interface to the judgment database of [rechtspraak.nl](http://www.rechtspraak.nl/).
## Documentation
This project is part of my master's thesis in Artificial Intelligence. A HTML copy of my thesis is available
at [here](https://digitalheir.github.io/java-rechtspraak-library/).
## Usage
Download [the latest JAR](https://github.com/digitalheir/java-rechtspraak-library/releases/latest) or grab from Maven:
```xml
org.leibnizcenter
rechtspraak
2.0.4
```
or Gradle:
```groovy
compile 'org.leibnizcenter:rechtspraak:2.0.4'
```
You can access the Rechtspraak.nl search API through `org.leibnizcenter.rechtspraak.SearchRequest.Builder` and `org.leibnizcenter.rechtspraak.SearchResult`. All builder options are optional. For instance:
```java
SearchResult iterator = new SearchRequest.Builder()
.max(1000) // Results per page. Cannot be larger than and defaults to 1000
.returnType(ReturnType.DOC) // Return documents for which Rechtspraak.nl lists at least metadata (META) or metadata and a transcription of the case (DOC)
.from(0) // Offset in results, used for pagination
.sort(Sort.ASC) //Sort results on modification date ascending or descending. Default is ascending (oldest first).
.build().execute();
Assert.assertTrue(iterator.hasNext());
iterator = iterator.next();
Assert.assertTrue(iterator.hasNext());
iterator = iterator.next();
```
For all options, see the [JavaDoc for SearchRequest.Builder](http://phil.uu.nl/~trompper/rechtspraak-2.0.0-javadoc/org/leibnizcenter/rechtspraak/SearchRequest.Builder.html)
Search results contain judgment metadata (accessed through `SearchResult#getJudgments()`). For fetching and parsing the actual documents, use `org.leibnizcenter.rechtspraak.RechtspraakNlInterface`. For example, given an ECLI:
```java
OpenRechtspraak doc = parseXml(
// For purists that don't trust the parsing scheme (there is no official doctype), you can work with the raw XML stream as well
requestXmlForEcli("ECLI:NL:RBNNE:2014:1005").body().byteStream()
);
```
`OpenRechtspraak` is a Java object which represents the unmarshalled XML document at http://data.rechtspraak.nl/uitspraken/content?id=ECLI:NL:RBNNE:2014:1005
## Requirements
* Versions 1.X.X require Java 7
* Versions 2.X.X require Java 8
## More
Inquiries go to maarten.trompper@gmail.com.