# oslc/adaptor-bugzilla-eclipse-archive architecture

> Architecture diagram of the GitHub repository oslc/adaptor-bugzilla-eclipse-archive, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/oslc/adaptor-bugzilla-eclipse-archive
- Repository: https://github.com/oslc/adaptor-bugzilla-eclipse-archive

## Overview

This is an OSLC Change Management server exposing archived Eclipse Lyo Bugzilla issues as OSLC resources. The main flow is an OSLC client request routed by the JAX-RS application to a change-request service; the delegate obtains archive data, maps it into Bugzilla change-request resources, and the server returns those resources. Separate endpoints provide comments and OSLC discovery metadata and resource shapes. The archive/parser internals and several service relationships are supported by the source index; unsampled routing details and the purpose of the delegated UI scripts are not inferred.

Main entry points: [`source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java) (JAX-RS application), [`source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java`](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java) (XML bug archive), [`source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java`](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java) (Catalog registry), [`source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java`](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java) (Comment service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP Runtime"]
  node_app["JAX-RS application<br/>[Application.java]"]
  node_bugservice["Change-request service"]
  node_commentservice["Comment service"]
  node_delegate["Resource delegate<br/>[RestDelegate.java]"]
end

subgraph group_archive["Bug Archive"]
  node_archive_store[("XML bug archive")]
  node_bug["Bug record<br/>[Bug.java]"]
  node_comment["Bug comment<br/>[Comment.java]"]
end

subgraph group_resources["OSLC Resources"]
  node_change["Change request model<br/>[ChangeRequest.java]"]
  node_bugchange["Bugzilla request model"]
  node_person["Person model<br/>[Person.java]"]
  node_type["Type model<br/>[Type.java]"]
  node_factory["Resource URI factory"]
  node_bugcomment["OSLC comment model"]
end

subgraph group_discovery["OSLC Discovery"]
  node_catalog[("Catalog registry")]
  node_providers["Provider factory"]
  node_catalogservice["Catalog endpoint"]
  node_providerservice["Provider endpoint"]
  node_rootservice["Root services"]
  node_shapeservice["Resource shapes"]
end

node_client(("OSLC client"))

node_client -.->|"sends requests"| node_app
node_app -->|"routes requests"| node_bugservice
node_app -->|"routes requests"| node_commentservice
node_app -->|"routes requests"| node_catalogservice
node_app -->|"routes requests"| node_providerservice
node_app -->|"routes requests"| node_shapeservice
node_bugservice -.->|"delegates retrieval"| node_delegate
node_commentservice -->|"reads archive"| node_archive_store
node_commentservice -->|"uses URIs"| node_factory
node_delegate -->|"retrieves records"| node_archive_store
node_delegate -->|"maps bug data"| node_bugchange
node_archive_store -->|"loads records"| node_bug
node_archive_store -->|"loads comments"| node_comment
node_bugchange -->|"extends model"| node_change
node_change -->|"uses person data"| node_person
node_change -->|"uses type data"| node_type
node_catalogservice -->|"reads catalog"| node_catalog
node_providerservice -->|"reads providers"| node_catalog
node_rootservice -->|"reads catalog"| node_catalog
node_catalog -->|"creates providers"| node_providers

click node_app "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java"
click node_bugservice "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaChangeRequestService.java"
click node_commentservice "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java"
click node_delegate "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/RestDelegate.java"
click node_archive_store "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java"
click node_bug "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/Bug.java"
click node_comment "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/Comment.java"
click node_change "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java"
click node_bugchange "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java"
click node_person "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/Person.java"
click node_type "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/Type.java"
click node_factory "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/ResourcesFactory.java"
click node_bugcomment "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaComment.java"
click node_catalog "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java"
click node_providers "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProvidersFactory.java"
click node_catalogservice "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java"
click node_providerservice "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java"
click node_rootservice "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java"
click node_shapeservice "https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ResourceShapeService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_bugservice,node_commentservice,node_delegate,node_client toneBlue
class node_archive_store,node_bug,node_comment toneAmber
class node_change,node_bugchange,node_person,node_type,node_factory,node_bugcomment toneMint
class node_catalog,node_providers,node_catalogservice,node_providerservice,node_rootservice,node_shapeservice toneRose
```

## Components

### HTTP Runtime

- [JAX-RS application](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`
- [Change-request service](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaChangeRequestService.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaChangeRequestService.java`
- [Comment service](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java`
- [Resource delegate](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/RestDelegate.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/RestDelegate.java`

### Bug Archive

- [XML bug archive](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java`
- [Bug record](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/Bug.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/Bug.java`
- [Bug comment](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/Comment.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/Comment.java`

### OSLC Resources

- [Change request model](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`
- [Bugzilla request model](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java`
- [Person model](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/Person.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/Person.java`
- [Type model](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/Type.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/Type.java`
- [Resource URI factory](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/ResourcesFactory.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/ResourcesFactory.java`
- [OSLC comment model](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaComment.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaComment.java`

### OSLC Discovery

- [Catalog registry](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java`
- [Provider factory](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProvidersFactory.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProvidersFactory.java`
- [Catalog endpoint](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java`
- [Provider endpoint](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java`
- [Root services](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java`
- [Resource shapes](https://github.com/oslc/adaptor-bugzilla-eclipse-archive/blob/main/source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ResourceShapeService.java): `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ResourceShapeService.java`

### Other components

- **OSLC client**

## Connections

- OSLC client → JAX-RS application: sends requests
- JAX-RS application → Change-request service: routes requests (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Comment service: routes requests (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Catalog endpoint: routes requests (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Provider endpoint: routes requests (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Resource shapes: routes requests (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- Change-request service → Resource delegate: delegates retrieval
- Comment service → XML bug archive: reads archive (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java`)
- Comment service → Resource URI factory: uses URIs (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/BugzillaCommentService.java`)
- Resource delegate → XML bug archive: retrieves records (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/RestDelegate.java`)
- Resource delegate → Bugzilla request model: maps bug data (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/RestDelegate.java`)
- XML bug archive → Bug record: loads records (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java`)
- XML bug archive → Bug comment: loads comments (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/bugzilla/BugzillaArchive.java`)
- Bugzilla request model → Change request model: extends model (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java`)
- Change request model → Person model: uses person data (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`)
- Change request model → Type model: uses type data (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`)
- Catalog endpoint → Catalog registry: reads catalog (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java`)
- Provider endpoint → Catalog registry: reads providers (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java`)
- Root services → Catalog registry: reads catalog (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java`)
- Catalog registry → Provider factory: creates providers (evidence: `source/BugzillaLyoArchives/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java`)
