Package (jdk.compiler 1.8.132 API)

java.lang.Object
- com.sun.tools.sjavac.Package

All Implemented Interfaces:

Comparable<Package>
```
public class Package
extends Object
implements Comparable<Package>
```
The Package class maintains meta information about a package. For example its sources, dependents,its pubapi and its artifacts. It might look odd that we track dependents/pubapi/artifacts on a package level, but it makes sense since recompiling a full package takes as long as recompiling a single java file in that package, if you take into account the startup time of the jvm. Also the dependency information will be much smaller (good for the javac_state file size) and it simplifies tracking artifact generation, you do not always know from which source a class file was generated, but you always know which package it belongs to. It is also educational to see package dependencies triggering recompilation of other packages. Even though the recompilation was perhaps not necessary, the visible recompilation of the dependent packages indicates how much circular dependencies your code has.
This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Constructor Summary

Constructors
Constructor and Description

Package(Module m, String n)

Constructors
Constructor and Description
`Package(Module m, String n)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addArtifact(File f)`
`void`	`addArtifact(String a)`
`void`	`addArtifacts(Set<URI> as)`
`void`	`addDependency(String d)`
`void`	`addDependent(String d)`
`void`	`addPubapi(String p)`
`void`	`addSource(Source s)`
`Map<String,File>`	`artifacts()`
`int`	`compareTo(Package o)`
`void`	`deleteArtifacts()` Always clean out a tainted package before it is recompiled.
`Set<String>`	`dependencies()`
`Set<String>`	`dependents()`
`String`	`dirname()`
`boolean`	`equals(Object o)`
`boolean`	`existsInJavacState()` Check if we have knowledge in the javac state that describe the results of compiling this package before.
`int`	`hashCode()`
`boolean`	`hasPubapiChanged(List<String> ps)`
`static Package`	`load(Module module, String l)`
`void`	`loadArtifact(String l)`
`void`	`loadDependency(String l)`
`void`	`loadPubapi(String l)`
`Module`	`mod()`
`String`	`name()`
`List<String>`	`pubapi()`
`static List<String>`	`pubapiToList(String ps)`
`void`	`save(StringBuilder b)`
`void`	`saveArtifacts(StringBuilder b)`
`void`	`saveDependencies(StringBuilder b)`
`static void`	`savePackages(Map<String,Package> packages, StringBuilder b)`
`void`	`savePubapi(StringBuilder b)`
`void`	`setArtifacts(Set<URI> as)`
`void`	`setDependencies(Set<String> ds)`
`void`	`setPubapi(List<String> ps)`
`Map<String,Source>`	`sources()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Package

public Package(Module m,
               String n)

Method Detail

mod
```
public Module mod()
```

name
```
public String name()
```

dirname
```
public String dirname()
```

sources
```
public Map<String,Source> sources()
```

artifacts
```
public Map<String,File> artifacts()
```

pubapi
```
public List<String> pubapi()
```

dependencies
```
public Set<String> dependencies()
```

dependents
```
public Set<String> dependents()
```

equals
```
public boolean equals(Object o)
```
Overrides:

equals in class Object

hashCode
```
public int hashCode()
```
Overrides:

hashCode in class Object

compareTo
```
public int compareTo(Package o)
```
Specified by:

compareTo in interface Comparable<Package>

addSource
```
public void addSource(Source s)
```

addDependency
```
public void addDependency(String d)
```

addDependent
```
public void addDependent(String d)
```

addPubapi
```
public void addPubapi(String p)
```

existsInJavacState
```
public boolean existsInJavacState()
```
Check if we have knowledge in the javac state that describe the results of compiling this package before.

pubapiToList

public static List<String> pubapiToList(String ps)

hasPubapiChanged

public boolean hasPubapiChanged(List<String> ps)

setPubapi

public void setPubapi(List<String> ps)

setDependencies

public void setDependencies(Set<String> ds)

save
```
public void save(StringBuilder b)
```

load

public static Package load(Module module,
                           String l)

loadDependency
```
public void loadDependency(String l)
```

loadPubapi
```
public void loadPubapi(String l)
```

saveDependencies

public void saveDependencies(StringBuilder b)

savePubapi

public void savePubapi(StringBuilder b)

savePackages

public static void savePackages(Map<String,Package> packages,
                                StringBuilder b)

addArtifact
```
public void addArtifact(String a)
```

addArtifact
```
public void addArtifact(File f)
```

addArtifacts

public void addArtifacts(Set<URI> as)

setArtifacts

public void setArtifacts(Set<URI> as)

loadArtifact
```
public void loadArtifact(String l)
```

saveArtifacts

public void saveArtifacts(StringBuilder b)

deleteArtifacts
```
public void deleteArtifacts()
```
Always clean out a tainted package before it is recompiled.

Class Package

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Package

Method Detail

mod

name

dirname

sources

artifacts

pubapi

dependencies

dependents

equals

hashCode

compareTo

addSource

addDependency

addDependent

addPubapi

existsInJavacState

pubapiToList

hasPubapiChanged

setPubapi

setDependencies

save

load

loadDependency

loadPubapi

saveDependencies

savePubapi

savePackages

addArtifact

addArtifact

addArtifacts

setArtifacts

loadArtifact

saveArtifacts

deleteArtifacts