https://github.com/javadev/underscore-java
java port of Underscore.js
https://github.com/javadev/underscore-java
functional-programming java java-xmlbuilder javascript json json-to-xml json-to-xml-converter json-to-xml-java underscore xml xml-to-json xml-to-json-java xmlbuilder
Last synced: 2 months ago
JSON representation
java port of Underscore.js
- Host: GitHub
- URL: https://github.com/javadev/underscore-java
- Owner: javadev
- License: mit
- Created: 2014-03-30T07:04:37.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T08:05:23.000Z (2 months ago)
- Last Synced: 2025-04-12T01:02:37.143Z (2 months ago)
- Topics: functional-programming, java, java-xmlbuilder, javascript, json, json-to-xml, json-to-xml-converter, json-to-xml-java, underscore, xml, xml-to-json, xml-to-json-java, xmlbuilder
- Language: Java
- Homepage: https://javadev.github.io/underscore-java/
- Size: 9.34 MB
- Stars: 537
- Watchers: 14
- Forks: 80
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
underscore-java
===============
[](https://central.sonatype.com/artifact/com.github.javadev/underscore/1.112)
[](https://github.com/javadev/underscore-java/blob/main/LICENSE)
[](https://github.com/javadev/underscore-java/actions/workflows/maven.yml)
[](https://github.com/javadev/underscore-java/actions/workflows/codeql.yml)
[](https://github.com/javadev/underscore-java/actions/workflows/semgrep.yml)
[](https://github.com/javadev/underscore-java/actions/workflows/scorecard.yml)
[](https://github.com/javadev/underscore-java/actions/workflows/ossar.yml)
[](https://bestpractices.coreinfrastructure.org/projects/7019)
[](https://coveralls.io/r/javadev/underscore-java)
[](https://codecov.io/gh/javadev/underscore-java)
[](https://circleci.com/gh/javadev/underscore-java)
[](https://ci.appveyor.com/project/javadev/underscore-java)
[](https://javadev.semaphoreci.com/projects/underscore-java)
[](https://snyk.io/test/github/javadev/underscore-java?targetFile=pom.xml)
[](https://javadoc.io/doc/com.github.javadev/underscore)
[](https://sonarcloud.io/summary/overall?id=javadev_underscore-java)
[](https://sonarcloud.io/summary/overall?id=javadev_underscore-java)
[](https://dev.azure.com/javadevazure/underscore-java/_build/latest?definitionId=1&branchName=main)
[](https://hitsofcode.com/github/javadev/underscore-java/view?branch=main)
[](https://codebeat.co/projects/github-com-javadev-underscore-java-main)
[](https://github.com/javadev/underscore-java)
[](https://github.com/javadev/underscore-java/fork)
[](https://gitter.im/javadev/underscore-java?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Requirements
============
Java 11 and later, [Java 17](https://github.com/javadev/underscore-java17) or [Kotlin](https://github.com/kotlindev/underscore-kotlin)
## Installation
To configure your Maven project, add the following code to your pom.xml file:
```xml
com.github.javadev
underscore
1.112
...
```
Gradle configuration:
```groovy
implementation 'com.github.javadev:underscore:1.112'
```
### Usage
```java
U.of(/* array | list | set | map | anything based on Iterable interface */)
.filter(..)
.map(..)
...
.sortWith()
.forEach(..);
U.of(value1, value2, value3)...
U.range(0, 10)...
U.of(1, 2, 3) // or java.util.Arrays.asList(1, 2, 3) or new Integer[] {1, 2, 3}
.filter(v -> v > 1)
// 2, 3
.map(v -> v + 1)
// 3, 4
.sortWith((a, b) -> b.compareTo(a))
.forEach(System.out::println);
// 4, 3
U.of(1, 2, 3) // or java.util.Arrays.asList(1, 2, 3) or new Integer[] {1, 2, 3}
.mapMulti((num, consumer) -> {
for (int i = 0; i < num; i++) {
consumer.accept("a" + num);
}
})
.forEach(System.out::println);
// "a1", "a2", "a2", "a3", "a3", "a3"
U.formatXml("data", Xml.XmlStringBuilder.Step.TWO_SPACES);
//
// data
//
U.formatJson("{\"a\":{\"b\":\"data\"}}", Json.JsonStringBuilder.Step.TWO_SPACES);
// {
// "a": {
// "b": "data"
// }
// }
U.xmlToJson(
"\n"
+ " \n"
+ " elements\n"
+ " more elements\n"
+ " \n"
+ " \n"
+ " element as well\n"
+ " \n"
+ "",
Json.JsonStringBuilder.Step.TWO_SPACES);
// {
// "mydocument": {
// "-has": "an attribute",
// "and": {
// "many": [
// "elements",
// "more elements"
// ]
// },
// "plus": {
// "-a": "complex",
// "#text": "\n element as well\n "
// }
// },
// "#omit-xml-declaration": "yes"
// }
U.xmlToJsonMinimum(
"\n"
+ " Example Text\n"
+ " 42\n"
+ " 3.14\n"
+ " true\n"
+ " 2025-02-26\n"
+ " \n"
+ " 2025-02-26T14:30:00Z\n"
+ " Item 1\n"
+ " Item 2\n"
+ " \n"
+ " Value 1\n"
+ " Value 2\n"
+ " \n"
+ " \n"
+ "\n",
Json.JsonStringBuilder.Step.TWO_SPACES);
// {
// "data": {
// "string": "Example Text",
// "integer": "42",
// "float": "3.14",
// "boolean": "true",
// "date": "2025-02-26",
// "time": "14:30:00",
// "datetime": "2025-02-26T14:30:00Z",
// "array": [
// "Item 1",
// "Item 2"
// ],
// "object": {
// "key1": "Value 1",
// "key2": "Value 2"
// },
// "null": ""
// }
// }
U.jsonToXml(
"{\n"
+ " \"mydocument\": {\n"
+ " \"-has\": \"an attribute\",\n"
+ " \"and\": {\n"
+ " \"many\": [\n"
+ " \"elements\",\n"
+ " \"more elements\"\n"
+ " ]\n"
+ " },\n"
+ " \"plus\": {\n"
+ " \"-a\": \"complex\",\n"
+ " \"#text\": \"\\n element as well\\n \"\n"
+ " }\n"
+ " },\n"
+ " \"#omit-xml-declaration\": \"yes\"\n"
+ "}",
Xml.XmlStringBuilder.Step.TWO_SPACES);
//
//
// elements
// more elements
//
//
// element as well
//
//
U.jsonToXmlMinimum(
"{\n"
+ " \"data\": {\n"
+ " \"string\": \"Example Text\",\n"
+ " \"integer\": \"42\",\n"
+ " \"float\": \"3.14\",\n"
+ " \"boolean\": \"true\",\n"
+ " \"date\": \"2025-02-26\",\n"
+ " \"time\": \"14:30:00\",\n"
+ " \"datetime\": \"2025-02-26T14:30:00Z\",\n"
+ " \"array\": [\n"
+ " \"Item 1\",\n"
+ " \"Item 2\"\n"
+ " ],\n"
+ " \"object\": {\n"
+ " \"key1\": \"Value 1\",\n"
+ " \"key2\": \"Value 2\"\n"
+ " },\n"
+ " \"null\": \"\"\n"
+ " }\n"
+ "}",
Xml.XmlStringBuilder.Step.TWO_SPACES);
//
// Example Text
// 42
// 3.14
// true
// 2025-02-26
//
// 2025-02-26T14:30:00Z
// Item 1
// Item 2
//
// Value 1
// Value 2
//
//
//
U.Builder builder = U.objectBuilder()
.add("firstName", "John")
.add("lastName", "Smith")
.add("age", 25)
.add("address", U.arrayBuilder()
.add(U.objectBuilder()
.add("streetAddress", "21 2nd Street")
.add("city", "New York")
.addNull("cityId")
.add("state", "NY")
.add("postalCode", "10021")))
.add("phoneNumber", U.arrayBuilder()
.add(U.objectBuilder()
.add("type", "home")
.add("number", "212 555-1234"))
.add(U.objectBuilder()
.add("type", "fax")
.add("number", "646 555-4567")));
System.out.println(builder.toJson());
System.out.println(builder.toXml());
```
```javascript
{
"firstName": "John",
"lastName": "Smith",
"age": 25,
"address": [
{
"streetAddress": "21 2nd Street",
"city": "New York",
"cityId": null,
"state": "NY",
"postalCode": "10021"
}
],
"phoneNumber": [
{
"type": "home",
"number": "212 555-1234"
},
{
"type": "fax",
"number": "646 555-4567"
}
]
}
```
```xml
John
Smith
25
21 2nd Street
New York
NY
10021
home
212 555-1234
fax
646 555-4567
```
Simplify XML document creation by structuring your code like the final document.
This code:
```java
XmlBuilder builder = XmlBuilder.create("Projects")
.e("underscore-java").a("language", "Java").a("scm", "SVN")
.e("Location").a("type", "URL")
.t("https://github.com/javadev/underscore-java/")
.up()
.up()
.e("JetS3t").a("language", "Java").a("scm", "CVS")
.e("Location").a("type", "URL")
.t("https://jets3t.s3.amazonaws.com/index.html");
System.out.println(builder.toXml(Xml.XmlStringBuilder.Step.TWO_SPACES));
System.out.println(builder.toJson(Json.JsonStringBuilder.Step.TWO_SPACES));
```
Generates the following XML and JSON documents:
```xml
https://github.com/javadev/underscore-java/
https://jets3t.s3.amazonaws.com/index.html
```
```json
{
"Projects": {
"underscore-java": {
"-language": "Java",
"-scm": "SVN",
"Location": {
"-type": "URL",
"#text": "https://github.com/javadev/underscore-java/"
}
},
"JetS3t": {
"-language": "Java",
"-scm": "CVS",
"Location": {
"-type": "URL",
"#text": "https://jets3t.s3.amazonaws.com/index.html"
}
}
}
}
```
Underscore-java is a java port of [Underscore.js](https://underscorejs.org/).
In addition to porting Underscore's functionality, Underscore-java includes matching unit tests.
For docs, license, tests, and downloads, see:
https://javadev.github.io/underscore-java
Thanks to Jeremy Ashkenas and all contributors to Underscore.js.