cleanup

Author: graemerocher

mcp-json-jackson/src/main/java/io/modelcontextprotocol/json/jackson/JacksonMcpJsonMapper.java

@@ -15,13 +15,25 @@ public final class JacksonMcpJsonMapper implements McpJsonMapper {
 
 	private final ObjectMapper objectMapper;
 
+    /**
+     * Constructs a new JacksonMcpJsonMapper instance with the given ObjectMapper.
+     *
+     * @param objectMapper the ObjectMapper to be used for JSON serialization and deserialization.
+     *                     Must not be null.
+     * @throws IllegalArgumentException if the provided ObjectMapper is null.
+     */
 	public JacksonMcpJsonMapper(ObjectMapper objectMapper) {
 		if (objectMapper == null) {
 			throw new IllegalArgumentException("ObjectMapper must not be null");
 		}
 		this.objectMapper = objectMapper;
 	}
 
+    /**
+     * Returns the underlying Jackson {@link ObjectMapper} used for JSON serialization and deserialization.
+     *
+     * @return the ObjectMapper instance
+     */
 	public ObjectMapper getObjectMapper() {
 		return objectMapper;
 	}

mcp-json-jackson/src/main/java/io/modelcontextprotocol/json/jackson/JacksonMcpJsonMapperSupplier.java

@@ -3,8 +3,20 @@
 import io.modelcontextprotocol.json.McpJsonMapper;
 import io.modelcontextprotocol.json.McpJsonMapperSupplier;
 
+/**
+ * A supplier of {@link McpJsonMapper} instances that uses the Jackson library for JSON serialization and deserialization.
+ * <p>
+ * This implementation provides a {@link McpJsonMapper} backed by a Jackson {@link com.fasterxml.jackson.databind.ObjectMapper}.
+ */
 public class JacksonMcpJsonMapperSupplier implements McpJsonMapperSupplier {
 
+    /**
+     * Returns a new instance of {@link McpJsonMapper} that uses the Jackson library for JSON serialization and deserialization.
+     * <p>
+     * The returned {@link McpJsonMapper} is backed by a new instance of {@link com.fasterxml.jackson.databind.ObjectMapper}.
+     *
+     * @return a new {@link McpJsonMapper} instance
+     */
 	@Override
 	public McpJsonMapper get() {
 		return new JacksonMcpJsonMapper(new com.fasterxml.jackson.databind.ObjectMapper());

mcp-json-jackson/src/main/java/io/modelcontextprotocol/json/schema/jackson/JacksonJsonSchemaValidatorSupplier.java

@@ -3,8 +3,21 @@
 import io.modelcontextprotocol.json.schema.JsonSchemaValidator;
 import io.modelcontextprotocol.json.schema.JsonSchemaValidatorSupplier;
 
+/**
+ * A concrete implementation of {@link JsonSchemaValidatorSupplier} that provides a
+ * {@link JsonSchemaValidator} instance based on the Jackson library.
+ *
+ * @see JsonSchemaValidatorSupplier
+ * @see JsonSchemaValidator
+ */
 public class JacksonJsonSchemaValidatorSupplier implements JsonSchemaValidatorSupplier {
 
+    /**
+     * Returns a new instance of {@link JsonSchemaValidator} that uses the Jackson library
+     * for JSON schema validation.
+     *
+     * @return A {@link JsonSchemaValidator} instance.
+     */
 	@Override
 	public JsonSchemaValidator get() {
 		return new DefaultJsonSchemaValidator();

mcp-json/pom.xml

@@ -10,8 +10,8 @@
 	</parent>
 	<artifactId>mcp-json</artifactId>
 	<packaging>jar</packaging>
-	<name>Java MCP SDK JSON Schema</name>
-	<description>Java MCP SDK JSON Schema API</description>
+	<name>Java MCP SDK JSON Support</name>
+	<description>Java MCP SDK JSON Support API</description>
 	<url>https://github.com/modelcontextprotocol/java-sdk</url>
 	<scm>
 		<url>https://github.com/modelcontextprotocol/java-sdk</url>

mcp-json/src/main/java/io/modelcontextprotocol/json/TypeRef.java

@@ -11,6 +11,16 @@ public abstract class TypeRef<T> {
 
 	private final Type type;
 
+    /**
+     * Constructs a new TypeRef instance, capturing the generic type information
+     * of the subclass. This constructor should be called from an anonymous subclass
+     * to capture the actual type arguments. For example:
+     * <pre>
+     * TypeRef&lt;List&lt;Foo&gt;&gt; ref = new TypeRef&lt;&gt;(){};
+     * </pre>
+     *
+     * @throws IllegalStateException if TypeRef is not subclassed with actual type information
+     */
 	protected TypeRef() {
 		Type superClass = getClass().getGenericSuperclass();
 		if (superClass instanceof Class) {
@@ -19,6 +29,11 @@ protected TypeRef() {
 		this.type = ((ParameterizedType) superClass).getActualTypeArguments()[0];
 	}
 
+    /**
+     * Returns the captured type information.
+     *
+     * @return the Type representing the actual type argument captured by this TypeRef instance
+     */
 	public Type getType() {
 		return type;
 	}