---
title: "[Java](https://en.wikipedia.org/wiki/Java_(programming_language))"
weight: 1
---

<div class="contents" data-local="" data-depth="1" data-backlinks="none">

Table of Contents

</div>

------------------------------------------------------------------------

```text
$ java -version
$ javac -version

$ jshell
```

## Installation

### Installation on macOS

- <https://docs.oracle.com/javase/9/install/installation-jdk-and-jre-macos.htm>

## Reference

### [Java SE](https://en.wikipedia.org/wiki/Java_Platform,_Standard_Edition)

- [java.awt](https://docs.oracle.com/javase/10/docs/api/java/awt/package-summary.html): [BufferedImage](https://docs.oracle.com/javase/10/docs/api/java/awt/image/BufferedImage.html)
- [java.io](https://docs.oracle.com/javase/10/docs/api/java/io/package-summary.html): [Closeable](https://docs.oracle.com/javase/10/docs/api/java/io/Closeable.html), [File](https://docs.oracle.com/javase/10/docs/api/java/io/File.html), [Reader](https://docs.oracle.com/javase/10/docs/api/java/io/Reader.html), [Writer](https://docs.oracle.com/javase/10/docs/api/java/io/Writer.html)
- [java.lang](https://docs.oracle.com/javase/10/docs/api/java/lang/package-summary.html): [Class](https://docs.oracle.com/javase/10/docs/api/java/lang/Class.html), [Math](https://docs.oracle.com/javase/10/docs/api/java/lang/Math.html), [Number](https://docs.oracle.com/javase/10/docs/api/java/lang/Number.html), [Object](https://docs.oracle.com/javase/10/docs/api/java/lang/Object.html), [ProcessBuilder](https://docs.oracle.com/javase/10/docs/api/java/lang/ProcessBuilder.html), [Runtime](https://docs.oracle.com/javase/10/docs/api/java/lang/Runtime.html), [String](https://docs.oracle.com/javase/10/docs/api/java/lang/String.html), [System](https://docs.oracle.com/javase/10/docs/api/java/lang/System.html), [Thread](https://docs.oracle.com/javase/10/docs/api/java/lang/Thread.html), [Throwable](https://docs.oracle.com/javase/10/docs/api/java/lang/Throwable.html)
- [java.math](https://docs.oracle.com/javase/10/docs/api/java/math/package-summary.html): [BigDecimal](https://docs.oracle.com/javase/10/docs/api/java/math/BigDecimal.html), [BigInteger](https://docs.oracle.com/javase/10/docs/api/java/math/BigInteger.html)
- [java.net](https://docs.oracle.com/javase/10/docs/api/java/net/package-summary.html): [InetAddress](https://docs.oracle.com/javase/10/docs/api/java/net/InetAddress.html), [URI](https://docs.oracle.com/javase/10/docs/api/java/net/URI.html), [URL](https://docs.oracle.com/javase/10/docs/api/java/net/URL.html)
- [java.nio](https://docs.oracle.com/javase/10/docs/api/java/nio/package-summary.html): [Buffer](https://docs.oracle.com/javase/10/docs/api/java/nio/Buffer.html), [ByteBuffer](https://docs.oracle.com/javase/10/docs/api/java/nio/ByteBuffer.html)
- [java.nio.channels](https://docs.oracle.com/javase/10/docs/api/java/nio/channels/package-summary.html): [Channel](https://docs.oracle.com/javase/10/docs/api/java/nio/channels/Channel.html)
- [java.nio.charset](https://docs.oracle.com/javase/10/docs/api/java/nio/charset/package-summary.html): [Charset](https://docs.oracle.com/javase/10/docs/api/java/nio/charset/Charset.html)
- [java.nio.file](https://docs.oracle.com/javase/10/docs/api/java/nio/file/package-summary.html): [Path](https://docs.oracle.com/javase/10/docs/api/java/nio/file/Path.html)
- [java.nio.file.attribute](https://docs.oracle.com/javase/10/docs/api/java/nio/file/attribute/package-summary.html): [FileAttribute](https://docs.oracle.com/javase/10/docs/api/java/nio/file/attribute/FileAttribute.html)
- [java.security](https://docs.oracle.com/javase/10/docs/api/java/security/package-summary.html): [MessageDigest](https://docs.oracle.com/javase/10/docs/api/java/security/MessageDigest.html), [SecureRandom](https://docs.oracle.com/javase/10/docs/api/java/security/SecureRandom.html)
- [java.sql](https://docs.oracle.com/javase/10/docs/api/java/sql/package-summary.html): [Connection](https://docs.oracle.com/javase/10/docs/api/java/sql/Connection.html), [ResultSet](https://docs.oracle.com/javase/10/docs/api/java/sql/ResultSet.html), [Statement](https://docs.oracle.com/javase/10/docs/api/java/sql/Statement.html)
- [java.text](https://docs.oracle.com/javase/10/docs/api/java/text/package-summary.html): [NumberFormat](https://docs.oracle.com/javase/10/docs/api/java/text/NumberFormat.html)
- [java.time](https://docs.oracle.com/javase/10/docs/api/java/time/package-summary.html): [Duration](https://docs.oracle.com/javase/10/docs/api/java/time/Duration.html), [Instant](https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html)
- [java.util](https://docs.oracle.com/javase/10/docs/api/java/util/package-summary.html): [Base64](https://docs.oracle.com/javase/10/docs/api/java/util/Base64.html), [Colleciton](https://docs.oracle.com/javase/10/docs/api/java/util/Collection.html), [Date](https://docs.oracle.com/javase/10/docs/api/java/util/Date.html), [Iterator](https://docs.oracle.com/javase/10/docs/api/java/util/Iterator.html), [List](https://docs.oracle.com/javase/10/docs/api/java/util/List.html), [Map](https://docs.oracle.com/javase/10/docs/api/java/util/Map.html), [Optional](https://docs.oracle.com/javase/10/docs/api/java/util/Optional.html), [Set](https://docs.oracle.com/javase/10/docs/api/java/util/Set.html), [UUID](https://docs.oracle.com/javase/10/docs/api/java/util/UUID.html)

### [Java EE](https://en.wikipedia.org/wiki/Java_Platform,_Enterprise_Edition)

- [javax.servlet.http](https://docs.oracle.com/javaee/7/api/javax/servlet/http/package-summary.html): [HttpServlet](https://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpServlet.html), [HttpServletRequest](https://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpServletRequest.html), [HttpServletResponse](https://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpServletResponse.html)

## History

### Java 10

- [JDK 10 Release Notes](http://www.oracle.com/technetwork/java/javase/10-relnote-issues-4108729.html)
- [Java SE 10 (18.3) (JSR 383)](http://cr.openjdk.java.net/~iris/se/10/latestSpec/)
- <http://jdk.java.net/10/>
- <http://openjdk.java.net/projects/jdk/10/>
- <http://www.baeldung.com/java-10>

### Java 9

- [What's New in Oracle JDK 9](https://docs.oracle.com/javase/9/whatsnew/toc.htm)
- <http://www.baeldung.com/new-java-9>

### Java 8

- [What's New in Oracle JDK 8](http://www.oracle.com/technetwork/java/javase/8-whats-new-2157071.html)
- <http://www.baeldung.com/java-8-new-features>
- <https://leanpub.com/whatsnewinjava8/read>

## Exceptions

### Null Argument Exceptions

Throw a `NullPointerException`, not an `IllegalArgumentException`.

#### References

- [java.util.Objects#requireNonNull() in Java 7](https://docs.oracle.com/javase/10/docs/api/java/util/Objects.html#requireNonNull(T))
- [IllegalArgumentException or NullPointerException for a null parameter?](http://stackoverflow.com/questions/3881/illegalargumentexception-or-nullpointerexception-for-a-null-parameter)
- [Apache Commons Mailing List: Re: commons lang3: NullArgumentException missing?](http://mail-archives.apache.org/mod_mbox/commons-user/201112.mbox/%3cCABLGb9w813MsWhMWM4Je=SiFo+x=XuwcTOgGfgzgfXPai2Tdtw@mail.gmail.com%3e)
- [Guava Idea Graveyard: Preconditions.checkArgumentNotNull() (throws IllegalArgumentException)](https://code.google.com/p/guava-libraries/wiki/IdeaGraveyard#Preconditions.checkArgumentNotNull()_(throws_IllegalArgumentExce)

### Null Pointer Exceptions

#### References

- [CERT Oracle Coding Standard for Java: ERR08-J. Do not catch NullPointerException or any of its ancestors](https://www.securecoding.cert.org/confluence/display/java/ERR08-J.+Do+not+catch+NullPointerException+or+any+of+its+ancestors)

## Testing

### Unit Testing

#### Test Frameworks

- [JUnit](https://junit.org/junit5/) ([user guide](https://junit.org/junit5/docs/current/user-guide/))
- [TestNG](http://testng.org/doc/)

#### Assertion Libraries

- [AssertJ](http://joel-costigliola.github.io/assertj/)
- [Truth](http://google.github.io/truth/) ([comparison to AssertJ](http://google.github.io/truth/comparison))
- [Hamcrest](http://hamcrest.org/JavaHamcrest/) (legacy)

## Hosting

- [Heroku](https://devcenter.heroku.com/articles/deploying-gradle-apps-on-heroku)
- [AWS Elastic Beanstalk](https://aws.amazon.com/elasticbeanstalk/)
  - [Using the AWS Elastic Beanstalk Tomcat Platform](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/java-tomcat-platform.html)
- [Google Cloud Platform](https://cloud.google.com/java/)

## See Also

- [Android](android), [Gradle](gradle), [JVM](jvm), [Kotlin](kotlin), [Maven](maven), [Tomcat](tomcat)
- [programming](programming)
- <http://openjdk.java.net/projects/jigsaw/>
