java

Documentation

Overview

Package java contains components for interrogating java packages in container layers.

Package java contains components for interrogating java maven packages in container layers.

Index

• Constants
• Variables
• func NewCoalescer(_ context.Context) (indexer.Coalescer, error)
• func NewEcosystem(ctx context.Context) *indexer.Ecosystem
• type RepoScanner
  • func (*RepoScanner) Kind() string
  • func (*RepoScanner) Name() string
  • func (rs *RepoScanner) Scan(ctx context.Context, layer *claircore.Layer) ([]*claircore.Repository, error)
  • func (*RepoScanner) Version() string
• type Scanner
  • func (s *Scanner) Configure(ctx context.Context, f indexer.ConfigDeserializer, c *http.Client) error
  • func (*Scanner) Kind() string
  • func (*Scanner) Name() string
  • func (s *Scanner) Scan(ctx context.Context, layer *claircore.Layer) ([]*claircore.Package, error)
  • func (*Scanner) Version() string
• type ScannerConfig
• Bugs

Constants

const DefaultSearchAPI = `https://search.maven.org/solrsearch/select`

Variables

var (
	Repository = claircore.Repository{
		Name: "maven",
		URI:  "https://repo1.maven.apache.org/maven2",
	}
)

Functions

func NewCoalescer

func NewCoalescer(_ context.Context) (indexer.Coalescer, error)

func NewEcosystem

func NewEcosystem(ctx context.Context) *indexer.Ecosystem

NewEcosystem provides the set of scanners for the java ecosystem.

Types

type RepoScanner

type RepoScanner struct{}

func (*RepoScanner) Kind

func (*RepoScanner) Kind() string

Kind implements scanner.VersionedScanner.

func (*RepoScanner) Name

func (*RepoScanner) Name() string

Name implements scanner.VersionedScanner.

func (*RepoScanner) Scan

func (rs *RepoScanner) Scan(ctx context.Context, layer *claircore.Layer) ([]*claircore.Repository, error)

Scan attempts to find jar, war or ear and record the package information there.

A return of (nil, nil) is expected if there's nothing found.

func (*RepoScanner) Version

func (*RepoScanner) Version() string

Version implements scanner.VersionedScanner.

type Scanner

type Scanner struct {
	// contains filtered or unexported fields
}

Scanner implements the scanner.PackageScanner interface.

It looks for files that seem like jar, war or ear, and looks at the metadata recorded there.

The zero value is ready to use.

func (*Scanner) Configure

func (s *Scanner) Configure(ctx context.Context, f indexer.ConfigDeserializer, c *http.Client) error

Configure implements indexer.RPCScanner.

func (*Scanner) Kind

func (*Scanner) Kind() string

Kind implements scanner.VersionedScanner.

func (*Scanner) Name

func (*Scanner) Name() string

Name implements scanner.VersionedScanner.

func (*Scanner) Scan

func (s *Scanner) Scan(ctx context.Context, layer *claircore.Layer) ([]*claircore.Package, error)

Scan attempts to find jar, war or ear files and record the package information there.

A return of (nil, nil) is expected if there's nothing found.

func (*Scanner) Version

func (*Scanner) Version() string

Version implements scanner.VersionedScanner.

type ScannerConfig

type ScannerConfig struct {
	// API is a URL endpoint to a maven-like REST API.
	// The default is DefaultSearchAPI.
	API string `yaml:"api" json:"api"`
}

ScannerConfig is the struct used to configure a Scanner.

Notes

Bugs

• There's no way for a scanner that makes RPC calls to signal "the call failed, these are best-effort results, and please retry."

• There's probably some bugs lurking in the jar.Info → claircore.Package mapping code around embedded jars. There's a testcase to be written, there.