Update javadoc links

Author: damianmalczewski

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/AttributeSupport.java

@@ -30,6 +30,8 @@ public final class AttributeSupport {
    *
    * <p>This key is <b>not used in {@code ProblemContext}</b>; it is used exclusively as a request
    * attribute (WebFlux or WebMVC) and is assigned by framework-specific filters.
+   *
+   * @see io.github.problem4j.core.ProblemContext
    */
   public static final String TRACE_ID_ATTRIBUTE = "io.github.problem4j.spring.web.traceId";
 

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/DefaultProblemFormat.java

@@ -42,7 +42,7 @@ public class DefaultProblemFormat implements ProblemFormat {
   private final String detailFormat;
 
   /**
-   * Constructs a new {@code DefaultProblemFormat}.
+   * Constructs a new {@link DefaultProblemFormat}.
    *
    * @param detailFormat the detail format string to use
    */

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/DefaultProblemPostProcessor.java

@@ -68,7 +68,7 @@ public class DefaultProblemPostProcessor implements ProblemPostProcessor {
   private final PostProcessorSettings settings;
 
   /**
-   * Constructs a new {@code DefaultProblemPostProcessor}.
+   * Constructs a new {@link DefaultProblemPostProcessor}.
    *
    * @param settings the post-processor settings to use
    */
@@ -79,7 +79,7 @@ public DefaultProblemPostProcessor(PostProcessorSettings settings) {
   /**
    * Applies configured overrides to {@code type} and/or {@code instance}.
    *
-   * <p>About {@code about:blank}: when the original type is {@code null} or {@code
+   * <p>About {@code about:blank}: when the original type is {@code null} or {@link
    * Problem#BLANK_TYPE}, the placeholder {@code {problem.type}} resolves to an empty string
    * (templates naturally collapse). If the template is exactly {@code {problem.type}}, the original
    * {@code about:blank} value is preserved instead of becoming empty.
@@ -143,13 +143,14 @@ protected boolean canOverride(boolean requiresProblemType, boolean hasProblemTyp
 
   /**
    * Because this implementation does not try to resolve dynamic fields, it does not reuse the code
-   * from {@code DefaultProblemMappingProcessor}. Instead, we rely on simple substring replacement
-   * in form of {@link String#replace(CharSequence, CharSequence)}, and then removing all remaining
-   * unknown variables.
+   * from {@code ProblemPostProcessor}. Instead, we rely on simple substring replacement in form of
+   * {@link String#replace(CharSequence, CharSequence)}, and then removing all remaining unknown
+   * variables.
    *
    * @param context the problem context
    * @param problem the original problem
    * @return an optional containing the new type if override is possible
+   * @see io.github.problem4j.spring.web.ProblemPostProcessor
    */
   protected Optional<String> overrideType(ProblemContext context, Problem problem) {
     if (!problem.isTypeNonBlank() || !StringUtils.hasLength(settings.getTypeOverride())) {
@@ -219,16 +220,17 @@ protected boolean canOverride(
 
   /**
    * Because this implementation does not try to resolve dynamic fields, it does not reuse the code
-   * from {@code DefaultProblemMappingProcessor}. Instead, we rely on simple substring replacement
-   * in form of {@link String#replace(CharSequence, CharSequence)}, and then removing all remaining
-   * unknown variables.
+   * from {@code ProblemPostProcessor}. Instead, we rely on simple substring replacement in form of
+   * {@link String#replace(CharSequence, CharSequence)}, and then removing all remaining unknown
+   * variables.
    *
    * <p>If the algorithm discovers remaining placeholders that are unresolved, overriding is aborted
    * and original value is restored.
    *
    * @param context the problem context
    * @param problem the original problem
    * @return the new instance string
+   * @see io.github.problem4j.spring.web.ProblemPostProcessor
    */
   protected String overrideInstance(ProblemContext context, Problem problem) {
     if (!StringUtils.hasLength(settings.getInstanceOverride())) {
@@ -266,6 +268,7 @@ protected String stringOrEmpty(Object value) {
    *
    * @param value the string to check
    * @return true if unresolved placeholders remain
+   * @see io.github.problem4j.core.ProblemMapper
    */
   protected boolean hasRemainingUnknownPlaceholders(String value) {
     return PLACEHOLDER.matcher(value).find();

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/ProblemFormat.java

@@ -26,6 +26,8 @@
  *
  * <p>Implementations can customize how details and property names are presented - for example, by
  * applying localization, case formatting, or message templating.
+ *
+ * @see io.github.problem4j.core.Problem
  */
 public interface ProblemFormat {
 
@@ -34,6 +36,7 @@ public interface ProblemFormat {
    *
    * @param detail the detail string to format
    * @return the formatted detail string
+   * @see io.github.problem4j.core.Problem
    */
   String formatDetail(String detail);
 }

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/ProblemPostProcessor.java

@@ -27,7 +27,7 @@
  * Defines a contract for post-processing {@link Problem} instances before they are returned in an
  * HTTP response.
  *
- * <p>Implementations of this interface can modify, enrich, or normalize {@code Problem} objects
+ * <p>Implementations of this interface can modify, enrich, or normalize {@link Problem} objects
  * generated by the framework or application code. Typical use cases include:
  *
  * <ul>

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/ProblemResolverStore.java

@@ -26,7 +26,7 @@
 /**
  * Registry that provides access to {@link ProblemResolver} instances based on exception types.
  *
- * <p>Implementations are responsible for locating the most specific resolver for a given {@code
+ * <p>Implementations are responsible for locating the most specific resolver for a given {@link
  * Exception} class, typically by checking class assignability and caching results to improve
  * performance.
  */

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/ProblemSupport.java

@@ -146,7 +146,7 @@ public final class ProblemSupport {
   /**
    * Resolves a {@link Problem} to a corresponding {@link HttpStatus}.
    *
-   * <p>If the problem's status value is not a valid HTTP status code, {@code
+   * <p>If the problem's status value is not a valid HTTP status code, {@link
    * HttpStatus#INTERNAL_SERVER_ERROR} is returned as a fallback.
    *
    * @param problem the {@link Problem} instance containing the status code
@@ -165,8 +165,8 @@ public static HttpStatus resolveStatus(Problem problem) {
   /**
    * Resolves an {@link HttpStatusCode} to a corresponding {@link ProblemStatus}.
    *
-   * <p>If the status code is {@code null} or not recognized, {@code INTERNAL_SERVER_ERROR} is
-   * returned as a fallback.
+   * <p>If the status code is {@code null} or not recognized, {@link
+   * ProblemStatus#INTERNAL_SERVER_ERROR} is returned as a fallback.
    *
    * @param status the {@link HttpStatusCode} to resolve
    * @return the corresponding {@link ProblemStatus}, or {@link ProblemStatus#INTERNAL_SERVER_ERROR}

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/autoconfigure/ProblemAutoConfiguration.java

@@ -54,6 +54,8 @@
  *   <li>{@link ConditionalOnMissingBean} ensures user-defined beans override defaults.
  *   <li>{@link ConditionalOnClass} ensures compatibility with optional framework classes.
  * </ul>
+ *
+ * @see io.github.problem4j.core.Problem
  */
 @AutoConfiguration
 @EnableConfigurationProperties({ProblemProperties.class})

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/autoconfigure/ProblemParameterConfiguration.java

@@ -78,7 +78,7 @@ MethodValidationResultSupport problemMethodValidationResultSupport(
   static class ProblemBeanParamAwareBindingConfiguration {
 
     /**
-     * Provides a {@link BindingResultSupport} bean that handles {@code BindParam}-annotations.
+     * Provides a {@link BindingResultSupport} bean that handles {@link BindParam}-annotations.
      *
      * @return a new {@link BindParamAwareResultSupport}
      */

problem4j-spring-web/src/main/java/io/github/problem4j/spring/web/autoconfigure/ProblemProperties.java

@@ -42,18 +42,19 @@ public class ProblemProperties implements ProblemContextSettings, PostProcessorS
   private final ResolverCaching resolverCaching;
 
   /**
-   * Constructs a new {@code ProblemProperties}.
+   * Constructs a new {@link ProblemProperties}.
    *
    * @param enabled whether problem handling is enabled
-   * @param detailFormat format for the "detail" field (one of {@link DetailFormat#LOWERCASE},
+   * @param detailFormat format for the {@code detail} field (one of {@link DetailFormat#LOWERCASE},
    *     {@link DetailFormat#CAPITALIZED}, {@link DetailFormat#UPPERCASE})
    * @param tracingHeaderName name of the HTTP header carrying a trace ID (nullable)
-   * @param typeOverride template for overriding the "type" field; may contain "{context.traceId}"
-   *     placeholder (nullable)
-   * @param instanceOverride template for overriding the "instance" field; may contain
-   *     "{context.traceId}" placeholder (nullable)
+   * @param typeOverride template for overriding the {@code type} field; may contain {@code
+   *     {context.traceId}} placeholder (nullable)
+   * @param instanceOverride template for overriding the {@code instance} field; may contain {@code
+   *     {context.traceId}} placeholder (nullable)
    * @param resolverCaching caching for resolver lookups ({@code CachingProblemResolverStore});
    *     defaults to {@link ResolverCaching#createDefault()}
+   * @see io.github.problem4j.spring.web.CachingProblemResolverStore
    */
   public ProblemProperties(
       @DefaultValue("true") boolean enabled,
@@ -99,6 +100,7 @@ public String getDetailFormat() {
    * <p>If no header name is configured, this method may return {@code null}.
    *
    * @return the tracing header name, or {@code null} if not set
+   * @see io.github.problem4j.core.Problem
    */
   @Override
   public String getTracingHeaderName() {
@@ -123,6 +125,7 @@ public String getTracingHeaderName() {
    * original problem type will be preserved.
    *
    * @return the configured type override string, or {@code null} if not set
+   * @see io.github.problem4j.core.ProblemContext
    */
   @Override
   public String getTypeOverride() {
@@ -146,6 +149,8 @@ public String getTypeOverride() {
    * configuration, along with {@link #tracingHeaderName}, enables this feature.
    *
    * @return the configured instance override string, or {@code null} if not set
+   * @see io.github.problem4j.core.ProblemContext
+   * @see io.github.problem4j.core.ProblemException
    */
   @Override
   public String getInstanceOverride() {
@@ -165,6 +170,8 @@ public ResolverCaching getResolverCaching() {
    * Caching configuration for ({@code CachingProblemResolverStore}).
    *
    * <p>Controls whether resolver lookup caching is enabled and its maximum size.
+   *
+   * @see io.github.problem4j.spring.web.CachingProblemResolverStore
    */
   public static class ResolverCaching {