{"id":"0de2d454adb56e03","repo":"spring-projects/spring-framework","slug":"targetmapclass-must-implement-java-util-map","errorCode":null,"errorMessage":"'targetMapClass' must implement [java.util.Map]","messagePattern":"'targetMapClass' must implement \\[java\\.util\\.Map\\]","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"spring-beans/src/main/java/org/springframework/beans/factory/config/MapFactoryBean.java","lineNumber":64,"sourceCode":"\t * Set the source Map, typically populated via XML \"map\" elements.\n\t */\n\tpublic void setSourceMap(Map<?, ?> sourceMap) {\n\t\tthis.sourceMap = sourceMap;\n\t}\n\n\t/**\n\t * Set the class to use for the target Map. Can be populated with a fully\n\t * qualified class name when defined in a Spring application context.\n\t * <p>Default is a linked HashMap, keeping the registration order.\n\t * @see java.util.LinkedHashMap\n\t */\n\t@SuppressWarnings(\"rawtypes\")\n\tpublic void setTargetMapClass(@Nullable Class<? extends Map> targetMapClass) {\n\t\tif (targetMapClass == null) {\n\t\t\tthrow new IllegalArgumentException(\"'targetMapClass' must not be null\");\n\t\t}\n\t\tif (!Map.class.isAssignableFrom(targetMapClass)) {\n\t\t\tthrow new IllegalArgumentException(\"'targetMapClass' must implement [java.util.Map]\");\n\t\t}\n\t\tthis.targetMapClass = targetMapClass;\n\t}\n\n\n\t@Override\n\t@SuppressWarnings(\"rawtypes\")\n\tpublic Class<Map> getObjectType() {\n\t\treturn Map.class;\n\t}\n\n\t@Override\n\t@SuppressWarnings(\"unchecked\")\n\tprotected Map<Object, Object> createInstance() {\n\t\tif (this.sourceMap == null) {\n\t\t\tthrow new IllegalArgumentException(\"'sourceMap' is required\");\n\t\t}\n\t\tMap<Object, Object> result = null;","sourceCodeStart":46,"sourceCodeEnd":82,"githubUrl":"https://github.com/spring-projects/spring-framework/blob/e8729d043887bf0d0baf91e062e909b56eb2b708/spring-beans/src/main/java/org/springframework/beans/factory/config/MapFactoryBean.java#L46-L82","documentation":"Error \"'targetMapClass' must implement [java.util.Map]\" thrown in spring-projects/spring-framework.","triggerScenarios":"Thrown at spring-beans/src/main/java/org/springframework/beans/factory/config/MapFactoryBean.java:64 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"e8729d043887bf0d0baf91e062e909b56eb2b708","analyzedAt":"2026-08-04T19:07:39.725Z","schemaVersion":2}