Why does parseInt warn of using valueOf

When looking at the source code for Integer.parseInt(String s, int radix) (java 8, 1.8.0_131), I found the following comment block:

/*
* WARNING: This method may be invoked early during VM initialization
* before IntegerCache is initialized. Care must be taken to not use
* the valueOf method.
*/

While I understand the first part about the IntegerCache, I don't understand why there's a warning about valueOf, and why in this context.

I see that valueOf() relies on parseInt(), but I still don't get why there's this warning.

Can someone explain what exactly the comment warns me about (and the context where valueOf shouldn't be used), and what could possibly go wrong.

Edit:

The code in Integer.valueOf(int i) seems to have changed since the other question from the comment below was asked, it is now

public static Integer valueOf(int i) {
    if (i >= IntegerCache.low && i <= IntegerCache.high)
        return IntegerCache.cache[i + (-IntegerCache.low)];
    return new Integer(i);
}

and should be save from the assertion error before.

> Can someone explain what exactly the comment warns me about (and the context where valueOf shouldn't be used), and what could possibly go wrong.

The Integer class creates and maintains a cache of Integer objects representing small integer values; by default, values in the range -128 to 127 are covered (more discussion here, here, and many other places). Integer.valueOf() will return an object from this cache when its argument represents a number in the range. The comment is warning that parseInt() must not rely on valueOf() because the former may be invoked before that cache is populated.

The misbehavior that could be expected in that case is not specified, and conceivably might vary between Java versions, but plausible possibilities are that null would be returned or an exception (NullPointerException, IndexOutOfBoundsException, ...) would be thrown.

In any case, this is an internal comment in the implementation, not a comment to users of class Integer. By the time any user code runs, the necessary cache initialization is complete, and Integer.valueOf() can be relied upon to behave fully as its API documentation describes.

The source code is (almost) just for reference, the javadoc does not contain that warning because it is only intended for the developers of Java itself.

It is probably a warning since there was some problem or bug caused by someone using the valueOf method to code the parseInt method which can be called before the internal cache is initialized.

In other words, that warning is not intended for you, assuming you are not changing the Integer class!