GH-877: Implement Plexus converter that can convert algebraic sealed types

The implementation of this will expect users to take a 'kind' attribute
on the marker for a sealed type parameter which is used via reflection
to determine the concrete implementation class. Right now, we have to
provide this info on each implementation via an annotation such that
we can influence the behaviour that will eventually be provided for us
by GH-880.

This PR also changes the documentation and plugin interface so that users
will pass in a <plugins> list containing all plugins now rather than
having four distinct parameters for the same information. The exisiting
parameters have been kept and still work the same way, but are now
undocumented in the plugin guide, and are marked as deprecated-for-removal
in v5.0.0.

With this change, we will be able to use sealed implementation kinds for
the <protoc/> parameter in future changes, further supporting GH-877.

Author: ascopes

.editorconfig

@@ -18,8 +18,8 @@ ij_wrap_on_typing = false
 
 # If we don't override this then it messes up on Windows by injecting a LF.
 [.mvn/jvm.config]
-charset              = latin1
-end_of_line          = unset
+charset = latin1
+end_of_line = unset
 insert_final_newline = false
 
 [*.java]
@@ -31,7 +31,8 @@ ij_java_align_multiline_array_initializer_expression = false
 ij_java_align_multiline_assignment = false
 ij_java_align_multiline_binary_operation = false
 ij_java_align_multiline_chained_methods = false
-ij_java_align_multiline_extends_list = false
+ij_java_align_multiline_deconstruction_list_components = true
+ij_java_align_multiline_extends_list = true
 ij_java_align_multiline_for = false
 ij_java_align_multiline_method_parentheses = false
 ij_java_align_multiline_parameters = false
@@ -41,9 +42,11 @@ ij_java_align_multiline_records = true
 ij_java_align_multiline_resources = false
 ij_java_align_multiline_ternary_operation = false
 ij_java_align_multiline_text_blocks = false
-ij_java_align_multiline_throws_list = false
+ij_java_align_multiline_throws_list = true
 ij_java_align_subsequent_simple_methods = false
 ij_java_align_throws_keyword = false
+ij_java_align_types_in_multi_catch = true
+ij_java_annotation_new_line_in_record_component = false
 ij_java_annotation_parameter_wrap = off
 ij_java_array_initializer_new_line_after_left_brace = false
 ij_java_array_initializer_right_brace_on_new_line = false
@@ -60,17 +63,19 @@ ij_java_blank_lines_after_package = 1
 ij_java_blank_lines_around_class = 1
 ij_java_blank_lines_around_field = 0
 ij_java_blank_lines_around_field_in_interface = 0
+ij_java_blank_lines_around_field_with_annotations = 0
 ij_java_blank_lines_around_initializer = 1
 ij_java_blank_lines_around_method = 1
 ij_java_blank_lines_around_method_in_interface = 1
 ij_java_blank_lines_before_class_end = 0
 ij_java_blank_lines_before_imports = 1
 ij_java_blank_lines_before_method_body = 0
 ij_java_blank_lines_before_package = 0
+ij_java_blank_lines_between_record_components = 0
 ij_java_block_brace_style = end_of_line
 ij_java_block_comment_add_space = false
 ij_java_block_comment_at_first_column = true
-ij_java_builder_methods = none
+ij_java_builder_methods =
 ij_java_call_parameters_new_line_after_left_paren = false
 ij_java_call_parameters_right_paren_on_new_line = false
 ij_java_call_parameters_wrap = normal
@@ -80,8 +85,11 @@ ij_java_class_annotation_wrap = split_into_lines
 ij_java_class_brace_style = end_of_line
 ij_java_class_count_to_use_import_on_demand = 999
 ij_java_class_names_in_javadoc = 1
+ij_java_deconstruction_list_wrap = normal
+ij_java_delete_unused_module_imports = false
 ij_java_do_not_indent_top_level_class_members = false
 ij_java_do_not_wrap_after_single_annotation = false
+ij_java_do_not_wrap_after_single_annotation_in_parameter = false
 ij_java_do_while_brace_force = always
 ij_java_doc_add_blank_line_after_description = true
 ij_java_doc_add_blank_line_after_param_comments = false
@@ -92,7 +100,7 @@ ij_java_doc_align_param_comments = true
 ij_java_doc_do_not_wrap_if_one_line = false
 ij_java_doc_enable_formatting = true
 ij_java_doc_enable_leading_asterisks = true
-ij_java_doc_indent_on_continuation = true
+ij_java_doc_indent_on_continuation = false
 ij_java_doc_keep_empty_lines = true
 ij_java_doc_keep_empty_parameter_tag = true
 ij_java_doc_keep_empty_return_tag = true
