{"id":63371,"date":"2020-08-28T06:11:43","date_gmt":"2020-08-28T06:11:43","guid":{"rendered":"https:\/\/www.baeldung.com\/?p=86300"},"modified":"2020-08-28T06:11:43","modified_gmt":"2020-08-28T06:11:43","slug":"illegalargumentexception-or-nullpointerexception-for-a-null-parameter","status":"publish","type":"post","link":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/2020\/08\/28\/illegalargumentexception-or-nullpointerexception-for-a-null-parameter\/","title":{"rendered":"IllegalArgumentException or NullPointerException for a Null Parameter?"},"content":{"rendered":"

<\/p>\n

1. Introduction<\/h2>\n
<\/div>\n

Among the decisions we make as we’re writing our applications, many are about when to throw exceptions<\/a> and which type to throw.<\/p>\n

In this quick tutorial, we’re going to tackle the issue of which exception to throw when someone passes a null<\/em> parameter to one of our methods: IllegalArgumentExcpetion<\/em> or NullPointerException<\/em><\/a>.<\/p>\n

We’ll explore the topic by examining the arguments for both sides.<\/p>\n

2. IllegalArgumentException<\/em><\/h2>\n
<\/div>\n

First, let’s look at the arguments for throwing an IllegalArgumentException<\/em>.<\/p>\n

Let’s create a simple method that throws an\u00a0IllegalArgumentException<\/em> when passed a null<\/em>:<\/p>\n

public void processSomethingNotNull(Object myParameter) {\r\n    if (myParameter == null) {\r\n        throw new IllegalArgumentException(\"Parameter 'myParameter' cannot be null\");\r\n    }\r\n}<\/code><\/pre>\n
Now, let’s move onto the arguments in favor of IllegalArgumentException<\/em>.<\/p>\n
2.1. It’s How the Javadoc Says to Use It<\/h3>\n
<\/div>\n
When we read the Javadoc for IllegalArgumentException<\/em><\/a>, it says it’s for use when an illegal or inappropriate value is passed to a method<\/strong>. We can consider a null<\/em> object to be illegal or inappropriate if our method isn’t expecting it, and this would be an appropriate exception for us to throw.<\/p>\n
2.2. It Matches Developer Expectations<\/h3>\n
<\/div>\n
Next, let’s think about how we, as developers, think when we see stack traces in our applications. A very common scenario in which we receive a NullPointerException<\/em> is when we’ve accidentally tried to access a null<\/em> object. In this case, we’re going to go as deep into the stack as we can to see what we’re referencing that’s null<\/em>.<\/p>\n
When we get an IllegalArgumentException<\/em>, we are likely to assume that we’re passing something wrong to a method. In this case, we’ll look in the stack for the bottom-most method we’re calling and start our debugging from there. If we consider this way of thinking, the IllegalArgumentException<\/em> is going to get us into our stack closer to where the mistake is being made.<\/p>\n
\u00a02.3. Other Arguments<\/h3>\n
<\/div>\n
Before we move onto the arguments for NullPointerException<\/em>, let’s look at a couple of smaller points in favor of IllegalArgumentException<\/em>. Some developers feel that only the JDK should be throwing NullPointerException<\/em>. As we’ll see in the next section, the Javadoc doesn’t support this theory. Another argument is that it’s more consistent to use IllegalArgumentException<\/em> since that’s what we’d use for other illegal parameter values.<\/p>\n
3. NullPointerException<\/em><\/h2>\n
<\/div>\n
Next, let’s consider the arguments for NullPointerException<\/em>.<\/p>\n
Let’s create an example that throws a NullPointerException<\/em>:<\/p>\n
public void processSomethingElseNotNull(Object myParameter) {\r\n    if (myParameter == null) {\r\n        throw new NullPointerException(\"Parameter 'myParameter' cannot be null\");\r\n    }\r\n}<\/code><\/pre>\n
3.1. It’s How the Javadoc Says to Use It<\/h3>\n
<\/div>\n
According to the Javadoc for NullPointerException<\/em><\/a>, NullPointerException<\/em> is meant to be used for attempting to use null<\/em> where an object is required<\/strong>. If our method parameter isn’t intended to be null<\/em>, then we could reasonably consider this as an object being required and throw the NullPointerException<\/em>.<\/p>\n
3.2. It’s Consistent with JDK APIs<\/h3>\n
<\/div>\n
Let’s take a moment to think about many of the common JDK methods we call during development. Many of them throw a NullPointerException<\/em> if we provide a null<\/em>. Additionally, Objects.requireNonNull() <\/em>throws a\u00a0NullPointerException\u00a0<\/em>if we pass in null.<\/em> According to the Objects<\/em> documentation,<\/a> it exists mostly for validating parameters.<\/p>\n
In addition to JDK methods that throw NullPointerException<\/em>, we can find other examples of specific exception types being thrown from methods in the Collections API. ArrayList.addAll(index, Collection)<\/em> throws an IndexOutOfBoundsException<\/em> if the index is outside of the list size and throws a NullPointerException<\/em> if the collection is null<\/em><\/strong>. These are two very specific exception types rather than the more generic IllegalArgumentException<\/em>.<\/p>\n
We could consider IllegalArgumentException<\/em> to be meant for cases when we don’t have a more specific exception type available to us.<\/p>\n
4. Conclusion<\/h2>\n
<\/div>\n
As we’ve seen in this tutorial, this is a question that doesn’t have a clear answer. The documentation for the two exceptions seems to overlap in that when taken alone, they both sound appropriate. There are also additional compelling arguments for both sides based on how developers do their debugging and on patterns seen in the JDK methods themselves.<\/p>\n
Whichever exception we chose, we should be consistent throughout our application. Additionally, we can make our exceptions more useful by providing meaningful information to the exception constructor. For example, our applications will be easier to debug if we provide the parameter name in the exception message.<\/p>\n
As always, the example code is available over on GitHub<\/a>.<\/p>\n
\"\"<\/p>\n
<\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/div>\n\n
\\\"IT\u96fb\u8166\u88dc\u7fd2
\u7acb\u523b\u8a3b\u518a\u53ca\u5831\u540d\u96fb\u8166\u88dc\u7fd2\u8ab2\u7a0b\u5427!<\/figcaption><\/figure>\r\n<\/br>Find A Teacher Form:\r\n<\/br>https:\/\/docs.google.com\/forms\/d\/1vREBnX5n262umf4wU5U2pyTwvk9O-JrAgblA-wH9GFQ\/viewform?edit_requested=true#responses\r\n<\/br><\/br>Email:\r\n<\/br>public1989two@gmail.com






\r\nwww.itsec.hk<\/a>
\r\nwww.itsec.vip<\/a>
\r\nwww.itseceu.uk<\/a>
<\/p>","protected":false},"excerpt":{"rendered":"
Explore the issue of which exception to throw when someone passes a null parameter to one of our methods: IllegalArgumentExcpetion or NullPointerException.<\/p>\n
<\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/div>\n<\/div>","protected":false},"author":779,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"slim_seo":{"title":"IllegalArgumentException or NullPointerException for a Null Parameter? - ITTeacherITFreelance.hk","description":"Explore the issue of which exception to throw when someone passes a null parameter to one of our methods: IllegalArgumentExcpetion or NullPointerException. &nbs"},"footnotes":""},"categories":[6],"tags":[],"_links":{"self":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts\/63371"}],"collection":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/users\/779"}],"replies":[{"embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/comments?post=63371"}],"version-history":[{"count":10,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts\/63371\/revisions"}],"predecessor-version":[{"id":68022,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts\/63371\/revisions\/68022"}],"wp:attachment":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/media?parent=63371"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/categories?post=63371"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/tags?post=63371"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}