stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

4285505: deprecate java.lang.Compiler

Browse Source 
Reviewed-by: shade, forax, kmo, tellison, mchung, alanb, rriggs
This commit is contained in:
Stuart Marks 2016-09-09 12:07:49 -07:00
parent 44d69dd31b
commit e249470c72
1 changed files with 8 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
jdk/src/java.base/share/classes/java/lang/Compiler.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1995, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -29,21 +29,18 @@ package java.lang;
* The {@code Compiler} class is provided to support Java-to-native-code
* compilers and related services. By design, the {@code Compiler} class does
* nothing; it serves as a placeholder for a JIT compiler implementation.
* If no compiler is available, these methods do nothing.
*
* <p> When the Java Virtual Machine first starts, it determines if the system
* property {@code java.compiler} exists. (System properties are accessible
* through {@link System#getProperty(String)} and {@link
* System#getProperty(String, String)}. If so, it is assumed to be the name of
* a library (with a platform-dependent exact location and type); {@link
* System#loadLibrary} is called to load that library. If this loading
* succeeds, the function named {@code java_lang_Compiler_start()} in that
* library is called.
*
* <p> If no compiler is available, these methods do nothing.
* @deprecated JIT compilers and their technologies vary too widely to
* be controlled effectively by a standardized interface. As such, many
* JIT compiler implementations ignore this interface, and are instead
* controllable by implementation-specific mechanisms such as command-line
* options. This class is subject to removal in a future version of Java SE.
*
* @author Frank Yellin
* @since 1.0
*/
@Deprecated(since="9", forRemoval=true)
public final class Compiler {
private Compiler() {} // don't make instances