@@ -103,16 +111,20 @@ ij_java_doc_preserve_line_breaks = false
 ij_java_doc_use_throws_not_exception_tag = true
 ij_java_else_on_new_line = false
 ij_java_enum_constants_wrap = off
+ij_java_enum_field_annotation_wrap = off
 ij_java_extends_keyword_wrap = off
 ij_java_extends_list_wrap = normal
 ij_java_field_annotation_wrap = split_into_lines
+ij_java_field_name_prefix =
+ij_java_field_name_suffix =
 ij_java_finally_on_new_line = false
 ij_java_for_brace_force = always
 ij_java_for_statement_new_line_after_left_paren = false
 ij_java_for_statement_right_paren_on_new_line = false
 ij_java_for_statement_wrap = normal
 ij_java_generate_final_locals = false
 ij_java_generate_final_parameters = false
+ij_java_generate_use_type_annotation_before_type = true
 ij_java_if_brace_force = always
 ij_java_imports_layout = $*, |, *
 ij_java_indent_case_from_switch = true
@@ -129,30 +141,42 @@ ij_java_keep_indents_on_empty_lines = false
 ij_java_keep_line_breaks = true
 ij_java_keep_multiple_expressions_in_one_line = false
 ij_java_keep_simple_blocks_in_one_line = false
-ij_java_keep_simple_classes_in_one_line = true
+ij_java_keep_simple_classes_in_one_line = false
 ij_java_keep_simple_lambdas_in_one_line = false
 ij_java_keep_simple_methods_in_one_line = false
 ij_java_label_indent_absolute = false
 ij_java_label_indent_size = 0
 ij_java_lambda_brace_style = end_of_line
+ij_java_layout_on_demand_import_from_same_package_first = true
 ij_java_layout_static_imports_separately = true
 ij_java_line_comment_add_space = false
+ij_java_line_comment_add_space_on_reformat = false
 ij_java_line_comment_at_first_column = true
+ij_java_local_variable_name_prefix =
+ij_java_local_variable_name_suffix =
 ij_java_method_annotation_wrap = split_into_lines
 ij_java_method_brace_style = end_of_line
 ij_java_method_call_chain_wrap = normal
 ij_java_method_parameters_new_line_after_left_paren = false
 ij_java_method_parameters_right_paren_on_new_line = false
 ij_java_method_parameters_wrap = normal
 ij_java_modifier_list_wrap = false
+ij_java_multi_catch_types_wrap = normal
 ij_java_names_count_to_use_import_on_demand = 999
+ij_java_new_line_after_lparen_in_annotation = false
+ij_java_new_line_after_lparen_in_deconstruction_pattern = true
 ij_java_new_line_after_lparen_in_record_header = false
+ij_java_new_line_when_body_is_presented = false
+ij_java_packages_to_use_import_on_demand =
 ij_java_parameter_annotation_wrap = off
+ij_java_parameter_name_prefix =
+ij_java_parameter_name_suffix =
 ij_java_parentheses_expression_new_line_after_left_paren = false
 ij_java_parentheses_expression_right_paren_on_new_line = false
 ij_java_place_assignment_sign_on_next_line = false
 ij_java_prefer_longer_names = true
 ij_java_prefer_parameters_wrap = false
+ij_java_preserve_module_imports = true
 ij_java_record_components_wrap = normal
 ij_java_repeat_synchronized = true
 ij_java_replace_instanceof_and_cast = false
@@ -161,6 +185,8 @@ ij_java_replace_sum_lambda_with_method_ref = true
 ij_java_resource_list_new_line_after_left_paren = false
 ij_java_resource_list_right_paren_on_new_line = false
 ij_java_resource_list_wrap = off
+ij_java_rparen_on_new_line_in_annotation = false
+ij_java_rparen_on_new_line_in_deconstruction_pattern = true
 ij_java_rparen_on_new_line_in_record_header = false
 ij_java_space_after_closing_angle_bracket_in_type_argument = false
 ij_java_space_after_colon = true
@@ -179,6 +205,7 @@ ij_java_space_before_class_left_brace = true
 ij_java_space_before_colon = true
 ij_java_space_before_colon_in_foreach = true
 ij_java_space_before_comma = false
+ij_java_space_before_deconstruction_list = false
 ij_java_space_before_do_left_brace = true
 ij_java_space_before_else_keyword = true
 ij_java_space_before_else_left_brace = true
@@ -209,6 +236,7 @@ ij_java_space_within_empty_array_initializer_braces = false
 ij_java_space_within_empty_method_call_parentheses = false
 ij_java_space_within_empty_method_parentheses = false
 ij_java_spaces_around_additive_operators = true
+ij_java_spaces_around_annotation_eq = true
 ij_java_spaces_around_assignment_operators = true
 ij_java_spaces_around_bitwise_operators = true
 ij_java_spaces_around_equality_operators = true
