{ "appStats": { "projectName": "petstore1.3.2", "currentDate": "04/01/2026, 10:55:35", "llmProvider": "VertexAI Gemini (Gemini Embeddings, Gemini Pro 3.0, Gemini Pro 2.5)", "fileCount": 565, "linesOfCode": 72079, "appDescription": "The application is the Java Pet Store Demo 1.3.2, a reference implementation of the J2EE BluePrints design guidelines. It is a comprehensive e-commerce platform designed to demonstrate the capabilities of the J2EE 1.3 platform, specifically focusing on Enterprise JavaBeans (EJB 2.0), Servlets, JSP, and JMS. The application is architected as a multi-tier system comprising a Web Tier, an EJB Tier, and a Client Tier. The Web Tier utilizes a custom Web Application Framework (WAF) that implements the Model-View-Controller (MVC) pattern, featuring a Front Controller (MainServlet), Request Processor, and a Templating mechanism for composite views. The EJB Tier encapsulates business logic using Session Beans (e.g., ShoppingController, SignOn), Entity Beans (e.g., Customer, PurchaseOrder, Catalog), and Message-Driven Beans (MDBs) for asynchronous processing. The application simulates a real-world scenario involving three main sub-applications: the Pet Store (B2C interface for customers), the Order Processing Center (OPC) for back-office order fulfillment, and a Supplier module for B2B inventory management. It relies heavily on asynchronous messaging via JMS to decouple the order lifecycle steps, such as order approval, invoicing, and shipping. Data persistence is handled through Container-Managed Persistence (CMP) Entity Beans and Data Access Objects (DAOs). Additionally, it includes a Swing-based Administration Client that communicates with the server via HTTP/XML to manage orders and view sales statistics." }, "fileTypesData": [ { "_id": "java", "lines": 34137, "files": 283, "fileType": "java" }, { "_id": "jsp", "lines": 10794, "files": 98, "fileType": "jsp" }, { "_id": "xml", "lines": 19227, "files": 75, "fileType": "xml" }, { "_id": "dtd", "lines": 1589, "files": 31, "fileType": "dtd" }, { "_id": "xsl", "lines": 541, "files": 13, "fileType": "xsl" }, { "_id": "tld", "lines": 3061, "files": 12, "fileType": "tld" }, { "_id": "mf", "lines": 39, "files": 11, "fileType": "mf" }, { "_id": "html", "lines": 292, "files": 9, "fileType": "html" }, { "_id": "sql", "lines": 1177, "files": 7, "fileType": "sql" }, { "_id": "sh", "lines": 475, "files": 7, "fileType": "sh" }, { "_id": "bat", "lines": 307, "files": 7, "fileType": "bat" }, { "_id": "properties", "lines": 241, "files": 7, "fileType": "properties" }, { "_id": "xsd", "lines": 103, "files": 3, "fileType": "xsd" }, { "_id": "", "lines": 96, "files": 2, "fileType": "" } ], "categorizedData": [ { "category": "technologies", "label": "Technologies", "data": [ { "name": "Java 2 Platform, Enterprise Edition (J2EE) 1.3", "description": "The core platform for the application, utilizing EJB 2.0, Servlet 2.3, and JSP 1.2 specifications. It provides the container services for transaction management, security, and concurrency." }, { "name": "Enterprise JavaBeans (EJB)", "description": "Used extensively for the business logic layer. Includes Stateless and Stateful Session Beans for workflow, Entity Beans (CMP) for persistence, and Message-Driven Beans (MDB) for asynchronous messaging." }, { "name": "Java Message Service (JMS)", "description": "Provides the asynchronous messaging backbone. It is used to decouple the Pet Store front-end from the OPC and the OPC from the Supplier, using Queues and Topics for reliable data transfer." }, { "name": "XML and XSLT", "description": "Used for B2B data exchange between the OPC and Supplier. Orders and Invoices are serialized to XML, and XSLT is used for transforming XML data for presentation (e.g., email content)." }, { "name": "Ant", "description": "The build tool used for compiling the application, packaging EAR/WAR/JAR files, and deploying the application to the J2EE server." }, { "name": "Cloudscape / Oracle", "description": "The relational database management systems supported for data persistence. The application includes SQL scripts and DAO implementations for both platforms." }, { "name": "Java Swing", "description": "Used to build the rich-client Administration application, which communicates with the server via HTTP tunneling (XML over HTTP)." } ] }, { "category": "businessProcesses", "label": "Business Processes", "data": [ { "name": "Customer Shopping and Checkout", "description": "The process where a user browses the catalog, manages a shopping cart, and places an order.", "keyBusinessActivities": [ { "activity": "Catalog Browsing", "description": "User views categories, products, and specific items with details." }, { "activity": "Cart Management", "description": "User adds items to the shopping cart, updates quantities, or removes items." }, { "activity": "User Authentication", "description": "User signs in or creates a new account to proceed with checkout." }, { "activity": "Order Placement", "description": "User confirms shipping and billing information and submits the order, generating a unique Order ID." } ] }, { "name": "Order Fulfillment (OPC)", "description": "The asynchronous workflow managed by the Order Processing Center to validate, approve, and ship orders.", "keyBusinessActivities": [ { "activity": "Order Ingestion", "description": "The system receives the new order via JMS and persists it as a pending order." }, { "activity": "Order Approval", "description": "Orders are checked against business rules (e.g., credit limits); small orders are auto-approved, larger ones require manual admin approval." }, { "activity": "Supplier Coordination", "description": "Approved orders are converted to XML and sent to the Supplier via JMS for fulfillment." }, { "activity": "Invoice Processing", "description": "The system receives an invoice from the supplier indicating shipment and updates the local order status." } ] }, { "name": "Supplier Inventory Management", "description": "The B2B process where the supplier receives orders and manages inventory.", "keyBusinessActivities": [ { "activity": "Order Reception", "description": "Supplier receives a purchase order XML message." }, { "activity": "Inventory Check", "description": "System checks stock levels and decrements inventory if items are available." }, { "activity": "Shipment Notification", "description": "Supplier generates an invoice XML and sends it back to the OPC to confirm shipment." } ] }, { "name": "Administration", "description": "Back-office management of the system by an administrator.", "keyBusinessActivities": [ { "activity": "Order Review", "description": "Administrator views pending orders and manually approves or denies them." }, { "activity": "Sales Analysis", "description": "Administrator views charts and statistics regarding sales revenue and order volume." } ] } ] }, { "category": "boundedContexts", "label": "Domain Model", "data": [ { "name": "Catalog Context", "description": "Manages the product information, categories, and specific items available for sale. It provides browsing and searching capabilities.", "aggregates": [ { "name": "Catalog", "description": "The root aggregate for browsing products. It provides read-only access to product data.", "repository": { "name": "CatalogDAO", "description": "Provides data access to catalog tables, supporting both direct JDBC (Fast Lane Reader) and EJB access." }, "entities": [ { "name": "Category", "description": "Represents a grouping of products (e.g., Birds, Dogs)." }, { "name": "Product", "description": "Represents a specific type of animal (e.g., Golden Retriever)." }, { "name": "Item", "description": "Represents a specific stock keeping unit (SKU) with a price and specific attributes." } ] } ] }, { "name": "Customer Context", "description": "Handles user identity, authentication, and profile management.", "aggregates": [ { "name": "Customer", "description": "Represents the registered user and their associated data.", "repository": { "name": "CustomerLocalHome", "description": "Manages the persistence of Customer entity beans." }, "entities": [ { "name": "Account", "description": "Holds account status and links to contact info." }, { "name": "ContactInfo", "description": "Stores address, email, and phone number." }, { "name": "CreditCard", "description": "Stores payment information." }, { "name": "Profile", "description": "Stores user preferences like language and favorite category." } ] } ] }, { "name": "Order Context", "description": "Manages the lifecycle of a customer's purchase order within the Pet Store front-end.", "aggregates": [ { "name": "PurchaseOrder", "description": "Represents a placed order containing all billing, shipping, and item details.", "repository": { "name": "PurchaseOrderLocalHome", "description": "Manages the persistence of PurchaseOrder entity beans." }, "entities": [ { "name": "LineItem", "description": "Represents a specific item and quantity within an order." } ] } ] }, { "name": "Fulfillment Context", "description": "Manages the backend processing of orders, including workflow state and supplier interaction.", "aggregates": [ { "name": "ProcessManager", "description": "Tracks the state of an order through the fulfillment workflow (Pending, Approved, Completed).", "repository": { "name": "ManagerLocalHome", "description": "Persists the state of order processing managers." }, "entities": [ { "name": "Manager", "description": "Represents the workflow state for a specific order ID." } ] } ] }, { "name": "Supplier Context", "description": "Manages the supplier's view of orders and inventory.", "aggregates": [ { "name": "SupplierOrder", "description": "Represents an order received by the supplier from the OPC.", "repository": { "name": "SupplierOrderLocalHome", "description": "Persists supplier orders." }, "entities": [ { "name": "Inventory", "description": "Tracks stock levels for items." } ] } ] } ] }, { "category": "potentialMicroservices", "label": "Potential Microservices", "data": [ { "name": "Catalog Service", "description": "A read-heavy service responsible for managing and serving product, category, and item data. It would replace the CatalogEJB and DAO layers, providing a RESTful interface for the storefront to browse and search for pets.", "entities": [ { "name": "Product", "description": "A specific type of pet available for sale.", "attributes": [ "productId", "categoryId", "name", "description", "image" ] }, { "name": "Item", "description": "A specific SKU of a product with pricing.", "attributes": [ "itemId", "productId", "listPrice", "unitCost", "status" ] } ], "endpoints": [ { "path": "/categories", "method": "GET", "description": "List all product categories." }, { "path": "/products", "method": "GET", "description": "List products, optionally filtered by category." }, { "path": "/items/{itemId}", "method": "GET", "description": "Get details for a specific item." } ], "operations": [ { "operation": "Search Items", "method": "GET", "description": "Search for items based on keywords." } ] }, { "name": "Order Service", "description": "Manages the lifecycle of customer orders. It handles order creation, persistence, and status updates. It would replace the PurchaseOrderEJB and related MDBs, potentially using an event bus for asynchronous processing.", "entities": [ { "name": "Order", "description": "The primary record of a transaction.", "attributes": [ "orderId", "userId", "orderDate", "totalPrice", "status" ] } ], "endpoints": [ { "path": "/orders", "method": "POST", "description": "Create a new order." }, { "path": "/orders/{orderId}", "method": "GET", "description": "Retrieve order details." } ], "operations": [ { "operation": "Create Order", "method": "POST", "description": "Submit a new order from the shopping cart." }, { "operation": "Update Order Status", "method": "PATCH", "description": "Update the status (e.g., Approved, Shipped) of an order." } ] }, { "name": "Customer Service", "description": "Manages user accounts, profiles, and authentication. It replaces the Customer, Account, and SignOn EJBs.", "entities": [ { "name": "Customer", "description": "The user account information.", "attributes": [ "userId", "email", "firstName", "lastName" ] }, { "name": "Address", "description": "Shipping or billing address.", "attributes": [ "street", "city", "state", "zip", "country" ] } ], "endpoints": [ { "path": "/customers/{userId}", "method": "GET", "description": "Get customer profile." }, { "path": "/customers", "method": "POST", "description": "Register a new customer." } ], "operations": [ { "operation": "Authenticate", "method": "POST", "description": "Verify user credentials." } ] }, { "name": "Inventory Service", "description": "Manages stock levels and supplier interactions. It replaces the Supplier module and Inventory EJB.", "entities": [ { "name": "InventoryItem", "description": "Stock level for a specific item.", "attributes": [ "itemId", "quantity" ] } ], "endpoints": [ { "path": "/inventory/{itemId}", "method": "GET", "description": "Get current stock level." }, { "path": "/inventory/{itemId}", "method": "PATCH", "description": "Update stock level (deduct or restock)." } ], "operations": [ { "operation": "Check Availability", "method": "GET", "description": "Check if an item is in stock." } ] } ] }, { "category": "inferredArchitecture", "label": "Inferred Architecture", "data": [ { "internalComponents": [ { "name": "Catalog Manager", "description": "Responsible for retrieving and searching product information. It abstracts the data access logic (DAO) and provides product details to the presentation layer." }, { "name": "Shopping Cart Manager", "description": "Manages the temporary state of a user's shopping session. It handles adding/removing items and calculating subtotals before an order is placed." }, { "name": "Customer Account Manager", "description": "Handles user registration, authentication (SignOn), and profile management (Contact Info, Credit Card, Preferences)." }, { "name": "Order Manager", "description": "Handles the creation and persistence of customer orders. It initiates the fulfillment workflow by sending order data to the processing center." }, { "name": "Order Processing Center (OPC)", "description": "The core workflow engine that manages the lifecycle of an order. It handles order approval (manual or automatic), coordinates with suppliers, and tracks order status." }, { "name": "Supplier Manager", "description": "Simulates an external B2B partner. It receives purchase orders from the OPC, checks inventory, and sends back invoices/shipment notifications." }, { "name": "Notification Service", "description": "Responsible for generating and sending emails to customers regarding order status updates (Received, Approved, Shipped)." }, { "name": "Administration Manager", "description": "Provides capabilities for administrators to view sales statistics and manually approve or deny pending orders." }, { "name": "Unique ID Generator", "description": "A utility component responsible for generating unique primary keys for orders and other entities." } ], "externalDependencies": [ { "name": "Cloudscape/Oracle Database", "type": "Database", "description": "Stores persistent data for Catalog, Customers, Orders, and Inventory." }, { "name": "JMS Provider", "type": "Message Queue", "description": "Handles asynchronous messaging between the Pet Store, OPC, and Supplier components (Queues and Topics)." }, { "name": "JavaMail Service", "type": "External API", "description": "Used by the Notification Service to send SMTP emails to customers." } ], "dependencies": [ { "from": "Shopping Cart Manager", "to": "Catalog Manager", "description": "Retrieves item details for cart display." }, { "from": "Order Manager", "to": "Customer Account Manager", "description": "Retrieves customer billing and shipping info for the order." }, { "from": "Order Manager", "to": "Unique ID Generator", "description": "Requests new IDs for orders." }, { "from": "Order Manager", "to": "JMS Provider", "description": "Sends new orders to the OPC queue." }, { "from": "Order Processing Center (OPC)", "to": "JMS Provider", "description": "Consumes orders, sends supplier requests, and receives invoices." }, { "from": "Order Processing Center (OPC)", "to": "Cloudscape/Oracle Database", "description": "Persists workflow state and order status." }, { "from": "Supplier Manager", "to": "JMS Provider", "description": "Receives POs and sends Invoices." }, { "from": "Supplier Manager", "to": "Cloudscape/Oracle Database", "description": "Manages inventory data." }, { "from": "Notification Service", "to": "JMS Provider", "description": "Listens for order status events." }, { "from": "Notification Service", "to": "JavaMail Service", "description": "Sends emails." }, { "from": "Administration Manager", "to": "Order Processing Center (OPC)", "description": "Queries order status and updates approval state." }, { "from": "Catalog Manager", "to": "Cloudscape/Oracle Database", "description": "Reads product data." }, { "from": "Customer Account Manager", "to": "Cloudscape/Oracle Database", "description": "Persists user data." } ] } ] } ], "dbInteractions": [ { "path": "dbstuff/forall-values-of.sql", "mechanism": "DML", "name": "Oracle PL/SQL Block", "description": "The code interacts with an Oracle database using PL/SQL anonymous blocks and standard SQL statements. It performs a bulk update operation using the FORALL construct to optimize performance when updating multiple records based on a collection of IDs. It also utilizes standard SELECT statements for data verification.", "databaseName": "Oracle", "tablesAccessed": [ "employees" ], "operationType": [ "READ", "WRITE" ], "queryPatterns": "PL/SQL FORALL bulk update with VALUES OF clause, Simple SELECT statements", "transactionHandling": "Implicit within the script execution context (no explicit COMMIT/ROLLBACK)", "protocol": "Oracle PL/SQL", "connectionInfo": "not applicable for SQL files", "codeExample": "FORALL l_index IN VALUES OF l_employee_values\n UPDATE employees\n SET salary = 10000\n WHERE employee_id = l_employees (l_index);" }, { "path": "com.sun.j2ee.blueprints.address.ejb", "mechanism": "EJB", "name": "AddressEJB", "description": "The class is an abstract Entity Bean using Container-Managed Persistence (CMP). The abstract getter and setter methods correspond to persistent fields that the EJB container automatically maps to database columns and manages synchronization for.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container Managed Persistence (CMP) handles queries automatically based on field access.", "transactionHandling": "Container Managed Transactions (CMT) via EJB container.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getStreetName1();\npublic abstract void setStreetName1(String streetName1);" }, { "path": "com.sun.j2ee.blueprints.address.ejb.AddressLocal", "mechanism": "EJB", "name": "Address Entity Bean", "description": "This interface represents the local view of an Entity Bean, which is a persistent data component in the J2EE architecture. The actual database interaction (SQL generation, connection management) is handled by the EJB Container (for Container-Managed Persistence) or the Bean implementation class (for Bean-Managed Persistence). The getters and setters defined here correspond to persistent fields in the underlying database table.", "databaseName": "unknown", "tablesAccessed": [ "Address" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "CRUD operations managed by EJB container", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB context", "protocol": "unknown", "connectionInfo": "Managed by J2EE Container", "codeExample": "public interface AddressLocal extends javax.ejb.EJBLocalObject {\n public String getStreetName1();\n public void setStreetName1(String streetName1);\n // ..." }, { "path": "com.sun.j2ee.blueprints.address.ejb.AddressLocalHome", "mechanism": "EJB", "name": "Address Entity Bean", "description": "This is an EJB Entity Bean Local Home interface. In the EJB component model, 'create' methods correspond to database INSERT operations, and 'find' methods correspond to database SELECT operations. The persistence is managed by the EJB container (Container-Managed Persistence) or the bean implementation (Bean-Managed Persistence).", "databaseName": "unknown", "tablesAccessed": [ "ADDRESS" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Insert via create, Select via findByPrimaryKey)", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB standard", "protocol": "EJB 2.x", "connectionInfo": "Managed by EJB Container", "codeExample": "public AddressLocal create(String streetName1, String streetName2...) throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.catalog.client.CatalogHelper", "mechanism": "EJB", "name": "CatalogLocal", "description": "The class integrates with the database primarily through the `CatalogLocal` Enterprise Java Bean (EJB) or alternatively via a direct `CatalogDAO` (Fast Lane pattern). The EJB approach uses a Service Locator to find the EJB Home and create a local interface reference. The DAO approach uses a Factory to obtain a DAO instance. Both paths ultimately perform READ operations against the catalog data.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ" ], "queryPatterns": "Simple CRUD and search operations with pagination", "transactionHandling": "Managed by EJB container or DAO implementation", "protocol": "EJB 2.x Local Interface / JDBC (via DAO)", "connectionInfo": "JNDI: java:comp/env/ejb/Catalog", "codeExample": "ServiceLocator sl = new ServiceLocator();\nCatalogLocalHome home =(CatalogLocalHome)sl.getLocalHome(JNDINames.CATALOG_EJBHOME);\nreturn home.create();" }, { "path": "com.sun.j2ee.blueprints.catalog.ejb", "mechanism": "EJB", "name": "CatalogLocal", "description": "This file is an EJB Local Interface. While it does not contain direct database code, it defines the data access contract for the Catalog component. The implementation of this interface (the Bean) is responsible for interacting with the database to retrieve Categories, Products, and Items.", "databaseName": "unknown", "tablesAccessed": [ "Category", "Product", "Item" ], "operationType": [ "READ" ], "queryPatterns": "The interface implies simple CRUD read operations (get by ID) and paginated list retrieval (get items/products with start/count).", "transactionHandling": "Transactions are likely managed by the EJB container (CMT), though not explicitly annotated in the interface.", "protocol": "unknown", "connectionInfo": "n/a", "codeExample": "public interface CatalogLocal extends EJBLocalObject {\n public Category getCategory(String categoryID, Locale l);\n ..." }, { "path": "com.sun.j2ee.blueprints.contactinfo.ejb", "mechanism": "EJB", "name": "ContactInfoLocal", "description": "This interface represents the local view of an Entity Bean (or Session Bean wrapping an entity) managed by the EJB container. The container handles the persistence of the fields defined by the getters and setters (FamilyName, GivenName, Telephone, Email) to the underlying database.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "simple CRUD", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB specification", "protocol": "EJB 2.x", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface ContactInfoLocal extends javax.ejb.EJBLocalObject {\n public String getFamilyName();\n public void setFamilyName(String familyName);\n}" }, { "path": "com.sun.j2ee.blueprints.contactinfo.ejb", "mechanism": "EJB", "name": "ContactInfoEJB", "description": "This class is an EJB 2.x Entity Bean using Container-Managed Persistence (CMP). The container manages the synchronization of the abstract accessor methods with the underlying database table. It also manages the relationship with the Address entity via Container-Managed Relationships (CMR).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container-managed CRUD operations", "transactionHandling": "Container-managed transactions (CMT) typically defined in deployment descriptors", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getFamilyName();\npublic abstract void setFamilyName(String familyName);" }, { "path": "com.sun.j2ee.blueprints.contactinfo.ejb", "mechanism": "EJB", "name": "ContactInfo Entity Bean", "description": "This file is the Local Home interface for an Entity EJB. It defines the methods to create (INSERT) and find (SELECT) persistent ContactInfo entities managed by the EJB container.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations managed by the container (Create and Find by Primary Key).", "transactionHandling": "Container Managed Transactions (CMT) are typical for EJB Home interfaces.", "protocol": "unknown", "connectionInfo": "Managed by J2EE Container", "codeExample": "public ContactInfoLocal findByPrimaryKey(Object key) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.creditcard.ejb", "mechanism": "EJB", "name": "CreditCard Entity Bean", "description": "This file is an EJB Local Home interface, which defines the persistence lifecycle methods (create, find) for an Entity Bean. The actual database interaction is handled by the EJB container (Container Managed Persistence) or the bean implementation (Bean Managed Persistence), mapping these methods to SQL INSERT and SELECT operations.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Standard EJB CRUD operations (Create and Find by Primary Key)", "transactionHandling": "Transactions are managed by the EJB Container (CMT) as per the deployment descriptor.", "protocol": "unknown", "connectionInfo": "n/a", "codeExample": "public CreditCardLocal findByPrimaryKey(Object key) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.creditcard.ejb", "mechanism": "EJB", "name": "CreditCardEJB", "description": "This interface represents the local view of an Enterprise Java Bean (EJB), likely an Entity Bean. In the J2EE architecture, Entity Beans are used to represent persistent data in a database. The container manages the synchronization between this object and the underlying database table.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "CRUD operations managed by the EJB container", "transactionHandling": "Managed by the EJB Container (CMT)", "protocol": "EJB 2.x", "connectionInfo": "Managed by Application Server", "codeExample": "public interface CreditCardLocal extends javax.ejb.EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.creditcard.ejb.CreditCardEJB", "mechanism": "EJB", "name": "CreditCardEJB", "description": "The class uses EJB 2.x Container Managed Persistence (CMP). The abstract getters and setters define the persistent fields, and the EJB container handles the actual database interactions (SQL generation, connection management) at runtime.", "databaseName": "unknown", "tablesAccessed": [ "CreditCard" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container Managed Persistence (ORM-style mapping)", "transactionHandling": "Container Managed Transactions (JTA)", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getCardNumber();\npublic abstract void setCardNumber(String cardNumber);" }, { "path": "com.sun.j2ee.blueprints.customer.account.ejb", "mechanism": "EJB", "name": "AccountEJB", "description": "The class is an EJB 2.x Entity Bean using Container-Managed Persistence (CMP). The abstract methods (getters/setters) are implemented by the EJB container to perform SQL operations (SELECT, INSERT, UPDATE) against the database. The mapping to specific tables and columns is defined in external XML deployment descriptors (not shown in code).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container-managed CRUD operations", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getStatus(); // CMP field managed by container" }, { "path": "com.sun.j2ee.blueprints.customer.account.ejb.AccountLocal", "mechanism": "EJB", "name": "AccountEJB", "description": "This is an EJB Local Interface (extending EJBLocalObject), which typically acts as the local view for an Entity Bean. Entity Beans in J2EE are used to represent persistent data in a database. The container handles the synchronization between this object and the database row.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container Managed Persistence (CMP) or Bean Managed Persistence (BMP) implied by EJB structure.", "transactionHandling": "Container Managed Transactions (CMT) typical for EJB Local Objects.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface AccountLocal extends javax.ejb.EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.customer.account.ejb.AccountLocalHome", "mechanism": "EJB", "name": "AccountEJB", "description": "This file is an EJB Local Home interface, which defines the lifecycle methods (create, find) for an Entity Bean. The EJB container intercepts calls to these methods to perform database INSERT and SELECT operations via Container-Managed Persistence (CMP) or Bean-Managed Persistence (BMP).", "databaseName": "unknown", "tablesAccessed": [ "Account" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Create and Find by Primary Key) managed by the EJB container.", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB specification.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public AccountLocal findByPrimaryKey(Object key) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.customer.ejb.CustomerEJB", "mechanism": "EJB", "name": "CustomerEJB", "description": "This class is an EJB 2.x Entity Bean using Container-Managed Persistence (CMP). The EJB container is responsible for generating the SQL and database connectivity code to persist the 'userId' field and manage the relationships to Account and Profile entities.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container Managed Persistence (implicit queries)", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getUserId();\npublic abstract void setUserId(String userId);" }, { "path": "com.sun.j2ee.blueprints.customer.ejb.CustomerLocal", "mechanism": "EJB", "name": "CustomerEJB", "description": "This interface represents the local view of an Entity Bean (likely Container-Managed Persistence - CMP) in a J2EE application. It provides access to persistent customer data and relationships (Account, Profile) managed by the EJB container.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ" ], "queryPatterns": "Navigation through EJB relationships (getAccount, getProfile)", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB architecture", "protocol": "EJB 2.x", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface CustomerLocal extends javax.ejb.EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.customer.ejb.CustomerLocalHome", "mechanism": "EJB", "name": "CustomerEntityBean", "description": "This is an EJB Entity Bean Home interface. It defines methods that map directly to database operations (INSERT for create, SELECT for finders) managed by the EJB container (CMP) or the bean implementation (BMP).", "databaseName": "unknown", "tablesAccessed": [ "Customer" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Create, Find by PK, Find All)", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB context", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public CustomerLocal findByPrimaryKey(String userId) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.customer.profile.ejb", "mechanism": "EJB", "name": "ProfileEJB", "description": "The class uses EJB 2.x Container-Managed Persistence (CMP). The abstract getters and setters define the persistent fields, and the EJB container automatically handles the SQL generation, database connection, and synchronization based on the deployment descriptor configuration.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getPreferredLanguage();\npublic abstract void setPreferredLanguage(String preferredLanguage);" }, { "path": "com.sun.j2ee.blueprints.customer.profile.ejb", "mechanism": "EJB", "name": "CustomerProfileEJB", "description": "This interface acts as the local view for an Enterprise Java Bean (likely an Entity Bean or a Session Bean wrapping an Entity) that persists customer profile data. The actual database interaction is handled by the EJB container (CMP) or the bean implementation (BMP), but this interface defines the data access contract.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "CRUD operations via EJB accessors", "transactionHandling": "Managed by EJB Container (CMT)", "protocol": "EJB 2.x", "connectionInfo": "n/a", "codeExample": "public interface ProfileLocal extends javax.ejb.EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.customer.profile.ejb.ProfileLocalHome", "mechanism": "EJB", "name": "ProfileLocalHome", "description": "This interface defines methods for creating and finding EJB instances, which implies database interaction managed by an EJB container. The `create` method corresponds to a database INSERT operation, and the `findByPrimaryKey` method corresponds to a database SELECT operation. This pattern is characteristic of EJB 2.x Container-Managed Persistence (CMP) or Bean-Managed Persistence (BMP), where the application server handles the persistence logic for entity beans.", "databaseName": "unknown", "tablesAccessed": [ "Profile" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "simple CRUD", "transactionHandling": "EJB Container-Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "unknown", "codeExample": "public ProfileLocal findByPrimaryKey(Object key) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.lineitem.ejb", "mechanism": "EJB", "name": "LineItemEJB", "description": "This interface represents the local view of an Enterprise Java Bean (EJB), likely an Entity Bean using Container-Managed Persistence (CMP) or Bean-Managed Persistence (BMP). The EJB container manages the synchronization of this object's state with the underlying database table.", "databaseName": "unknown", "tablesAccessed": [ "LINEITEM" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM-style persistence managed by the EJB container.", "transactionHandling": "Managed by the EJB Container (CMT).", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface LineItemLocal extends EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.lineitem.ejb", "mechanism": "EJB", "name": "LineItemEJB", "description": "This class is an EJB 2.x Container-Managed Persistence (CMP) Entity Bean. The abstract getter and setter methods (e.g., getCategoryId, setQuantity) correspond to persistent fields managed by the EJB container. The container generates the SQL to read/write these fields to a database table based on the deployment descriptor (ejb-jar.xml).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container-managed CRUD operations", "transactionHandling": "Container-managed transactions (CMT)", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getCategoryId();\npublic abstract void setCategoryId(String id);" }, { "path": "com.sun.j2ee.blueprints.lineitem.ejb.LineItemLocalHome", "mechanism": "EJB", "name": "LineItem EJB", "description": "This file is the Home interface for an Entity Bean. The 'create' methods correspond to database INSERT operations, and 'findByPrimaryKey' corresponds to a database SELECT operation by primary key. The actual persistence logic (SQL generation and execution) is handled by the EJB container (likely Container-Managed Persistence).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Create and Find by ID) managed by the EJB container.", "transactionHandling": "Managed by the EJB Container (CMT).", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "LineItemLocal create(String catId, String prodId, String itemId, String lineNo, int qty, float price, int qtyShipped) throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.opc.admin.ejb", "mechanism": "EJB", "name": "PurchaseOrder and ProcessManager EJBs", "description": "The code interacts with the database indirectly through Enterprise Java Beans (Entity Beans). It uses Local Home interfaces to execute finders and retrieve Entity instances, which represent database rows.", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder", "LineItem", "ProcessManager" ], "operationType": [ "READ" ], "queryPatterns": "The code uses EJB Finder methods (findByPrimaryKey, findPOBetweenDates) to retrieve entities and then traverses relationships (getAllItems) to aggregate data in memory.", "transactionHandling": "Container-Managed Transactions (CMT) implied by SessionBean usage, though not explicitly annotated in the code snippet.", "protocol": "EJB Local Interface", "connectionInfo": "JNDI: java:comp/env/ejb/PurchaseOrder, java:comp/env/ejb/ProcessManager", "codeExample": "PurchaseOrderLocalHome pohome = getPO();\nCollection poColl = pohome.findPOBetweenDates(start.getTime(), end.getTime());\nIterator it = poColl.iterator();\nwhile((it!= null) && (it.hasNext())) {\n po = (PurchaseOrderLocal) it.next();\n // ..." }, { "path": "com.sun.j2ee.blueprints.opc.customerrelations.ejb", "mechanism": "EJB", "name": "PurchaseOrderLocalHome", "description": "The code uses EJB 2.x Entity Beans to interact with the database. It utilizes the `PurchaseOrderLocalHome` interface to find a `PurchaseOrderLocal` entity bean by its primary key (the order ID). This abstracts the direct database operations.", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder" ], "operationType": [ "READ" ], "queryPatterns": "Key-based lookup (findByPrimaryKey)", "transactionHandling": "Container-managed transactions (implied by EJB context)", "protocol": "EJB Local Interface", "connectionInfo": "JNDI lookup via ServiceLocator", "codeExample": "PurchaseOrderLocal po = poHome.findByPrimaryKey(invoiceXDE.getOrderId());" }, { "path": "com.sun.j2ee.blueprints.opc.customerrelations.ejb.MailCompletedOrderMDB", "mechanism": "EJB", "name": "PurchaseOrderEJB", "description": "The code uses EJB 2.x Entity Beans to access database information. It uses the `PurchaseOrderLocalHome` interface to find a Purchase Order by its primary key (the order ID) and retrieves the underlying data object.", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder" ], "operationType": [ "READ" ], "queryPatterns": "Entity Bean lookup by Primary Key", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB context", "protocol": "EJB 2.x Local Interface", "connectionInfo": "JNDI lookup: JNDINames.PURCHASE_ORDER_EJB", "codeExample": "PurchaseOrder poData = poHome.findByPrimaryKey(orderId).getData();" }, { "path": "com.sun.j2ee.blueprints.opc.customerrelations.ejb.MailOrderApprovalMDB", "mechanism": "EJB", "name": "PurchaseOrderLocalHome", "description": "The code interacts with the database via EJB 2.x Entity Beans. It uses the PurchaseOrderLocalHome interface to find PurchaseOrderLocal entity instances by their primary key (OrderId).", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder" ], "operationType": [ "READ" ], "queryPatterns": "Entity Bean lookup by Primary Key (findByPrimaryKey).", "transactionHandling": "Container Managed Transactions (implied by EJB context)", "protocol": "EJB 2.x Local Interface", "connectionInfo": "JNDI Lookup: java:comp/env/ejb/purchaseorder/PurchaseOrder", "codeExample": "po = poHome.findByPrimaryKey(co.getOrderId());\nString emailAddress = po.getPoEmailId();" }, { "path": "com.sun.j2ee.blueprints.opc.ejb", "mechanism": "EJB", "name": "PurchaseOrderLocalHome", "description": "The code uses EJB 2.x Entity Beans (Local Interfaces) to persist data. It utilizes `PurchaseOrderLocalHome` to create new Purchase Order entities in the underlying database.", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder" ], "operationType": [ "WRITE" ], "queryPatterns": "Entity Bean creation (INSERT)", "transactionHandling": "Container Managed Transactions (implied by EJB MDB context)", "protocol": "EJB 2.x CMP/BMP", "connectionInfo": "Managed by J2EE Container via JNDI lookup of 'java:comp/env/ejb/PurchaseOrderEJB'", "codeExample": "poHome = (PurchaseOrderLocalHome)serviceLocator.getLocalHome(JNDINames.PURCHASE_ORDER_EJB);\n// ...\nPurchaseOrder purchaseOrder = PurchaseOrder.fromXML(xmlMessage, entityCatalogURL, validateXmlPurchaseOrder);\npoHome.create(purchaseOrder);" }, { "path": "com.sun.j2ee.blueprints.opc.ejb.InvoiceMDB", "mechanism": "EJB", "name": "PurchaseOrder and ProcessManager Entity Beans", "description": "The class interacts with the database through EJB 2.x Entity Beans. It uses `PurchaseOrderLocalHome` to find purchase orders by primary key and `ProcessManagerLocalHome` to create or find process managers. The actual persistence logic is abstracted by the EJB container (CMP or BMP).", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder", "ProcessManager" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Lookup by Primary Key via EJB Home interface", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB context", "protocol": "EJB Local Interface", "connectionInfo": "JNDI lookup via ServiceLocator", "codeExample": "poHome = (PurchaseOrderLocalHome)serviceLocator.getLocalHome(JNDINames.PURCHASE_ORDER_EJB);\nPurchaseOrderLocal po = poHome.findByPrimaryKey(invoiceXDE.getOrderId());\nprocessManager.updateStatus(invoiceXDE.getOrderId(), OrderStatusNames.COMPLETED);" }, { "path": "com.sun.j2ee.blueprints.opc.ejb.OrderApprovalMDB", "mechanism": "EJB", "name": "PurchaseOrderEJB", "description": "The code interacts with the database using EJB 2.x Entity Beans (`PurchaseOrderLocal`) and Session Beans (`ProcessManagerLocal`). It retrieves purchase orders by primary key and updates order statuses via the process manager.", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder", "LineItem", "Address", "ContactInfo" ], "operationType": [ "READ", "WRITE" ], "queryPatterns": "Lookup by Primary Key (findByPrimaryKey) and updates via Session Facade.", "transactionHandling": "Container Managed Transactions (Implicit in EJB MDB)", "protocol": "EJB 2.x Local Interfaces", "connectionInfo": "JNDI Lookup via ServiceLocator", "codeExample": "po = poHome.findByPrimaryKey(co.getOrderId());\nprocessManager.updateStatus(co.getOrderId(), co.getOrderStatus());" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.ejb", "mechanism": "EJB", "name": "CustomerLocalHome", "description": "The code interacts with the database through Enterprise JavaBeans (EJB) Entity Beans. Specifically, it uses the `CustomerLocalHome` interface to find and create Customer entities, which represent persistent data in the underlying database.", "databaseName": "unknown", "tablesAccessed": [ "Customer" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "EJB Entity Bean lookups (findByPrimaryKey) and creation.", "transactionHandling": "Container-managed transactions (standard for Session Beans invoking Entity Beans).", "protocol": "EJB Local Interface", "connectionInfo": "JNDI Lookup: JNDINames.CUSTOMER_EJBHOME", "codeExample": "ServiceLocator sl = new ServiceLocator();\nCustomerLocalHome home =(CustomerLocalHome)sl.getLocalHome(JNDINames.CUSTOMER_EJBHOME);\ncustomer = home.findByPrimaryKey(userId);" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.ejb.ShoppingClientFacadeLocal", "mechanism": "EJB", "name": "ShoppingClientFacade", "description": "This interface represents a J2EE Enterprise Java Bean (EJB) Local Interface. While the interface itself does not contain SQL, it defines the contract for a Session Bean that orchestrates Entity Beans (CustomerLocal) which map directly to database tables. The `getCustomer` and `createCustomer` methods imply direct interaction with the persistence layer via the EJB container.", "databaseName": "unknown", "tablesAccessed": [ "Customer" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "EJB Entity Bean lookups and creation", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB architecture", "protocol": "unknown", "connectionInfo": "Managed by J2EE Container", "codeExample": "public interface ShoppingClientFacadeLocal extends EJBLocalObject {\n public CustomerLocal getCustomer() throws FinderException;\n}" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.ejb.actions", "mechanism": "EJB", "name": "ProfileLocal", "description": "The code interacts with the persistence layer through Enterprise Java Beans (EJB). Specifically, it accesses the `ProfileLocal` entity bean to retrieve customer profile information (preferred language). The presence of `FinderException` handling indicates a database lookup operation.", "databaseName": "unknown", "tablesAccessed": [ "Profile", "Customer" ], "operationType": [ "READ" ], "queryPatterns": "Entity Bean traversal (getProfile) and property access", "transactionHandling": "Container Managed Transactions (implied by EJB context)", "protocol": "EJB Local Interface", "connectionInfo": "n/a", "codeExample": "ProfileLocal profile = scf.getCustomer().getProfile();\nLocale locale = I18nUtil.getLocaleFromString(profile.getPreferredLanguage());" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.ejb.actions", "mechanism": "EJB", "name": "SignOnLocal", "description": "The class delegates database persistence operations to the SignOnLocal Enterprise Java Bean. While this class does not contain direct SQL, it invokes the transactional 'createUser' method on the EJB, which is responsible for persisting the user credentials to the underlying data store.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "WRITE" ], "queryPatterns": "Delegated to EJB (likely transactional INSERT)", "transactionHandling": "Container Managed Transactions (implied by EJB usage)", "protocol": "EJB Local Interface", "connectionInfo": "JNDI Lookup: JNDINames.SIGN_ON_EJBHOME", "codeExample": "SignOnLocalHome home =(SignOnLocalHome)sl.getLocalHome(JNDINames.SIGN_ON_EJBHOME);\nsignOn = home.create();\nsignOn.createUser(userName, password);" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.ejb.actions.CustomerEJBAction", "mechanism": "EJB", "name": "ShoppingClientFacadeLocal", "description": "The code interacts with the database through Enterprise JavaBeans (Entity Beans) accessed via a Session Facade. It retrieves Local Interfaces for Customer, Account, ContactInfo, Address, and CreditCard entities and performs updates by calling setter methods on these persistent objects.", "databaseName": "unknown", "tablesAccessed": [ "Customer", "Account", "ContactInfo", "Address", "CreditCard", "Profile" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Navigation through Entity Bean relationships (getAccount, getContactInfo) and updates via setter methods.", "transactionHandling": "Likely handled by the EJB container (CMT) on the perform method or the facade methods.", "protocol": "EJB Local Interface", "connectionInfo": "n/a", "codeExample": "CustomerLocal customer = scf.getCustomer();\nAccountLocal account = customer.getAccount();\nContactInfoLocal contactInfoLocal = account.getContactInfo();\ncontactInfoLocal.setFamilyName(contactInfo.getFamilyName());" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.web", "mechanism": "EJB", "name": "ShoppingController", "description": "The class interacts with the persistence tier through Enterprise Java Beans (EJB). It uses a ServiceLocator to look up the 'ShoppingControllerLocalHome' via JNDI and creates a 'ShoppingControllerLocal' EJB. This EJB acts as a facade to manage data related to shopping carts and customers.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "EJB Entity/Session bean access via Home interfaces", "transactionHandling": "Container Managed Transactions (CMT) likely handled by the EJB container", "protocol": "EJB Local Interface", "connectionInfo": "JNDI Lookup: JNDINames.SHOPPING_CONTROLLER_EJBHOME", "codeExample": "ShoppingControllerLocalHome scEjbHome =\n (ShoppingControllerLocalHome)serviceLocator.getLocalHome(JNDINames.SHOPPING_CONTROLLER_EJBHOME);\nscEjb = scEjbHome.create();" }, { "path": "com.sun.j2ee.blueprints.petstore.controller.web", "mechanism": "EJB", "name": "ShoppingControllerLocal", "description": "This class interacts with the ShoppingControllerLocal Enterprise Java Bean. While it does not execute SQL directly, it delegates business operations to the EJB layer which is responsible for transaction management and persistence operations within the J2EE container.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "Delegates to EJB", "transactionHandling": "Managed by EJB Container (Stateful Session Bean)", "protocol": "EJB Local Interface", "connectionInfo": "n/a", "codeExample": "ShoppingControllerLocal scEjb = pcm.getShoppingController(session);\nreturn scEjb.processEvent(ev);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "EJB", "name": "ProfileLocalHome", "description": "The class interacts with the database via Enterprise Java Beans (EJB) 2.x Entity Beans. It looks up the Local Home interface using JNDI and invokes the `create` method to persist a new Profile entity.", "databaseName": "unknown", "tablesAccessed": [ "Profile" ], "operationType": [ "WRITE" ], "queryPatterns": "EJB Entity Bean creation (INSERT)", "transactionHandling": "Container Managed (implied by EJB)", "protocol": "EJB Local Interface", "connectionInfo": "java:comp/env/ejb/Profile", "codeExample": "InitialContext context = new InitialContext();\nprofileHome = (ProfileLocalHome) context.lookup(JNDI_PROFILE_HOME);\nreturn profileHome.create(preferredLanguage, favoriteCategory, myListPreference, bannerPreference);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "EJB", "name": "Account EJB", "description": "The class uses Enterprise Java Beans (EJB 2.x) Entity Beans to persist account data. It interacts with the container via JNDI to locate the Home interface and creates new entities.", "databaseName": "unknown", "tablesAccessed": [ "Account" ], "operationType": [ "WRITE" ], "queryPatterns": "EJB Create Method", "transactionHandling": "Container Managed (EJB)", "protocol": "EJB/RMI", "connectionInfo": "JNDI: java:comp/env/ejb/Account", "codeExample": "InitialContext context = new InitialContext();\naccountHome = (AccountLocalHome) context.lookup(JNDI_ACCOUNT_HOME);\nreturn accountHome.create(AccountLocalHome.Active, contactInfo, creditCard);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "EJB", "name": "CreditCardEJB", "description": "The code interacts with the database through Enterprise Java Beans (EJB). It looks up the Local Home interface for the CreditCard EJB and invokes the `create` method, which delegates the actual database INSERT operation to the EJB container (likely CMP).", "databaseName": "unknown", "tablesAccessed": [ "CreditCard" ], "operationType": [ "WRITE" ], "queryPatterns": "EJB Entity Bean creation (INSERT)", "transactionHandling": "Container Managed Transactions (implied by EJB)", "protocol": "EJB Local Interface", "connectionInfo": "JNDI: java:comp/env/ejb/CreditCard", "codeExample": "InitialContext context = new InitialContext();\ncreditCardHome = (CreditCardLocalHome) context.lookup(JNDI_CREDIT_CARD_HOME);\nreturn creditCardHome.create(cardNumber, cardType, expiryDate);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "EJB", "name": "UserLocalHome", "description": "The class uses Enterprise JavaBeans (EJB) Entity Beans to interact with the database. It obtains a reference to the UserLocalHome interface via JNDI and uses it to create and find User entities.", "databaseName": "unknown", "tablesAccessed": [ "User" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "EJB CMP/BMP operations (create, findByPrimaryKey, findAllUsers)", "transactionHandling": "Container-managed transactions (implied by EJB usage)", "protocol": "EJB 2.x", "connectionInfo": "JNDI: java:comp/env/ejb/User", "codeExample": "InitialContext context = new InitialContext();\nuserHome = (UserLocalHome) context.lookup(JNDI_USER_HOME);\nuser = userHome.create(id, password);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.AddressPopulator", "mechanism": "EJB", "name": "AddressLocalHome", "description": "The code uses Enterprise JavaBeans (EJB) 2.x Local Interfaces to persist data. It looks up the EJB Home interface via JNDI and uses the `create()` factory method to instantiate a new persistent entity, then populates its fields via setter methods.", "databaseName": "unknown", "tablesAccessed": [ "Address" ], "operationType": [ "WRITE" ], "queryPatterns": "ORM-style entity creation via EJB Container", "transactionHandling": "Container Managed (implied by EJB)", "protocol": "EJB Container Protocol", "connectionInfo": "java:comp/env/ejb/Address", "codeExample": "InitialContext context = new InitialContext();\naddressHome = (AddressLocalHome) context.lookup(JNDI_ADDRESS_HOME);\nAddressLocal address = addressHome.create();\naddress.setStreetName1(streetName1);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.ContactInfoPopulator", "mechanism": "EJB", "name": "ContactInfoLocalHome", "description": "The class uses Enterprise Java Beans (EJB 2.x) Entity Beans to persist data. It looks up the Local Home interface via JNDI and uses the `create` method to insert data.", "databaseName": "unknown", "tablesAccessed": [ "ContactInfo" ], "operationType": [ "WRITE" ], "queryPatterns": "ORM entity creation via EJB Home interface", "transactionHandling": "Container-managed transactions (implied by EJB)", "protocol": "EJB/JNDI", "connectionInfo": "java:comp/env/ejb/ContactInfo", "codeExample": "InitialContext context = new InitialContext();\ncontactInfoHome = (ContactInfoLocalHome) context.lookup(JNDI_CONTACT_INFO_HOME);\nreturn contactInfoHome.create(givenName, familyName, phone, email, address);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.CustomerPopulator", "mechanism": "EJB", "name": "CustomerEJB", "description": "The class interacts with the database via Enterprise Java Beans (EJB 2.x) Entity Beans. It uses the CustomerLocalHome interface to find, create, and remove Customer entities. It also interacts with AccountLocal and ProfileLocal interfaces to manage related data.", "databaseName": "unknown", "tablesAccessed": [ "Customer", "Account", "Profile" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "EJB Finder methods (findAllCustomers, findByPrimaryKey) and CRUD operations (create, remove).", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB usage.", "protocol": "EJB 2.0 Local Interfaces", "connectionInfo": "JNDI: java:comp/env/ejb/Customer", "codeExample": "customerHome = (CustomerLocalHome) context.lookup(JNDI_CUSTOMER_HOME);\nCustomerLocal customer = customerHome.create(id);" }, { "path": "com.sun.j2ee.blueprints.processmanager.ejb", "mechanism": "EJB", "name": "ManagerLocalHome", "description": "The class interacts with the database indirectly through EJB Entity Beans. It uses the `ManagerLocalHome` interface to find, create, and update `ManagerLocal` entities, which represent persistent data (likely orders). The actual SQL or database interaction is handled by the EJB container's persistence mechanism (CMP or BMP) associated with the `Manager` bean.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "CRUD operations via EJB Home interface finders and creators", "transactionHandling": "Container Managed Transactions (implied by EJB)", "protocol": "EJB Local Interface", "connectionInfo": "JNDI: java:comp/env/ejb/Manager", "codeExample": "ManagerLocal manager = mlh.findByPrimaryKey(orderId);\nmanager.setStatus(status);" }, { "path": "com.sun.j2ee.blueprints.processmanager.ejb", "mechanism": "EJB", "name": "ProcessManager Persistence", "description": "The interface extends EJBLocalObject and declares methods throwing CreateException and FinderException, which are standard EJB patterns for interacting with a persistence layer (likely Entity Beans or direct JDBC within a Session Bean). The methods imply CRUD operations on an order process entity.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "CRUD operations (Create, Read, Update) and a finder query by status.", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB architecture.", "protocol": "unknown", "connectionInfo": "n/a", "codeExample": "public void createManager (String orderId, String status) throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.processmanager.ejb.ProcessManagerLocalHome", "mechanism": "EJB", "name": "ProcessManager Entity EJB", "description": "This is a Home interface for an Entity EJB, which represents a persistent data object. The create method typically corresponds to an INSERT operation in the underlying database, managed either by the container (CMP) or the bean implementation (BMP).", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "WRITE" ], "queryPatterns": "Entity Bean creation typically maps to a SQL INSERT.", "transactionHandling": "Transactions are typically Container-Managed (CMT) via JTA.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public ProcessManagerLocal create() throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.processmanager.manager.ejb", "mechanism": "EJB", "name": "ProcessManager Entity Bean", "description": "This file is an EJB Entity Bean Home interface. It defines persistence operations (create, find) that the EJB container maps to database operations (INSERT, SELECT).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Create by ID, Find by Primary Key, Find by Status attribute)", "transactionHandling": "Container Managed Transactions (CMT) provided by the EJB container", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public ManagerLocal create(String orderId, String status) throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.processmanager.manager.ejb", "mechanism": "EJB", "name": "ManagerEJB", "description": "The class uses EJB 2.x Container-Managed Persistence (CMP). The abstract class defines the data schema via abstract getters and setters, and the EJB container is responsible for generating the SQL and database connectivity code at deployment time.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container-Managed Persistence (CMP) handles queries automatically based on deployment descriptors.", "transactionHandling": "Container-Managed Transactions (CMT) handled by the EJB container.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract class ManagerEJB implements EntityBean {\n // CMP fields\n public abstract String getOrderId();\n public abstract void setOrderId(String orderId);\n // ...\n}" }, { "path": "com.sun.j2ee.blueprints.processmanager.manager.ejb.ManagerLocal", "mechanism": "EJB", "name": "ManagerEJB", "description": "This interface represents the local view of an Enterprise Java Bean (EJB). In the context of J2EE Blueprints, this likely corresponds to an Entity Bean or a Session Bean that manages persistence for process manager state. The methods defined (getOrderId, getStatus, setStatus) imply a direct mapping to persistent fields or a stateful workflow backed by a database.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "CRUD operations via EJB container management", "transactionHandling": "Container-Managed Transactions (CMT) implied by EJB architecture", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface ManagerLocal extends javax.ejb.EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.purchaseorder.ejb", "mechanism": "EJB", "name": "PurchaseOrder/LineItem Entity Beans", "description": "The code interacts with the database through EJB Entity Beans (Local interfaces). It navigates the relationship between PurchaseOrder and LineItems and updates the persistent state (quantityShipped) of LineItem entities.", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder", "LineItem" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Navigation of entity relationships and update of scalar fields.", "transactionHandling": "Likely Container Managed Transactions (CMT) propagated from the caller.", "protocol": "EJB Local Interface", "connectionInfo": "n/a", "codeExample": "LineItemLocal li = (LineItemLocal) liIt.next();\nif(lineItemIds.containsKey(li.getItemId())) {\n Integer shipped = (Integer) lineItemIds.get(li.getItemId());\n li.setQuantityShipped(li.getQuantityShipped() + shipped.intValue());\n}" }, { "path": "com.sun.j2ee.blueprints.purchaseorder.ejb.PurchaseOrderEJB", "mechanism": "EJB", "name": "PurchaseOrderEJB", "description": "The class is an EJB 2.0 Entity Bean using Container-Managed Persistence (CMP). The abstract getters and setters map directly to database columns managed by the EJB container. Relationships with other entities (LineItems, ContactInfo) are handled via Container-Managed Relationships (CMR).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "unknown", "codeExample": "public abstract String getPoId();\npublic abstract void setPoId(String id);" }, { "path": "com.sun.j2ee.blueprints.purchaseorder.ejb.PurchaseOrderLocal", "mechanism": "EJB", "name": "PurchaseOrder", "description": "This interface defines an EJB Entity Bean using Container Managed Persistence (CMP). The comments explicitly mention 'getters and setters for PO CMP fields', indicating that the EJB container is responsible for mapping these methods to database columns and handling persistence automatically.", "databaseName": "unknown", "tablesAccessed": [ "PURCHASE_ORDER" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Container Managed Transactions (CMT) typical for EJB Entity Beans", "protocol": "unknown", "connectionInfo": "Managed by J2EE Container", "codeExample": "public String getPoId();\npublic void setContactInfo(ContactInfoLocal addr);" }, { "path": "com.sun.j2ee.blueprints.purchaseorder.ejb.PurchaseOrderLocalHome", "mechanism": "EJB", "name": "PurchaseOrderLocalHome", "description": "This interface defines methods for creating and finding PurchaseOrder EJB instances, which is a core part of the EJB 2.x persistence framework. While it doesn't contain direct database access code itself, the EJB container implements these methods to interact with the database. The `create` and `find...` methods are mapped to underlying persistence operations (e.g., SQL INSERT and SELECT statements) against the table corresponding to the PurchaseOrder entity. This pattern is characteristic of Container-Managed Persistence (CMP).", "databaseName": "unknown", "tablesAccessed": [ "PurchaseOrder" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Defines standard primary key lookups and a custom finder method for querying by a date range. These are mapped by the EJB container to corresponding SQL queries.", "transactionHandling": "Transactions are managed by the EJB container, typically using JTA (Java Transaction API). Method calls to the EJB are automatically enlisted in a transaction, which is either started by the container or propagated from the client.", "protocol": "unknown", "connectionInfo": "unknown", "codeExample": "public PurchaseOrderLocal findByPrimaryKey(String poId) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.signon.ejb", "mechanism": "EJB", "name": "UserLocalHome", "description": "The class interacts with the database indirectly through Enterprise Java Beans (Entity Beans). It uses the `UserLocalHome` interface to find and create `UserLocal` entities, which represent rows in the underlying database table. The actual SQL generation and execution are handled by the EJB container (CMP) or the Entity Bean implementation (BMP).", "databaseName": "unknown", "tablesAccessed": [ "User" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Entity Bean lookups (findByPrimaryKey) and creation", "transactionHandling": "Container Managed Transactions (implied by EJB SessionBean)", "protocol": "EJB 2.x", "connectionInfo": "java:comp/env/ejb/User", "codeExample": "UserLocal user = ulh.findByPrimaryKey(userName);" }, { "path": "com.sun.j2ee.blueprints.signon.ejb.SignOnLocalHome", "mechanism": "EJB", "name": "SignOn Entity Bean", "description": "This file is the Home interface for an EJB Entity Bean. The `create()` method corresponds to the creation of a persistent entity, which implies a database INSERT operation managed by the EJB container (CMP) or the bean implementation (BMP).", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "WRITE" ], "queryPatterns": "Entity creation (INSERT)", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB standard", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public SignOnLocal create() throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.signon.user.ejb", "mechanism": "EJB", "name": "User Entity Bean", "description": "This interface represents the local view of an Entity Bean, which is a J2EE component model specifically designed for database persistence. The methods defined (get/set password, getUserName) map directly to columns in a database table (likely a 'Users' or 'SignOn' table). In EJB 2.x, the container handles the synchronization between this object and the database row.", "databaseName": "unknown", "tablesAccessed": [ "User" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM-style entity access managed by the EJB container.", "transactionHandling": "Transactions are typically managed declaratively by the EJB container (CMT) via deployment descriptors.", "protocol": "EJB 2.x Container Protocol", "connectionInfo": "Managed by J2EE Container", "codeExample": "public interface UserLocal extends javax.ejb.EJBLocalObject {\n public String getUserName();\n public void setPassword(String password);\n}" }, { "path": "com.sun.j2ee.blueprints.signon.user.ejb.UserEJB", "mechanism": "EJB", "name": "UserEJB", "description": "The class uses EJB 2.x Container-Managed Persistence (CMP). The abstract methods `getUserName`/`setUserName` and `getPassword`/`setPassword` are implemented by the EJB container to map directly to database columns. The container handles the generation of SQL for INSERT, UPDATE, SELECT, and DELETE operations based on the deployment descriptor configuration.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations managed by the container.", "transactionHandling": "Container Managed Transactions (CMT) via EJB Context.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getUserName();\npublic abstract void setUserName(String userName);" }, { "path": "com.sun.j2ee.blueprints.signon.user.ejb.UserLocalHome", "mechanism": "EJB", "name": "UserLocalHome", "description": "This interface defines the contract for an EJB 2.x Entity Bean's local home. It provides methods for creating and finding 'User' entities. The EJB container implements this interface at deployment time, generating the necessary data access logic (typically SQL) to interact with a database based on the EJB's deployment descriptor (e.g., ejb-jar.xml). The methods 'create', 'findByPrimaryKey', and 'findAllUsers' correspond to database INSERT and SELECT operations.", "databaseName": "unknown", "tablesAccessed": [ "User" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "EJB-QL or container-managed persistence finders. The `create` method maps to an INSERT. `findByPrimaryKey` maps to a `SELECT` by primary key. `findAllUsers` maps to a `SELECT` for all rows.", "transactionHandling": "Container-Managed Transactions (CMT). The EJB container automatically manages transaction boundaries for these methods, as is standard for EJB entity beans.", "protocol": "unknown", "connectionInfo": "unknown", "codeExample": "public UserLocal findByPrimaryKey (String userName) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.signon.web", "mechanism": "EJB", "name": "SignOn", "description": "The servlet interacts with the database indirectly through an Enterprise Java Bean (SignOnLocal). The EJB encapsulates the persistence logic for creating a user.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "WRITE" ], "queryPatterns": "n/a", "transactionHandling": "unknown", "protocol": "EJB Local Interface", "connectionInfo": "java:comp/env/ejb/SignOn", "codeExample": "InitialContext ic = new InitialContext();\nObject o = ic.lookup(\"java:comp/env/ejb/SignOn\");\nSignOnLocalHome home =(SignOnLocalHome)o;\nsignOn = home.create();\nsignOn.createUser(userName, password);" }, { "path": "com.sun.j2ee.blueprints.signon.web.SignOnFilter", "mechanism": "EJB", "name": "SignOn EJB", "description": "The filter delegates the actual database authentication logic to an Enterprise JavaBean (`SignOnLocal`). The filter looks up the EJB via JNDI and invokes the `authenticate` method, which presumably interacts with the database to verify credentials.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ" ], "queryPatterns": "n/a", "transactionHandling": "unknown", "protocol": "EJB Local Interface", "connectionInfo": "java:comp/env/ejb/SignOn", "codeExample": "InitialContext ic = new InitialContext();\nObject o = ic.lookup(\"java:comp/env/ejb/SignOn\");\nSignOnLocalHome home =(SignOnLocalHome)o;\nsignOn = home.create();\nboolean authenticated = signOn.authenticate(userName, password);" }, { "path": "com.sun.j2ee.blueprints.supplier.inventory.ejb", "mechanism": "EJB", "name": "InventoryEJB", "description": "The class uses EJB 2.x Container-Managed Persistence (CMP). The EJB container automatically handles the database interactions (SELECT, INSERT, UPDATE, DELETE) based on the abstract accessor methods defined in this class and the deployment descriptor mapping.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "n/a", "codeExample": "public abstract String getItemId();\npublic abstract void setItemId(String itemId);" }, { "path": "com.sun.j2ee.blueprints.supplier.inventory.ejb", "mechanism": "EJB", "name": "Inventory CMP Bean", "description": "This interface represents a Container Managed Persistence (CMP) Entity Bean. The EJB container automatically handles the synchronization of the bean's state (itemId, quantity) with the underlying database table based on the deployment descriptor.", "databaseName": "unknown", "tablesAccessed": [ "Inventory" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM-style persistence managed by the EJB container", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB specification", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface InventoryLocal extends EJBLocalObject" }, { "path": "com.sun.j2ee.blueprints.supplier.inventory.ejb", "mechanism": "EJB", "name": "Inventory CMP Bean", "description": "The code defines an EJB Local Home interface for a Container Managed Persistence (CMP) bean. The EJB container handles the actual database interactions (SQL generation, connection management) based on this interface and the associated deployment descriptors.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Create, Find By ID, Find All)", "transactionHandling": "Container Managed Transactions (CMT) implied by EJB context", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public InventoryLocal create(String itemId, int quantity)\n throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.supplier.inventory.web", "mechanism": "EJB", "name": "InventoryLocalHome", "description": "The class interacts with the database indirectly by invoking methods on an Enterprise JavaBean (EJB) Local Home interface. The `findAllInventoryItems` method on the EJB likely executes a database query (SQL or JPQL) to retrieve all inventory records.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ" ], "queryPatterns": "The method name `findAllInventoryItems` suggests a 'Select All' style query pattern, likely returning a collection of entity beans or DTOs.", "transactionHandling": "unknown", "protocol": "EJB Local Interface", "connectionInfo": "JNDI Name: JNDINames.INV_EJB", "codeExample": "inventoryHomeRef = (InventoryLocalHome)\n serviceLocator.getLocalHome(JNDINames.INV_EJB);\ninvColl = inventoryHomeRef.findAllInventoryItems();" }, { "path": "com.sun.j2ee.blueprints.supplier.inventory.web", "mechanism": "EJB", "name": "InventoryLocal, OrderFulfillmentFacadeLocal", "description": "The code interacts with the database using EJB 2.x Entity Beans (`InventoryLocal`) and Session Beans (`OrderFulfillmentFacadeLocal`). It performs explicit transaction management using JTA `UserTransaction` to wrap multiple database operations (finding and updating inventory items) into a single atomic unit.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Manual JTA UserTransaction (begin/commit)", "protocol": "unknown", "connectionInfo": "JNDI lookup via ServiceLocator", "codeExample": "ut = (UserTransaction) ic.lookup(JNDINames.USER_TRANSACTION);\nut.begin();\n// ...\ninventory = inventoryHomeRef.findByPrimaryKey(itemId);\ninventory.setQuantity(qty.intValue());\n// ...\nut.commit();" }, { "path": "com.sun.j2ee.blueprints.supplier.orderfulfillment.ejb.OrderFulfillmentFacadeEJB", "mechanism": "EJB", "name": "SupplierOrderLocalHome, InventoryLocalHome", "description": "The application uses EJB 2.x Entity Beans to interact with the database. It persists new orders using the `SupplierOrderLocalHome` interface and manages inventory levels using the `InventoryLocalHome` interface. The persistence logic is abstracted behind these EJB interfaces, which handle the underlying database operations.", "databaseName": "unknown", "tablesAccessed": [ "SupplierOrder", "Inventory", "LineItem" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Transactional CRUD operations via EJB Entity Beans. Includes finding by primary key, finding by status, creating new entities, and updating entity fields (reducing inventory).", "transactionHandling": "JPA ENTITYTRANSACTION", "protocol": "EJB 2.x Entity Beans", "connectionInfo": "Managed by EJB Container (JNDI lookups)", "codeExample": "InventoryLocal inv = invHome.findByPrimaryKey(item.getItemId());\nif(inv.getQuantity() < item.getQuantity())\n return(false);\ninv.reduceQuantity(item.getQuantity());" }, { "path": "com.sun.j2ee.blueprints.supplier.orderfulfillment.ejb.OrderFulfillmentFacadeLocal", "mechanism": "EJB", "name": "OrderFulfillmentFacade", "description": "This is an EJB Local Interface that defines business methods implying database interaction. The `processPO` method suggests data creation (INSERT), and `processPendingPO` throws `FinderException`, which is explicitly used in EJB to signal issues finding data in a database (SELECT). The underlying implementation would typically use EJB Entity Beans or JDBC.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "Likely involves creating new records for Purchase Orders and querying for records with a 'PENDING' status.", "transactionHandling": "EJB methods typically run within Container-Managed Transactions (CMT) by default.", "protocol": "unknown", "connectionInfo": "n/a", "codeExample": "public Collection processPendingPO() throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.supplier.processpo.ejb.SupplierOrderMDB", "mechanism": "EJB", "name": "OrderFulfillmentFacade", "description": "The class delegates data persistence and business logic to a local Enterprise Java Bean (Entity or Session facade). It does not execute SQL directly but relies on the `OrderFulfillmentFacadeLocal` component to persist purchase order data and generate invoices.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "Delegated to EJB Facade", "transactionHandling": "Container Managed (implied by EJB context)", "protocol": "EJB Local Interface", "connectionInfo": "JNDI: JNDINames.ORDERFACADE_EJB", "codeExample": "OrderFulfillmentFacadeLocalHome ref = (OrderFulfillmentFacadeLocalHome)\n serviceLocator.getLocalHome(JNDINames.ORDERFACADE_EJB);\npoProcessor = ref.create();\n// ...\ninvoice = poProcessor.processPO(xmlMessage);" }, { "path": "com.sun.j2ee.blueprints.supplier.tools.populate", "mechanism": "EJB", "name": "InventoryLocalHome", "description": "The class uses Enterprise JavaBeans (EJB) 2.x Entity Beans to manage persistence. It looks up the Local Home interface via JNDI and uses it to find, remove, and create inventory items.", "databaseName": "unknown", "tablesAccessed": [ "Inventory" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Container Managed (Implicit via EJB)", "protocol": "unknown", "connectionInfo": "java:comp/env/ejb/Inventory", "codeExample": "InitialContext context = new InitialContext();\ninventoryHome = (InventoryLocalHome) context.lookup(JNDI_INVENTORY_HOME);\n// ...\ninventory = inventoryHome.create(id, quantity);" }, { "path": "com.sun.j2ee.blueprints.supplierpo.ejb", "mechanism": "EJB", "name": "SupplierOrderEJB", "description": "The class is an EJB 2.0 Entity Bean using Container-Managed Persistence (CMP). The EJB container handles the persistence of fields (PoId, PoDate, PoStatus) and relationships (ContactInfo, LineItems) to the underlying database.", "databaseName": "unknown", "tablesAccessed": [ "SupplierOrder", "LineItem", "ContactInfo" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container Managed Persistence (CMP) handles CRUD operations.", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public abstract String getPoId();\npublic abstract void setPoId(String id);" }, { "path": "com.sun.j2ee.blueprints.supplierpo.ejb", "mechanism": "EJB", "name": "SupplierOrder Entity Bean", "description": "The code defines an EJB Local Interface for an Entity Bean using Container Managed Persistence (CMP). The comments explicitly mention 'CMP fields', indicating that the EJB container automatically handles the persistence of fields like PoId, PoDate, and PoStatus to the underlying database.", "databaseName": "unknown", "tablesAccessed": [ "SupplierOrder" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Container Managed Persistence (CMP) handles queries automatically based on field access.", "transactionHandling": "Container Managed Transactions (CMT) are standard for EJB Entity Beans.", "protocol": "unknown", "connectionInfo": "Managed by EJB Container", "codeExample": "public interface SupplierOrderLocal extends EJBLocalObject{\n // getters and setters for PO CMP fields\n public String getPoId();" }, { "path": "com.sun.j2ee.blueprints.supplierpo.ejb", "mechanism": "EJB", "name": "SupplierOrderLocalHome", "description": "This is an EJB Entity Bean Home interface. It defines methods that the EJB container maps to database operations (INSERT for create, SELECT for finders).", "databaseName": "unknown", "tablesAccessed": [ "SupplierOrder" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD and conditional search based on status", "transactionHandling": "Container Managed Transactions (implied by EJB architecture)", "protocol": "unknown", "connectionInfo": "managed by container", "codeExample": "SupplierOrderLocal create(SupplierOrder supplierOrder) throws CreateException;" }, { "path": "com.sun.j2ee.blueprints.uidgen.counter.ejb", "mechanism": "EJB", "name": "CounterEJB", "description": "The class uses EJB 2.x Container-Managed Persistence (CMP). The EJB container automatically handles the mapping of the abstract 'counter' and 'name' fields to columns in a database table. The developer does not write SQL; instead, the container generates the necessary JDBC calls at runtime based on deployment descriptors.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "ORM QUERIES", "transactionHandling": "Container Managed Transactions (CMT)", "protocol": "unknown", "connectionInfo": "n/a", "codeExample": "public abstract int getCounter();\npublic abstract void setCounter(int counter);" }, { "path": "com.sun.j2ee.blueprints.uidgen.counter.ejb.CounterLocalHome", "mechanism": "EJB", "name": "Counter EJB Persistence", "description": "This file is an EJB Local Home interface. In EJB 2.x architecture, methods defined here (create, findByPrimaryKey) directly map to persistence operations managed by the container (CMP) or the bean implementation (BMP). The 'create' method implies an INSERT operation, and 'findByPrimaryKey' implies a SELECT operation by ID.", "databaseName": "unknown", "tablesAccessed": [ "unknown" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Simple CRUD operations (Insert and Select by Primary Key) managed by the EJB container.", "transactionHandling": "Container Managed Transactions (CMT) are standard for EJB Home interfaces.", "protocol": "EJB 2.x Container Protocol", "connectionInfo": "Managed by EJB Container", "codeExample": "public CounterLocal findByPrimaryKey(String name) throws FinderException;" }, { "path": "com.sun.j2ee.blueprints.uidgen.ejb.UniqueIdGeneratorEJB", "mechanism": "EJB", "name": "Counter", "description": "The class interacts with the persistence layer through EJB 2.x Entity Beans. It uses the CounterLocalHome interface to find existing Counter entities by their primary key or create new ones if they do not exist. This implies an underlying database table where counter states are stored.", "databaseName": "unknown", "tablesAccessed": [ "Counter" ], "operationType": [ "READ_WRITE" ], "queryPatterns": "Entity Bean finder (findByPrimaryKey) and creation (create) methods.", "transactionHandling": "Container-managed transactions (implied by EJB context).", "protocol": "EJB 2.x Entity Bean", "connectionInfo": "JNDI: java:comp/env/ejb/Counter", "codeExample": "counter = clh.findByPrimaryKey(name);\n} catch (FinderException fe) {\n counter = clh.create(name);\n}" }, { "path": "src/lib/jstl/sql.tld", "mechanism": "JDBC", "name": "JSTL SQL Tag Library", "description": "This file defines the interface for the JSTL SQL library, which provides a direct wrapper around JDBC functionality for use in JSP pages. It defines tags that allow setting up JDBC DataSources, executing SQL queries and updates, and managing database transactions.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE", "DDL", "OTHER" ], "queryPatterns": "Arbitrary SQL queries and updates defined by the user in JSP pages using the and tags.", "transactionHandling": "Provides a tag that wraps other database tags to execute them within a single JDBC transaction context.", "protocol": "JDBC", "connectionInfo": "Dynamic connection configuration via attributes: driver, url, user, password", "codeExample": "\n setDataSource\n org.apache.taglibs.standard.tag.el.sql.SetDataSourceTag\n empty\n \n Creates a simple DataSource suitable only for prototyping.\n \n \n driver\n false\n false\n \n \n url\n false\n false\n \n" }, { "path": "src/lib/jstl/sql-rt.tld", "mechanism": "JDBC", "name": "JSTL SQL Tag Library", "description": "This TLD defines the interface for JSTL SQL tags, which act as wrappers around JDBC functionality. It enables the execution of arbitrary SQL statements directly from JSP pages by mapping XML tags to Java classes that manage JDBC Connections, Statements, and ResultSets.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "Arbitrary SQL queries and updates defined directly within JSP pages using the and tags.", "transactionHandling": "Explicit transaction management is supported via the tag, which groups nested database operations into a single JDBC transaction.", "protocol": "JDBC", "connectionInfo": "Dynamic connection configuration via the tag attributes (driver, url, user, password)", "codeExample": "\n query\n org.apache.taglibs.standard.tag.rt.sql.QueryTag\n JSP\n \n Executes the SQL query defined in its body or through the\n sql attribute.\n \n..." }, { "path": "com.sun.j2ee.blueprints.catalog.dao.CloudscapeCatalogDAO", "mechanism": "JDBC", "name": "CloudscapeCatalogDAO", "description": "The class uses raw JDBC (Java Database Connectivity) to interact with a Cloudscape database. It obtains connections via a DataSource looked up through JNDI. It uses PreparedStatement for all queries to handle parameters safely. The code manually manages resources (Connection, PreparedStatement, ResultSet) using try-catch-finally blocks (or close calls within the try block in this specific legacy style).", "databaseName": "Cloudscape (inferred from class name)", "tablesAccessed": [ "category", "category_details", "product", "product_details", "item", "item_details" ], "operationType": [ "READ" ], "queryPatterns": "The code uses parameterized SELECT statements with joins (INNER JOIN) to fetch localized data. It includes a dynamic query builder for search functionality that constructs a WHERE clause based on the number of input keywords.", "transactionHandling": "Manual resource management (close() calls). No explicit transaction boundaries (commit/rollback) are defined, implying auto-commit or read-only behavior.", "protocol": "JDBC", "connectionInfo": "JNDI: java:comp/env/jdbc/CatalogDataSource", "codeExample": "c = getDataSource().getConnection();\nps = c.prepareStatement(GET_CATEGORY_STATEMENT,\n ResultSet.TYPE_SCROLL_INSENSITIVE,\n ResultSet.CONCUR_READ_ONLY);\nps.setString(1, l.toString());\nps.setString(2, categoryID);\nrs = ps.executeQuery();" }, { "path": "com.sun.j2ee.blueprints.catalog.dao.GenericCatalogDAO", "mechanism": "JDBC", "name": "CatalogDataSource", "description": "The class uses standard JDBC APIs (Connection, PreparedStatement, ResultSet) to interact with the database. It retrieves a DataSource via JNDI lookup. SQL statements are not hardcoded in the Java file but are constructed from fragments loaded from an external XML file, allowing for dynamic query generation based on parameters.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ" ], "queryPatterns": "Dynamic SQL construction from XML fragments, primarily SELECT statements with parameter binding.", "transactionHandling": "Transactions are not explicitly managed within this class (no commit/rollback calls), implying auto-commit mode or container-managed transactions.", "protocol": "JDBC", "connectionInfo": "JNDI: java:comp/env/jdbc/CatalogDataSource", "codeExample": "connection = getDataSource().getConnection();\nString[] parameterValues = new String[] { locale.toString(), categoryID };\nstatement = buildSQLStatement(connection, sqlStatements, XML_GET_CATEGORY, parameterValues);\nresultSet = statement.executeQuery();" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "JDBC", "name": "ItemPopulator", "description": "The class interacts with the database using raw JDBC connections passed into its methods. It relies on a `PopulateUtils` helper class to execute SQL statements stored in a `Map`. It performs DDL (Create/Drop) and DML (Insert) operations.", "databaseName": "unknown", "tablesAccessed": [ "item" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "Simple CRUD (Insert) and DDL (Create Table, Drop Table) operations defined externally in a Map.", "transactionHandling": "Manual transaction handling implied by passing the Connection object; specific commit/rollback logic is likely handled by the caller or the utility class.", "protocol": "JDBC", "connectionInfo": "Passed as java.sql.Connection parameter", "codeExample": "PopulateUtils.executeSQLStatement(connection, sqlStatements, PopulateUtils.makeSQLStatementKey(PopulateUtils.INSERT_OPERATION, \"item\"), PARAMETER_NAMES, this);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "JDBC", "name": "ProductPopulator", "description": "The class interacts with the database using standard JDBC `Connection` objects passed to its methods. It delegates the actual execution of SQL to a utility class `PopulateUtils`, which retrieves SQL templates from a `Map` based on operation keys (INSERT, CREATE, DROP, CHECK). It supports both direct execution against a database and generating SQL scripts (printing) when no connection is provided.", "databaseName": "unknown", "tablesAccessed": [ "product" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "The code performs DDL operations (CREATE/DROP tables) and batch-like INSERT operations driven by XML parsing. It also performs simple checks (SELECT 1 or similar) to verify table existence.", "transactionHandling": "Transactions are not explicitly managed within this class (no commit/rollback calls). It relies on the provided JDBC Connection's state (likely auto-commit or managed by the caller).", "protocol": "JDBC", "connectionInfo": "Passed dynamically via method parameters", "codeExample": "PopulateUtils.executeSQLStatement(connection, sqlStatements, PopulateUtils.makeSQLStatementKey(PopulateUtils.INSERT_OPERATION, \"product\"), PARAMETER_NAMES, this);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "JDBC", "name": "CategoryPopulator", "description": "The class interacts with the database using raw JDBC Connections and SQL statements provided in a Map. It uses a utility class 'PopulateUtils' to abstract the execution of PreparedStatement logic.", "databaseName": "unknown", "tablesAccessed": [ "category" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "Simple CRUD (INSERT) and DDL (CREATE, DROP) operations defined externally in a Map.", "transactionHandling": "Manual transaction context implied by passing Connection objects, though explicit commit/rollback is not visible in this file.", "protocol": "JDBC", "connectionInfo": "Passed as java.sql.Connection parameter", "codeExample": "PopulateUtils.executeSQLStatement(connection, sqlStatements, PopulateUtils.makeSQLStatementKey(PopulateUtils.INSERT_OPERATION, \"category\"), PARAMETER_NAMES, this);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate", "mechanism": "JDBC", "name": "CatalogPopulator", "description": "The class manages database schema operations (DDL) and data verification via JDBC Connections passed to helper classes. It does not execute SQL directly but orchestrates the execution via CategoryPopulator, ProductPopulator, and ItemPopulator.", "databaseName": "unknown", "tablesAccessed": [ "Category", "Product", "Item" ], "operationType": [ "DDL", "READ" ], "queryPatterns": "DDL operations (CREATE/DROP) and checks.", "transactionHandling": "Manual or Auto-commit (managed by caller providing the Connection)", "protocol": "JDBC", "connectionInfo": "Passed via method arguments", "codeExample": "public void createTables(Connection connection) throws PopulateException {\n categoryPopulator.createTables(connection);\n productPopulator.createTables(connection);\n itemPopulator.createTables(connection);\n return;\n }" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.CategoryDetailsPopulator", "mechanism": "JDBC", "name": "CategoryDetailsPopulator", "description": "The class interacts with the database using standard JDBC connections passed to its methods. It does not contain inline SQL but retrieves SQL statements from a `Map` (likely loaded from a properties file elsewhere). It performs DDL operations (CREATE, DROP) and DML operations (INSERT) via a helper utility `PopulateUtils`.", "databaseName": "unknown", "tablesAccessed": [ "category_details" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "Simple CRUD (Insert) and DDL (Create/Drop) operations executed via prepared statements or generic execution handlers.", "transactionHandling": "Manual transaction handling is implied as the Connection object is passed in, but explicit commit/rollback is not visible in this file (likely handled by the caller or PopulateUtils).", "protocol": "JDBC", "connectionInfo": "Passed as java.sql.Connection parameter", "codeExample": "PopulateUtils.executeSQLStatement(connection, sqlStatements, PopulateUtils.makeSQLStatementKey(PopulateUtils.INSERT_OPERATION, \"category_details\"), PARAMETER_NAMES, this);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.ItemDetailsPopulator", "mechanism": "JDBC", "name": "item_details", "description": "The class interacts with the database using raw JDBC Connections passed to its methods. It executes SQL statements (INSERT, CREATE, DROP, CHECK) stored in a Map, using a helper utility 'PopulateUtils' to handle the PreparedStatement execution.", "databaseName": "unknown", "tablesAccessed": [ "item_details" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "Simple CRUD and DDL operations defined externally in a Map.", "transactionHandling": "Manual transaction handling via the passed Connection object (likely managed by the caller).", "protocol": "JDBC", "connectionInfo": "Passed as method argument 'java.sql.Connection'", "codeExample": "PopulateUtils.executeSQLStatement(connection, sqlStatements, PopulateUtils.makeSQLStatementKey(PopulateUtils.INSERT_OPERATION, \"item_details\"), PARAMETER_NAMES, this);" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.PopulateServlet", "mechanism": "JDBC", "name": "CatalogDataSource", "description": "The servlet interacts with the database using raw JDBC connections obtained from a DataSource looked up via JNDI. It executes dynamic SQL statements (DDL for table creation and DML for data insertion) that are parsed from XML configuration files.", "databaseName": "cloudscape", "tablesAccessed": [ "unknown (dynamic from XML)" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "Dynamic SQL execution based on XML definitions, including CREATE TABLE, INSERT, DROP TABLE, and CHECK statements.", "transactionHandling": "Manual/Implicit (Connection obtained from DataSource, no explicit commit/rollback logic visible in this file, likely auto-commit or handled by populators)", "protocol": "JDBC", "connectionInfo": "JNDI: java:comp/env/jdbc/CatalogDataSource (inferred from JNDINames.CATALOG_DATASOURCE)", "codeExample": "InitialContext context = new InitialContext();\nreturn ((DataSource) context.lookup(JNDINames.CATALOG_DATASOURCE)).getConnection();" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.PopulateUtils", "mechanism": "JDBC", "name": "PopulateUtils", "description": "The class interacts directly with the database using the Java Database Connectivity (JDBC) API. It uses `PreparedStatement` to execute arbitrary SQL commands (CREATE, INSERT, DROP, CHECK) defined in external maps or strings.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "READ_WRITE" ], "queryPatterns": "The code executes dynamic SQL statements provided as strings. These can be DDL (create/drop) or DML (insert) operations depending on the input.", "transactionHandling": "The code operates on a passed `Connection` object. It does not explicitly call commit or rollback, implying that transaction management is either handled by the caller or the connection is in auto-commit mode.", "protocol": "RmiJdbc (inferred from private constant DATABASE_DRIVER)", "connectionInfo": "unknown", "codeExample": "PreparedStatement statement = connection.prepareStatement(sqlStatement);\nif (parameterNames != null) {\n for (int i = 0; i < parameterNames.length; i++) {\n String value = handler.getValue(parameterNames[i]);\n statement.setString(i + 1, value);\n }\n}\nstatement.execute();" }, { "path": "com.sun.j2ee.blueprints.petstore.tools.populate.ProductDetailsPopulator", "mechanism": "JDBC", "name": "ProductDetailsPopulator", "description": "The class interacts with the database using raw JDBC Connections passed into its methods. It does not contain hardcoded SQL but retrieves SQL statements from a `Map` passed during construction, using keys generated by `PopulateUtils`. It performs DDL (Create, Drop) and DML (Insert) operations.", "databaseName": "unknown", "tablesAccessed": [ "product_details" ], "operationType": [ "READ_WRITE", "DDL" ], "queryPatterns": "Simple CRUD and DDL operations defined externally in a Map.", "transactionHandling": "Manual transaction handling is implied as the Connection is passed in from an external source; the code itself does not explicitly commit or rollback.", "protocol": "JDBC", "connectionInfo": "Passed as parameter 'connection'", "codeExample": "PopulateUtils.executeSQLStatement(connection, sqlStatements, PopulateUtils.makeSQLStatementKey(PopulateUtils.INSERT_OPERATION, \"product_details\"), PARAMETER_NAMES, this);" }, { "path": "com.sun.j2ee.blueprints.servicelocator.ejb.ServiceLocator", "mechanism": "JDBC", "name": "ServiceLocator", "description": "The class acts as a factory to retrieve `javax.sql.DataSource` objects via JNDI lookup. It does not execute SQL itself, but it is the gateway for the application to obtain database connections managed by the application server.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "OTHER" ], "queryPatterns": "n/a", "transactionHandling": "unknown", "protocol": "JDBC", "connectionInfo": "JNDI lookup (name provided at runtime)", "codeExample": "dataSource = (DataSource)ic.lookup(dataSourceName);" }, { "path": "com.sun.j2ee.blueprints.servicelocator.web.ServiceLocator", "mechanism": "JDBC", "name": "DataSourceFactory", "description": "The class acts as a factory to retrieve `javax.sql.DataSource` objects via JNDI lookup. It caches these references to optimize performance. It does not execute SQL itself, but provides the connection factory for other classes to do so.", "databaseName": "unknown", "tablesAccessed": [], "operationType": [ "OTHER" ], "queryPatterns": "n/a", "transactionHandling": "none", "protocol": "JDBC", "connectionInfo": "JNDI Lookup", "codeExample": "dataSource = (DataSource)ic.lookup(dataSourceName);" }, { "path": "dbstuff/forall-inserts-comparison.sql", "mechanism": "STORED-PROCEDURE", "name": "Oracle PL/SQL Benchmark", "description": "The code is a native Oracle PL/SQL script that integrates directly with the database engine. It defines Data Definition Language (DDL) objects including tables and types, and uses a Stored Procedure to execute Data Manipulation Language (DML) operations. The integration leverages high-performance features such as Bulk Collect, FORALL, and Direct Path Inserts (via hints) to interact with the defined tables.", "databaseName": "Oracle", "tablesAccessed": [ "parts", "parts2" ], "operationType": [ "READ", "WRITE", "DDL" ], "queryPatterns": "The code uses simple INSERTs, Bulk INSERTs (FORALL), INSERT SELECT from TABLE() casts, and Dynamic SQL for TRUNCATE operations.", "transactionHandling": "The code explicitly manages transactions using COMMIT and ROLLBACK statements to reset table states between performance tests.", "protocol": "Oracle PL/SQL", "connectionInfo": "not applicable for SQL files", "codeExample": "FORALL indx IN 1 .. num\n INSERT INTO parts\n VALUES (pnums (indx), pnames (indx) \n );\n\nshow_elapsed_time ('FORALL (bulk)' || num);" }, { "path": "dbstuff/forall-bulk-rowcount.sql", "mechanism": "STORED-PROCEDURE", "name": "Oracle PL/SQL Bulk Processing", "description": "The code relies entirely on Oracle PL/SQL specific features. It integrates via stored procedures and anonymous blocks using bulk processing commands (`FORALL`, `BULK COLLECT`) to optimize database round-trips. It employs Dynamic SQL (`EXECUTE IMMEDIATE`) for schema changes and data insertion. It interacts with the `employees` table for updates and manages the lifecycle of the `empno_temp` table.", "databaseName": "Oracle", "tablesAccessed": [ "employees", "empno_temp" ], "operationType": [ "READ", "WRITE", "DDL" ], "queryPatterns": "Bulk UPDATE with RETURNING clause, Dynamic CREATE/DROP TABLE, Dynamic INSERT with bind variables", "transactionHandling": "Explicit COMMIT/ROLLBACK and PRAGMA AUTONOMOUS_TRANSACTION", "protocol": "Oracle PL/SQL", "connectionInfo": "not applicable for SQL files", "codeExample": "FORALL indx IN 1 .. n_in.COUNT\n EXECUTE IMMEDIATE 'insert into empno_temp values (:empno)'\n USING n_in (indx);\nCOMMIT;" }, { "path": "dbstuff/cursors-in-plsql.sql", "mechanism": "STORED-PROCEDURE", "name": "Oracle PL/SQL Cursors", "description": "The code relies entirely on Oracle PL/SQL for database integration. It performs DDL to define schema objects and DML to manipulate data. It extensively uses stored procedures, packages, and anonymous blocks to interact with the database using various cursor mechanisms (Implicit, Explicit, REF CURSOR) and dynamic SQL methods (DBMS_SQL, EXECUTE IMMEDIATE patterns via OPEN FOR).", "databaseName": "Oracle Database", "tablesAccessed": [ "endangered_species", "hr.locations", "hr.departments", "hr.employees" ], "operationType": [ "READ", "WRITE", "DDL" ], "queryPatterns": "The code demonstrates multiple patterns: simple SELECT INTO, BULK COLLECT for batch retrieval, explicit CURSOR declaration and iteration, dynamic SQL using OPEN FOR, and low-level dynamic SQL using DBMS_SQL.", "transactionHandling": "Explicit COMMIT is used after the initial data insertion; otherwise, read operations do not explicitly manage transactions.", "protocol": "Oracle PL/SQL", "connectionInfo": "not applicable for SQL files", "codeExample": "CURSOR species_cur (filter_in IN VARCHAR2) \nIS \n SELECT * \n FROM endangered_species \n WHERE species_name LIKE filter_in;" }, { "path": "dbstuff/cursor-for-loop.sql", "mechanism": "STORED-PROCEDURE", "name": "emps_pkg", "description": "The code integrates with an Oracle database using PL/SQL scripts and DDL. It defines a stored package ('emps_pkg') and executes anonymous blocks to manage data retrieval via cursors. The integration relies on standard SQL queries embedded within PL/SQL constructs to access the 'employees' table.", "databaseName": "Oracle Database", "tablesAccessed": [ "employees" ], "operationType": [ "READ", "DDL" ], "queryPatterns": "The code uses 'SELECT *' queries within cursor definitions, including parameterized WHERE clauses.", "transactionHandling": "No explicit transaction control (COMMIT/ROLLBACK) is used as the operations are read-only or DDL (which auto-commits).", "protocol": "Oracle PL/SQL", "connectionInfo": "not applicable for SQL files", "codeExample": "CURSOR emps_cur (department_id_in IN INTEGER) \nIS \n SELECT * FROM employees \n WHERE department_id = department_id_in;" }, { "path": "dbstuff/cursor-for-loop-optimization.sql", "mechanism": "STORED-PROCEDURE", "name": "test_cursor_performance", "description": "The file defines a PL/SQL stored procedure that interacts with the Oracle database engine. It uses SELECT queries on the system table 'dual' to generate data. It also includes DDL statements (ALTER PROCEDURE) to modify compiler settings and anonymous PL/SQL blocks to execute the procedure.", "databaseName": "Oracle", "tablesAccessed": [ "dual" ], "operationType": [ "READ", "DDL", "ADMIN" ], "queryPatterns": "CONNECT BY LEVEL generation, Cursor iteration, BULK COLLECT, ALTER PROCEDURE statements", "transactionHandling": "None (Read-only logic)", "protocol": "Oracle PL/SQL", "connectionInfo": "not applicable for SQL files", "codeExample": "CURSOR cur IS \n SELECT * FROM dual \n CONNECT BY LEVEL < 100001; \nFETCH cur BULK COLLECT INTO many_rows LIMIT 100;\nALTER PROCEDURE test_cursor_performance COMPILE plsql_optimize_level=2;" }, { "path": "dbstuff/trigger-predicates.sql", "mechanism": "TRIGGER", "name": "Oracle PL/SQL Triggers and Procedures", "description": "The code utilizes Oracle PL/SQL to define database triggers that respond to DML events (INSERT, UPDATE, DELETE). It integrates DDL for table creation, Stored Procedures for shared logic, and Triggers for event interception. The logic relies on Oracle-specific conditional predicates to determine the operation type dynamically.", "databaseName": "Oracle Database", "tablesAccessed": [ "employees" ], "operationType": [ "DDL", "READ", "WRITE" ], "queryPatterns": "The script uses CREATE TABLE for schema definition, standard INSERT/UPDATE/DELETE statements for data manipulation, and PL/SQL blocks for logic.", "transactionHandling": "Explicit COMMIT is used in the initial data setup block; other operations rely on the session's transaction state.", "protocol": "Oracle PL/SQL 12c+", "codeExample": "CREATE OR REPLACE TRIGGER employee_changes_after \n AFTER UPDATE OR INSERT \n ON employees \nBEGIN \n show_trigger_event; \nEND;" } ], "procsAndTriggers": { "procs": { "total": 9, "low": 5, "medium": 4, "high": 0, "list": [ { "path": "dbstuff/cursor-for-loop-optimization.sql", "type": "STORED PROCEDURE", "name": "test_cursor_performance", "functionName": "test_cursor_performance", "complexity": "MEDIUM", "complexityReason": "Contains internal sub-procedures, dynamic cursor handling, bulk collection logic, and case switching for different execution paths.", "linesOfCode": 76, "purpose": "Benchmarks cursor iteration performance by generating dummy data and iterating through it using implicit loops, explicit fetches, or bulk collects. It measures and prints the execution time for the selected method. It is designed to show the impact of compiler optimization levels." }, { "path": "dbstuff/cursor-for-loop.sql", "type": "STORED PROCEDURE", "name": "emps_pkg", "functionName": "emps_pkg", "complexity": "LOW", "complexityReason": "The package consists primarily of declarative cursor definitions and simple SQL queries without complex procedural logic.", "linesOfCode": 18, "purpose": "A PL/SQL package that defines a reusable cursor for the employees table, demonstrating how to declare cursors in a package specification and optionally hide the query implementation in the package body." }, { "path": "dbstuff/cursors-in-plsql.sql", "type": "STORED PROCEDURE", "name": "show_common_names", "functionName": "show_common_names", "complexity": "MEDIUM", "complexityReason": "It utilizes the DBMS_SQL package which requires manual parsing, column definition, and fetching, making it more verbose than standard SQL.", "linesOfCode": 19, "purpose": "Dynamically queries a specified table to retrieve and print the 'common_name' column using the DBMS_SQL package." }, { "path": "dbstuff/cursors-in-plsql.sql", "type": "STORED PROCEDURE", "name": "refcursor_pkg.filtered_species_cv", "functionName": "refcursor_pkg.filtered_species_cv", "complexity": "LOW", "complexityReason": "Contains simple conditional logic to open a cursor with or without a WHERE clause.", "linesOfCode": 13, "purpose": "Returns a strongly typed REF CURSOR containing species data, optionally filtered by a search string." }, { "path": "dbstuff/cursors-in-plsql.sql", "type": "STORED PROCEDURE", "name": "refcursor_pkg.data_from_any_query_cv", "functionName": "refcursor_pkg.data_from_any_query_cv", "complexity": "LOW", "complexityReason": "Consists of a single OPEN-FOR statement using a dynamic string.", "linesOfCode": 7, "purpose": "Returns a weakly typed REF CURSOR based on any dynamic SQL query string provided as an argument." }, { "path": "dbstuff/cursors-in-plsql.sql", "type": "STORED PROCEDURE", "name": "refcursor_pkg.data_from_any_query_cv2", "functionName": "refcursor_pkg.data_from_any_query_cv2", "complexity": "LOW", "complexityReason": "Consists of a single OPEN-FOR statement using the standard SYS_REFCURSOR type.", "linesOfCode": 7, "purpose": "Returns a SYS_REFCURSOR based on a dynamic query string, utilizing the built-in system cursor type." }, { "path": "dbstuff/forall-bulk-rowcount.sql", "type": "STORED PROCEDURE", "name": "put_in_table", "functionName": "put_in_table", "complexity": "MEDIUM", "complexityReason": "Uses autonomous transactions, dynamic SQL for both DDL and DML, and bulk binding.", "linesOfCode": 26, "purpose": "A helper procedure designed to log a collection of IDs into a database table. It handles the creation of the target table dynamically and ensures the data is committed independently of the main transaction." }, { "path": "dbstuff/forall-inserts-comparison.sql", "type": "STORED PROCEDURE", "name": "compare_inserting", "functionName": "compare_inserting", "complexity": "MEDIUM", "complexityReason": "The procedure utilizes advanced PL/SQL features such as bulk binding (FORALL), dynamic SQL, custom object types, and nested table manipulations.", "linesOfCode": 103, "purpose": "This procedure runs a series of performance tests to compare different methods of inserting data into a database table. It populates in-memory collections with dummy data and then times the execution of row-by-row inserts, bulk inserts, and SQL-based inserts. It outputs the elapsed CPU time for each method to the console to facilitate performance analysis." }, { "path": "dbstuff/trigger-predicates.sql", "type": "STORED PROCEDURE", "name": "show_trigger_event", "functionName": "show_trigger_event", "complexity": "LOW", "complexityReason": "It consists of a single CASE statement to check boolean predicates and print a string.", "linesOfCode": 11, "purpose": "This utility procedure determines the context in which it was called by checking Oracle conditional predicates (INSERTING, UPDATING, DELETING). It outputs the type of DML operation occurring to the console via DBMS_OUTPUT. It also handles cases where it is called outside of a trigger context." } ] }, "trigs": { "total": 2, "low": 2, "medium": 0, "high": 0, "list": [ { "path": "dbstuff/trigger-predicates.sql", "type": "TRIGGER", "name": "employee_changes_after", "functionName": "employee_changes_after", "complexity": "LOW", "complexityReason": "The trigger body contains a single line of code calling a stored procedure.", "linesOfCode": 5, "purpose": "This trigger fires after any INSERT or UPDATE operation is performed on the employees table. It calls the shared utility procedure to log the specific event type." }, { "path": "dbstuff/trigger-predicates.sql", "type": "TRIGGER", "name": "employee_changes_before", "functionName": "employee_changes_before", "complexity": "LOW", "complexityReason": "The trigger body contains a single line of code calling a stored procedure.", "linesOfCode": 5, "purpose": "This trigger fires before any DELETE operation is performed on the employees table. It calls the shared utility procedure to log the specific event type." } ] } }, "integrationPoints": [ { "namespace": "com.sun.j2ee.blueprints.admin.client", "filepath": "src/apps/admin/src/client/com/sun/j2ee/blueprints/admin/client/PetStoreProxy.java", "mechanism": "OTHER", "name": "PetStore Admin Service", "description": "The interface defines a client proxy for interacting with a remote PetStore server.", "direction": "CONSUMER", "protocol": "Unknown (Abstracted by Proxy)", "connectionInfo": "Configured via setup(host, port, endpoint)" }, { "namespace": "com.sun.j2ee.blueprints.admin.client.DataSource", "filepath": "src/apps/admin/src/client/com/sun/j2ee/blueprints/admin/client/DataSource.java", "mechanism": "OTHER", "name": "PetStoreProxy", "description": "Communicates with the backend server to retrieve orders and sales data, and to update order statuses.", "direction": "BIDIRECTIONAL", "connectionInfo": "Configured via hostname, port, and endpoint passed to constructor" }, { "namespace": "com.sun.j2ee.blueprints.admin.client.HttpPostPetStoreProxy", "filepath": "src/apps/admin/src/client/com/sun/j2ee/blueprints/admin/client/HttpPostPetStoreProxy.java", "mechanism": "REST", "name": "ApplRequestProcessor", "description": "The main entry point for the PetStore Admin backend. Although it uses XML payloads over HTTP POST (XML-RPC style), it functions as the primary HTTP integration point.", "path": "/admin/ApplRequestProcessor", "method": "POST", "direction": "BIDIRECTIONAL", "requestBody": "Custom XML structure (e.g., ......)", "responseBody": "XML Document", "protocol": "HTTP/1.1", "connectionInfo": "http://{host}:{port}/admin/ApplRequestProcessor" }, { "namespace": "com.sun.j2ee.blueprints.admin.web", "filepath": "src/apps/admin/src/admin/com/sun/j2ee/blueprints/admin/web/AdminRequestProcessor.java", "mechanism": "REST", "name": "AdminRequestProcessor Servlet", "description": "Standard Java Servlet handling HTTP requests for the Admin module.", "path": "/admin (inferred from JNLP codebase construction)", "method": "GET, POST", "direction": "CONSUMER", "protocol": "HTTP/1.1" }, { "namespace": "com.sun.j2ee.blueprints.admin.web.AdminRequestBD", "filepath": "src/apps/admin/src/admin/com/sun/j2ee/blueprints/admin/web/AdminRequestBD.java", "mechanism": "JMS-QUEUE", "name": "Order Approval Sender", "description": "Produces a message to an asynchronous processing queue to handle order updates. The message payload is an XML representation of the 'OrderApproval' object. The actual sending is delegated to the 'AsyncSender' EJB.", "queueOrTopicName": "Not directly specified, managed by the 'AsyncSender' EJB", "messageType": "String (XML)", "direction": "PRODUCER", "requestBody": "XML representation of a com.sun.j2ee.blueprints.xmldocuments.OrderApproval object." }, { "namespace": "com.sun.j2ee.blueprints.admin.web.ApplRequestProcessor", "filepath": "src/apps/admin/src/admin/com/sun/j2ee/blueprints/admin/web/ApplRequestProcessor.java", "mechanism": "REST", "name": "ApplRequestProcessor", "description": "A single servlet endpoint that processes XML requests from a rich client. The specific action is determined by a `` element within the XML payload. It handles fetching orders by status, updating order statuses, and retrieving aggregated data for charts.", "path": "unknown (defined in web.xml)", "method": "POST", "requestBody": "XML document containing a element (e.g., GETORDERS, UPDATESTATUS, REVENUE, ORDERS) and other data specific to the request type.", "responseBody": "XML document containing a root element, with data corresponding to the request or an element.", "protocol": "HTTP/1.1" }, { "namespace": "com.sun.j2ee.blueprints.asyncsender.ejb", "filepath": "src/components/asyncsender/src/com/sun/j2ee/blueprints/asyncsender/ejb/AsyncSenderEJB.java", "mechanism": "JMS-QUEUE", "name": "ASYNC_SENDER_QUEUE", "description": "Sends asynchronous text messages to a JMS queue defined by JNDI name.", "queueOrTopicName": "JNDINames.ASYNC_SENDER_QUEUE", "messageType": "TextMessage", "direction": "PRODUCER", "connectionInfo": "JNDINames.QUEUE_CONNECTION_FACTORY" }, { "namespace": "com.sun.j2ee.blueprints.asyncsender.util.JNDINames", "filepath": "src/components/asyncsender/src/com/sun/j2ee/blueprints/asyncsender/util/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "AsyncSenderQueue", "description": "JNDI lookup name for the AsyncSender JMS Queue defined as a constant.", "queueOrTopicName": "AsyncSenderQueue", "direction": "OTHER", "connectionInfo": "java:comp/env/jms/AsyncSenderQueue" }, { "namespace": "com.sun.j2ee.blueprints.asyncsender.util.JNDINames", "filepath": "src/components/asyncsender/src/com/sun/j2ee/blueprints/asyncsender/util/JNDINames.java", "mechanism": "OTHER", "name": "AsyncSender EJB", "description": "JNDI lookup name for the AsyncSender Local EJB Home interface.", "connectionInfo": "java:comp/env/ejb/AsyncSender" }, { "namespace": "com.sun.j2ee.blueprints.catalog.client.CatalogHelper", "filepath": "src/components/catalog/src/com/sun/j2ee/blueprints/catalog/client/CatalogHelper.java", "mechanism": "OTHER", "name": "CatalogLocal EJB", "description": "Local Enterprise Java Bean interface for Catalog services", "path": "JNDINames.CATALOG_EJBHOME", "method": "create, searchItems, getCategories, getProducts, getItems, getItem", "direction": "CONSUMER", "protocol": "EJB RMI/Local", "connectionInfo": "JNDI Lookup via ServiceLocator" }, { "namespace": "com.sun.j2ee.blueprints.catalog.dao", "filepath": "src/components/catalog/src/com/sun/j2ee/blueprints/catalog/dao/CatalogDAOFactory.java", "mechanism": "OTHER", "name": "JNDI Configuration Lookup", "description": "Looks up the implementation class name for the DAO from the JNDI context.", "path": "JNDINames.CATALOG_DAO_CLASS", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.catalog.dao.GenericCatalogDAO", "filepath": "src/components/catalog/src/com/sun/j2ee/blueprints/catalog/dao/GenericCatalogDAO.java", "mechanism": "OTHER", "name": "JNDI DataSource Lookup", "description": "Looks up the JDBC DataSource using JNDI.", "path": "java:comp/env/jdbc/CatalogDataSource", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.catalog.dao.GenericCatalogDAO", "filepath": "src/components/catalog/src/com/sun/j2ee/blueprints/catalog/dao/GenericCatalogDAO.java", "mechanism": "OTHER", "name": "JNDI Configuration Lookup", "description": "Looks up the URL for the DAO SQL XML configuration file.", "path": "java:comp/env/url/CatalogDAOSQLURL", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.catalog.ejb", "filepath": "src/components/catalog/src/com/sun/j2ee/blueprints/catalog/ejb/CatalogLocal.java", "mechanism": "OTHER", "name": "CatalogLocal", "description": "EJB Local Interface defining the API for the Catalog service component.", "direction": "BIDIRECTIONAL" }, { "namespace": "com.sun.j2ee.blueprints.customer.account.ejb", "filepath": "src/components/customer/src/com/sun/j2ee/blueprints/customer/account/ejb/AccountEJB.java", "mechanism": "OTHER", "name": "java:comp/env/ejb/ContactInfo", "description": "JNDI lookup for ContactInfo Local Home interface", "path": "java:comp/env/ejb/ContactInfo", "method": "lookup", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.customer.account.ejb", "filepath": "src/components/customer/src/com/sun/j2ee/blueprints/customer/account/ejb/AccountEJB.java", "mechanism": "OTHER", "name": "java:comp/env/ejb/CreditCard", "description": "JNDI lookup for CreditCard Local Home interface", "path": "java:comp/env/ejb/CreditCard", "method": "lookup", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.customer.account.ejb.AccountLocal", "filepath": "src/components/customer/src/com/sun/j2ee/blueprints/customer/account/ejb/AccountLocal.java", "mechanism": "OTHER", "name": "EJB Local Interface", "description": "Exposes local business methods for the Account component within the EJB container.", "direction": "BIDIRECTIONAL" }, { "namespace": "com.sun.j2ee.blueprints.customer.ejb.CustomerEJB", "filepath": "src/components/customer/src/com/sun/j2ee/blueprints/customer/ejb/CustomerEJB.java", "mechanism": "OTHER", "name": "java:comp/env/ejb/Account", "description": "JNDI lookup for the Account EJB Local Home interface.", "path": "java:comp/env/ejb/Account", "method": "lookup", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.customer.ejb.CustomerEJB", "filepath": "src/components/customer/src/com/sun/j2ee/blueprints/customer/ejb/CustomerEJB.java", "mechanism": "OTHER", "name": "java:comp/env/ejb/Profile", "description": "JNDI lookup for the Profile EJB Local Home interface.", "path": "java:comp/env/ejb/Profile", "method": "lookup", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.encodingfilter.web", "filepath": "src/components/encodingfilter/src/com/sun/j2ee/blueprints/encodingfilter/web/EncodingFilter.java", "mechanism": "REST", "name": "EncodingFilter", "description": "A Servlet Filter that intercepts HTTP requests to set the character encoding.", "path": "/* (configured in web.xml)", "method": "ALL", "direction": "BOTH", "protocol": "HTTP", "connectionInfo": "Servlet Container" }, { "namespace": "com.sun.j2ee.blueprints.mailer.ejb", "filepath": "src/components/mailer/src/com/sun/j2ee/blueprints/mailer/ejb/MailerMDB.java", "mechanism": "JMS-QUEUE", "name": "mailer queue", "description": "Receives email requests formatted as XML strings within JMS TextMessages.", "messageType": "TextMessage", "direction": "CONSUMER", "requestBody": "XML string containing email address, subject, and content." }, { "namespace": "com.sun.j2ee.blueprints.mailer.ejb", "filepath": "src/components/mailer/src/com/sun/j2ee/blueprints/mailer/ejb/MailHelper.java", "mechanism": "OTHER", "name": "JavaMail Service", "description": "Sends email messages via the configured J2EE Mail Session.", "direction": "PRODUCER", "protocol": "SMTP", "connectionInfo": "JNDI: mail/Session" }, { "namespace": "com.sun.j2ee.blueprints.opc.admin.ejb", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/admin/ejb/OPCAdminFacadeEJB.java", "mechanism": "OTHER", "name": "PurchaseOrder EJB", "description": "Local EJB interaction to retrieve purchase order data.", "path": "java:comp/env/ejb/PurchaseOrder", "method": "findByPrimaryKey, findPOBetweenDates", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.opc.admin.ejb", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/admin/ejb/OPCAdminFacadeEJB.java", "mechanism": "OTHER", "name": "ProcessManager EJB", "description": "Local EJB interaction to retrieve process management data.", "path": "java:comp/env/ejb/ProcessManager", "method": "getOrdersByStatus", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.opc.admin.ejb.OPCAdminFacade", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/admin/ejb/OPCAdminFacade.java", "mechanism": "OTHER", "name": "OPCAdminFacade EJB Remote Interface", "description": "Defines the RMI-IIOP remote interface for the OPC Admin EJB, allowing remote clients to invoke administrative business logic.", "direction": "BIDIRECTIONAL", "authentication": "Container Managed (likely)", "protocol": "RMI-IIOP", "connectionInfo": "JNDI lookup required" }, { "namespace": "com.sun.j2ee.blueprints.opc.admin.ejb.OPCAdminFacadeHome", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/admin/ejb/OPCAdminFacadeHome.java", "mechanism": "OTHER", "name": "OPCAdminFacadeHome", "description": "EJB Home Interface via RMI/IIOP", "direction": "BIDIRECTIONAL", "protocol": "EJB/RMI" }, { "namespace": "com.sun.j2ee.blueprints.opc.customerrelations.ejb", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/customerrelations/ejb/MailInvoiceMDB.java", "mechanism": "JMS-QUEUE", "name": "Invoice Listener", "description": "Receives JMS messages containing invoice XML data for processing.", "messageType": "XML Invoice", "direction": "CONSUMER", "requestBody": "XML String containing invoice details", "protocol": "JMS" }, { "namespace": "com.sun.j2ee.blueprints.opc.customerrelations.ejb", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/customerrelations/ejb/MailInvoiceMDB.java", "mechanism": "OTHER", "name": "MailInvoiceTransitionDelegate", "description": "Delegates the sending of the generated email XML to the next step in the process (likely another JMS queue for the Mailer service).", "messageType": "XML Mail Message", "direction": "PRODUCER" }, { "namespace": "com.sun.j2ee.blueprints.opc.customerrelations.ejb.MailCompletedOrderMDB", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/customerrelations/ejb/MailCompletedOrderMDB.java", "mechanism": "JMS-QUEUE", "name": "MailCompletedOrderQueue", "description": "Receives JMS messages containing the ID of completed orders.", "messageType": "TextMessage", "direction": "CONSUMER", "requestBody": "String (Order ID)", "protocol": "JMS", "connectionInfo": "Managed by EJB Container" }, { "namespace": "com.sun.j2ee.blueprints.opc.customerrelations.ejb.MailOrderApprovalMDB", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/customerrelations/ejb/MailOrderApprovalMDB.java", "mechanism": "JMS-QUEUE", "name": "OrderApprovalQueue", "description": "Receives JMS messages containing OrderApproval XML documents.", "path": "n/a", "method": "onMessage", "queueOrTopicName": "unknown (configured in deployment descriptor)", "messageType": "TextMessage (XML)", "direction": "CONSUMER", "requestBody": "XML String representing OrderApproval", "responseBody": "n/a", "protocol": "JMS", "connectionInfo": "Container Managed" }, { "namespace": "com.sun.j2ee.blueprints.opc.customerrelations.ejb.MailOrderApprovalMDB", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/customerrelations/ejb/MailOrderApprovalMDB.java", "mechanism": "JMS-QUEUE", "name": "MailerService", "description": "Sends generated email XML messages to the mailer service via a TransitionDelegate.", "path": "n/a", "method": "send", "queueOrTopicName": "unknown (hidden behind TransitionDelegate)", "messageType": "XML String (Mail)", "direction": "PRODUCER", "requestBody": "XML String representing Mail object", "responseBody": "n/a", "protocol": "JMS", "connectionInfo": "Managed by MailOrderApprovalTransitionDelegate" }, { "namespace": "com.sun.j2ee.blueprints.opc.ejb", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/ejb/PurchaseOrderMDB.java", "mechanism": "JMS-QUEUE", "name": "PurchaseOrderQueue", "description": "Receives purchase order XML messages from the Pet Store frontend.", "messageType": "TextMessage (XML)", "direction": "CONSUMER", "protocol": "JMS", "connectionInfo": "Configured via deployment descriptor (ejb-jar.xml)" }, { "namespace": "com.sun.j2ee.blueprints.opc.ejb", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/ejb/PurchaseOrderMDB.java", "mechanism": "JMS-QUEUE", "name": "OrderApprovalQueue", "description": "Sends auto-approved order messages to the OrderApproval queue via the TransitionDelegate.", "messageType": "XML", "direction": "PRODUCER", "protocol": "JMS", "connectionInfo": "Managed by TransitionDelegate/PurchaseOrderTD" }, { "namespace": "com.sun.j2ee.blueprints.opc.ejb.InvoiceMDB", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/ejb/InvoiceMDB.java", "mechanism": "JMS-QUEUE", "name": "Invoice Queue", "description": "Receives JMS messages containing XML invoices.", "messageType": "TextMessage (XML)", "direction": "CONSUMER", "requestBody": "XML Invoice Document", "protocol": "JMS", "connectionInfo": "Managed by EJB Container" }, { "namespace": "com.sun.j2ee.blueprints.opc.ejb.OrderApprovalMDB", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/ejb/OrderApprovalMDB.java", "mechanism": "JMS-QUEUE", "name": "OrderApprovalQueue", "description": "Receives order approval/denial notifications via JMS.", "messageType": "TextMessage (XML)", "direction": "CONSUMER", "requestBody": "XML containing list of ChangedOrder elements", "protocol": "JMS", "connectionInfo": "Managed by EJB Container" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/PurchaseOrderTD.java", "mechanism": "JMS-QUEUE", "name": "OrderApprovalQueue", "description": "Sends an order approval XML message to the Order Approval MDB Queue.", "queueOrTopicName": "JNDINames.ORDER_APPROVAL_MDB_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "connectionInfo": "JNDI lookup via ServiceLocator" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/MailInvoiceTransitionDelegate.java", "mechanism": "JMS-QUEUE", "name": "MAIL_SENDER_QUEUE", "description": "Sends an XML-formatted invoice email message to a JMS queue for asynchronous processing by a mailer service.", "queueOrTopicName": "JNDINames.MAIL_SENDER_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "requestBody": "XML String containing email details", "connectionInfo": "JNDI lookup via ServiceLocator" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/InvoiceTD.java", "mechanism": "JMS-QUEUE", "name": "CR_MAIL_COMPLETED_ORDER_MDB_QUEUE", "description": "Queue used to send completed order messages for mailing.", "queueOrTopicName": "CR_MAIL_COMPLETED_ORDER_MDB_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "connectionInfo": "JNDI: QUEUE_CONNECTION_FACTORY" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/MailCompletedOrderTD.java", "mechanism": "JMS-QUEUE", "name": "JNDINames.MAIL_SENDER_QUEUE", "description": "Sends an XML-based email notification message to a JMS queue for asynchronous processing by a mailer service.", "queueOrTopicName": "JNDINames.MAIL_SENDER_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "connectionInfo": "JNDINames.QUEUE_CONNECTION_FACTORY" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.JNDINames", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "QueueConnectionFactory", "description": "JNDI lookup name for the JMS Queue Connection Factory.", "queueOrTopicName": "java:comp/env/jms/QueueConnectionFactory", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.JNDINames", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "OrderApprovalQueue", "description": "JNDI lookup name for the Order Approval MDB Queue.", "queueOrTopicName": "java:comp/env/jms/OrderApprovalQueue", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.JNDINames", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "OrderApprovalMailQueue", "description": "JNDI lookup name for the Customer Relations Mail Order Approval Queue.", "queueOrTopicName": "java:comp/env/jms/OrderApprovalMailQueue", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.JNDINames", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "CompletedOrderMailQueue", "description": "JNDI lookup name for the Customer Relations Mail Completed Order Queue.", "queueOrTopicName": "java:comp/env/jms/CompletedOrderMailQueue", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.JNDINames", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "PurchaseOrderQueue", "description": "JNDI lookup name for the Supplier Purchase Order Queue.", "queueOrTopicName": "java:comp/env/jms/PurchaseOrderQueue", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.JNDINames", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/JNDINames.java", "mechanism": "JMS-QUEUE", "name": "MailQueue", "description": "JNDI lookup name for the Mail Sender Queue.", "queueOrTopicName": "java:comp/env/jms/MailQueue", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.MailOrderApprovalTransitionDelegate", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/MailOrderApprovalTransitionDelegate.java", "mechanism": "JMS-QUEUE", "name": "MAIL_SENDER_QUEUE", "description": "Sends XML-formatted email messages to a JMS queue for asynchronous processing by a mailer service.", "queueOrTopicName": "JNDINames.MAIL_SENDER_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "connectionInfo": "JNDI lookup via ServiceLocator" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.OrderApprovalTD", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/OrderApprovalTD.java", "mechanism": "JMS-QUEUE", "name": "Supplier Purchase Order Queue", "description": "Queue used to send purchase orders to suppliers.", "queueOrTopicName": "JNDINames.SUPPLIER_PURCHASE_ORDER_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "requestBody": "XML Purchase Order", "connectionInfo": "Lookup via JNDINames.QUEUE_CONNECTION_FACTORY" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.OrderApprovalTD", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/OrderApprovalTD.java", "mechanism": "JMS-QUEUE", "name": "Mail Order Approval Queue", "description": "Queue used to send order approval/denial notices to customer relations for emailing.", "queueOrTopicName": "JNDINames.CR_MAIL_ORDER_APPROVAL_MDB_QUEUE", "messageType": "XML String", "direction": "PRODUCER", "requestBody": "XML Order Approval List", "connectionInfo": "Lookup via JNDINames.QUEUE_CONNECTION_FACTORY" }, { "namespace": "com.sun.j2ee.blueprints.opc.transitions.QueueHelper", "filepath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/transitions/QueueHelper.java", "mechanism": "JMS-QUEUE", "name": "Unknown (Dynamic)", "description": "Sends a JMS TextMessage containing XML to a dynamically configured queue.", "path": "n/a", "method": "SEND", "queueOrTopicName": "Stored in 'q' field", "messageType": "TextMessage (XML)", "direction": "PRODUCER", "requestBody": "XML String", "responseBody": "n/a", "protocol": "JMS", "connectionInfo": "Managed via QueueConnectionFactory" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.ejb", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/ejb/ShoppingClientFacadeLocalEJB.java", "mechanism": "OTHER", "name": "Customer Service", "description": "Integration with the Customer EJB component via JNDI lookup.", "path": "JNDINames.CUSTOMER_EJBHOME", "direction": "CONSUMER", "protocol": "JNDI/EJB Local" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.ejb", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/ejb/ShoppingClientFacadeLocalEJB.java", "mechanism": "OTHER", "name": "Shopping Cart Service", "description": "Integration with the Shopping Cart EJB component via JNDI lookup.", "path": "JNDINames.SHOPPING_CART_EJBHOME", "direction": "CONSUMER", "protocol": "JNDI/EJB Local" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.ejb.ShoppingClientFacadeLocal", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/ejb/ShoppingClientFacadeLocal.java", "mechanism": "OTHER", "name": "ShoppingClientFacadeLocal", "description": "J2EE EJB Local Interface serving as a facade for shopping operations.", "direction": "BIDIRECTIONAL" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.ejb.actions", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/ejb/actions/CartEJBAction.java", "mechanism": "OTHER", "name": "ShoppingCartLocal", "description": "Invocation of EJB Local Interface for Shopping Cart operations", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.ejb.actions.OrderEJBAction", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/ejb/actions/OrderEJBAction.java", "mechanism": "JMS-QUEUE", "name": "JNDINames.ASYNCSENDER_LOCAL_EJB_HOME", "description": "This action produces a message containing a purchase order in XML format. It uses the AsyncSender EJB, looked up via JNDI, to send the message to a message queue for asynchronous backend processing. This decouples the web front-end from order fulfillment tasks.", "queueOrTopicName": "unknown, encapsulated by AsyncSender EJB", "messageType": "String (XML)", "direction": "PRODUCER", "connectionInfo": "JNDI Name: com.sun.j2ee.blueprints.asyncsender.ejb.AsyncSenderLocal" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.web", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/web/ShoppingWebController.java", "mechanism": "OTHER", "name": "ShoppingControllerLocal", "description": "Interaction with the EJB tier via the ShoppingControllerLocal interface.", "path": "n/a", "method": "processEvent", "direction": "PRODUCER", "protocol": "EJB", "connectionInfo": "Lookup via PetstoreComponentManager" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.web.SignOnNotifier", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/web/SignOnNotifier.java", "mechanism": "OTHER", "name": "HttpSessionAttributeListener", "description": "Listens for changes to HTTP Session attributes to trigger application logic.", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.web.actions.CustomerHTMLAction", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/web/actions/CustomerHTMLAction.java", "mechanism": "OTHER", "name": "Servlet Request Processing", "description": "Processes standard Java Servlet HTTP requests to extract form data.", "direction": "CONSUMER", "protocol": "HTTP" }, { "namespace": "com.sun.j2ee.blueprints.petstore.controller.web.actions.OrderHTMLAction", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/controller/web/actions/OrderHTMLAction.java", "mechanism": "REST", "name": "Order Processing Action", "description": "Consumes HTTP requests via the Servlet API to process form data.", "path": "unknown (dynamic)", "method": "POST", "direction": "CONSUMER", "requestBody": "Form data (family_name, given_name, address_1, etc.)", "protocol": "HTTP/Servlet" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/UserPopulator.java", "mechanism": "OTHER", "name": "User EJB", "description": "Integration with the EJB Container to manage User entities.", "path": "java:comp/env/ejb/User", "direction": "BIDIRECTIONAL", "protocol": "JNDI/RMI", "connectionInfo": "java:comp/env/ejb/User" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/CreditCardPopulator.java", "mechanism": "OTHER", "name": "CreditCard EJB", "description": "Integration with the CreditCard Enterprise Java Bean via JNDI lookup.", "path": "java:comp/env/ejb/CreditCard", "direction": "PRODUCER" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/AccountPopulator.java", "mechanism": "OTHER", "name": "JNDI Account Lookup", "description": "Looks up the Account EJB Local Home interface using JNDI.", "path": "java:comp/env/ejb/Account", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate.AddressPopulator", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/AddressPopulator.java", "mechanism": "OTHER", "name": "JNDI Lookup", "description": "Looks up the EJB Home interface using the Java Naming and Directory Interface.", "path": "java:comp/env/ejb/Address", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate.ContactInfoPopulator", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/ContactInfoPopulator.java", "mechanism": "OTHER", "name": "JNDI_CONTACT_INFO_HOME", "description": "Lookup of EJB Home interface via JNDI", "path": "java:comp/env/ejb/ContactInfo", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate.CustomerPopulator", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/CustomerPopulator.java", "mechanism": "OTHER", "name": "JNDI Lookup", "description": "Lookups up the Local Home interface for the Customer EJB.", "path": "java:comp/env/ejb/Customer", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.petstore.tools.populate.PopulateServlet", "filepath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/PopulateServlet.java", "mechanism": "REST", "name": "PopulateServlet", "description": "Servlet endpoint that triggers the database population process.", "path": "/populate (inferred)", "method": "POST", "direction": "CONSUMER", "requestBody": "Form parameters: success_page, error_page, forcefully", "responseBody": "HTTP Redirect" }, { "namespace": "com.sun.j2ee.blueprints.processmanager.ejb", "filepath": "src/components/processmanager/src/com/sun/j2ee/blueprints/processmanager/ejb/ProcessManagerLocal.java", "mechanism": "OTHER", "name": "EJB Local Interface", "description": "This interface acts as a local integration point for other components within the same JVM to access the Process Manager business logic via the EJB container.", "direction": "BIDIRECTIONAL" }, { "namespace": "com.sun.j2ee.blueprints.servicelocator.ejb.ServiceLocator", "filepath": "src/components/servicelocator/src/com/sun/j2ee/blueprints/servicelocator/ejb/ServiceLocator.java", "mechanism": "JMS-QUEUE", "name": "Dynamic Queue Lookup", "description": "Provides access to JMS Queues and QueueConnectionFactories via JNDI lookup.", "queueOrTopicName": "Dynamic (passed as parameter)", "direction": "BOTH" }, { "namespace": "com.sun.j2ee.blueprints.servicelocator.ejb.ServiceLocator", "filepath": "src/components/servicelocator/src/com/sun/j2ee/blueprints/servicelocator/ejb/ServiceLocator.java", "mechanism": "JMS-TOPIC", "name": "Dynamic Topic Lookup", "description": "Provides access to JMS Topics and TopicConnectionFactories via JNDI lookup.", "queueOrTopicName": "Dynamic (passed as parameter)", "direction": "BOTH" }, { "namespace": "com.sun.j2ee.blueprints.signon.ejb", "filepath": "src/components/signon/src/com/sun/j2ee/blueprints/signon/ejb/SignOnEJB.java", "mechanism": "OTHER", "name": "java:comp/env/ejb/User", "description": "JNDI lookup for the User Entity Bean Home interface.", "path": "java:comp/env/ejb/User", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.signon.web", "filepath": "src/components/signon/src/com/sun/j2ee/blueprints/signon/web/CreateUserServlet.java", "mechanism": "REST", "name": "CreateUserServlet", "description": "HTTP Servlet endpoint for creating users.", "path": "unknown", "method": "POST", "direction": "BIDIRECTIONAL", "requestBody": "Form data: user_name, password", "responseBody": "Redirect" }, { "namespace": "com.sun.j2ee.blueprints.signon.web.SignOnFilter", "filepath": "src/components/signon/src/com/sun/j2ee/blueprints/signon/web/SignOnFilter.java", "mechanism": "REST", "name": "SignOn Check Endpoint", "description": "Intercepts HTTP requests sent to the sign-on check URL to process login credentials.", "path": "j_signon_check", "method": "POST", "direction": "CONSUMER", "requestBody": "Form data: j_username, j_password, j_remember_username", "responseBody": "Redirect to original URL or error page" }, { "namespace": "com.sun.j2ee.blueprints.supplier.inventory.web", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/RcvrRequestProcessor.java", "mechanism": "REST", "name": "RcvrRequestProcessor Servlet", "description": "Standard Java Servlet endpoint processing HTTP requests for supplier inventory and orders.", "path": "unknown (mapped in web.xml)", "method": "POST, GET", "direction": "CONSUMER", "requestBody": "Form data (currentScreen, item_*, qty_*)", "responseBody": "HTML (forwarded JSP)", "protocol": "HTTP" }, { "namespace": "com.sun.j2ee.blueprints.supplier.inventory.web", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/RcvrRequestProcessor.java", "mechanism": "OTHER", "name": "TransitionDelegate", "description": "Integration point for sending invoices, likely via messaging or XML transport, abstracted by the TransitionDelegate pattern.", "messageType": "Invoice (XML likely)", "direction": "PRODUCER" }, { "namespace": "com.sun.j2ee.blueprints.supplier.inventory.web", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/DisplayInventoryBean.java", "mechanism": "OTHER", "name": "Inventory EJB", "description": "Integration with a local Enterprise JavaBean via JNDI lookup.", "path": "JNDINames.INV_EJB", "method": "findAllInventoryItems", "direction": "CONSUMER", "protocol": "EJB/JNDI", "connectionInfo": "JNDI Lookup via ServiceLocator" }, { "namespace": "com.sun.j2ee.blueprints.supplier.inventory.web.JNDINames", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/JNDINames.java", "mechanism": "OTHER", "name": "INV_EJB", "description": "JNDI Lookup Name for Inventory EJB", "connectionInfo": "java:comp/env/ejb/Inventory" }, { "namespace": "com.sun.j2ee.blueprints.supplier.inventory.web.JNDINames", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/JNDINames.java", "mechanism": "OTHER", "name": "ORDERFACADE_EJB", "description": "JNDI Lookup Name for OrderFulfillmentFacade EJB", "connectionInfo": "java:comp/env/ejb/OrderFulfillmentFacade" }, { "namespace": "com.sun.j2ee.blueprints.supplier.inventory.web.JNDINames", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/JNDINames.java", "mechanism": "OTHER", "name": "USER_TRANSACTION", "description": "JNDI Lookup Name for UserTransaction (JTA)", "connectionInfo": "java:comp/UserTransaction" }, { "namespace": "com.sun.j2ee.blueprints.supplier.orderfulfillment.ejb", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/orderfulfillment/ejb/TPASupplierOrderXDE.java", "mechanism": "OTHER", "name": "XML File Input", "description": "Reads and parses XML files from the file system via the main method or input streams.", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.supplier.processpo.ejb.JNDINames", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/processpo/ejb/JNDINames.java", "mechanism": "JMS-TOPIC", "name": "INVOICE_MDB_TOPIC", "description": "JNDI name for the Invoice JMS Topic used to send invoices.", "queueOrTopicName": "java:comp/env/jms/opc/InvoiceTopic", "direction": "PRODUCER" }, { "namespace": "com.sun.j2ee.blueprints.supplier.processpo.ejb.JNDINames", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/processpo/ejb/JNDINames.java", "mechanism": "OTHER", "name": "ORDERFACADE_EJB", "description": "JNDI name for the OrderFulfillmentFacade EJB.", "path": "java:comp/env/ejb/OrderFulfillmentFacade" }, { "namespace": "com.sun.j2ee.blueprints.supplier.processpo.ejb.SupplierOrderMDB", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/processpo/ejb/SupplierOrderMDB.java", "mechanism": "JMS-QUEUE", "name": "Supplier Order Queue", "description": "Receives purchase orders from the Order Processing Center.", "messageType": "XML (Purchase Order)", "direction": "CONSUMER", "requestBody": "XML String representing a Purchase Order", "protocol": "JMS", "connectionInfo": "Configured via deployment descriptor (ejb-jar.xml)" }, { "namespace": "com.sun.j2ee.blueprints.supplier.processpo.ejb.SupplierOrderMDB", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/processpo/ejb/SupplierOrderMDB.java", "mechanism": "JMS-QUEUE", "name": "Invoice Transition", "description": "Sends an invoice back to the OPC via a TransitionDelegate if the order is shipped.", "messageType": "XML (Invoice)", "direction": "PRODUCER", "requestBody": "XML String representing an Invoice", "protocol": "JMS (implied by TransitionDelegate)", "connectionInfo": "JNDI: JNDINames.TRANSITION_DELEGATE__SUPPLIER_ORDER" }, { "namespace": "com.sun.j2ee.blueprints.supplier.tools.populate", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/tools/populate/PopulateServlet.java", "mechanism": "REST", "name": "PopulateServlet", "description": "HTTP Servlet endpoint used to trigger data population.", "path": "unknown (configured in web.xml)", "method": "POST", "direction": "CONSUMER", "requestBody": "Form parameters: success_page, error_page, forcefully", "responseBody": "Redirect or Error Page" }, { "namespace": "com.sun.j2ee.blueprints.supplier.transitions", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/transitions/SupplierOrderTD.java", "mechanism": "JMS-TOPIC", "name": "INVOICE_MDB_TOPIC", "description": "Publishes invoice XML messages to a JMS Topic for downstream processing.", "queueOrTopicName": "INVOICE_MDB_TOPIC", "messageType": "XML String", "direction": "PRODUCER", "connectionInfo": "JNDI lookup via ServiceLocator" }, { "namespace": "com.sun.j2ee.blueprints.supplier.transitions", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/transitions/JNDINames.java", "mechanism": "JMS-TOPIC", "name": "TopicConnectionFactory", "description": "Defines the JNDI location for the JMS Topic Connection Factory used to create connections for topic-based messaging.", "direction": "BOTH", "connectionInfo": "java:comp/env/jms/TopicConnectionFactory" }, { "namespace": "com.sun.j2ee.blueprints.supplier.transitions", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/transitions/JNDINames.java", "mechanism": "JMS-TOPIC", "name": "InvoiceTopic", "description": "Defines the JNDI location for the Invoice Topic, likely used for publishing or subscribing to invoice-related events.", "direction": "BOTH", "connectionInfo": "java:comp/env/jms/opc/InvoiceTopic" }, { "namespace": "com.sun.j2ee.blueprints.supplier.transitions.TopicSender", "filepath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/transitions/TopicSender.java", "mechanism": "JMS-TOPIC", "name": "Invoice MDB Topic", "description": "Publishes XML text messages to a JMS Topic.", "queueOrTopicName": "Configured via constructor (referenced as Invoice MDB Topic in Javadoc)", "messageType": "TextMessage (XML)", "direction": "PRODUCER", "protocol": "JMS", "connectionInfo": "Managed via TopicConnectionFactory injected in constructor" }, { "namespace": "com.sun.j2ee.blueprints.uidgen.counter.ejb.CounterLocal", "filepath": "src/components/uidgen/src/com/sun/j2ee/blueprints/uidgen/counter/ejb/CounterLocal.java", "mechanism": "OTHER", "name": "CounterLocal", "description": "EJB Local Interface definition for the Counter service, allowing local component integration.", "direction": "BIDIRECTIONAL" }, { "namespace": "com.sun.j2ee.blueprints.uidgen.ejb.UniqueIdGeneratorEJB", "filepath": "src/components/uidgen/src/com/sun/j2ee/blueprints/uidgen/ejb/UniqueIdGeneratorEJB.java", "mechanism": "OTHER", "name": "java:comp/env/ejb/Counter", "description": "JNDI lookup for the Counter Entity Bean Home interface.", "path": "java:comp/env/ejb/Counter", "method": "lookup", "direction": "CONSUMER", "protocol": "JNDI" }, { "namespace": "com.sun.j2ee.blueprints.waf.controller.ejb", "filepath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/ejb/EJBControllerLocalEJB.java", "mechanism": "OTHER", "name": "EJBControllerLocalEJB", "description": "EJB Session Bean implementation acting as a controller for the WAF framework.", "direction": "BOTH" }, { "namespace": "com.sun.j2ee.blueprints.waf.controller.web", "filepath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/web/MainServlet.java", "mechanism": "REST", "name": "MainServlet", "description": "Acts as the Front Controller Servlet handling HTTP requests for the application.", "path": "Defined in web.xml (not visible)", "method": "GET, POST", "direction": "CONSUMER", "protocol": "HTTP" }, { "namespace": "com.sun.j2ee.blueprints.waf.controller.web", "filepath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/web/DefaultWebController.java", "mechanism": "OTHER", "name": "EJBControllerLocal", "description": "Interaction with the EJB tier via a local interface to process business events.", "direction": "BIDIRECTIONAL" }, { "namespace": "com.sun.j2ee.blueprints.waf.controller.web", "filepath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/web/ComponentManager.java", "mechanism": "OTHER", "name": "HttpSessionListener", "description": "Integrates with the Servlet Container lifecycle by extending the standard HttpSessionListener interface.", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.waf.controller.web.action.HTMLAction", "filepath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/web/action/HTMLAction.java", "mechanism": "REST", "name": "Servlet API Interaction", "description": "This interface is designed to work within a Servlet container, processing HttpServletRequests. While it does not define a specific endpoint path itself, it is the contract for classes that handle HTTP requests in the web tier.", "path": "Dynamic (determined by implementing classes and controller mapping)", "method": "HTTP (GET/POST/etc.)", "direction": "CONSUMER" }, { "namespace": "com.sun.j2ee.blueprints.waf.controller.web.flow.ScreenFlowManager", "filepath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/web/flow/ScreenFlowManager.java", "mechanism": "OTHER", "name": "Servlet Request Dispatching", "description": "Forwards HTTP requests to internal resources (JSPs or Servlets) based on flow logic.", "direction": "OTHER" }, { "namespace": "com.sun.j2ee.blueprints.waf.view.template.TemplateServlet", "filepath": "src/waf/src/view/template/com/sun/j2ee/blueprints/waf/view/template/TemplateServlet.java", "mechanism": "REST", "name": "TemplateServlet", "description": "Handles HTTP requests for UI screens, acting as a front controller.", "path": "/* (Dynamic based on configuration)", "method": "GET, POST", "direction": "CONSUMER", "protocol": "HTTP/1.1" }, { "namespace": "com.sun.j2ee.blueprints.xmldocuments.XMLDocumentEditorFactory", "filepath": "src/components/xmldocuments/src/com/sun/j2ee/blueprints/xmldocuments/XMLDocumentEditorFactory.java", "mechanism": "OTHER", "name": "Catalog Loader", "description": "Loads configuration properties from a URL resource.", "path": "n/a", "method": "GET", "direction": "CONSUMER", "protocol": "URL/Stream", "connectionInfo": "URL provided via constructor" } ], "billOfMaterials": [ { "name": "asyncsender-ejb-client.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "asyncsender-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "asyncsender-ejb.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "base64.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/waf/src/build.xml" ] }, { "name": "cart-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "catalog-ejb-client.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/cart/src/build.xml" ] }, { "name": "catalog-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "contactinfo", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/customer/src/build.xml" ] }, { "name": "creditcard", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/customer/src/build.xml" ] }, { "name": "crimson.jar", "groupId": "org.apache.crimson", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "customer-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "j2ee.jar", "groupId": "javax.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/address/src/build.xml", "src/components/signon/src/build.xml", "src/components/processmanager/src/build.xml", "src/components/asyncsender/src/build.xml", "src/components/catalog/src/build.xml", "src/components/cart/src/build.xml", "src/components/creditcard/src/build.xml", "src/components/customer/src/build.xml", "src/components/contactinfo/src/build.xml", "src/components/purchaseorder/src/build.xml", "src/apps/admin/src/build.xml" ] }, { "name": "j2ee.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/util/tracer/src/build.xml", "src/components/encodingfilter/src/build.xml", "src/components/servicelocator/src/build.xml", "src/components/xmldocuments/src/build.xml", "src/components/lineitem/src/build.xml", "src/build.xml", "src/components/supplierpo/src/build.xml", "src/waf/src/build.xml", "src/apps/supplier/src/build.xml" ] }, { "name": "j2ee.jar", "groupId": "Sun Microsystems", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/uidgen/src/build.xml" ] }, { "name": "j2ee.jar", "groupId": "sun.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/mailer/src/build.xml", "src/apps/petstore/src/build.xml" ] }, { "name": "j2ee.jar", "groupId": "com.sun.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/opc/src/build.xml" ] }, { "name": "j2eetools.jar", "groupId": "com.sun.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/opc/src/build.xml" ] }, { "name": "j2eetools.jar", "groupId": "javax.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "j2eetools.jar", "groupId": "sun.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "j2eetools.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/supplier/src/build.xml" ] }, { "name": "jaxp.jar", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "jstl.jar", "groupId": "javax.servlet.jsp.jstl", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "locale", "versions": [], "hasConflict": false, "scopes": [ "compile", "runtime" ], "locations": [ "src/components/address/src/build.xml", "src/components/encodingfilter/src/build.xml", "src/components/servicelocator/src/build.xml", "src/components/lineitem/src/build.xml", "src/components/customer/src/build.xml", "src/waf/src/build.xml" ] }, { "name": "locale", "groupId": "sun.j2ee", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/components/mailer/src/build.xml" ] }, { "name": "locale", "groupId": "javax.j2ee", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/contactinfo/src/build.xml" ] }, { "name": "mailer-ejb-client.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/opc/src/build.xml" ] }, { "name": "opc-ejb-client.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "opc-ejb.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "po-ejb-client.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/opc/src/build.xml" ] }, { "name": "po-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "processmanager-ejb-client.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/opc/src/build.xml" ] }, { "name": "processmanager-ejb-client.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/supplier/src/build.xml" ] }, { "name": "servicelocator.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/asyncsender/src/build.xml", "src/apps/opc/src/build.xml" ] }, { "name": "servicelocator.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/catalog/src/build.xml", "src/apps/admin/src/build.xml" ] }, { "name": "servicelocator.jar", "groupId": "contactinfo.components", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/contactinfo/src/build.xml" ] }, { "name": "servicelocator.jar", "groupId": "project.servicelocator", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/purchaseorder/src/build.xml" ] }, { "name": "servicelocator.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/supplierpo/src/build.xml", "src/waf/src/build.xml", "src/apps/supplier/src/build.xml" ] }, { "name": "servicelocator.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "signon-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "standard.jar", "groupId": "javax.servlet.jsp.jstl", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "supplierpo-ejb-client.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/supplier/src/build.xml" ] }, { "name": "tracer.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/catalog/src/build.xml" ] }, { "name": "tracer.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/cart/src/build.xml" ] }, { "name": "tracer.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/waf/src/build.xml" ] }, { "name": "tracer.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "uidgen-ejb-client.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "waf-ejb.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "waf-web.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "runtime" ], "locations": [ "src/apps/petstore/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "com.sun.j2ee.blueprints", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/address/src/build.xml", "src/apps/opc/src/build.xml", "src/components/creditcard/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "lineitem", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/lineitem/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "xmldocuments", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/mailer/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "contactinfo.components", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/contactinfo/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "project.xmldocuments", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/purchaseorder/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "internal", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/admin/src/build.xml" ] }, { "name": "xmldocuments.jar", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/components/supplierpo/src/build.xml", "src/apps/supplier/src/build.xml" ] }, { "name": "xmldocuments.jar", "groupId": "petstore.component", "versions": [], "hasConflict": false, "scopes": [ "compile" ], "locations": [ "src/apps/petstore/src/build.xml" ] } ], "codeQualitySummary": { "topComplexFunctions": [ { "complexity": 22, "functionName": "com.sun.j2ee.blueprints.waf.view.template.TemplateServlet::process", "filePath": "src/waf/src/view/template/com/sun/j2ee/blueprints/waf/view/template/TemplateServlet.java", "linesOfCode": 82, "codeSmells": [ "LONG METHOD", "COMPLEX CONDITIONAL", "DEEP NESTING" ] }, { "complexity": 22, "functionName": "com.sun.j2ee.blueprints.admin.client.TableSorter::compareRowsByColumn", "filePath": "src/apps/admin/src/client/com/sun/j2ee/blueprints/admin/client/TableSorter.java", "linesOfCode": 68, "codeSmells": [ "COMPLEX CONDITIONAL", "LONG METHOD" ] }, { "complexity": 21, "functionName": "com.sun.j2ee.blueprints.waf.controller.web.URLMappingsXmlDAO::getRequestMappings", "filePath": "src/waf/src/controller/com/sun/j2ee/blueprints/waf/controller/web/URLMappingsXmlDAO.java", "linesOfCode": 75, "codeSmells": [ "LONG METHOD", "DEEP NESTING", "COMPLEX CONDITIONAL" ] }, { "complexity": 16, "functionName": "com.sun.j2ee.blueprints.waf.view.taglibs.smart::doEndTag", "filePath": "src/waf/src/view/taglibs/com/sun/j2ee/blueprints/taglibs/smart/ClientStateTag.java", "linesOfCode": 92, "codeSmells": [ "LONG METHOD", "DEEP NESTING", "COMPLEX CONDITIONAL" ] }, { "complexity": 14, "functionName": "com.sun.j2ee.blueprints.catalog.dao.CloudscapeCatalogDAO::searchItems", "filePath": "src/components/catalog/src/com/sun/j2ee/blueprints/catalog/dao/CloudscapeCatalogDAO.java", "linesOfCode": 65, "codeSmells": [ "LONG METHOD", "COMPLEX CONDITIONAL", "DUPLICATE CODE", "MAGIC NUMBERS" ] }, { "complexity": 13, "functionName": "com.sun.j2ee.blueprints.supplier.inventory.web::doPost", "filePath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/inventory/web/RcvrRequestProcessor.java", "linesOfCode": 36, "codeSmells": [ "COMPLEX CONDITIONAL", "MAGIC NUMBERS", "LONG METHOD" ] }, { "complexity": 13, "functionName": "com.sun.j2ee.blueprints.opc.admin.ejb::getChartInfo", "filePath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/admin/ejb/OPCAdminFacadeEJB.java", "linesOfCode": 56, "codeSmells": [ "LONG METHOD", "DEEP NESTING", "COMPLEX CONDITIONAL", "DUPLICATE CODE" ] }, { "complexity": 13, "functionName": "com.sun.j2ee.blueprints.petstore.tools.populate::startElement", "filePath": "src/apps/petstore/src/com/sun/j2ee/blueprints/petstore/tools/populate/XMLDBHandler.java", "linesOfCode": 36, "codeSmells": [ "COMPLEX CONDITIONAL", "LONG METHOD" ] }, { "complexity": 12, "functionName": "com.sun.j2ee.blueprints.supplier.tools.populate.XMLDBHandler::startElement", "filePath": "src/apps/supplier/src/com/sun/j2ee/blueprints/supplier/tools/populate/XMLDBHandler.java", "linesOfCode": 30, "codeSmells": [ "COMPLEX CONDITIONAL", "LONG METHOD" ] }, { "complexity": 10, "functionName": "com.sun.j2ee.blueprints.opc.customerrelations.ejb.LocaleUtil::getLocaleFromString", "filePath": "src/apps/opc/src/com/sun/j2ee/blueprints/opc/customerrelations/ejb/LocaleUtil.java", "linesOfCode": 22, "codeSmells": [ "COMPLEX CONDITIONAL", "DEAD CODE", "MAGIC NUMBERS" ] } ], "commonCodeSmells": [ { "occurrences": 39, "smellType": "OTHER", "affectedFiles": 31 }, { "occurrences": 37, "smellType": "DATA CLASS", "affectedFiles": 37 }, { "occurrences": 18, "smellType": "MAGIC NUMBERS", "affectedFiles": 18 }, { "occurrences": 14, "smellType": "COMPLEX CONDITIONAL", "affectedFiles": 14 }, { "occurrences": 13, "smellType": "LONG PARAMETER LIST", "affectedFiles": 13 }, { "occurrences": 13, "smellType": "LONG METHOD", "affectedFiles": 13 }, { "occurrences": 12, "smellType": "DUPLICATE CODE", "affectedFiles": 12 }, { "occurrences": 12, "smellType": "TOO MANY METHODS", "affectedFiles": 12 }, { "occurrences": 6, "smellType": "DEEP NESTING", "affectedFiles": 6 }, { "occurrences": 4, "smellType": "DEAD CODE", "affectedFiles": 4 }, { "occurrences": 2, "smellType": "FEATURE ENVY", "affectedFiles": 2 }, { "occurrences": 2, "smellType": "INVALID", "affectedFiles": 2 }, { "occurrences": 1, "smellType": "LARGE FILE", "affectedFiles": 1 } ], "overallStatistics": { "totalFunctions": 1500, "highComplexityCount": 9, "veryHighComplexityCount": 3, "longFunctionCount": 7, "averageComplexity": 1.63, "averageFunctionLength": 4.9 } }, "scheduledJobsSummary": { "jobs": [ { "jobName": "Ant Build Execution", "sourceFile": "src/apps/admin/src/build.bat", "trigger": "manual", "purpose": "Executes the Apache Ant build system with a pre-configured classpath and system properties tailored for the 'estore' J2EE application. It acts as the primary entry point for compiling, packaging, and managing the application lifecycle.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "Ant libraries (ant.jar, xml.jar)", "Java tools (tools.jar)", "J2EE libraries (j2ee.jar)", "build.xml (implicit Ant configuration)" ], "outputResources": [ "Compiled Java classes", "Javadocs", "Build artifacts (likely WAR or EAR files)" ], "dependencies": [ "Java SDK", "J2EE SDK", "Apache Ant" ] }, { "jobName": "Ant Build Execution", "sourceFile": "src/build.bat", "trigger": "manual", "purpose": "Configures the Java classpath with J2EE and Ant dependencies and launches the Apache Ant build tool to process build targets.", "inputResources": [ "Environment Variable: JAVA_HOME", "Environment Variable: J2EE_HOME", "File: ./lib/ant/lib/ant.jar", "File: ./lib/ant/lib/jaxp.jar", "File: ./lib/ant/lib/parser.jar", "File: %J2EE_HOME%/lib/j2ee.jar" ], "outputResources": [ "Process: org.apache.tools.ant.Main" ], "dependencies": [ "Java SDK", "J2EE SDK", "Apache Ant Libraries" ] }, { "jobName": "Ant Build Wrapper", "sourceFile": "src/waf/src/build.bat", "trigger": "Manual", "purpose": "Sets up the Java classpath including J2EE and Ant libraries and executes the Apache Ant Main class to perform build tasks.", "inputResources": [ "../../lib/ant", "%JAVA_HOME%/lib/tools.jar", "%J2EE_HOME%/lib/j2ee.jar" ], "outputResources": [ "Build Artifacts (determined by build.xml)" ], "dependencies": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "Apache Ant libraries" ] }, { "jobName": "Ant Setup Build", "sourceFile": "setup.bat", "trigger": "manual", "purpose": "Initiates the Apache Ant build process using the configuration defined in setup.xml, typically used to compile, package, or configure the J2EE application.", "inputResources": [ "setup.xml", "src/lib/ant/lib/ant.jar", "src/lib/ant/lib/parser.jar", "src/lib/ant/lib/jaxp.jar", "%JAVA_HOME%/lib/tools.jar", "%J2EE_HOME%/lib/j2ee.jar" ], "outputResources": [ "Build artifacts (determined by setup.xml targets)" ], "dependencies": [ "Java Development Kit (JAVA_HOME)", "J2EE SDK (J2EE_HOME)", "Apache Ant libraries" ] }, { "jobName": "build.sh", "sourceFile": "src/apps/petstore/src/build.sh", "trigger": "manual", "purpose": "Initiates the Apache Ant build process for the application, handling environment setup and classpath configuration automatically.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "Ant libraries (ant.jar, parser.jar, jaxp.jar)", "J2EE libraries (j2ee.jar)", "Project source code (implied by Ant execution)" ], "outputResources": [ "Compiled Java classes", "Build artifacts (likely JAR, WAR, or EAR files)" ], "dependencies": [ "Java Development Kit (JDK)", "J2EE SDK", "Apache Ant" ] }, { "jobName": "build.sh", "sourceFile": "src/apps/admin/src/build.sh", "trigger": "manual", "purpose": "Wraps the Apache Ant execution to compile, build, and potentially package the J2EE application (referenced as 'estore').", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "../../../lib/ant (Ant libraries)", "Source code (implied by Ant execution)" ], "outputResources": [ "Compiled Java classes", "J2EE Archives (WAR/EAR files)", "Javadoc documentation" ], "dependencies": [ "Java SDK", "J2EE SDK", "Apache Ant" ] }, { "jobName": "build.sh", "sourceFile": "src/build.sh", "trigger": "manual", "purpose": "Initializes the environment and executes the Apache Ant build tool to compile and package the J2EE application.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "lib/ant/lib/ant.jar", "lib/ant/lib/jaxp.jar", "lib/ant/lib/parser.jar", "$J2EE_HOME/lib/j2ee.jar", "$JAVA_HOME/lib/tools.jar" ], "outputResources": [ "Ant Build Artifacts (determined by build.xml targets)" ], "dependencies": [ "Java SDK", "J2EE SDK", "Apache Ant (embedded in lib/ant)" ] }, { "jobName": "build.sh", "sourceFile": "src/waf/src/build.sh", "trigger": "manual", "purpose": "Initializes the environment and executes the Apache Ant build process for a J2EE application.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "../../lib/ant (Ant libraries)", "build.xml (implied Ant default)" ], "outputResources": [ "Compiled Java classes", "J2EE archives (WAR/EAR/JAR)" ], "dependencies": [ "Java SDK", "J2EE SDK", "Apache Ant" ] }, { "jobName": "build.sh", "sourceFile": "src/apps/opc/src/build.sh", "trigger": "manual", "purpose": "Initializes the environment and executes the Apache Ant build system to compile and package the application.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "../../../lib/ant/lib/ant.jar", "../../../lib/ant/lib/xml.jar", "$J2EE_HOME/lib/j2ee.jar" ], "outputResources": [ "Ant Build Process" ], "dependencies": [ "java", "ant", "j2ee-sdk" ] }, { "jobName": "build.sh", "sourceFile": "src/apps/supplier/src/build.sh", "trigger": "manual", "purpose": "Initializes the environment and executes the Apache Ant build process for the application.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "../../../lib/ant/lib/ant.jar", "$JAVA_HOME/lib/tools.jar", "$J2EE_HOME/lib/j2ee.jar" ], "outputResources": [ "Ant build artifacts (compiled classes, JARs, WARs)", "Console build logs" ], "dependencies": [ "Java Development Kit (JDK)", "J2EE SDK", "Apache Ant" ] }, { "jobName": "J2EE Ant Build Launcher", "sourceFile": "src/apps/petstore/src/build.bat", "trigger": "manual", "purpose": "Configures the Java classpath and system properties to launch the Apache Ant build tool for a J2EE project.", "inputResources": [ "Environment Variable: JAVA_HOME", "Environment Variable: J2EE_HOME", "File: ../../../lib/ant/lib/ant.jar", "File: ../../../lib/ant/lib/xml.jar", "File: %JAVA_HOME%/lib/tools.jar", "File: %J2EE_HOME%/lib/j2ee.jar" ], "outputResources": [ "Ant Build Artifacts (dependent on build.xml targets)" ], "dependencies": [ "Java Runtime Environment", "Apache Ant", "J2EE SDK" ] }, { "jobName": "J2EE Ant Build Launcher", "sourceFile": "src/apps/supplier/src/build.bat", "trigger": "manual", "purpose": "Configures the Java classpath with J2EE and Ant libraries, then executes the Apache Ant Main class to perform build operations defined in an associated build.xml file.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "../../../lib/ant/lib/ant.jar", "lib/j2ee.jar", "Command line arguments (%1 %2 %3 %4)" ], "outputResources": [ "Java Process (Ant Build)", "Console Output" ], "dependencies": [ "Java SDK (tools.jar)", "Apache Ant", "J2EE SDK" ] }, { "jobName": "J2EE Ant Build Wrapper", "sourceFile": "src/apps/opc/src/build.bat", "trigger": "manual", "purpose": "Invokes the Apache Ant build system with a pre-configured classpath that includes J2EE and Java tool dependencies to compile and package the application.", "inputResources": [ "JAVA_HOME environment variable", "J2EE_HOME environment variable", "../../../lib/ant (Ant libraries)", "build.xml (implicit Ant input)" ], "outputResources": [ "Console output (Build logs)", "Compiled Java classes", "J2EE Artifacts (WAR/EAR/JAR files)" ], "dependencies": [ "Java Development Kit (JDK)", "J2EE SDK", "Apache Ant" ] }, { "jobName": "setup.sh", "sourceFile": "setup.sh", "trigger": "manual", "purpose": "Initiates the application setup or build process by configuring the environment and invoking the Apache Ant build tool with the 'setup.xml' file.", "inputResources": [ "setup.xml", "JAVA_HOME environment variable", "J2EE_HOME environment variable", "./src/lib/ant or ./lib/ant directory", "tools.jar", "j2ee.jar" ], "outputResources": [ "Console output (classpath echo)", "Ant build artifacts (defined in setup.xml)" ], "dependencies": [ "Java Runtime Environment", "J2EE SDK", "Apache Ant libraries" ] } ], "totalJobs": 14, "triggerTypes": [ "manual" ], "jobFiles": [ "src/apps/admin/src/build.bat", "setup.bat", "src/apps/opc/src/build.bat", "src/build.bat", "src/apps/petstore/src/build.bat", "src/apps/supplier/src/build.bat", "src/waf/src/build.bat", "setup.sh", "src/apps/petstore/src/build.sh", "src/apps/admin/src/build.sh", "src/build.sh", "src/waf/src/build.sh", "src/apps/opc/src/build.sh", "src/apps/supplier/src/build.sh" ] }, "moduleCoupling": { "couplings": [ { "fromModule": "src/apps", "toModule": "com.sun", "referenceCount": 583, "couplingLevel": "Very High", "couplingLevelClass": "badge-danger" }, { "fromModule": "src/components", "toModule": "com.sun", "referenceCount": 226, "couplingLevel": "Medium", "couplingLevelClass": "badge-warning" }, { "fromModule": "src/waf", "toModule": "com.sun", "referenceCount": 124, "couplingLevel": "Medium", "couplingLevelClass": "badge-warning" }, { "fromModule": "src/apps", "toModule": "customer.account", "referenceCount": 16, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "WEB-INF/c.tld", "referenceCount": 12, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "WEB-INF/waftags.tld", "referenceCount": 12, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/waf", "toModule": "WEB-INF/waftags.tld", "referenceCount": 7, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "customer.profile", "referenceCount": 4, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "cart.do", "referenceCount": 3, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "customer.do", "referenceCount": 3, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "order.do", "referenceCount": 3, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "WEB-INF/fmt.tld", "referenceCount": 3, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "WEB-INF/template.tld", "referenceCount": 3, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "enter_order_information.screen", "referenceCount": 2, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "item.screen", "referenceCount": 2, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "update_customer.screen", "referenceCount": 2, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "admin/AdminRequestProcessor", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "cart.count", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "cart.items", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "cart.subTotal", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "changelocale.do", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "index.html", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "item.attribute", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "item.itemId", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "item.name", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "item.quantity", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "item.unitCost", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "main.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "petstore/main.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "search.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "signoff.do", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "signon_welcome.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "signon.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/apps", "toModule": "supplier/populating.jsp", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/waf", "toModule": "clientstatetag_test.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/waf", "toModule": "formtag.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/waf", "toModule": "images/clientstate.jpg", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" }, { "fromModule": "src/waf", "toModule": "inputtag.screen", "referenceCount": 1, "couplingLevel": "Low", "couplingLevelClass": "badge-success" } ], "totalModules": 38, "totalCouplings": 38, "highestCouplingCount": 583, "moduleDepth": 2 } }