Browse a repository
The Browse page shows what the repository holds, down to the entries inside a JAR file. You need the Read repository role.
Find an artifact
Browse opens on every artifact in the repository as Maven coordinates, with the most recently changed artifact first. Each row shows the group ID and artifact ID, the description from the POM, the highest version according to Maven version ordering, how many versions there are, and when the artifact last changed. Clicking a row opens that highest version.
Three views share the page:
- Artifacts lists every artifact.
- Groups shows the tree. Clicking a group shows the groups under it, with how many artifacts each branch holds, and the artifacts in the group itself.
- Files lists files by path, the most recently added first.
An artifact whose files were all deleted doesn't appear.
Search
The search box at the top narrows whichever view is showing. In Artifacts and Groups, the query is matched against the group ID, the artifact ID, and the name and description from the POM. The tree shows only the branches that contain a match. In Files, the query is matched against the path.
Every term is matched as a prefix, not as a substring, so widg finds widget but idget doesn't. In Files, a term can match any part of the path. Every term has to match, so adding a term narrows the results. You can separate terms with spaces or with a colon, so a coordinate pasted as com.example:widget works as a query.
Search covers the files that the repository stores, including files cached from upstreams. It doesn't search the upstreams themselves.
A version
A version page shows the following:
- Every file of the version, with its file type, size, and origin.
- The dependencies and dependency management entries from the POM. Each dependency is one coordinate, and a dependency that this repository holds links to its version page.
- The variants from Gradle Module Metadata (
.module), if the version has a.modulefile: what each variant is for, the files it carries, and its dependencies. See Gradle Module Metadata in Artifex.
Beside them, the page shows how to depend on the version from Gradle and Maven, every other version of the artifact, the name, description, license, and links from the POM, and the version's origin. To switch versions, pick one from the list or from the Version menu. For a snapshot version, its timestamped snapshots are listed too. See Snapshots.
If the version is relocated, the POM's relocation coordinates are shown.
A file
A file page shows the following:
- What it is: the coordinates, the name, the size, and the file type.
- Its origin: deployed here, or the upstream it was fetched from, by name. A fetched file shows every upstream in order and what each one did: not requested, not found, no response, not needed because an earlier upstream served the file, or served it, with how long each took to respond. When more than one upstream was requested, the page also shows how long the whole resolution took beside the serving upstream's own time. It also names who requested it, the token, client IP address, client, and time, and the upstream URL that served the file.
- Its SHA-256 checksum, and the MD5, SHA-1, and SHA-512 under Other checksums. Which of the upstream's own checksums were verified is shown beside them.
- The detached signature, if one was deployed next to it. See Checksums and signatures.
- The recorded events for that path, newest first. See Activity.
Open or download a file
The file page and the version page's file list offer the following actions:
- Download saves the file under its own name.
- Open lists the entries of a JAR, WAR, EAR, AAR, or zip file, and shows a POM, a Gradle
.modulefile, or another text file in your browser. Other files only download.
Inside an archive
For a JAR, WAR, EAR, AAR, or zip file, click Open to list the entries with their compressed and uncompressed sizes and their compression method.
Click an entry to open it. Text and images open in your browser; anything else downloads.
Read Javadoc
A Javadoc JAR file is an archive like any other, so you can read it in place instead of downloading and extracting it.
To read the Javadoc of a version, follow these steps:
- Open the version page.
- In the file list, click Open beside the file whose classifier is
javadoc. - In the entry list, open
index.html.
Delete
Where the repository's settings allow deleting, the file and version pages offer it. Deleting a version deletes every file of that version. For more information, see Immutability.
Advanced
Archive entries are served in a sandbox, so a page inside an archive can't act as Artifex, read your session, or use the rest of the site. An entry that uses a compression method other than stored or deflated can't be shown.