@@ -220,13 +248,15 @@ ij_java_spaces_around_relational_operators = true
 ij_java_spaces_around_shift_operators = true
 ij_java_spaces_around_type_bounds_in_type_parameters = true
 ij_java_spaces_around_unary_operator = false
+ij_java_spaces_inside_block_braces_when_body_is_present = false
 ij_java_spaces_within_angle_brackets = false
 ij_java_spaces_within_annotation_parentheses = false
 ij_java_spaces_within_array_initializer_braces = false
 ij_java_spaces_within_braces = false
 ij_java_spaces_within_brackets = false
 ij_java_spaces_within_cast_parentheses = false
 ij_java_spaces_within_catch_parentheses = false
+ij_java_spaces_within_deconstruction_list = false
 ij_java_spaces_within_for_parentheses = false
 ij_java_spaces_within_if_parentheses = false
 ij_java_spaces_within_method_call_parentheses = false
@@ -238,9 +268,14 @@ ij_java_spaces_within_synchronized_parentheses = false
 ij_java_spaces_within_try_parentheses = false
 ij_java_spaces_within_while_parentheses = false
 ij_java_special_else_if_treatment = true
+ij_java_static_field_name_prefix =
+ij_java_static_field_name_suffix =
+ij_java_subclass_name_prefix =
 ij_java_subclass_name_suffix = Impl
+ij_java_switch_expressions_wrap = normal
 ij_java_ternary_operation_signs_on_next_line = true
 ij_java_ternary_operation_wrap = normal
+ij_java_test_name_prefix =
 ij_java_test_name_suffix = Test
 ij_java_throws_keyword_wrap = normal
 ij_java_throws_list_wrap = off
@@ -255,6 +290,7 @@ ij_java_while_on_new_line = false
 ij_java_wrap_comments = true
 ij_java_wrap_first_method_in_call_chain = false
 ij_java_wrap_long_lines = false
+ij_java_wrap_semicolon_after_call_chain = false
 
 [*.properties]
 ij_properties_align_group_field_declarations = false

README.md

