8142968: Module System implementation
Initial integration of JEP 200, JEP 260, JEP 261, and JEP 282
Co-authored-by: Alex Buckley <alex.buckley@oracle.com>
Co-authored-by: Jonathan Gibbons <jonathan.gibbons@oracle.com>
Co-authored-by: Karen Kinnear <karen.kinnear@oracle.com>
Co-authored-by: Mandy Chung <mandy.chung@oracle.com>
Co-authored-by: Mark Reinhold <mark.reinhold@oracle.com>
Co-authored-by: Chris Hegarty <chris.hegarty@oracle.com>
Co-authored-by: Alexandr Scherbatiy <alexandr.scherbatiy@oracle.com>
Co-authored-by: Amy Lu <amy.lu@oracle.com>
Co-authored-by: Calvin Cheung <calvin.cheung@oracle.com>
Co-authored-by: Daniel Fuchs <daniel.fuchs@oracle.com>
Co-authored-by: Erik Joelsson <erik.joelsson@oracle.com>
Co-authored-by: Harold Seigel <harold.seigel@oracle.com>
Co-authored-by: Jaroslav Bachorik <jaroslav.bachorik@oracle.com>
Co-authored-by: Jean-Francois Denise <jean-francois.denise@oracle.com>
Co-authored-by: Jan Lahoda <jan.lahoda@oracle.com>
Co-authored-by: James Laskey <james.laskey@oracle.com>
Co-authored-by: Lois Foltan <lois.foltan@oracle.com>
Co-authored-by: Miroslav Kos <miroslav.kos@oracle.com>
Co-authored-by: Huaming Li <huaming.li@oracle.com>
Co-authored-by: Sean Mullan <sean.mullan@oracle.com>
Co-authored-by: Naoto Sato <naoto.sato@oracle.com>
Co-authored-by: Masayoshi Okutsu <masayoshi.okutsu@oracle.com>
Co-authored-by: Peter Levart <peter.levart@gmail.com>
Co-authored-by: Philip Race <philip.race@oracle.com>
Co-authored-by: Claes Redestad <claes.redestad@oracle.com>
Co-authored-by: Sergey Bylokhov <sergey.bylokhov@oracle.com>
Co-authored-by: Alexandre Iline <alexandre.iline@oracle.com>
Co-authored-by: Volker Simonis <volker.simonis@gmail.com>
Co-authored-by: Staffan Larsen <staffan.larsen@oracle.com>
Co-authored-by: Stuart Marks <stuart.marks@oracle.com>
Co-authored-by: Semyon Sadetsky <semyon.sadetsky@oracle.com>
Co-authored-by: Serguei Spitsyn <serguei.spitsyn@oracle.com>
Co-authored-by: Sundararajan Athijegannathan <sundararajan.athijegannathan@oracle.com>
Co-authored-by: Valerie Peng <valerie.peng@oracle.com>
Co-authored-by: Vincent Ryan <vincent.x.ryan@oracle.com>
Co-authored-by: Weijun Wang <weijun.wang@oracle.com>
Co-authored-by: Yuri Nesterenko <yuri.nesterenko@oracle.com>
Co-authored-by: Yekaterina Kantserova <yekaterina.kantserova@oracle.com>
Co-authored-by: Alexander Kulyakthin <alexander.kulyakhtin@oracle.com>
Co-authored-by: Felix Yang <felix.yang@oracle.com>
Co-authored-by: Andrei Eremeev <andrei.eremeev@oracle.com>
Co-authored-by: Frank Yuan <frank.yuan@oracle.com>
Co-authored-by: Sergei Pikalev <sergei.pikalev@oracle.com>
Co-authored-by: Sibabrata Sahoo <sibabrata.sahoo@oracle.com>
Co-authored-by: Tiantian Du <tiantian.du@oracle.com>
Co-authored-by: Sha Jiang <sha.jiang@oracle.com>
Reviewed-by: alanb, mchung, naoto, rriggs, psandoz, plevart, mullan, ascarpino, vinnie, prr, sherman, dfuchs, mhaupt
2016-03-17 19:04:16 +00:00
|
|
|
/*
|
|
|
|
* Copyright (c) 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
|
|
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
|
|
*
|
|
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
|
|
* accompanied this code).
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License version
|
|
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
*
|
|
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
|
|
* questions.
|
|
|
|
*/
|
|
|
|
|
|
|
|
package java.lang.module;
|
|
|
|
|
|
|
|
import java.util.Objects;
|
|
|
|
import java.util.Set;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A module in a graph of <em>resolved modules</em>.
|
|
|
|
*
|
|
|
|
* <p> {@code ResolvedModule} defines the {@link #configuration configuration}
|
|
|
|
* method to get the configuration that the resolved module is in. It defines
|
|
|
|
* the {@link #reference() reference} method to get the reference to the
|
|
|
|
* module's content.
|
|
|
|
*
|
|
|
|
* @since 9
|
2017-02-10 09:04:39 +00:00
|
|
|
* @spec JPMS
|
8142968: Module System implementation
Initial integration of JEP 200, JEP 260, JEP 261, and JEP 282
Co-authored-by: Alex Buckley <alex.buckley@oracle.com>
Co-authored-by: Jonathan Gibbons <jonathan.gibbons@oracle.com>
Co-authored-by: Karen Kinnear <karen.kinnear@oracle.com>
Co-authored-by: Mandy Chung <mandy.chung@oracle.com>
Co-authored-by: Mark Reinhold <mark.reinhold@oracle.com>
Co-authored-by: Chris Hegarty <chris.hegarty@oracle.com>
Co-authored-by: Alexandr Scherbatiy <alexandr.scherbatiy@oracle.com>
Co-authored-by: Amy Lu <amy.lu@oracle.com>
Co-authored-by: Calvin Cheung <calvin.cheung@oracle.com>
Co-authored-by: Daniel Fuchs <daniel.fuchs@oracle.com>
Co-authored-by: Erik Joelsson <erik.joelsson@oracle.com>
Co-authored-by: Harold Seigel <harold.seigel@oracle.com>
Co-authored-by: Jaroslav Bachorik <jaroslav.bachorik@oracle.com>
Co-authored-by: Jean-Francois Denise <jean-francois.denise@oracle.com>
Co-authored-by: Jan Lahoda <jan.lahoda@oracle.com>
Co-authored-by: James Laskey <james.laskey@oracle.com>
Co-authored-by: Lois Foltan <lois.foltan@oracle.com>
Co-authored-by: Miroslav Kos <miroslav.kos@oracle.com>
Co-authored-by: Huaming Li <huaming.li@oracle.com>
Co-authored-by: Sean Mullan <sean.mullan@oracle.com>
Co-authored-by: Naoto Sato <naoto.sato@oracle.com>
Co-authored-by: Masayoshi Okutsu <masayoshi.okutsu@oracle.com>
Co-authored-by: Peter Levart <peter.levart@gmail.com>
Co-authored-by: Philip Race <philip.race@oracle.com>
Co-authored-by: Claes Redestad <claes.redestad@oracle.com>
Co-authored-by: Sergey Bylokhov <sergey.bylokhov@oracle.com>
Co-authored-by: Alexandre Iline <alexandre.iline@oracle.com>
Co-authored-by: Volker Simonis <volker.simonis@gmail.com>
Co-authored-by: Staffan Larsen <staffan.larsen@oracle.com>
Co-authored-by: Stuart Marks <stuart.marks@oracle.com>
Co-authored-by: Semyon Sadetsky <semyon.sadetsky@oracle.com>
Co-authored-by: Serguei Spitsyn <serguei.spitsyn@oracle.com>
Co-authored-by: Sundararajan Athijegannathan <sundararajan.athijegannathan@oracle.com>
Co-authored-by: Valerie Peng <valerie.peng@oracle.com>
Co-authored-by: Vincent Ryan <vincent.x.ryan@oracle.com>
Co-authored-by: Weijun Wang <weijun.wang@oracle.com>
Co-authored-by: Yuri Nesterenko <yuri.nesterenko@oracle.com>
Co-authored-by: Yekaterina Kantserova <yekaterina.kantserova@oracle.com>
Co-authored-by: Alexander Kulyakthin <alexander.kulyakhtin@oracle.com>
Co-authored-by: Felix Yang <felix.yang@oracle.com>
Co-authored-by: Andrei Eremeev <andrei.eremeev@oracle.com>
Co-authored-by: Frank Yuan <frank.yuan@oracle.com>
Co-authored-by: Sergei Pikalev <sergei.pikalev@oracle.com>
Co-authored-by: Sibabrata Sahoo <sibabrata.sahoo@oracle.com>
Co-authored-by: Tiantian Du <tiantian.du@oracle.com>
Co-authored-by: Sha Jiang <sha.jiang@oracle.com>
Reviewed-by: alanb, mchung, naoto, rriggs, psandoz, plevart, mullan, ascarpino, vinnie, prr, sherman, dfuchs, mhaupt
2016-03-17 19:04:16 +00:00
|
|
|
* @see Configuration#modules()
|
|
|
|
*/
|
|
|
|
public final class ResolvedModule {
|
|
|
|
|
|
|
|
private final Configuration cf;
|
|
|
|
private final ModuleReference mref;
|
|
|
|
|
|
|
|
ResolvedModule(Configuration cf, ModuleReference mref) {
|
|
|
|
this.cf = Objects.requireNonNull(cf);
|
|
|
|
this.mref = Objects.requireNonNull(mref);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the configuration that this resolved module is in.
|
|
|
|
*
|
|
|
|
* @return The configuration that this resolved module is in
|
|
|
|
*/
|
|
|
|
public Configuration configuration() {
|
|
|
|
return cf;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the reference to the module's content.
|
|
|
|
*
|
|
|
|
* @return The reference to the module's content
|
|
|
|
*/
|
|
|
|
public ModuleReference reference() {
|
|
|
|
return mref;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the module descriptor.
|
|
|
|
*
|
|
|
|
* This convenience method is the equivalent to invoking:
|
|
|
|
* <pre> {@code
|
|
|
|
* reference().descriptor()
|
|
|
|
* }</pre>
|
|
|
|
*
|
|
|
|
* @return The module descriptor
|
|
|
|
*/
|
|
|
|
ModuleDescriptor descriptor() {
|
|
|
|
return reference().descriptor();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the module name.
|
|
|
|
*
|
|
|
|
* This convenience method is the equivalent to invoking:
|
|
|
|
* <pre> {@code
|
|
|
|
* reference().descriptor().name()
|
|
|
|
* }</pre>
|
|
|
|
*
|
|
|
|
* @return The module name
|
|
|
|
*/
|
|
|
|
public String name() {
|
|
|
|
return reference().descriptor().name();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the set of resolved modules that this resolved module reads.
|
|
|
|
*
|
|
|
|
* @return A possibly-empty unmodifiable set of resolved modules that
|
|
|
|
* this resolved module reads
|
|
|
|
*/
|
|
|
|
public Set<ResolvedModule> reads() {
|
|
|
|
return cf.reads(this);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Computes a hash code for this resolved module.
|
|
|
|
*
|
|
|
|
* <p> The hash code is based upon the components of the resolved module
|
|
|
|
* and satisfies the general contract of the {@link Object#hashCode
|
|
|
|
* Object.hashCode} method. </p>
|
|
|
|
*
|
|
|
|
* @return The hash-code value for this resolved module
|
|
|
|
*/
|
|
|
|
@Override
|
|
|
|
public int hashCode() {
|
|
|
|
return cf.hashCode() ^ mref.hashCode();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Tests this resolved module for equality with the given object.
|
|
|
|
*
|
|
|
|
* <p> If the given object is not a {@code ResolvedModule} then this
|
|
|
|
* method returns {@code false}. Two {@code ResolvedModule} objects are
|
|
|
|
* equal if they are in the same configuration and have equal references
|
|
|
|
* to the module content. </p>
|
|
|
|
*
|
|
|
|
* <p> This method satisfies the general contract of the {@link
|
|
|
|
* java.lang.Object#equals(Object) Object.equals} method. </p>
|
|
|
|
*
|
|
|
|
* @param ob
|
|
|
|
* the object to which this object is to be compared
|
|
|
|
*
|
|
|
|
* @return {@code true} if, and only if, the given object is a module
|
|
|
|
* reference that is equal to this module reference
|
|
|
|
*/
|
|
|
|
@Override
|
|
|
|
public boolean equals(Object ob) {
|
|
|
|
if (!(ob instanceof ResolvedModule))
|
|
|
|
return false;
|
|
|
|
|
|
|
|
ResolvedModule that = (ResolvedModule) ob;
|
|
|
|
return Objects.equals(this.cf, that.cf)
|
|
|
|
&& Objects.equals(this.mref, that.mref);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a string describing this resolved module.
|
|
|
|
*
|
|
|
|
* @return A string describing this resolved module
|
|
|
|
*/
|
|
|
|
@Override
|
|
|
|
public String toString() {
|
|
|
|
return System.identityHashCode(cf) + "/" + name();
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|