Road grading

Signed-off-by: Laird Nelson <[email protected]>

Author: ljnelson

README.md

@@ -0,0 +1,40 @@
+# microBean™ Producer
+
+[![Maven Central](https://img.shields.io/maven-central/v/org.microbean/microbean-producer.svg?label=Maven%20Central)](https://search.maven.org/artifact/org.microbean/microbean-producer)
+
+The microBean™ Producer project provides classes and interfaces assisting with implementing
+[`Factory`](https://microbean.github.io/microbean-bean/apidocs/org.microbean.bean/org/microbean/bean/Factory.html)
+instances.
+
+# Status
+
+This project is currently experimental, in a pre-alpha state, and unsuitable for production use.
+
+# Compatibility
+
+**Until further notice, this project's APIs are subject to frequent backwards-incompatible signature and behavior
+changes, regardless of project version and without notice.**
+
+# Requirements
+
+microBean™ Producer requires a Java runtime of version 21 or higher.
+
+# Installation
+
+microBean™ Producer is available on [Maven
+Central](https://central.sonatype.com/artifact/org.microbean/microbean-producer). Include microBean™ Producer as a Maven
+dependency:
+
+```xml
+<dependency>
+  <groupId>org.microbean</groupId>
+  <artifactId>microbean-producer</artifactId>
+  <!-- Always check https://central.sonatype.com/artifact/org.microbean/microbean-producer for up-to-date available versions. -->
+  <version>0.0.2</version>
+</dependency>
+```
+
+# Documentation
+
+Full documentation is available at
+[microbean.github.io/microbean-producer](https://microbean.github.io/microbean-producer/).

pom.xml

@@ -80,7 +80,7 @@
     <!-- maven-javadoc-plugin properties -->
     <bottom><![CDATA[Copyright &copy; ${project.inceptionYear}&ndash;{currentYear}, <a href="${project.organization.url}" target="_top">${project.organization.name}</a>. All rights reserved.]]></bottom>
     <doctitle>&lt;a href="${project.url}" target="_top"&gt;&lt;span style="font-family:Lobster, cursive;"&gt;µb&lt;/span&gt; ${project.artifactId}&lt;/a&gt; ${project.version}</doctitle>
-    <links>https://microbean.github.io/microbean-bean/apidocs/,https://microbean.github.io/microbean-interceptor/apidocs/</links>
+    <links>https://microbean.github.io/microbean-bean/apidocs/,https://microbean.github.io/microbean-construct/apidocs/,https://microbean.github.io/microbean-interceptor/apidocs/,https://microbean.github.io/microbean-proxy/apidocs/</links>
     <sourcetab>2</sourcetab>
 
     <!-- maven-release-plugin properties -->
@@ -125,17 +125,35 @@
       <dependency>
         <groupId>org.junit</groupId>
         <artifactId>junit-bom</artifactId>
-        <version>5.11.4</version>
+        <version>5.13.0</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
 
       <!-- Normal dependencies. -->
 
+      <dependency>
+        <groupId>org.microbean</groupId>
+        <artifactId>microbean-assign</artifactId>
+        <version>0.0.5</version>
+      </dependency>
+
+      <dependency>
+        <groupId>org.microbean</groupId>
+        <artifactId>microbean-attributes</artifactId>
+        <version>0.0.2</version>
+      </dependency>
+
       <dependency>
         <groupId>org.microbean</groupId>
         <artifactId>microbean-bean</artifactId>
-        <version>0.0.16</version>
+        <version>0.0.18</version>
+      </dependency>
+
+      <dependency>
+        <groupId>org.microbean</groupId>
+        <artifactId>microbean-construct</artifactId>
+        <version>0.0.10</version>
       </dependency>
 
       <dependency>
@@ -144,23 +162,53 @@
         <version>0.5.1</version>
       </dependency>
 
+      <dependency>
+        <groupId>org.microbean</groupId>
+        <artifactId>microbean-proxy</artifactId>
+        <version>0.0.2</version>
+      </dependency>
+
     </dependencies>
   </dependencyManagement>
 
   <dependencies>
 
+    <dependency>
+      <groupId>org.microbean</groupId>
+      <artifactId>microbean-assign</artifactId>
+      <scope>compile</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.microbean</groupId>
+      <artifactId>microbean-attributes</artifactId>
+      <scope>compile</scope>
+    </dependency>
+
     <dependency>
       <groupId>org.microbean</groupId>
       <artifactId>microbean-bean</artifactId>
       <scope>compile</scope>
     </dependency>
 
+    <dependency>
+      <groupId>org.microbean</groupId>
+      <artifactId>microbean-construct</artifactId>
+      <scope>compile</scope>
+    </dependency>
+
     <dependency>
       <groupId>org.microbean</groupId>
       <artifactId>microbean-interceptor</artifactId>
       <scope>compile</scope>
     </dependency>
 
+    <dependency>
+      <groupId>org.microbean</groupId>
+      <artifactId>microbean-proxy</artifactId>
+      <scope>compile</scope>
+    </dependency>
+
     <!-- Test-scoped dependencies. -->
 
     <dependency>
@@ -174,7 +222,7 @@
       <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
     </dependency>
-    
+
   </dependencies>
 
   <build>
@@ -302,7 +350,7 @@
         </plugin>
         <plugin>
           <artifactId>maven-clean-plugin</artifactId>
-          <version>3.4.1</version>
+          <version>3.5.0</version>
           <configuration>
             <filesets>
               <fileset>
@@ -417,14 +465,7 @@
         </plugin>
         <plugin>
           <artifactId>maven-surefire-plugin</artifactId>
-          <version>3.5.2</version>
-          <dependencies>
-            <dependency>
-              <groupId>org.apache.maven.surefire</groupId>
-              <artifactId>surefire-junit-platform</artifactId>
-              <version>3.5.2</version>
-            </dependency>
-          </dependencies>
+          <version>3.5.3</version>
         </plugin>
         <plugin>
           <artifactId>maven-toolchains-plugin</artifactId>
@@ -433,7 +474,7 @@
         <plugin>
           <groupId>com.github.spotbugs</groupId>
           <artifactId>spotbugs-maven-plugin</artifactId>
-          <version>4.9.2.0</version>
+          <version>4.9.3.0</version>
         </plugin>
         <plugin>
           <groupId>org.codehaus.mojo</groupId>
@@ -443,7 +484,7 @@
         <plugin>
           <groupId>io.smallrye</groupId>
           <artifactId>jandex-maven-plugin</artifactId>
-          <version>3.2.7</version>
+          <version>3.3.1</version>
         </plugin>
         <plugin>
           <groupId>org.sonatype.plugins</groupId>

src/main/java/module-info.java

@@ -22,6 +22,8 @@
   exports org.microbean.producer;
 
   requires transitive org.microbean.bean;
+  requires org.microbean.construct;
   requires transitive org.microbean.interceptor;
+  requires transitive org.microbean.proxy;
 
 }

src/main/java/org/microbean/producer/AbstractLifecycleCallbackInterceptorMethodType.java

@@ -0,0 +1,27 @@
+/* -*- mode: Java; c-basic-offset: 2; indent-tabs-mode: nil; coding: utf-8-unix -*-
+ *
+ * Copyright © 2025 microBean™.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+package org.microbean.producer;
+
+/**
+ * A lifecycle event-oriented {@link InterceptorMethodType}.
+ *
+ * @author <a href="https://about.me/lairdnelson" target="_top">Laird Nelson</a>
+ */
+public abstract non-sealed class AbstractLifecycleCallbackInterceptorMethodType extends InterceptorMethodType {
+
+  AbstractLifecycleCallbackInterceptorMethodType(final TargetKind kind, final String name) {
+    super(kind, name);
+  }
+  
+}

src/main/java/org/microbean/producer/AbstractMethodInterceptorMethodType.java

@@ -0,0 +1,34 @@
+/* -*- mode: Java; c-basic-offset: 2; indent-tabs-mode: nil; coding: utf-8-unix -*-
+ *
+ * Copyright © 2025 microBean™.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+package org.microbean.producer;
+
+/**
+ * A business method-oriented {@link InterceptorMethodType}.
+ *
+ * @author <a href="https://about.me/lairdnelson" target="_top">Laird Nelson</a>
+ */
+public abstract non-sealed class AbstractMethodInterceptorMethodType extends InterceptorMethodType {
+
+  /**
+   * Creates a new {@link AbstractMethodInterceptorMethodType}.
+   *
+   * @param name a globally unique name; must not be {@code null}
+   *
+   * @exception NullPointerException if {@code name} is {@code null}
+   */
+  protected AbstractMethodInterceptorMethodType(final String name) {
+    super(TargetKind.METHOD, name);
+  }
+  
+}

src/main/java/org/microbean/producer/AroundConstructInterceptorMethodType.java

@@ -0,0 +1,32 @@
+/* -*- mode: Java; c-basic-offset: 2; indent-tabs-mode: nil; coding: utf-8-unix -*-
+ *
+ * Copyright © 2025 microBean™.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+package org.microbean.producer;
+
+/**
+ * A constructor- or production-oriented {@link AbstractLifecycleCallbackInterceptorMethodType}.
+ *
+ * @author <a href="https://about.me/lairdnelson" target="_top">Laird Nelson</a>
+ */
+public final class AroundConstructInterceptorMethodType extends AbstractLifecycleCallbackInterceptorMethodType {
+
+  /**
+   * The sole instance of this class.
+   */
+  public static final AroundConstructInterceptorMethodType INSTANCE = new AroundConstructInterceptorMethodType();
+  
+  private AroundConstructInterceptorMethodType() {
+    super(TargetKind.CONSTRUCTOR, "AroundConstruct");
+  }
+  
+}

src/main/java/org/microbean/producer/AroundInvokeInterceptorMethodType.java

@@ -0,0 +1,32 @@
+/* -*- mode: Java; c-basic-offset: 2; indent-tabs-mode: nil; coding: utf-8-unix -*-
+ *
+ * Copyright © 2025 microBean™.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+package org.microbean.producer;
+
+/**
+ * A business method-oriented {@link AbstractMethodInterceptorMethodType}.
+ *
+ * @author <a href="https://about.me/lairdnelson" target="_top">Laird Nelson</a>
+ */
+public final class AroundInvokeInterceptorMethodType extends AbstractMethodInterceptorMethodType {
+
+  /**
+   * The sole instance of this class.
+   */
+  public static final AroundInvokeInterceptorMethodType INSTANCE = new AroundInvokeInterceptorMethodType();
+  
+  private AroundInvokeInterceptorMethodType() {
+    super("AroundInvoke");
+  }
+  
+}