@@ -149,34 +149,32 @@ and then proceed to generate gRPC wrappers and Reactor gRPC wrappers.
 
 ```xml
 
-<plugin>
+<plugins>
   <groupId>io.github.ascopes</groupId>
   <artifactId>protobuf-maven-plugin</artifactId>
 
   <configuration>
     <protoc>${protobuf-java.version}</protoc>
-
-    <!-- Vanilla protoc plugins - these are platform specific executables
-         just like protoc is. -->
-    <binaryMavenPlugins>
-      <binaryMavenPlugin>
+    
+    <plugins>
+      <!-- Vanilla protoc plugins - these are platform specific executables
+           just like protoc is. -->
+      <plugin kind="binary-maven">
         <groupId>io.grpc</groupId>
         <artifactId>protoc-gen-grpc-java</artifactId>
         <version>${grpc.version}</version>
-      </binaryMavenPlugin>
-    </binaryMavenPlugins>
-
-    <!-- JVM plugins are distributed as JARs rather than native system
-         executables. The protobuf-maven-plugin will automatically bootstrap
-         them for you, without the need for additional
-         tooling for your platform. It should "just work". -->
-    <jvmMavenPlugins>
-      <jvmMavenPlugin>
+      </plugin>
+
+      <!-- JVM plugins are distributed as JARs rather than native system
+           executables. The protobuf-maven-plugin will automatically bootstrap
+           them for you, without the need for additional
+           tooling for your platform. It should "just work". -->
+      <plugin kind="jvm-maven">
         <groupId>com.salesforce.servicelibs</groupId>
         <artifactId>reactor-grpc</artifactId>
         <version>${reactor-grpc.version}</version>
-      </jvmMavenPlugin>
-    </jvmMavenPlugins>
+      </plugin>
+    </plugins>
   </configuration>
 
   <executions>

protobuf-maven-plugin/src/it/gh-277-plugin-ordering/pom.xml

@@ -75,21 +75,21 @@
         <artifactId>@project.artifactId@</artifactId>
 
         <configuration>
-          <binaryMavenPlugins>
-            <binaryMavenPlugin>
+          <plugins>
+            <plugin kind="binary-maven">
               <groupId>com.salesforce.servicelibs</groupId>
               <artifactId>reactor-grpc</artifactId>
               <version>${reactor-grpc.version}</version>
               <order>200</order>
-            </binaryMavenPlugin>
+            </plugin>
 
-            <binaryMavenPlugin>
+            <plugin kind="binary-maven">
               <groupId>io.grpc</groupId>
               <artifactId>protoc-gen-grpc-java</artifactId>
               <version>${grpc.version}</version>
               <order>100</order>
-            </binaryMavenPlugin>
-          </binaryMavenPlugins>
+            </plugin>
+          </plugins>
         </configuration>
 
         <executions>

protobuf-maven-plugin/src/it/gh-358-unpackaged-jar-plugin/some-project/pom.xml

@@ -38,14 +38,14 @@
         <version>@project.version@</version>
 
         <configuration>
-          <jvmMavenPlugins>
-            <jvmMavenPlugin>
+          <plugins>
+            <plugin kind="jvm-maven">
               <groupId>${project.groupId}</groupId>
               <artifactId>protoc-plugin</artifactId>
               <version>${project.version}</version>
               <mainClass>org.example.protocplugin.ProtocPlugin</mainClass>
-            </jvmMavenPlugin>
-          </jvmMavenPlugins>
+            </plugin>
+          </plugins>
 
           <javaEnabled>false</javaEnabled>
           <protoc>${protobuf.version}</protoc>

protobuf-maven-plugin/src/it/gh-359-modular-jar-plugin/some-project/pom.xml

@@ -37,13 +37,13 @@
         <artifactId>@project.artifactId@</artifactId>
 
         <configuration>
-          <jvmMavenPlugins>
-            <jvmMavenPlugin>
+          <plugins>
+            <plugin kind="jvm-maven">
               <groupId>${project.groupId}</groupId>
               <artifactId>protoc-plugin-frontend</artifactId>
               <version>${project.version}</version>
-            </jvmMavenPlugin>
-          </jvmMavenPlugins>
+            </plugin>
+          </plugins>
 
           <javaEnabled>false</javaEnabled>
         </configuration>

protobuf-maven-plugin/src/it/gh-363-packaged-jvm-plugin-with-mainclass-set/some-project/pom.xml

@@ -38,13 +38,13 @@
         <version>@project.version@</version>
 
         <configuration>
-          <jvmMavenPlugins>
-            <jvmMavenPlugin>
+          <plugins>
+            <plugin kind="jvm-maven">
               <groupId>${project.groupId}</groupId>
               <artifactId>protoc-plugin</artifactId>
               <version>${project.version}</version>
-            </jvmMavenPlugin>
-          </jvmMavenPlugins>
+            </plugin>
+          </plugins>
 
           <javaEnabled>false</javaEnabled>
           <protoc>${protobuf.version}</protoc>

protobuf-maven-plugin/src/it/gh-363-packaged-jvm-plugin-without-mainclass-set/some-project/pom.xml

@@ -38,14 +38,14 @@
         <version>@project.version@</version>
 
         <configuration>
-          <jvmMavenPlugins>
-            <jvmMavenPlugin>
+          <plugins>
+            <plugin kind="jvm-maven">
               <groupId>${project.groupId}</groupId>
               <artifactId>protoc-plugin</artifactId>
               <version>${project.version}</version>
               <mainClass>org.example.protocplugin.ProtocPlugin</mainClass>
-            </jvmMavenPlugin>
-          </jvmMavenPlugins>
+            </plugin>
+          </plugins>
 
           <javaEnabled>false</javaEnabled>
           <protoc>${protobuf.version}</protoc>

protobuf-maven-plugin/src/it/gh-372-paths-with-spaces/some-project/pom.xml

@@ -38,13 +38,13 @@
         <version>@project.version@</version>
 
         <configuration>
-          <jvmMavenPlugins>
-            <jvmMavenPlugin>
+          <plugins>
+            <plugin kind="jvm-maven">
               <groupId>${project.groupId}</groupId>
               <artifactId>protoc-plugin</artifactId>
               <version>${project.version}</version>
-            </jvmMavenPlugin>
-          </jvmMavenPlugins>
+            </plugin>
+          </plugins>
 
           <javaEnabled>false</javaEnabled>
           <protoc>${protobuf.version}</protoc>

protobuf-maven-plugin/src/it/gh-397-jvm-plugin-commandline-args/some-project/pom.xml

@@ -38,8 +38,8 @@
         <version>@project.version@</version>
 
         <configuration>
-          <jvmMavenPlugins>
-            <jvmMavenPlugin>
+          <plugins>
+            <plugin kind="jvm-maven">
               <groupId>${project.groupId}</groupId>
               <artifactId>protoc-plugin</artifactId>
               <version>${project.version}</version>
@@ -48,8 +48,8 @@
                 <jvmArg>bar</jvmArg>
                 <jvmArg>baz</jvmArg>
               </jvmArgs>
-            </jvmMavenPlugin>
-          </jvmMavenPlugins>
+            </plugin>
+          </plugins>
 
           <javaEnabled>false</javaEnabled>
           <protoc>${protobuf.version}</protoc>