[ { "path": ".dockerignore", "content": "ui\n.github\n.git" }, { "path": ".editorconfig", "content": "root=true\n\n[*]\ncharset = utf-8\nend_of_line = lf\nindent_size = 4\nindent_style = space\ninsert_final_newline = false\nmax_line_length = 120\ntab_width = 4\nij_continuation_indent_size = 8\nij_formatter_off_tag = @formatter:off\nij_formatter_on_tag = @formatter:on\nij_formatter_tags_enabled = true\nij_smart_tabs = false\nij_wrap_on_typing = false\n\n[*.java]\nmax_line_length = 100\nij_continuation_indent_size = 4\nij_java_align_consecutive_assignments = false\nij_java_align_consecutive_variable_declarations = false\nij_java_align_group_field_declarations = false\nij_java_align_multiline_annotation_parameters = false\nij_java_align_multiline_array_initializer_expression = false\nij_java_align_multiline_assignment = false\nij_java_align_multiline_binary_operation = false\nij_java_align_multiline_chained_methods = false\nij_java_align_multiline_extends_list = false\nij_java_align_multiline_for = true\nij_java_align_multiline_method_parentheses = false\nij_java_align_multiline_parameters = false\nij_java_align_multiline_parameters_in_calls = false\nij_java_align_multiline_parenthesized_expression = false\nij_java_align_multiline_records = true\nij_java_align_multiline_resources = true\nij_java_align_multiline_ternary_operation = false\nij_java_align_multiline_text_blocks = false\nij_java_align_multiline_throws_list = false\nij_java_align_subsequent_simple_methods = false\nij_java_align_throws_keyword = false\nij_java_annotation_parameter_wrap = off\nij_java_array_initializer_new_line_after_left_brace = false\nij_java_array_initializer_right_brace_on_new_line = false\nij_java_array_initializer_wrap = normal\nij_java_assert_statement_colon_on_next_line = false\nij_java_assert_statement_wrap = normal\nij_java_assignment_wrap = normal\nij_java_binary_operation_sign_on_next_line = true\nij_java_binary_operation_wrap = normal\nij_java_blank_lines_after_anonymous_class_header = 0\nij_java_blank_lines_after_class_header = 0\nij_java_blank_lines_after_imports = 1\nij_java_blank_lines_after_package = 1\nij_java_blank_lines_around_class = 1\nij_java_blank_lines_around_field = 0\nij_java_blank_lines_around_field_in_interface = 0\nij_java_blank_lines_around_initializer = 1\nij_java_blank_lines_around_method = 1\nij_java_blank_lines_around_method_in_interface = 1\nij_java_blank_lines_before_class_end = 0\nij_java_blank_lines_before_imports = 0\nij_java_blank_lines_before_method_body = 0\nij_java_blank_lines_before_package = 1\nij_java_block_brace_style = end_of_line\nij_java_block_comment_at_first_column = false\nij_java_call_parameters_new_line_after_left_paren = false\nij_java_call_parameters_right_paren_on_new_line = false\nij_java_call_parameters_wrap = normal\nij_java_case_statement_on_separate_line = true\nij_java_catch_on_new_line = false\nij_java_class_annotation_wrap = split_into_lines\nij_java_class_brace_style = end_of_line\nij_java_class_count_to_use_import_on_demand = 999\nij_java_class_names_in_javadoc = 1\nij_java_do_not_indent_top_level_class_members = false\nij_java_do_not_wrap_after_single_annotation = false\nij_java_do_while_brace_force = always\nij_java_doc_add_blank_line_after_description = true\nij_java_doc_add_blank_line_after_param_comments = false\nij_java_doc_add_blank_line_after_return = false\nij_java_doc_add_p_tag_on_empty_lines = true\nij_java_doc_align_exception_comments = true\nij_java_doc_align_param_comments = false\nij_java_doc_do_not_wrap_if_one_line = false\nij_java_doc_enable_formatting = true\nij_java_doc_enable_leading_asterisks = true\nij_java_doc_indent_on_continuation = false\nij_java_doc_keep_empty_lines = true\nij_java_doc_keep_empty_parameter_tag = true\nij_java_doc_keep_empty_return_tag = true\nij_java_doc_keep_empty_throws_tag = true\nij_java_doc_keep_invalid_tags = true\nij_java_doc_param_description_on_new_line = false\nij_java_doc_preserve_line_breaks = false\nij_java_doc_use_throws_not_exception_tag = true\nij_java_else_on_new_line = false\nij_java_enum_constants_wrap = normal\nij_java_extends_keyword_wrap = normal\nij_java_extends_list_wrap = normal\nij_java_field_annotation_wrap = split_into_lines\nij_java_finally_on_new_line = false\nij_java_for_brace_force = always\nij_java_for_statement_new_line_after_left_paren = false\nij_java_for_statement_right_paren_on_new_line = false\nij_java_for_statement_wrap = normal\nij_java_generate_final_locals = false\nij_java_generate_final_parameters = false\nij_java_if_brace_force = always\nij_java_imports_layout = $*, |, *, |, *\nij_java_indent_case_from_switch = true\nij_java_insert_inner_class_imports = false\nij_java_insert_override_annotation = true\nij_java_keep_blank_lines_before_right_brace = 2\nij_java_keep_blank_lines_between_package_declaration_and_header = 2\nij_java_keep_blank_lines_in_code = 2\nij_java_keep_blank_lines_in_declarations = 2\nij_java_keep_control_statement_in_one_line = true\nij_java_keep_first_column_comment = true\nij_java_keep_indents_on_empty_lines = false\nij_java_keep_line_breaks = true\nij_java_keep_multiple_expressions_in_one_line = false\nij_java_keep_simple_blocks_in_one_line = false\nij_java_keep_simple_classes_in_one_line = false\nij_java_keep_simple_lambdas_in_one_line = false\nij_java_keep_simple_methods_in_one_line = false\nij_java_label_indent_absolute = false\nij_java_label_indent_size = 0\nij_java_lambda_brace_style = end_of_line\nij_java_layout_static_imports_separately = true\nij_java_line_comment_add_space = true\nij_java_line_comment_at_first_column = false\nij_java_method_annotation_wrap = split_into_lines\nij_java_method_brace_style = end_of_line\nij_java_method_call_chain_wrap = normal\nij_java_method_parameters_new_line_after_left_paren = false\nij_java_method_parameters_right_paren_on_new_line = false\nij_java_method_parameters_wrap = normal\nij_java_modifier_list_wrap = false\nij_java_names_count_to_use_import_on_demand = 999\nij_java_new_line_after_lparen_in_record_header = false\nij_java_parameter_annotation_wrap = normal\nij_java_parentheses_expression_new_line_after_left_paren = false\nij_java_parentheses_expression_right_paren_on_new_line = false\nij_java_place_assignment_sign_on_next_line = false\nij_java_prefer_longer_names = true\nij_java_prefer_parameters_wrap = false\nij_java_record_components_wrap = normal\nij_java_repeat_synchronized = true\nij_java_replace_instanceof_and_cast = false\nij_java_replace_null_check = true\nij_java_replace_sum_lambda_with_method_ref = true\nij_java_resource_list_new_line_after_left_paren = false\nij_java_resource_list_right_paren_on_new_line = false\nij_java_resource_list_wrap = normal\nij_java_rparen_on_new_line_in_record_header = false\nij_java_space_after_closing_angle_bracket_in_type_argument = false\nij_java_space_after_colon = true\nij_java_space_after_comma = true\nij_java_space_after_comma_in_type_arguments = true\nij_java_space_after_for_semicolon = true\nij_java_space_after_quest = true\nij_java_space_after_type_cast = true\nij_java_space_before_annotation_array_initializer_left_brace = false\nij_java_space_before_annotation_parameter_list = false\nij_java_space_before_array_initializer_left_brace = true\nij_java_space_before_catch_keyword = true\nij_java_space_before_catch_left_brace = true\nij_java_space_before_catch_parentheses = true\nij_java_space_before_class_left_brace = true\nij_java_space_before_colon = true\nij_java_space_before_colon_in_foreach = true\nij_java_space_before_comma = false\nij_java_space_before_do_left_brace = true\nij_java_space_before_else_keyword = true\nij_java_space_before_else_left_brace = true\nij_java_space_before_finally_keyword = true\nij_java_space_before_finally_left_brace = true\nij_java_space_before_for_left_brace = true\nij_java_space_before_for_parentheses = true\nij_java_space_before_for_semicolon = false\nij_java_space_before_if_left_brace = true\nij_java_space_before_if_parentheses = true\nij_java_space_before_method_call_parentheses = false\nij_java_space_before_method_left_brace = true\nij_java_space_before_method_parentheses = false\nij_java_space_before_opening_angle_bracket_in_type_parameter = false\nij_java_space_before_quest = true\nij_java_space_before_switch_left_brace = true\nij_java_space_before_switch_parentheses = true\nij_java_space_before_synchronized_left_brace = true\nij_java_space_before_synchronized_parentheses = true\nij_java_space_before_try_left_brace = true\nij_java_space_before_try_parentheses = true\nij_java_space_before_type_parameter_list = false\nij_java_space_before_while_keyword = true\nij_java_space_before_while_left_brace = true\nij_java_space_before_while_parentheses = true\nij_java_space_inside_one_line_enum_braces = false\nij_java_space_within_empty_array_initializer_braces = false\nij_java_space_within_empty_method_call_parentheses = false\nij_java_space_within_empty_method_parentheses = false\nij_java_spaces_around_additive_operators = true\nij_java_spaces_around_assignment_operators = true\nij_java_spaces_around_bitwise_operators = true\nij_java_spaces_around_equality_operators = true\nij_java_spaces_around_lambda_arrow = true\nij_java_spaces_around_logical_operators = true\nij_java_spaces_around_method_ref_dbl_colon = false\nij_java_spaces_around_multiplicative_operators = true\nij_java_spaces_around_relational_operators = true\nij_java_spaces_around_shift_operators = true\nij_java_spaces_around_type_bounds_in_type_parameters = true\nij_java_spaces_around_unary_operator = false\nij_java_spaces_within_angle_brackets = false\nij_java_spaces_within_annotation_parentheses = false\nij_java_spaces_within_array_initializer_braces = false\nij_java_spaces_within_braces = false\nij_java_spaces_within_brackets = false\nij_java_spaces_within_cast_parentheses = false\nij_java_spaces_within_catch_parentheses = false\nij_java_spaces_within_for_parentheses = false\nij_java_spaces_within_if_parentheses = false\nij_java_spaces_within_method_call_parentheses = false\nij_java_spaces_within_method_parentheses = false\nij_java_spaces_within_parentheses = false\nij_java_spaces_within_switch_parentheses = false\nij_java_spaces_within_synchronized_parentheses = false\nij_java_spaces_within_try_parentheses = false\nij_java_spaces_within_while_parentheses = false\nij_java_special_else_if_treatment = true\nij_java_subclass_name_suffix = Impl\nij_java_ternary_operation_signs_on_next_line = true\nij_java_ternary_operation_wrap = normal\nij_java_test_name_suffix = Test\nij_java_throws_keyword_wrap = normal\nij_java_throws_list_wrap = normal\nij_java_use_external_annotations = false\nij_java_use_fq_class_names = false\nij_java_use_relative_indents = false\nij_java_use_single_class_imports = true\nij_java_variable_annotation_wrap = normal\nij_java_visibility = public\nij_java_while_brace_force = always\nij_java_while_on_new_line = false\nij_java_wrap_comments = false\nij_java_wrap_first_method_in_call_chain = false\nij_java_wrap_long_lines = true\n\n[*.properties]\nij_properties_align_group_field_declarations = false\nij_properties_keep_blank_lines = false\nij_properties_key_value_delimiter = equals\nij_properties_spaces_around_key_value_delimiter = false\n\n[.editorconfig]\nij_editorconfig_align_group_field_declarations = false\nij_editorconfig_space_after_colon = false\nij_editorconfig_space_after_comma = true\nij_editorconfig_space_before_colon = false\nij_editorconfig_space_before_comma = false\nij_editorconfig_spaces_around_assignment_operators = true\n\n[{*.ant, *.fxml, *.jhm, *.jnlp, *.jrxml, *.jspx, *.pom, *.rng, *.tagx, *.tld, *.wsdl, *.xml, *.xsd, *.xsl, *.xslt, *.xul}]\nij_xml_align_attributes = true\nij_xml_align_text = false\nij_xml_attribute_wrap = normal\nij_xml_block_comment_at_first_column = true\nij_xml_keep_blank_lines = 2\nij_xml_keep_indents_on_empty_lines = false\nij_xml_keep_line_breaks = true\nij_xml_keep_line_breaks_in_text = true\nij_xml_keep_whitespaces = false\nij_xml_keep_whitespaces_around_cdata = preserve\nij_xml_keep_whitespaces_inside_cdata = false\nij_xml_line_comment_at_first_column = true\nij_xml_space_after_tag_name = false\nij_xml_space_around_equals_in_attribute = false\nij_xml_space_inside_empty_tag = false\nij_xml_text_wrap = normal\n\n[{*.bash, *.sh, *.zsh}]\nindent_size = 2\ntab_width = 2\nij_shell_binary_ops_start_line = false\nij_shell_keep_column_alignment_padding = false\nij_shell_minify_program = false\nij_shell_redirect_followed_by_space = false\nij_shell_switch_cases_indented = false\n\n[{*.gant, *.gradle, *.groovy, *.gy}]\nij_groovy_align_group_field_declarations = false\nij_groovy_align_multiline_array_initializer_expression = false\nij_groovy_align_multiline_assignment = false\nij_groovy_align_multiline_binary_operation = false\nij_groovy_align_multiline_chained_methods = false\nij_groovy_align_multiline_extends_list = false\nij_groovy_align_multiline_for = true\nij_groovy_align_multiline_list_or_map = true\nij_groovy_align_multiline_method_parentheses = false\nij_groovy_align_multiline_parameters = true\nij_groovy_align_multiline_parameters_in_calls = false\nij_groovy_align_multiline_resources = true\nij_groovy_align_multiline_ternary_operation = false\nij_groovy_align_multiline_throws_list = false\nij_groovy_align_named_args_in_map = true\nij_groovy_align_throws_keyword = false\nij_groovy_array_initializer_new_line_after_left_brace = false\nij_groovy_array_initializer_right_brace_on_new_line = false\nij_groovy_array_initializer_wrap = off\nij_groovy_assert_statement_wrap = off\nij_groovy_assignment_wrap = off\nij_groovy_binary_operation_wrap = off\nij_groovy_blank_lines_after_class_header = 0\nij_groovy_blank_lines_after_imports = 1\nij_groovy_blank_lines_after_package = 1\nij_groovy_blank_lines_around_class = 1\nij_groovy_blank_lines_around_field = 0\nij_groovy_blank_lines_around_field_in_interface = 0\nij_groovy_blank_lines_around_method = 1\nij_groovy_blank_lines_around_method_in_interface = 1\nij_groovy_blank_lines_before_imports = 1\nij_groovy_blank_lines_before_method_body = 0\nij_groovy_blank_lines_before_package = 0\nij_groovy_block_brace_style = end_of_line\nij_groovy_block_comment_at_first_column = true\nij_groovy_call_parameters_new_line_after_left_paren = false\nij_groovy_call_parameters_right_paren_on_new_line = false\nij_groovy_call_parameters_wrap = off\nij_groovy_catch_on_new_line = false\nij_groovy_class_annotation_wrap = split_into_lines\nij_groovy_class_brace_style = end_of_line\nij_groovy_class_count_to_use_import_on_demand = 5\nij_groovy_do_while_brace_force = never\nij_groovy_else_on_new_line = false\nij_groovy_enum_constants_wrap = off\nij_groovy_extends_keyword_wrap = off\nij_groovy_extends_list_wrap = off\nij_groovy_field_annotation_wrap = split_into_lines\nij_groovy_finally_on_new_line = false\nij_groovy_for_brace_force = never\nij_groovy_for_statement_new_line_after_left_paren = false\nij_groovy_for_statement_right_paren_on_new_line = false\nij_groovy_for_statement_wrap = off\nij_groovy_if_brace_force = never\nij_groovy_import_annotation_wrap = 2\nij_groovy_indent_case_from_switch = true\nij_groovy_indent_label_blocks = true\nij_groovy_insert_inner_class_imports = false\nij_groovy_keep_blank_lines_before_right_brace = 2\nij_groovy_keep_blank_lines_in_code = 2\nij_groovy_keep_blank_lines_in_declarations = 2\nij_groovy_keep_control_statement_in_one_line = true\nij_groovy_keep_first_column_comment = true\nij_groovy_keep_indents_on_empty_lines = false\nij_groovy_keep_line_breaks = true\nij_groovy_keep_multiple_expressions_in_one_line = false\nij_groovy_keep_simple_blocks_in_one_line = false\nij_groovy_keep_simple_classes_in_one_line = true\nij_groovy_keep_simple_lambdas_in_one_line = true\nij_groovy_keep_simple_methods_in_one_line = true\nij_groovy_label_indent_absolute = false\nij_groovy_label_indent_size = 0\nij_groovy_lambda_brace_style = end_of_line\nij_groovy_layout_static_imports_separately = true\nij_groovy_line_comment_add_space = false\nij_groovy_line_comment_at_first_column = true\nij_groovy_method_annotation_wrap = split_into_lines\nij_groovy_method_brace_style = end_of_line\nij_groovy_method_call_chain_wrap = off\nij_groovy_method_parameters_new_line_after_left_paren = false\nij_groovy_method_parameters_right_paren_on_new_line = false\nij_groovy_method_parameters_wrap = off\nij_groovy_modifier_list_wrap = false\nij_groovy_names_count_to_use_import_on_demand = 3\nij_groovy_parameter_annotation_wrap = off\nij_groovy_parentheses_expression_new_line_after_left_paren = false\nij_groovy_parentheses_expression_right_paren_on_new_line = false\nij_groovy_prefer_parameters_wrap = false\nij_groovy_resource_list_new_line_after_left_paren = false\nij_groovy_resource_list_right_paren_on_new_line = false\nij_groovy_resource_list_wrap = off\nij_groovy_space_after_assert_separator = true\nij_groovy_space_after_colon = true\nij_groovy_space_after_comma = true\nij_groovy_space_after_comma_in_type_arguments = true\nij_groovy_space_after_for_semicolon = true\nij_groovy_space_after_quest = true\nij_groovy_space_after_type_cast = true\nij_groovy_space_before_annotation_parameter_list = false\nij_groovy_space_before_array_initializer_left_brace = false\nij_groovy_space_before_assert_separator = false\nij_groovy_space_before_catch_keyword = true\nij_groovy_space_before_catch_left_brace = true\nij_groovy_space_before_catch_parentheses = true\nij_groovy_space_before_class_left_brace = true\nij_groovy_space_before_closure_left_brace = true\nij_groovy_space_before_colon = true\nij_groovy_space_before_comma = false\nij_groovy_space_before_do_left_brace = true\nij_groovy_space_before_else_keyword = true\nij_groovy_space_before_else_left_brace = true\nij_groovy_space_before_finally_keyword = true\nij_groovy_space_before_finally_left_brace = true\nij_groovy_space_before_for_left_brace = true\nij_groovy_space_before_for_parentheses = true\nij_groovy_space_before_for_semicolon = false\nij_groovy_space_before_if_left_brace = true\nij_groovy_space_before_if_parentheses = true\nij_groovy_space_before_method_call_parentheses = false\nij_groovy_space_before_method_left_brace = true\nij_groovy_space_before_method_parentheses = false\nij_groovy_space_before_quest = true\nij_groovy_space_before_switch_left_brace = true\nij_groovy_space_before_switch_parentheses = true\nij_groovy_space_before_synchronized_left_brace = true\nij_groovy_space_before_synchronized_parentheses = true\nij_groovy_space_before_try_left_brace = true\nij_groovy_space_before_try_parentheses = true\nij_groovy_space_before_while_keyword = true\nij_groovy_space_before_while_left_brace = true\nij_groovy_space_before_while_parentheses = true\nij_groovy_space_in_named_argument = true\nij_groovy_space_in_named_argument_before_colon = false\nij_groovy_space_within_empty_array_initializer_braces = false\nij_groovy_space_within_empty_method_call_parentheses = false\nij_groovy_spaces_around_additive_operators = true\nij_groovy_spaces_around_assignment_operators = true\nij_groovy_spaces_around_bitwise_operators = true\nij_groovy_spaces_around_equality_operators = true\nij_groovy_spaces_around_lambda_arrow = true\nij_groovy_spaces_around_logical_operators = true\nij_groovy_spaces_around_multiplicative_operators = true\nij_groovy_spaces_around_regex_operators = true\nij_groovy_spaces_around_relational_operators = true\nij_groovy_spaces_around_shift_operators = true\nij_groovy_spaces_within_annotation_parentheses = false\nij_groovy_spaces_within_array_initializer_braces = false\nij_groovy_spaces_within_braces = true\nij_groovy_spaces_within_brackets = false\nij_groovy_spaces_within_cast_parentheses = false\nij_groovy_spaces_within_catch_parentheses = false\nij_groovy_spaces_within_for_parentheses = false\nij_groovy_spaces_within_gstring_injection_braces = false\nij_groovy_spaces_within_if_parentheses = false\nij_groovy_spaces_within_list_or_map = false\nij_groovy_spaces_within_method_call_parentheses = false\nij_groovy_spaces_within_method_parentheses = false\nij_groovy_spaces_within_parentheses = false\nij_groovy_spaces_within_switch_parentheses = false\nij_groovy_spaces_within_synchronized_parentheses = false\nij_groovy_spaces_within_try_parentheses = false\nij_groovy_spaces_within_tuple_expression = false\nij_groovy_spaces_within_while_parentheses = false\nij_groovy_special_else_if_treatment = true\nij_groovy_ternary_operation_wrap = off\nij_groovy_throws_keyword_wrap = off\nij_groovy_throws_list_wrap = off\nij_groovy_use_flying_geese_braces = false\nij_groovy_use_fq_class_names = false\nij_groovy_use_fq_class_names_in_javadoc = true\nij_groovy_use_relative_indents = false\nij_groovy_use_single_class_imports = true\nij_groovy_variable_annotation_wrap = off\nij_groovy_while_brace_force = never\nij_groovy_while_on_new_line = false\nij_groovy_wrap_long_lines = false\n\n[{*.har, *.json}]\nindent_size = 2\nij_json_keep_blank_lines_in_code = 0\nij_json_keep_indents_on_empty_lines = false\nij_json_keep_line_breaks = true\nij_json_space_after_colon = true\nij_json_space_after_comma = true\nij_json_space_before_colon = true\nij_json_space_before_comma = false\nij_json_spaces_within_braces = false\nij_json_spaces_within_brackets = false\nij_json_wrap_long_lines = false\n\n[{*.htm, *.html, *.sht, *.shtm, *.shtml}]\nij_html_add_new_line_before_tags = body, div, p, form, h1, h2, h3\nij_html_align_attributes = true\nij_html_align_text = false\nij_html_attribute_wrap = normal\nij_html_block_comment_at_first_column = true\nij_html_do_not_align_children_of_min_lines = 0\nij_html_do_not_break_if_inline_tags = title, h1, h2, h3, h4, h5, h6, p\nij_html_do_not_indent_children_of_tags = html, body, thead, tbody, tfoot\nij_html_enforce_quotes = false\nij_html_inline_tags = a, abbr, acronym, b, basefont, bdo, big, br, cite, cite, code, dfn, em, font, i, img, input, kbd, label, q, s, samp, select, small, span, strike, strong, sub, sup, textarea, tt, u, var\nij_html_keep_blank_lines = 2\nij_html_keep_indents_on_empty_lines = false\nij_html_keep_line_breaks = true\nij_html_keep_line_breaks_in_text = true\nij_html_keep_whitespaces = false\nij_html_keep_whitespaces_inside = span, pre, textarea\nij_html_line_comment_at_first_column = true\nij_html_new_line_after_last_attribute = never\nij_html_new_line_before_first_attribute = never\nij_html_quote_style = double\nij_html_remove_new_line_before_tags = br\nij_html_space_after_tag_name = false\nij_html_space_around_equality_in_attribute = false\nij_html_space_inside_empty_tag = false\nij_html_text_wrap = normal\n\n[{*.yaml, *.yml}]\nindent_size = 2\nij_yaml_keep_indents_on_empty_lines = false\nij_yaml_keep_line_breaks = true\n\n[*.md]\nindent_size = 2\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.en.yml", "content": "name: Bug Report\ndescription: File a bug report\nlabels: [bug]\nbody:\n - type: checkboxes\n id: preface\n attributes:\n label: Prerequisites\n description: Thank you for taking the time to fill out this issue report! Before we begin, we highly recommend reading through the [Open Source Guides](https://opensource.guide/), which will greatly improve our mutual efficiency.\n options:\n - label: I have searched for related issues in the [issues](https://github.com/halo-dev/halo/issues) list.\n required: true\n - label: \"This is an issue with the Halo project itself. If it is not an issue with the project itself(For example: Installation and deployment issues.), it is recommended to submit it in the [Discussions](https://github.com/halo-dev/halo/discussions).\"\n required: true\n - label: I have tried disabling all plugins to rule out plugins as the cause of the problem.\n required: true\n - label: If it is an issue with plugins and themes, please submit it in the respective plugin and theme repositories.\n required: true\n - type: markdown\n id: environment\n attributes:\n value: \"## Environment\"\n - type: textarea\n id: system-information\n attributes:\n label: \"System information\"\n description: \"Access the actuator page of the Console, click the copy button in the upper right corner, and paste the information here.\"\n placeholder: |\n - External url: https://demo.halo.run\n - Start time: 2024-07-21 14:50\n - Version: 2.x.x\n - Build time: 2024-07-15 18:19\n - Git Commit: 6d4bedd\n - Java: IBM Semeru Runtime Open Edition / ...\n - Database: PostgreSQL / 16.3 ...\n - Operating system: Linux / 5.15.0-88 ...\n - Activated theme: ...\n - Enabled plugins:\n - ...\n validations:\n required: true\n - type: dropdown\n id: operation-method\n validations:\n required: true\n attributes:\n label: \"What is the project operation method?\"\n options:\n - Docker\n - Docker Compose\n - Fat Jar\n - Source Code\n - type: markdown\n id: details\n attributes:\n value: \"## Details\"\n - type: textarea\n id: what-happened\n attributes:\n label: \"What happened?\"\n description: \"For ease of management, please do not report multiple unrelated issues under the same issue.\"\n validations:\n required: true\n - type: textarea\n id: reproduce-steps\n attributes:\n label: \"Reproduce Steps\"\n description: \"If it can be consistently reproduced, please provide detailed steps.\"\n placeholder: |\n 1. Open '...'\n 2. Click '...'\n - type: textarea\n id: logs\n attributes:\n label: \"Relevant log output\"\n description: \"Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks.\"\n render: shell\n - type: textarea\n id: additional-information\n attributes:\n label: \"Additional information\"\n description: \"If you have other information to note, you can fill it in here (screenshots, videos, etc.).\"\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.zh.yml", "content": "name: Bug 反馈\ndescription: 提交 Bug 反馈\nlabels: [bug]\nbody:\n - type: checkboxes\n id: preface\n attributes:\n label: 前置条件\n description: 感谢你花时间填写此错误报告！在开始之前，我们非常推荐阅读一遍[《开源软件指南》](https://opensource.guide/zh-hans/)，这会在很大程度上提高我们彼此的效率。\n options:\n - label: 已经在 [issues](https://github.com/halo-dev/halo/issues) 列表中搜索了相关问题。\n required: true\n - label: 这是 Halo 项目本身存在的问题，如果是非项目本身的问题（如：安装部署问题），建议在 [Discussions](https://github.com/halo-dev/halo/discussions) 提交。\n required: true\n - label: 已经尝试过停用所有的插件，排除是插件导致的问题。\n required: true\n - label: 如果是插件和主题的问题，请在对应的插件和主题仓库提交。\n required: true\n - type: markdown\n id: environment\n attributes:\n value: \"## 环境信息\"\n - type: textarea\n id: system-information\n attributes:\n label: \"系统信息\"\n description: \"访问 Console 的概览页面，点击右上角的复制按钮，将信息粘贴到此处。\"\n placeholder: |\n - 外部访问地址: https://demo.halo.run\n - 启动时间: 2024-07-21 14:50\n - 版本: 2.x.x\n - 构建时间: 2024-07-15 18:19\n - Git Commit: 6d4bedd\n - Java: IBM Semeru Runtime Open Edition / ...\n - 数据库: PostgreSQL / 16.3 ...\n - 操作系统: Linux / 5.15.0-88 ...\n - 已激活主题: ...\n - 已启动插件:\n - ...\n validations:\n required: true\n - type: dropdown\n id: operation-method\n validations:\n required: true\n attributes:\n label: \"使用的哪种方式运行？\"\n options:\n - Docker\n - Docker Compose\n - Fat Jar\n - Source Code\n - type: markdown\n id: details\n attributes:\n value: \"## 详细信息\"\n - type: textarea\n id: what-happened\n attributes:\n label: \"发生了什么？\"\n description: \"为了方便我们管理，请不要在同一个 issue 下报告多个不相关的问题。\"\n validations:\n required: true\n - type: textarea\n id: reproduce-steps\n attributes:\n label: \"复现步骤\"\n description: \"如果可以稳定复现，请提供详细的步骤。\"\n placeholder: |\n 1. 打开 '...'\n 2. 点击 '...'\n - type: textarea\n id: logs\n attributes:\n label: \"相关日志输出\"\n description: \"请复制并粘贴任何相关的日志输出。这将自动格式化为代码，因此无需反引号。\"\n render: shell\n - type: textarea\n id: additional-information\n attributes:\n label: \"附加信息\"\n description: \"如果你还有其他需要提供的信息，可以在这里填写（可以提供截图、视频等）。\"\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: false\ncontact_links:\n - name: 商业产品反馈\n url: https://github.com/orgs/lxware-dev/discussions\n about: Halo 付费版以及应用市场商业应用的问题，建议优先在这里反馈。\n - name: 对 Halo 有其他问题\n url: https://bbs.halo.run\n about: 如果你对 Halo 有其他想要提问的，欢迎到官方社区进行提问。" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.en.yml", "content": "name: Feature Request\ndescription: File a feature request\nbody:\n - type: checkboxes\n id: preface\n attributes:\n label: Prerequisites\n description: Hello! Thank you for submitting a new feature suggestion for Halo. Before we begin, we highly recommend reading through the [Open Source Guides](https://opensource.guide/), which will greatly improve our mutual efficiency.\n options:\n - label: I have searched for related issues in the [Issues](https://github.com/halo-dev/halo/issues) list.\n required: true\n - label: This is a feature related to Halo. If it is not an issue with the project itself, it is recommended to submit it in the [Discussions](https://github.com/halo-dev/halo/discussions).\n required: true\n - label: If it is a feature suggestion for plugins and themes, please submit it in the respective plugin and theme repositories.\n required: true\n - type: markdown\n id: environment\n attributes:\n value: \"## Environment\"\n - type: input\n id: version\n attributes:\n label: \"Your current Halo version\"\n - type: markdown\n id: details\n attributes:\n value: \"## Details\"\n - type: textarea\n id: description\n attributes:\n label: \"Describe this feature\"\n description: \"For ease of management, please do not submit multiple unrelated features under the same issue.\"\n validations:\n required: true\n - type: textarea\n id: additional-information\n attributes:\n label: \"Additional information\"\n description: \"If you have other information to note, you can fill it in here (screenshots, videos, etc.).\"" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.zh.yml", "content": "name: 新特性建议\ndescription: 提交新特性建议\nbody:\n - type: checkboxes\n id: preface\n attributes:\n label: 前置条件\n description: 你好！感谢你为 Halo 提交新特性建议。在开始之前，我们非常推荐阅读一遍[《开源软件指南》](https://opensource.guide/zh-hans/)，这会在很大程度上提高我们彼此的效率。\n options:\n - label: 已经在 [Issues](https://github.com/halo-dev/halo/issues) 列表中搜索了相关问题。\n required: true\n - label: 这是和 Halo 相关的特性，如果是非项目本身的问题，建议在 [Discussions](https://github.com/halo-dev/halo/discussions) 提交。\n required: true\n - label: 如果是插件和主题特性建议，请在对应的插件和主题仓库提交。\n required: true\n - type: markdown\n id: environment\n attributes:\n value: \"## 环境信息\"\n - type: input\n id: version\n attributes:\n label: \"你当前使用的版本\"\n - type: markdown\n id: details\n attributes:\n value: \"## 详细信息\"\n - type: textarea\n id: description\n attributes:\n label: \"描述一下此特性\"\n description: \"为了方便我们管理，请不要在同一个 issue 下提交多个没有相关性的特性。\"\n validations:\n required: true\n - type: textarea\n id: additional-information\n attributes:\n label: \"附加信息\"\n description: \"如果你还有其他需要提供的信息，可以在这里填写（可以提供截图、视频等）。\"" }, { "path": ".github/actions/docker-buildx-push/action.yaml", "content": "name: \"Docker buildx and push\"\ndescription: \"Buildx and push the Docker image.\"\n\ninputs:\n ghcr-token:\n description: Token of current GitHub account in GitHub container registry.\n required: false\n default: \"\"\n dockerhub-user:\n description: \"User name for the DockerHub account\"\n required: false\n default: \"\"\n dockerhub-token:\n description: Token for the DockerHub account\n required: false\n default: \"\"\n f2c-registry-user:\n description: \"User name of Fit2Cloud Docker Registry.\"\n required: false\n default: \"\"\n f2c-registry-token:\n description: \"Token of Fit2Cloud Docker Registry.\"\n required: false\n default: \"\"\n push:\n description: Should push the docker image or not.\n required: false\n default: \"false\"\n platforms:\n description: Target platforms for building image\n required: false\n default: \"linux/amd64,linux/arm/v7,linux/arm64/v8,linux/ppc64le,linux/s390x\"\n image-name:\n description: The basic name of docker.\n required: false\n default: \"halo\"\n\nruns:\n using: \"composite\"\n steps:\n - name: Docker meta for Halo\n id: meta\n uses: docker/metadata-action@v5\n with:\n images: |\n ghcr.io/${{ github.repository_owner }}/${{ inputs.image-name }}\n halohub/${{ inputs.image-name }}\n registry.fit2cloud.com/halo/${{ inputs.image-name }}\n tags: |\n type=schedule,pattern=nightly-{{date 'YYYYMMDD'}},enabled=${{ github.event_name == 'schedule' }}\n type=ref,event=branch,enabled=${{ github.event_name == 'push' }}\n type=ref,event=pr,enabled=${{ github.event_name == 'pull_request' }}\n type=semver,pattern={{major}}\n type=semver,pattern={{major}}.{{minor}}\n type=semver,pattern={{ version }}\n type=sha,enabled=${{ github.event_name == 'push' }}\n flavor: |\n latest=false\n - name: Set up QEMU\n uses: docker/setup-qemu-action@v3\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v3\n - name: Login to GHCR\n uses: docker/login-action@v3\n if: inputs.ghcr-token != '' && github.event_name != 'pull_request'\n with:\n registry: ghcr.io\n username: ${{ github.repository_owner }}\n password: ${{ inputs.ghcr-token }}\n - name: Login to DockerHub\n if: inputs.dockerhub-token != '' && github.event_name != 'pull_request'\n uses: docker/login-action@v3\n with:\n username: ${{ inputs.dockerhub-user }}\n password: ${{ inputs.dockerhub-token }}\n - name: Login to Fit2Cloud Docker Registry\n if: inputs.f2c-registry-token != '' && github.event_name != 'pull_request'\n uses: docker/login-action@v3\n with:\n registry: registry.fit2cloud.com\n username: ${{ inputs.f2c-registry-user }}\n password: ${{ inputs.f2c-registry-token }}\n - name: Build and push\n uses: docker/build-push-action@v5\n with:\n context: .\n file: ./Dockerfile\n platforms: ${{ inputs.platforms }}\n labels: ${{ steps.meta.outputs.labels }}\n tags: ${{ steps.meta.outputs.tags }}\n push: ${{ (inputs.ghcr-token != '' || inputs.dockerhub-token != '') && inputs.push == 'true' }}\n" }, { "path": ".github/actions/setup-env/action.yaml", "content": "name: Setup Environment\ndescription: Setup environment to check and build Halo, including console and core projects.\n\ninputs:\n node-version:\n description: Node.js version.\n required: false\n default: \"24\"\n\n pnpm-version:\n description: pnpm version.\n required: false\n default: \"10\"\n\n java-version:\n description: Java version.\n required: false\n default: \"21\"\n\nruns:\n using: \"composite\"\n steps:\n - uses: pnpm/action-setup@v3\n name: Setup pnpm\n with:\n version: ${{ inputs.pnpm-version }}\n\n - name: Set up Node.js\n uses: actions/setup-node@v4\n with:\n node-version: ${{ inputs.node-version }}\n cache: \"pnpm\"\n cache-dependency-path: \"ui/pnpm-lock.yaml\"\n\n - name: Setup JDK\n uses: actions/setup-java@v4\n with:\n distribution: \"temurin\"\n cache: \"gradle\"\n java-version: ${{ inputs.java-version }}\n" }, { "path": ".github/pull_request_template.md", "content": "\n\n#### What type of PR is this?\n\n\n\n#### What this PR does / why we need it:\n\n#### Which issue(s) this PR fixes:\n\n\nFixes #\n\n#### Special notes for your reviewer:\n\n#### Does this PR introduce a user-facing change?\n\n\n\n```release-note\n```\n" }, { "path": ".github/workflows/halo.yaml", "content": "name: Halo Workflow\n\non:\n pull_request:\n branches:\n - main\n - release-*\n paths:\n - \"**\"\n - \"!**.md\"\n push:\n branches:\n - main\n - release-*\n paths:\n - \"**\"\n - \"!**.md\"\n release:\n types:\n - published\n\nconcurrency: \n group: ${{github.workflow}} - ${{github.ref}}\n cancel-in-progress: true\n\njobs:\n test:\n if: github.event_name == 'pull_request' || github.event_name == 'push'\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - name: Setup Environment\n uses: ./.github/actions/setup-env\n - name: Check Halo\n run: ./gradlew clean check --configuration-cache --configuration-cache-problems=warn\n - name: Upload coverage reports to Codecov\n if: github.repository == 'halo-dev/halo'\n uses: codecov/codecov-action@v4\n\n build:\n runs-on: ubuntu-latest\n if: always() && (needs.test.result == 'skipped' || needs.test.result == 'success')\n needs: test\n steps:\n - uses: actions/checkout@v4\n - name: Setup Environment\n uses: ./.github/actions/setup-env\n - name: Reset version of Halo\n if: github.event_name == 'release'\n shell: bash\n run: |\n # Set the version with tag name when releasing\n version=${{ github.event.release.tag_name }}\n version=${version#v}\n sed -i \"s/version=.*-SNAPSHOT$/version=$version/1\" gradle.properties\n - name: Build Halo\n run: ./gradlew clean downloadPluginPresets build -x check --configuration-cache --configuration-cache-problems=warn\n - name: Upload Artifacts\n if: github.repository == 'halo-dev/halo'\n uses: actions/upload-artifact@v4\n with:\n name: halo-artifacts\n path: application/build/libs\n retention-days: 1\n\n github-release:\n runs-on: ubuntu-latest\n if: always() && needs.build.result == 'success' && github.event_name == 'release'\n needs: build\n steps:\n - uses: actions/checkout@v4\n - name: Download Artifacts\n uses: actions/download-artifact@v4\n with:\n name: halo-artifacts\n path: application/build/libs\n - name: Upload Artifacts\n if: github.repository == 'halo-dev/halo'\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: gh release upload ${{ github.event.release.tag_name }} application/build/libs/*\n\n build-and-publish-container-image-with-buildpacks:\n needs: build\n if: always() && needs.build.result == 'success' && (github.event_name == 'push' || github.event_name == 'release')\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - name: Setup Environment\n uses: ./.github/actions/setup-env\n - name: Reset version of Halo\n if: github.event_name == 'release'\n shell: bash\n run: |\n # Set the version with tag name when releasing\n version=${{ github.event.release.tag_name }}\n version=${version#v}\n sed -i \"s/version=.*-SNAPSHOT$/version=$version/1\" gradle.properties\n - name: Publish To Container Registries\n env:\n DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}\n DOCKER_TOKEN: ${{ secrets.DOCKER_TOKEN }}\n F2C_USERNAME: ${{ secrets.F2C_REGISTRY_USER }}\n F2C_TOKEN: ${{ secrets.F2C_REGISTRY_TOKEN }}\n GHCR_USERNAME: ${{ github.repository_owner }}\n GHCR_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run:\n ./gradlew publishToAllRegistries -Prelease=${{ github.event_name == 'release' && 'true' || 'false' }}\n\n docker-build-and-push:\n if: always() && needs.build.result == 'success' && (github.event_name == 'push' || github.event_name == 'release')\n runs-on: ubuntu-latest\n needs: build\n steps:\n - uses: actions/checkout@v4\n - name: Download Artifacts\n uses: actions/download-artifact@v4\n with:\n name: halo-artifacts\n path: application/build/libs\n - name: Docker Buildx and Push\n uses: ./.github/actions/docker-buildx-push\n with:\n image-name: ${{ github.event_name == 'release' && 'halo' || 'halo-dev' }}\n ghcr-token: ${{ secrets.GITHUB_TOKEN }}\n dockerhub-user: ${{ secrets.DOCKER_USERNAME }}\n dockerhub-token: ${{ secrets.DOCKER_TOKEN }}\n f2c-registry-user: ${{ secrets.F2C_REGISTRY_USER }}\n f2c-registry-token: ${{ secrets.F2C_REGISTRY_TOKEN }}\n push: true\n platforms: linux/amd64,linux/arm64/v8,linux/ppc64le,linux/s390x\n\n e2e-test:\n if: always() && needs.build.result == 'success' && (github.event_name == 'pull_request' || github.event_name == 'push')\n runs-on: ubuntu-latest\n needs: build\n steps:\n - uses: actions/checkout@v4\n - name: Download Artifacts\n uses: actions/download-artifact@v4\n with:\n name: halo-artifacts\n path: application/build/libs\n - name: Docker Build\n uses: docker/build-push-action@v5\n with:\n tags: ghcr.io/halo-dev/halo-dev:main\n push: false\n context: .\n - name: E2E Testing\n continue-on-error: true\n run: |\n sudo curl -L https://github.com/docker/compose/releases/download/v2.23.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose\n sudo chmod u+x /usr/local/bin/docker-compose\n cd e2e && make all\n" }, { "path": ".github/workflows/openapi-check.yaml", "content": "name: OpenAPI Check\n\non:\n pull_request:\n branches:\n - main\n - release-*\n paths:\n - 'application/src/**'\n - 'api/src/**'\n - 'api-docs/openapi/**'\n - 'ui/packages/api-client/**'\n push:\n branches:\n - main\n - release-*\n paths:\n - 'application/src/**'\n - 'api/src/**'\n - 'api-docs/openapi/**'\n - 'ui/packages/api-client/**'\n\nconcurrency:\n group: ${{github.workflow}} - ${{github.ref}}\n cancel-in-progress: true\n\njobs:\n openapi-check:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - name: Setup Environment\n uses: ./.github/actions/setup-env\n - name: Install UI dependencies\n run: ./gradlew pnpmInstall\n - name: Regenerate OpenAPI docs\n run: ./gradlew generateOpenApiDocs --no-configuration-cache\n - name: Regenerate api-client\n run: cd ui && pnpm run api-client:gen\n - name: Verify OpenAPI docs and api-client are in sync\n run: |\n if ! git diff --exit-code -- api-docs/openapi ui/packages/api-client/src; then\n echo \"::error::OpenAPI docs or api-client generated code is out of sync with the current API. Run './gradlew generateOpenApiDocs --no-configuration-cache' and 'cd ui && pnpm run api-client:gen', then commit the changes under api-docs/openapi and ui/packages/api-client/src.\"\n git diff --stat api-docs/openapi ui/packages/api-client/src\n exit 1\n fi\n" }, { "path": ".github/workflows/packages-preview-release.yaml", "content": "name: \"Packages preview release\"\non:\n push:\n paths:\n - \"ui/packages/**\"\n branches:\n - main\n pull_request:\n paths:\n - \"ui/packages/**\"\n branches:\n - main\njobs:\n packages-preview-release:\n runs-on: ubuntu-latest\n if: github.repository == 'halo-dev/halo'\n steps:\n - uses: actions/checkout@v4\n - name: Setup Environment\n uses: ./.github/actions/setup-env\n\n - name: Install Dependencies\n run: ./gradlew pnpmInstall\n\n - name: Build Packages\n run: cd ui && pnpm build:packages\n\n - name: Release\n run: cd ui && pnpx pkg-pr-new publish --compact --pnpm './packages/*'\n" }, { "path": ".github/workflows/release-ui-packages.yaml", "content": "name: Release UI Packages\n\non:\n release:\n types:\n - published\n\npermissions:\n contents: write\n id-token: write\n\njobs:\n release:\n runs-on: ubuntu-latest\n if: github.repository == 'halo-dev/halo' && github.event.release.prerelease == false\n steps:\n - uses: actions/checkout@v4\n with:\n fetch-depth: 0\n - name: Setup Environment\n uses: ./.github/actions/setup-env\n - run: ./gradlew pnpmInstall\n - name: Publish to NPM\n run: cd ui && pnpm run publish:packages\n" }, { "path": ".github/workflows/stale-issues.yaml", "content": "name: Close Stale Issues\n\non:\n schedule:\n - cron: \"30 1 * * *\"\n workflow_dispatch:\n\npermissions:\n issues: write\n\njobs:\n stale:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/stale@v10\n with:\n stale-issue-message: |\n This issue has been automatically marked as stale because it has not had recent activity.\n It will be closed if no further activity occurs within the next 2 days.\n If you believe this issue is still relevant, please provide the requested information.\n close-issue-message: |\n This issue has been automatically closed due to inactivity.\n If you have the requested information, feel free to reopen it or create a new issue.\n days-before-issue-stale: 60\n days-before-issue-close: 2\n days-before-pr-stale: -1\n days-before-pr-close: -1\n stale-issue-label: \"lifecycle/stale\"\n any-of-issue-labels: \"triage/needs-information,priority/awaiting-more-evidence,help wanted\"\n operations-per-run: 100\n ascending: true\n" }, { "path": ".gitignore", "content": "### Maven\ntarget/\nlogs/\n!.mvn/wrapper/maven-wrapper.jar\n\n### Gradle\n.gradle\nbuild/\nout/\n!gradle/wrapper/gradle-wrapper.jar\nbin/\n\n### STS ###\n.apt_generated\n.classpath\n.factorypath\n.project\n.settings\n.springBeans\n.sts4-cache\n\n### IntelliJ IDEA ###\n.idea\n*.iws\n*.iml\n*.ipr\nlog/\n\n### NetBeans ###\nnbproject/private/\nbuild/\nnbbuild/\ndist/\nnbdist/\n.nb-gradle/\n\n### Mac\n.DS_Store\n*/.DS_Store\n\n### VS Code ###\n*.project\n*.factorypath\n\n### Compiled class file\n*.class\n\n### Log file\n*.log\n\n### BlueJ files\n*.ctxt\n\n### Mobile Tools for Java (J2ME)\n.mtj.tmp/\n\n### Package Files\n*.war\n*.nar\n*.ear\n*.zip\n*.tar.gz\n*.rar\n\n### VSCode\n.vscode\n!.vscode/settings.json\n!.vscode/extensions.json\n\n### Local file\napplication-local.yml\napplication-local.yaml\napplication-local.properties\n\n### Zip file for test\n!application/src/test/resources/themes/*.zip\n!application/src/main/resources/themes/*.zip\napplication/src/main/resources/console/\napplication/src/main/resources/uc/\napplication/src/main/resources/presets/\n\n### Node\nnode_modules\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\nlerna-debug.log*\n\n### Frontend\ndist\ncoverage\n*.local\n\n### Cypress\n/cypress/videos/\n/cypress/screenshots/\n\n### Frontend build\n!src/build\nstorybook-static\ntsconfig.tsbuildinfo\n.tgz" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nWe as members, contributors, and leaders pledge to make participation in our\ncommunity a harassment-free experience for everyone, regardless of age, body\nsize, visible or invisible disability, ethnicity, sex characteristics, gender\nidentity and expression, level of experience, education, socio-economic status,\nnationality, personal appearance, race, religion, or sexual identity\nand orientation.\n\nWe pledge to act and interact in ways that contribute to an open, welcoming,\ndiverse, inclusive, and healthy community.\n\n## Our Standards\n\nExamples of behavior that contributes to a positive environment for our\ncommunity include:\n\n* Demonstrating empathy and kindness toward other people\n* Being respectful of differing opinions, viewpoints, and experiences\n* Giving and gracefully accepting constructive feedback\n* Accepting responsibility and apologizing to those affected by our mistakes,\n and learning from the experience\n* Focusing on what is best not just for us as individuals, but for the\n overall community\n\nExamples of unacceptable behavior include:\n\n* The use of sexualized language or imagery, and sexual attention or\n advances of any kind\n* Trolling, insulting or derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or email\n address, without their explicit permission\n* Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Enforcement Responsibilities\n\nCommunity leaders are responsible for clarifying and enforcing our standards of\nacceptable behavior and will take appropriate and fair corrective action in\nresponse to any behavior that they deem inappropriate, threatening, offensive,\nor harmful.\n\nCommunity leaders have the right and responsibility to remove, edit, or reject\ncomments, commits, code, wiki edits, issues, and other contributions that are\nnot aligned to this Code of Conduct, and will communicate reasons for moderation\ndecisions when appropriate.\n\n## Scope\n\nThis Code of Conduct applies within all community spaces, and also applies when\nan individual is officially representing the community in public spaces.\nExamples of representing our community include using an official e-mail address,\nposting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported to the community leaders responsible for enforcement at\nhi@halo.run.\nAll complaints will be reviewed and investigated promptly and fairly.\n\nAll community leaders are obligated to respect the privacy and security of the\nreporter of any incident.\n\n## Enforcement Guidelines\n\nCommunity leaders will follow these Community Impact Guidelines in determining\nthe consequences for any action they deem in violation of this Code of Conduct:\n\n### 1. Correction\n\n**Community Impact**: Use of inappropriate language or other behavior deemed\nunprofessional or unwelcome in the community.\n\n**Consequence**: A private, written warning from community leaders, providing\nclarity around the nature of the violation and an explanation of why the\nbehavior was inappropriate. A public apology may be requested.\n\n### 2. Warning\n\n**Community Impact**: A violation through a single incident or series\nof actions.\n\n**Consequence**: A warning with consequences for continued behavior. No\ninteraction with the people involved, including unsolicited interaction with\nthose enforcing the Code of Conduct, for a specified period of time. This\nincludes avoiding interactions in community spaces as well as external channels\nlike social media. Violating these terms may lead to a temporary or\npermanent ban.\n\n### 3. Temporary Ban\n\n**Community Impact**: A serious violation of community standards, including\nsustained inappropriate behavior.\n\n**Consequence**: A temporary ban from any sort of interaction or public\ncommunication with the community for a specified period of time. No public or\nprivate interaction with the people involved, including unsolicited interaction\nwith those enforcing the Code of Conduct, is allowed during this period.\nViolating these terms may lead to a permanent ban.\n\n### 4. Permanent Ban\n\n**Community Impact**: Demonstrating a pattern of violation of community\nstandards, including sustained inappropriate behavior, harassment of an\nindividual, or aggression toward or disparagement of classes of individuals.\n\n**Consequence**: A permanent ban from any sort of public interaction within\nthe community.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage],\nversion 2.0, available at\nhttps://www.contributor-covenant.org/version/2/0/code_of_conduct.html.\n\nCommunity Impact Guidelines were inspired by [Mozilla's code of conduct\nenforcement ladder](https://github.com/mozilla/diversity).\n\n[homepage]: https://www.contributor-covenant.org\n\nFor answers to common questions about this code of conduct, see the FAQ at\nhttps://www.contributor-covenant.org/faq. Translations are available at\nhttps://www.contributor-covenant.org/translations.\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing Guide\n\nThank you for your interest in contributing to Halo.\n\nThis document explains the recommended workflow for submitting high-quality contributions, including code, tests, and documentation updates.\n\n## Before You Start\n\n- For new features or major behavior changes, please open an issue first so we can align on scope and design.\n- For clear bug fixes, you can submit a pull request directly.\n- If your report is not about the core project itself (for example, deployment questions), please use Discussions instead of Issues.\n\n## Development Environment\n\nThis repository mainly contains:\n\n- Backend and platform modules built with Gradle.\n- Frontend code in `ui`, managed with `pnpm` workspaces.\n\n### Prerequisites\n\n- Git\n- JDK (version compatible with the project build)\n- Node.js and `pnpm` (see `ui/package.json` for the current package manager)\n- Docker / Docker Compose (required for e2e scenarios)\n\n## Contribution Workflow\n\n### 1. Fork and Clone\n\nFork this repository, then clone your fork:\n\n```bash\ngit clone https://github.com/{YOUR_USERNAME}/{REPOSITORY}.git\ncd {REPOSITORY}\n```\n\n### 2. Add Upstream Remote\n\n```bash\ngit remote add upstream https://github.com/halo-dev/halo.git\ngit fetch upstream\n```\n\n### 3. Create a Branch\n\nUse a focused branch name that reflects your change:\n\n```bash\ngit checkout -b feat/short-description\n```\n\n### 4. Implement and Validate\n\nRun relevant checks before opening a PR.\n\nBackend and general checks:\n\n```bash\n./gradlew clean check\n```\n\nFrontend checks (in `ui`):\n\n```bash\ncd ui\npnpm install\npnpm build:packages\npnpm lint\npnpm typecheck\npnpm test:unit\n```\n\n### 5. Commit and Push\n\n```bash\ngit push origin \n```\n\n### 6. Open a Pull Request\n\nOpen a PR from your branch to `main` and fill out the PR template carefully:\n\n- Describe what changed and why.\n- Link related issues (for example, `Fixes #123`).\n- Add release note content or `NONE` when no user-facing change is introduced.\n- Add proper `/kind` labels as requested in the template.\n\n## AI-Assisted Contribution Policy\n\nAI-assisted development is not prohibited, including code generation and refactoring support.\n\nHowever, you are fully responsible for any code in your PR.\n\nIf you used AI tools, please follow these rules:\n\n- Review all AI-generated content before submission.\n- Verify correctness, security, performance, and maintainability.\n- Ensure generated code follows project conventions and architecture.\n- Remove low-quality or redundant generated code.\n- Mention AI assistance in your PR description when AI materially contributed to the final changes.\n\nIn short: AI assistance is allowed, but unreviewed AI output is not acceptable.\n\n## Testing Expectations\n\n- Add or update tests whenever you change behavior.\n- If you add or modify APIs, please include corresponding e2e test cases.\n- See `e2e/README.md` for e2e workflow and local execution details.\n\n## Coding Standards\n\n- Follow the project coding style guide: \n- Keep changes focused and avoid unrelated refactors in the same PR.\n- Run formatters and linters before pushing.\n\n## Keep Your Fork Updated\n\nBefore starting new work, sync your branch with upstream:\n\n```bash\ngit fetch upstream\ngit checkout main\ngit merge upstream/main\ngit push origin main\n```\n\n## Need Help?\n\n- Open an issue for confirmed bugs and feature proposals.\n- Use Discussions for general questions and usage/deployment topics.\n\nThanks again for helping improve Halo.\n" }, { "path": "Dockerfile", "content": "FROM eclipse-temurin:21-jre as builder\n\nWORKDIR application\nARG JAR_FILE=application/build/libs/*.jar\nCOPY ${JAR_FILE} application.jar\nRUN java -Djarmode=layertools -jar application.jar extract\n\n################################\n\nFROM ibm-semeru-runtimes:open-21-jre\nLABEL maintainer=\"johnniang \"\nWORKDIR application\nCOPY --from=builder application/dependencies/ ./\nCOPY --from=builder application/spring-boot-loader/ ./\nCOPY --from=builder application/snapshot-dependencies/ ./\nCOPY --from=builder application/application/ ./\n\nENV JVM_OPTS=\"\" \\\n HALO_WORK_DIR=\"/root/.halo2\" \\\n SPRING_CONFIG_LOCATION=\"optional:classpath:/;optional:file:/root/.halo2/\" \\\n TZ=Asia/Shanghai\n\nRUN ln -sf /usr/share/zoneinfo/$TZ /etc/localtime \\\n && echo $TZ > /etc/timezone\n\nExpose 8090\n\nENTRYPOINT [\"sh\", \"-c\", \"java ${JVM_OPTS} org.springframework.boot.loader.launch.JarLauncher ${0} ${@}\"]\n" }, { "path": "LICENSE", "content": " GNU GENERAL PUBLIC LICENSE\n Version 3, 29 June 2007\n\n Copyright (C) 2007 Free Software Foundation, Inc. \n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n Preamble\n\n The GNU General Public License is a free, copyleft license for\nsoftware and other kinds of works.\n\n The licenses for most software and other practical works are designed\nto take away your freedom to share and change the works. By contrast,\nthe GNU General Public License is intended to guarantee your freedom to\nshare and change all versions of a program--to make sure it remains free\nsoftware for all its users. We, the Free Software Foundation, use the\nGNU General Public License for most of our software; it applies also to\nany other work released this way by its authors. You can apply it to\nyour programs, too.\n\n When we speak of free software, we are referring to freedom, not\nprice. Our General Public Licenses are designed to make sure that you\nhave the freedom to distribute copies of free software (and charge for\nthem if you wish), that you receive source code or can get it if you\nwant it, that you can change the software or use pieces of it in new\nfree programs, and that you know you can do these things.\n\n To protect your rights, we need to prevent others from denying you\nthese rights or asking you to surrender the rights. Therefore, you have\ncertain responsibilities if you distribute copies of the software, or if\nyou modify it: responsibilities to respect the freedom of others.\n\n For example, if you distribute copies of such a program, whether\ngratis or for a fee, you must pass on to the recipients the same\nfreedoms that you received. You must make sure that they, too, receive\nor can get the source code. And you must show them these terms so they\nknow their rights.\n\n Developers that use the GNU GPL protect your rights with two steps:\n(1) assert copyright on the software, and (2) offer you this License\ngiving you legal permission to copy, distribute and/or modify it.\n\n For the developers' and authors' protection, the GPL clearly explains\nthat there is no warranty for this free software. For both users' and\nauthors' sake, the GPL requires that modified versions be marked as\nchanged, so that their problems will not be attributed erroneously to\nauthors of previous versions.\n\n Some devices are designed to deny users access to install or run\nmodified versions of the software inside them, although the manufacturer\ncan do so. This is fundamentally incompatible with the aim of\nprotecting users' freedom to change the software. The systematic\npattern of such abuse occurs in the area of products for individuals to\nuse, which is precisely where it is most unacceptable. Therefore, we\nhave designed this version of the GPL to prohibit the practice for those\nproducts. If such problems arise substantially in other domains, we\nstand ready to extend this provision to those domains in future versions\nof the GPL, as needed to protect the freedom of users.\n\n Finally, every program is threatened constantly by software patents.\nStates should not allow patents to restrict development and use of\nsoftware on general-purpose computers, but in those that do, we wish to\navoid the special danger that patents applied to a free program could\nmake it effectively proprietary. To prevent this, the GPL assures that\npatents cannot be used to render the program non-free.\n\n The precise terms and conditions for copying, distribution and\nmodification follow.\n\n TERMS AND CONDITIONS\n\n 0. Definitions.\n\n \"This License\" refers to version 3 of the GNU General Public License.\n\n \"Copyright\" also means copyright-like laws that apply to other kinds of\nworks, such as semiconductor masks.\n\n \"The Program\" refers to any copyrightable work licensed under this\nLicense. Each licensee is addressed as \"you\". \"Licensees\" and\n\"recipients\" may be individuals or organizations.\n\n To \"modify\" a work means to copy from or adapt all or part of the work\nin a fashion requiring copyright permission, other than the making of an\nexact copy. The resulting work is called a \"modified version\" of the\nearlier work or a work \"based on\" the earlier work.\n\n A \"covered work\" means either the unmodified Program or a work based\non the Program.\n\n To \"propagate\" a work means to do anything with it that, without\npermission, would make you directly or secondarily liable for\ninfringement under applicable copyright law, except executing it on a\ncomputer or modifying a private copy. Propagation includes copying,\ndistribution (with or without modification), making available to the\npublic, and in some countries other activities as well.\n\n To \"convey\" a work means any kind of propagation that enables other\nparties to make or receive copies. Mere interaction with a user through\na computer network, with no transfer of a copy, is not conveying.\n\n An interactive user interface displays \"Appropriate Legal Notices\"\nto the extent that it includes a convenient and prominently visible\nfeature that (1) displays an appropriate copyright notice, and (2)\ntells the user that there is no warranty for the work (except to the\nextent that warranties are provided), that licensees may convey the\nwork under this License, and how to view a copy of this License. If\nthe interface presents a list of user commands or options, such as a\nmenu, a prominent item in the list meets this criterion.\n\n 1. Source Code.\n\n The \"source code\" for a work means the preferred form of the work\nfor making modifications to it. \"Object code\" means any non-source\nform of a work.\n\n A \"Standard Interface\" means an interface that either is an official\nstandard defined by a recognized standards body, or, in the case of\ninterfaces specified for a particular programming language, one that\nis widely used among developers working in that language.\n\n The \"System Libraries\" of an executable work include anything, other\nthan the work as a whole, that (a) is included in the normal form of\npackaging a Major Component, but which is not part of that Major\nComponent, and (b) serves only to enable use of the work with that\nMajor Component, or to implement a Standard Interface for which an\nimplementation is available to the public in source code form. A\n\"Major Component\", in this context, means a major essential component\n(kernel, window system, and so on) of the specific operating system\n(if any) on which the executable work runs, or a compiler used to\nproduce the work, or an object code interpreter used to run it.\n\n The \"Corresponding Source\" for a work in object code form means all\nthe source code needed to generate, install, and (for an executable\nwork) run the object code and to modify the work, including scripts to\ncontrol those activities. However, it does not include the work's\nSystem Libraries, or general-purpose tools or generally available free\nprograms which are used unmodified in performing those activities but\nwhich are not part of the work. For example, Corresponding Source\nincludes interface definition files associated with source files for\nthe work, and the source code for shared libraries and dynamically\nlinked subprograms that the work is specifically designed to require,\nsuch as by intimate data communication or control flow between those\nsubprograms and other parts of the work.\n\n The Corresponding Source need not include anything that users\ncan regenerate automatically from other parts of the Corresponding\nSource.\n\n The Corresponding Source for a work in source code form is that\nsame work.\n\n 2. Basic Permissions.\n\n All rights granted under this License are granted for the term of\ncopyright on the Program, and are irrevocable provided the stated\nconditions are met. This License explicitly affirms your unlimited\npermission to run the unmodified Program. The output from running a\ncovered work is covered by this License only if the output, given its\ncontent, constitutes a covered work. This License acknowledges your\nrights of fair use or other equivalent, as provided by copyright law.\n\n You may make, run and propagate covered works that you do not\nconvey, without conditions so long as your license otherwise remains\nin force. You may convey covered works to others for the sole purpose\nof having them make modifications exclusively for you, or provide you\nwith facilities for running those works, provided that you comply with\nthe terms of this License in conveying all material for which you do\nnot control copyright. Those thus making or running the covered works\nfor you must do so exclusively on your behalf, under your direction\nand control, on terms that prohibit them from making any copies of\nyour copyrighted material outside their relationship with you.\n\n Conveying under any other circumstances is permitted solely under\nthe conditions stated below. Sublicensing is not allowed; section 10\nmakes it unnecessary.\n\n 3. Protecting Users' Legal Rights From Anti-Circumvention Law.\n\n No covered work shall be deemed part of an effective technological\nmeasure under any applicable law fulfilling obligations under article\n11 of the WIPO copyright treaty adopted on 20 December 1996, or\nsimilar laws prohibiting or restricting circumvention of such\nmeasures.\n\n When you convey a covered work, you waive any legal power to forbid\ncircumvention of technological measures to the extent such circumvention\nis effected by exercising rights under this License with respect to\nthe covered work, and you disclaim any intention to limit operation or\nmodification of the work as a means of enforcing, against the work's\nusers, your or third parties' legal rights to forbid circumvention of\ntechnological measures.\n\n 4. Conveying Verbatim Copies.\n\n You may convey verbatim copies of the Program's source code as you\nreceive it, in any medium, provided that you conspicuously and\nappropriately publish on each copy an appropriate copyright notice;\nkeep intact all notices stating that this License and any\nnon-permissive terms added in accord with section 7 apply to the code;\nkeep intact all notices of the absence of any warranty; and give all\nrecipients a copy of this License along with the Program.\n\n You may charge any price or no price for each copy that you convey,\nand you may offer support or warranty protection for a fee.\n\n 5. Conveying Modified Source Versions.\n\n You may convey a work based on the Program, or the modifications to\nproduce it from the Program, in the form of source code under the\nterms of section 4, provided that you also meet all of these conditions:\n\n a) The work must carry prominent notices stating that you modified\n it, and giving a relevant date.\n\n b) The work must carry prominent notices stating that it is\n released under this License and any conditions added under section\n 7. This requirement modifies the requirement in section 4 to\n \"keep intact all notices\".\n\n c) You must license the entire work, as a whole, under this\n License to anyone who comes into possession of a copy. This\n License will therefore apply, along with any applicable section 7\n additional terms, to the whole of the work, and all its parts,\n regardless of how they are packaged. This License gives no\n permission to license the work in any other way, but it does not\n invalidate such permission if you have separately received it.\n\n d) If the work has interactive user interfaces, each must display\n Appropriate Legal Notices; however, if the Program has interactive\n interfaces that do not display Appropriate Legal Notices, your\n work need not make them do so.\n\n A compilation of a covered work with other separate and independent\nworks, which are not by their nature extensions of the covered work,\nand which are not combined with it such as to form a larger program,\nin or on a volume of a storage or distribution medium, is called an\n\"aggregate\" if the compilation and its resulting copyright are not\nused to limit the access or legal rights of the compilation's users\nbeyond what the individual works permit. Inclusion of a covered work\nin an aggregate does not cause this License to apply to the other\nparts of the aggregate.\n\n 6. Conveying Non-Source Forms.\n\n You may convey a covered work in object code form under the terms\nof sections 4 and 5, provided that you also convey the\nmachine-readable Corresponding Source under the terms of this License,\nin one of these ways:\n\n a) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by the\n Corresponding Source fixed on a durable physical medium\n customarily used for software interchange.\n\n b) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by a\n written offer, valid for at least three years and valid for as\n long as you offer spare parts or customer support for that product\n model, to give anyone who possesses the object code either (1) a\n copy of the Corresponding Source for all the software in the\n product that is covered by this License, on a durable physical\n medium customarily used for software interchange, for a price no\n more than your reasonable cost of physically performing this\n conveying of source, or (2) access to copy the\n Corresponding Source from a network server at no charge.\n\n c) Convey individual copies of the object code with a copy of the\n written offer to provide the Corresponding Source. This\n alternative is allowed only occasionally and noncommercially, and\n only if you received the object code with such an offer, in accord\n with subsection 6b.\n\n d) Convey the object code by offering access from a designated\n place (gratis or for a charge), and offer equivalent access to the\n Corresponding Source in the same way through the same place at no\n further charge. You need not require recipients to copy the\n Corresponding Source along with the object code. If the place to\n copy the object code is a network server, the Corresponding Source\n may be on a different server (operated by you or a third party)\n that supports equivalent copying facilities, provided you maintain\n clear directions next to the object code saying where to find the\n Corresponding Source. Regardless of what server hosts the\n Corresponding Source, you remain obligated to ensure that it is\n available for as long as needed to satisfy these requirements.\n\n e) Convey the object code using peer-to-peer transmission, provided\n you inform other peers where the object code and Corresponding\n Source of the work are being offered to the general public at no\n charge under subsection 6d.\n\n A separable portion of the object code, whose source code is excluded\nfrom the Corresponding Source as a System Library, need not be\nincluded in conveying the object code work.\n\n A \"User Product\" is either (1) a \"consumer product\", which means any\ntangible personal property which is normally used for personal, family,\nor household purposes, or (2) anything designed or sold for incorporation\ninto a dwelling. In determining whether a product is a consumer product,\ndoubtful cases shall be resolved in favor of coverage. For a particular\nproduct received by a particular user, \"normally used\" refers to a\ntypical or common use of that class of product, regardless of the status\nof the particular user or of the way in which the particular user\nactually uses, or expects or is expected to use, the product. A product\nis a consumer product regardless of whether the product has substantial\ncommercial, industrial or non-consumer uses, unless such uses represent\nthe only significant mode of use of the product.\n\n \"Installation Information\" for a User Product means any methods,\nprocedures, authorization keys, or other information required to install\nand execute modified versions of a covered work in that User Product from\na modified version of its Corresponding Source. The information must\nsuffice to ensure that the continued functioning of the modified object\ncode is in no case prevented or interfered with solely because\nmodification has been made.\n\n If you convey an object code work under this section in, or with, or\nspecifically for use in, a User Product, and the conveying occurs as\npart of a transaction in which the right of possession and use of the\nUser Product is transferred to the recipient in perpetuity or for a\nfixed term (regardless of how the transaction is characterized), the\nCorresponding Source conveyed under this section must be accompanied\nby the Installation Information. But this requirement does not apply\nif neither you nor any third party retains the ability to install\nmodified object code on the User Product (for example, the work has\nbeen installed in ROM).\n\n The requirement to provide Installation Information does not include a\nrequirement to continue to provide support service, warranty, or updates\nfor a work that has been modified or installed by the recipient, or for\nthe User Product in which it has been modified or installed. Access to a\nnetwork may be denied when the modification itself materially and\nadversely affects the operation of the network or violates the rules and\nprotocols for communication across the network.\n\n Corresponding Source conveyed, and Installation Information provided,\nin accord with this section must be in a format that is publicly\ndocumented (and with an implementation available to the public in\nsource code form), and must require no special password or key for\nunpacking, reading or copying.\n\n 7. Additional Terms.\n\n \"Additional permissions\" are terms that supplement the terms of this\nLicense by making exceptions from one or more of its conditions.\nAdditional permissions that are applicable to the entire Program shall\nbe treated as though they were included in this License, to the extent\nthat they are valid under applicable law. If additional permissions\napply only to part of the Program, that part may be used separately\nunder those permissions, but the entire Program remains governed by\nthis License without regard to the additional permissions.\n\n When you convey a copy of a covered work, you may at your option\nremove any additional permissions from that copy, or from any part of\nit. (Additional permissions may be written to require their own\nremoval in certain cases when you modify the work.) You may place\nadditional permissions on material, added by you to a covered work,\nfor which you have or can give appropriate copyright permission.\n\n Notwithstanding any other provision of this License, for material you\nadd to a covered work, you may (if authorized by the copyright holders of\nthat material) supplement the terms of this License with terms:\n\n a) Disclaiming warranty or limiting liability differently from the\n terms of sections 15 and 16 of this License; or\n\n b) Requiring preservation of specified reasonable legal notices or\n author attributions in that material or in the Appropriate Legal\n Notices displayed by works containing it; or\n\n c) Prohibiting misrepresentation of the origin of that material, or\n requiring that modified versions of such material be marked in\n reasonable ways as different from the original version; or\n\n d) Limiting the use for publicity purposes of names of licensors or\n authors of the material; or\n\n e) Declining to grant rights under trademark law for use of some\n trade names, trademarks, or service marks; or\n\n f) Requiring indemnification of licensors and authors of that\n material by anyone who conveys the material (or modified versions of\n it) with contractual assumptions of liability to the recipient, for\n any liability that these contractual assumptions directly impose on\n those licensors and authors.\n\n All other non-permissive additional terms are considered \"further\nrestrictions\" within the meaning of section 10. If the Program as you\nreceived it, or any part of it, contains a notice stating that it is\ngoverned by this License along with a term that is a further\nrestriction, you may remove that term. If a license document contains\na further restriction but permits relicensing or conveying under this\nLicense, you may add to a covered work material governed by the terms\nof that license document, provided that the further restriction does\nnot survive such relicensing or conveying.\n\n If you add terms to a covered work in accord with this section, you\nmust place, in the relevant source files, a statement of the\nadditional terms that apply to those files, or a notice indicating\nwhere to find the applicable terms.\n\n Additional terms, permissive or non-permissive, may be stated in the\nform of a separately written license, or stated as exceptions;\nthe above requirements apply either way.\n\n 8. Termination.\n\n You may not propagate or modify a covered work except as expressly\nprovided under this License. Any attempt otherwise to propagate or\nmodify it is void, and will automatically terminate your rights under\nthis License (including any patent licenses granted under the third\nparagraph of section 11).\n\n However, if you cease all violation of this License, then your\nlicense from a particular copyright holder is reinstated (a)\nprovisionally, unless and until the copyright holder explicitly and\nfinally terminates your license, and (b) permanently, if the copyright\nholder fails to notify you of the violation by some reasonable means\nprior to 60 days after the cessation.\n\n Moreover, your license from a particular copyright holder is\nreinstated permanently if the copyright holder notifies you of the\nviolation by some reasonable means, this is the first time you have\nreceived notice of violation of this License (for any work) from that\ncopyright holder, and you cure the violation prior to 30 days after\nyour receipt of the notice.\n\n Termination of your rights under this section does not terminate the\nlicenses of parties who have received copies or rights from you under\nthis License. If your rights have been terminated and not permanently\nreinstated, you do not qualify to receive new licenses for the same\nmaterial under section 10.\n\n 9. Acceptance Not Required for Having Copies.\n\n You are not required to accept this License in order to receive or\nrun a copy of the Program. Ancillary propagation of a covered work\noccurring solely as a consequence of using peer-to-peer transmission\nto receive a copy likewise does not require acceptance. However,\nnothing other than this License grants you permission to propagate or\nmodify any covered work. These actions infringe copyright if you do\nnot accept this License. Therefore, by modifying or propagating a\ncovered work, you indicate your acceptance of this License to do so.\n\n 10. Automatic Licensing of Downstream Recipients.\n\n Each time you convey a covered work, the recipient automatically\nreceives a license from the original licensors, to run, modify and\npropagate that work, subject to this License. You are not responsible\nfor enforcing compliance by third parties with this License.\n\n An \"entity transaction\" is a transaction transferring control of an\norganization, or substantially all assets of one, or subdividing an\norganization, or merging organizations. If propagation of a covered\nwork results from an entity transaction, each party to that\ntransaction who receives a copy of the work also receives whatever\nlicenses to the work the party's predecessor in interest had or could\ngive under the previous paragraph, plus a right to possession of the\nCorresponding Source of the work from the predecessor in interest, if\nthe predecessor has it or can get it with reasonable efforts.\n\n You may not impose any further restrictions on the exercise of the\nrights granted or affirmed under this License. For example, you may\nnot impose a license fee, royalty, or other charge for exercise of\nrights granted under this License, and you may not initiate litigation\n(including a cross-claim or counterclaim in a lawsuit) alleging that\nany patent claim is infringed by making, using, selling, offering for\nsale, or importing the Program or any portion of it.\n\n 11. Patents.\n\n A \"contributor\" is a copyright holder who authorizes use under this\nLicense of the Program or a work on which the Program is based. The\nwork thus licensed is called the contributor's \"contributor version\".\n\n A contributor's \"essential patent claims\" are all patent claims\nowned or controlled by the contributor, whether already acquired or\nhereafter acquired, that would be infringed by some manner, permitted\nby this License, of making, using, or selling its contributor version,\nbut do not include claims that would be infringed only as a\nconsequence of further modification of the contributor version. For\npurposes of this definition, \"control\" includes the right to grant\npatent sublicenses in a manner consistent with the requirements of\nthis License.\n\n Each contributor grants you a non-exclusive, worldwide, royalty-free\npatent license under the contributor's essential patent claims, to\nmake, use, sell, offer for sale, import and otherwise run, modify and\npropagate the contents of its contributor version.\n\n In the following three paragraphs, a \"patent license\" is any express\nagreement or commitment, however denominated, not to enforce a patent\n(such as an express permission to practice a patent or covenant not to\nsue for patent infringement). To \"grant\" such a patent license to a\nparty means to make such an agreement or commitment not to enforce a\npatent against the party.\n\n If you convey a covered work, knowingly relying on a patent license,\nand the Corresponding Source of the work is not available for anyone\nto copy, free of charge and under the terms of this License, through a\npublicly available network server or other readily accessible means,\nthen you must either (1) cause the Corresponding Source to be so\navailable, or (2) arrange to deprive yourself of the benefit of the\npatent license for this particular work, or (3) arrange, in a manner\nconsistent with the requirements of this License, to extend the patent\nlicense to downstream recipients. \"Knowingly relying\" means you have\nactual knowledge that, but for the patent license, your conveying the\ncovered work in a country, or your recipient's use of the covered work\nin a country, would infringe one or more identifiable patents in that\ncountry that you have reason to believe are valid.\n\n If, pursuant to or in connection with a single transaction or\narrangement, you convey, or propagate by procuring conveyance of, a\ncovered work, and grant a patent license to some of the parties\nreceiving the covered work authorizing them to use, propagate, modify\nor convey a specific copy of the covered work, then the patent license\nyou grant is automatically extended to all recipients of the covered\nwork and works based on it.\n\n A patent license is \"discriminatory\" if it does not include within\nthe scope of its coverage, prohibits the exercise of, or is\nconditioned on the non-exercise of one or more of the rights that are\nspecifically granted under this License. You may not convey a covered\nwork if you are a party to an arrangement with a third party that is\nin the business of distributing software, under which you make payment\nto the third party based on the extent of your activity of conveying\nthe work, and under which the third party grants, to any of the\nparties who would receive the covered work from you, a discriminatory\npatent license (a) in connection with copies of the covered work\nconveyed by you (or copies made from those copies), or (b) primarily\nfor and in connection with specific products or compilations that\ncontain the covered work, unless you entered into that arrangement,\nor that patent license was granted, prior to 28 March 2007.\n\n Nothing in this License shall be construed as excluding or limiting\nany implied license or other defenses to infringement that may\notherwise be available to you under applicable patent law.\n\n 12. No Surrender of Others' Freedom.\n\n If conditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot convey a\ncovered work so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you may\nnot convey it at all. For example, if you agree to terms that obligate you\nto collect a royalty for further conveying from those to whom you convey\nthe Program, the only way you could satisfy both those terms and this\nLicense would be to refrain entirely from conveying the Program.\n\n 13. Use with the GNU Affero General Public License.\n\n Notwithstanding any other provision of this License, you have\npermission to link or combine any covered work with a work licensed\nunder version 3 of the GNU Affero General Public License into a single\ncombined work, and to convey the resulting work. The terms of this\nLicense will continue to apply to the part which is the covered work,\nbut the special requirements of the GNU Affero General Public License,\nsection 13, concerning interaction through a network will apply to the\ncombination as such.\n\n 14. Revised Versions of this License.\n\n The Free Software Foundation may publish revised and/or new versions of\nthe GNU General Public License from time to time. Such new versions will\nbe similar in spirit to the present version, but may differ in detail to\naddress new problems or concerns.\n\n Each version is given a distinguishing version number. If the\nProgram specifies that a certain numbered version of the GNU General\nPublic License \"or any later version\" applies to it, you have the\noption of following the terms and conditions either of that numbered\nversion or of any later version published by the Free Software\nFoundation. If the Program does not specify a version number of the\nGNU General Public License, you may choose any version ever published\nby the Free Software Foundation.\n\n If the Program specifies that a proxy can decide which future\nversions of the GNU General Public License can be used, that proxy's\npublic statement of acceptance of a version permanently authorizes you\nto choose that version for the Program.\n\n Later license versions may give you additional or different\npermissions. However, no additional obligations are imposed on any\nauthor or copyright holder as a result of your choosing to follow a\nlater version.\n\n 15. Disclaimer of Warranty.\n\n THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY\nAPPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT\nHOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY\nOF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,\nTHE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM\nIS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF\nALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n 16. Limitation of Liability.\n\n IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\nWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS\nTHE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY\nGENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE\nUSE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF\nDATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD\nPARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),\nEVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGES.\n\n 17. Interpretation of Sections 15 and 16.\n\n If the disclaimer of warranty and limitation of liability provided\nabove cannot be given local legal effect according to their terms,\nreviewing courts shall apply local law that most closely approximates\nan absolute waiver of all civil liability in connection with the\nProgram, unless a warranty or assumption of liability accompanies a\ncopy of the Program in return for a fee.\n\n END OF TERMS AND CONDITIONS\n\n How to Apply These Terms to Your New Programs\n\n If you develop a new program, and you want it to be of the greatest\npossible use to the public, the best way to achieve this is to make it\nfree software which everyone can redistribute and change under these terms.\n\n To do so, attach the following notices to the program. It is safest\nto attach them to the start of each source file to most effectively\nstate the exclusion of warranty; and each file should have at least\nthe \"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see .\n\nAlso add information on how to contact you by electronic and paper mail.\n\n If the program does terminal interaction, make it output a short\nnotice like this when it starts in an interactive mode:\n\n Copyright (C) \n This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\n This is free software, and you are welcome to redistribute it\n under certain conditions; type `show c' for details.\n\nThe hypothetical commands `show w' and `show c' should show the appropriate\nparts of the General Public License. Of course, your program's commands\nmight be different; for a GUI interface, you would use an \"about box\".\n\n You should also get your employer (if you work as a programmer) or school,\nif any, to sign a \"copyright disclaimer\" for the program, if necessary.\nFor more information on this, and how to apply and follow the GNU GPL, see\n.\n\n The GNU General Public License does not permit incorporating your program\ninto proprietary programs. If your program is a subroutine library, you\nmay consider it more useful to permit linking proprietary applications with\nthe library. If this is what you want to do, use the GNU Lesser General\nPublic License instead of this License. But first, please read\n.\n" }, { "path": "OWNERS", "content": "approvers:\n- ruibaby\n- guqing\n- JohnNiang\n- LIlGG\n" }, { "path": "README.md", "content": "

\n \n \"Halo\n \n

\n\n

Halo [ˈheɪloʊ]，强大易用的开源建站工具。

\n

\n\"GitHub\n\"Docker\n\"GitHub\n\"GitHub\n\"Codecov\n\"GitCode\n\"Halo\n
\n官网\n文档\n社区\nGitee\nTelegram 频道\n

\n\n[![Watch the video](https://www.halo.run/upload/halo-github-screenshot.png)](https://www.bilibili.com/video/BV15x4y1U7RU/?share_source=copy_web&vd_source=0ab6cf86ca512a363f04f18b86f55b86)\n\n------------------------------\n\n## 快速开始\n\n如果你的设备有 Docker 环境，可以使用以下命令快速启动一个 Halo 的体验环境：\n\n```bash\ndocker run -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.22\n```\n\n或者点击下方按钮使用 [Gitpod](https://gitpod.io/) 或 [ClawCloud Run](https://template.us-west-1.run.claw.cloud/deploy?templateName=halo) 启动一个体验环境：\n\n[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/halo-sigs/gitpod-demo)\n\n[![Run on ClawCloud](https://raw.githubusercontent.com/ClawCloud/Run-Template/refs/heads/main/Run-on-ClawCloud.svg)](https://template.us-west-1.run.claw.cloud/deploy?templateName=halo)\n\n**以上方式仅作为体验使用，推荐使用开源 Linux 服务器运维管理面板 [1Panel](https://github.com/1Panel-dev/1Panel) 进行部署（[查看文档](https://docs.halo.run/getting-started/install/1panel)），轻松搞定反向代理、SSL 证书及升级备份任务。更多部署方式，请[查看文档](https://docs.halo.run/category/%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97)。**\n\n## 在线体验\n\n- 环境地址：\n- 后台地址：\n- 用户名：`demo`\n- 密码：`P@ssw0rd123..`\n\n## 付费版\n\n相比于社区版，Halo 付费版为用户提供了大量增强功能及技术支持服务，增强功能包括商城、短信验证码注册登录、全站私有化、LDAP 登录、三方账号登录及自定义 Logo 等。 [点击查看付费版详细介绍](https://www.lxware.cn/halo)。\n\n## 生态\n\n可访问 [官方应用市场](https://www.halo.run/store/apps) 或 [awesome-halo 仓库](https://github.com/halo-sigs/awesome-halo) 查看适用于 Halo 2.x 的主题和插件。\n\n## 许可证\n\n[![license](https://img.shields.io/github/license/halo-dev/halo.svg?style=flat-square)](https://github.com/halo-dev/halo/blob/master/LICENSE)\n\nHalo 使用 GPL-v3.0 协议开源，请遵守开源协议。\n\n## 贡献\n\n参考 [CONTRIBUTING](https://github.com/halo-dev/halo/blob/main/CONTRIBUTING.md)。\n\n\n\n## 状态\n\n![Repobeats analytics](https://repobeats.axiom.co/api/embed/ad008b2151c22e7cf734d2688befaa795d593b95.svg \"Repobeats analytics image\")\n" }, { "path": "SECURITY.md", "content": "# Security Policy\n\n## Supported Versions\n\nHalo currently supports the versions listed below, where as:\n\n- :white_check_mark: indicates an active development roadmap, is therefore maintaining, and **will** receive Security\n Vulnerability Report.\n- :x: indicates such version has already deprecated and **will not** be receiving Security Vulnerability Report.\n\n| Version | Supported |\n| ------- | ------------------ |\n| 0.x | :x: |\n| 1.x | :x: |\n| 2.x | :white_check_mark: |\n\n## Reporting a Vulnerability\n\nWe first appreciate and are very thankful that you've found a vulnerability issue in Halo! By disclosing such issue to\nHalo development team you are helping Halo to become a much more safer project than before! ;)\n\nTo protect the existing users of Halo, we kindly ask you to not disclose the vulnerability to anyone except the Halo\ndevelopment team before a fix has been rolled out.\n\nTo Report a Vulnerability, please complete the form below, and send such report by email to `hi@halo.run`.\n\n```\nVulnerability has been observed in...\n - Docker? [n/y]: \n if yes for the question above,\n - `docker -v`: \n - `docker images halohub/halo`: \n \n - by `java -jar halo.jar`? [n/y]: \n if yes for the question above,\n - `uname -a`: \n - `java -version`: \n \n- Affected by Halo version(s) [e.g. v2.4.0]: \n- Vulnerability self-scoring [1-10]: \n- Would you like to be attributed? (Whether you agree us to appreciate you by putting your name in the CHANGELOG of the next fix release) [n/y]: \n```\n" }, { "path": "api/build.gradle", "content": "plugins {\n id 'checkstyle'\n id 'java-library'\n id 'halo.publish'\n id 'jacoco'\n alias(libs.plugins.lombok)\n alias(libs.plugins.versions)\n}\n\ngroup = 'run.halo.app'\ndescription = 'API of halo project, connecting by other projects.'\n\ntasks.withType(JavaCompile).configureEach {\n options.release = 21\n options.encoding = 'UTF-8'\n}\n\ntasks.withType(Javadoc).configureEach {\n options.encoding = 'UTF-8'\n}\n\njava {\n toolchain {\n languageVersion = JavaLanguageVersion.of(21)\n }\n withJavadocJar()\n withSourcesJar()\n}\n\ncheckstyle {\n toolVersion = libs.versions.checkstyle.get()\n showViolations = false\n ignoreFailures = false\n}\n\njar {\n manifest {\n attributes(\n 'Implementation-Title': project.name,\n 'Implementation-Version': project.version,\n 'Implementation-Vendor': 'Halo Project',\n )\n }\n}\n\nrepositories {\n mavenCentral()\n}\n\ndependencies {\n api platform(project(':platform:application'))\n annotationProcessor platform(project(':platform:application'))\n\n api 'org.springframework.boot:spring-boot-starter-actuator'\n api 'org.springframework.boot:spring-boot-starter-mail'\n api 'org.springframework.boot:spring-boot-starter-thymeleaf'\n api 'org.springframework.boot:spring-boot-starter-webflux'\n api 'org.springframework.boot:spring-boot-starter-validation'\n api 'org.springframework.boot:spring-boot-starter-data-r2dbc'\n api 'org.springframework.session:spring-session-core'\n api 'org.springframework.boot:spring-boot-jackson2'\n api 'org.springframework.boot:spring-boot-integration'\n api 'org.springframework.boot:spring-boot-session'\n\n // Spring Security\n api 'org.springframework.boot:spring-boot-starter-security'\n api 'org.springframework.security:spring-security-oauth2-jose'\n api 'org.springframework.security:spring-security-oauth2-client'\n api 'org.springframework.security:spring-security-oauth2-resource-server'\n\n api 'io.micrometer:context-propagation'\n\n // Cache\n api \"org.springframework.boot:spring-boot-starter-cache\"\n api \"com.github.ben-manes.caffeine:caffeine\"\n\n api \"org.springdoc:springdoc-openapi-starter-webflux-ui\"\n api 'org.openapi4j:openapi-schema-validator'\n api \"net.bytebuddy:byte-buddy\"\n api \"org.bouncycastle:bcpkix-jdk18on\"\n\n // Apache Lucene\n api \"org.apache.lucene:lucene-core\"\n api \"org.apache.lucene:lucene-queryparser\"\n api \"org.apache.lucene:lucene-highlighter\"\n api \"org.apache.lucene:lucene-backward-codecs\"\n api 'org.apache.lucene:lucene-analysis-common'\n\n api \"org.apache.commons:commons-lang3\"\n api \"io.seruco.encoding:base62\"\n api \"org.pf4j:pf4j\"\n api \"com.google.guava:guava\"\n api \"org.jsoup:jsoup\"\n api \"io.github.java-diff-utils:java-diff-utils\"\n api \"org.springframework.integration:spring-integration-core\"\n api \"com.github.java-json-tools:json-patch\"\n api \"org.thymeleaf.extras:thymeleaf-extras-springsecurity6\"\n api 'org.apache.tika:tika-core'\n api 'net.coobird:thumbnailator'\n\n api \"io.github.resilience4j:resilience4j-spring-boot3\"\n api \"io.github.resilience4j:resilience4j-reactor\"\n\n api \"com.j256.two-factor-auth:two-factor-auth\"\n\n runtimeOnly 'io.r2dbc:r2dbc-h2'\n runtimeOnly 'org.postgresql:postgresql'\n runtimeOnly 'org.postgresql:r2dbc-postgresql'\n runtimeOnly 'org.mariadb:r2dbc-mariadb'\n runtimeOnly 'io.asyncer:r2dbc-mysql'\n runtimeOnly 'com.github.therapi:therapi-runtime-javadoc'\n\n annotationProcessor \"com.github.therapi:therapi-runtime-javadoc-scribe\"\n\n testImplementation 'org.springframework.boot:spring-boot-starter-test'\n testImplementation 'org.springframework.security:spring-security-test'\n testImplementation 'io.projectreactor:reactor-test'\n\n testRuntimeOnly 'org.junit.platform:junit-platform-launcher'\n}\n\npublishing {\n publications.named('mavenJava', MavenPublication) {\n from components.java\n pom {\n name = 'API library'\n description = \"$project.description\"\n }\n }\n}\n\ntasks.named('test') {\n useJUnitPlatform()\n finalizedBy jacocoTestReport\n}\n\ntasks.named('jacocoTestReport') {\n reports {\n xml.required = true\n html.required = false\n }\n}\n\ntasks.named('uploadBundle') {\n mustRunAfter project(':platform:application').tasks.named('uploadBundle')\n}\n" }, { "path": "api/src/main/java/run/halo/app/content/ContentWrapper.java", "content": "package run.halo.app.content;\n\nimport lombok.Builder;\nimport lombok.Data;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.Snapshot;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\npublic class ContentWrapper {\n private String snapshotName;\n private String raw;\n private String content;\n private String rawType;\n\n public static ContentWrapper patchSnapshot(Snapshot patchSnapshot, Snapshot baseSnapshot) {\n Assert.notNull(baseSnapshot, \"The baseSnapshot must not be null.\");\n String baseSnapshotName = baseSnapshot.getMetadata().getName();\n if (StringUtils.equals(patchSnapshot.getMetadata().getName(), baseSnapshotName)) {\n return ContentWrapper.builder()\n .snapshotName(patchSnapshot.getMetadata().getName())\n .raw(patchSnapshot.getSpec().getRawPatch())\n .content(patchSnapshot.getSpec().getContentPatch())\n .rawType(patchSnapshot.getSpec().getRawType())\n .build();\n }\n String patchedContent = PatchUtils.applyPatch(baseSnapshot.getSpec().getContentPatch(),\n patchSnapshot.getSpec().getContentPatch());\n String patchedRaw = PatchUtils.applyPatch(baseSnapshot.getSpec().getRawPatch(),\n patchSnapshot.getSpec().getRawPatch());\n return ContentWrapper.builder()\n .snapshotName(patchSnapshot.getMetadata().getName())\n .raw(patchedRaw)\n .content(patchedContent)\n .rawType(patchSnapshot.getSpec().getRawType())\n .build();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/content/ExcerptGenerator.java", "content": "package run.halo.app.content;\n\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Mono;\n\npublic interface ExcerptGenerator extends ExtensionPoint {\n\n Mono generate(ExcerptGenerator.Context context);\n\n @Data\n @Accessors(chain = true)\n class Context {\n private String raw;\n /**\n * html content.\n */\n private String content;\n\n private String rawType;\n /**\n * keywords in the content to help the excerpt generation more accurate.\n */\n private Set keywords;\n /**\n * Max length of the generated excerpt.\n */\n private int maxLength;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/content/PatchUtils.java", "content": "package run.halo.app.content;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport com.github.difflib.DiffUtils;\nimport com.github.difflib.patch.AbstractDelta;\nimport com.github.difflib.patch.ChangeDelta;\nimport com.github.difflib.patch.Chunk;\nimport com.github.difflib.patch.DeleteDelta;\nimport com.github.difflib.patch.DeltaType;\nimport com.github.difflib.patch.InsertDelta;\nimport com.github.difflib.patch.Patch;\nimport com.github.difflib.patch.PatchFailedException;\nimport com.google.common.base.Splitter;\nimport java.util.Collections;\nimport java.util.List;\nimport lombok.Data;\nimport org.apache.commons.lang3.StringUtils;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class PatchUtils {\n private static final String DELIMITER = \"\\n\";\n private static final Splitter lineSplitter = Splitter.on(DELIMITER);\n\n public static Patch create(String deltasJson) {\n List deltas = JsonUtils.jsonToObject(deltasJson, new TypeReference<>() {\n });\n Patch patch = new Patch<>();\n for (Delta delta : deltas) {\n StringChunk sourceChunk = delta.getSource();\n StringChunk targetChunk = delta.getTarget();\n Chunk orgChunk = new Chunk<>(sourceChunk.getPosition(), sourceChunk.getLines(),\n sourceChunk.getChangePosition());\n Chunk revChunk = new Chunk<>(targetChunk.getPosition(), targetChunk.getLines(),\n targetChunk.getChangePosition());\n switch (delta.getType()) {\n case DELETE -> patch.addDelta(new DeleteDelta<>(orgChunk, revChunk));\n case INSERT -> patch.addDelta(new InsertDelta<>(orgChunk, revChunk));\n case CHANGE -> patch.addDelta(new ChangeDelta<>(orgChunk, revChunk));\n default -> throw new IllegalArgumentException(\"Unsupported delta type.\");\n }\n }\n return patch;\n }\n\n public static String patchToJson(Patch patch) {\n List> deltas = patch.getDeltas();\n return JsonUtils.objectToJson(deltas);\n }\n\n public static String applyPatch(String original, String patchJson) {\n Patch patch = PatchUtils.create(patchJson);\n try {\n return String.join(DELIMITER, patch.applyTo(breakLine(original)));\n } catch (PatchFailedException e) {\n throw new RuntimeException(e);\n }\n }\n\n public static String diffToJsonPatch(String original, String revised) {\n Patch patch = DiffUtils.diff(breakLine(original), breakLine(revised));\n return PatchUtils.patchToJson(patch);\n }\n\n public static List breakLine(String content) {\n if (StringUtils.isBlank(content)) {\n return Collections.emptyList();\n }\n return lineSplitter.splitToList(content);\n }\n\n @Data\n public static class Delta {\n private StringChunk source;\n private StringChunk target;\n private DeltaType type;\n }\n\n @Data\n public static class StringChunk {\n private int position;\n private List lines;\n private List changePosition;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/content/PostContentService.java", "content": "package run.halo.app.content;\n\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\npublic interface PostContentService {\n\n Mono getHeadContent(String postName);\n\n Mono getReleaseContent(String postName);\n\n Mono getSpecifiedContent(String postName, String snapshotName);\n\n Flux listSnapshots(String postName);\n}\n" }, { "path": "api/src/main/java/run/halo/app/content/comment/CommentSubject.java", "content": "package run.halo.app.content.comment;\n\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.Ref;\n\n/**\n * Comment subject.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface CommentSubject extends ExtensionPoint {\n\n Mono get(String name);\n\n default Mono getSubjectDisplay(String name) {\n return Mono.empty();\n }\n\n boolean supports(Ref ref);\n\n record SubjectDisplay(String title, String url, String kindName) {\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/attachment/ThumbnailProvider.java", "content": "package run.halo.app.core.attachment;\n\nimport java.net.URI;\nimport java.net.URL;\nimport lombok.Builder;\nimport lombok.Data;\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.attachment.endpoint.AttachmentHandler;\n\n/**\n * Thumbnail provider extension.\n *\n * @since 2.22.0\n * @deprecated Use {@link AttachmentHandler} instead. We are planing to remove this extension\n * point in future release.\n */\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic interface ThumbnailProvider extends ExtensionPoint {\n\n /**\n * Generate thumbnail URI for given image URL and size.\n *\n * @param context Thumbnail context including image URI and size\n * @return Generated thumbnail URI\n */\n Mono generate(ThumbnailContext context);\n\n /**\n * Delete thumbnail file for given image URL.\n *\n * @param imageUrl original image URL\n */\n Mono delete(URL imageUrl);\n\n /**\n * Whether the provider supports the given image URI.\n *\n * @return {@code true} if supports, {@code false} otherwise\n */\n Mono supports(ThumbnailContext context);\n\n @Data\n @Builder\n class ThumbnailContext {\n private final URL imageUrl;\n private final ThumbnailSize size;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/attachment/ThumbnailSize.java", "content": "package run.halo.app.core.attachment;\n\nimport java.util.Arrays;\nimport java.util.Optional;\nimport lombok.Getter;\n\n@Getter\npublic enum ThumbnailSize {\n S(400),\n M(800),\n L(1200),\n XL(1600);\n\n private final int width;\n\n ThumbnailSize(int width) {\n this.width = width;\n }\n\n /**\n * Convert width string to {@link ThumbnailSize}.\n *\n * @param width width string\n */\n public static ThumbnailSize fromWidth(String width) {\n for (ThumbnailSize value : values()) {\n if (String.valueOf(value.getWidth()).equals(width)) {\n return value;\n }\n }\n return ThumbnailSize.M;\n }\n\n /**\n * Convert name to {@link ThumbnailSize}.\n */\n public static ThumbnailSize fromName(String name) {\n for (ThumbnailSize value : values()) {\n if (value.name().equalsIgnoreCase(name)) {\n return value;\n }\n }\n throw new IllegalArgumentException(\"No such thumbnail size: \" + name);\n }\n\n public static Optional optionalValueOf(String name) {\n for (ThumbnailSize value : values()) {\n if (value.name().equalsIgnoreCase(name)) {\n return Optional.of(value);\n }\n }\n return Optional.empty();\n }\n\n public static Integer[] allowedWidths() {\n return Arrays.stream(ThumbnailSize.values())\n .map(ThumbnailSize::getWidth)\n .toArray(Integer[]::new);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/endpoint/WebSocketEndpoint.java", "content": "package run.halo.app.core.endpoint;\n\nimport org.springframework.web.reactive.socket.WebSocketHandler;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * Endpoint for WebSocket.\n *\n * @author johnniang\n */\npublic interface WebSocketEndpoint {\n\n /**\n * Path of the URL after group version.\n *\n * @return path of the URL.\n */\n String urlPath();\n\n /**\n * Group and version parts of the endpoint.\n *\n * @return GroupVersion.\n */\n GroupVersion groupVersion();\n\n /**\n * Real WebSocket handler for the endpoint.\n *\n * @return WebSocket handler.\n */\n WebSocketHandler handler();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/AnnotationSetting.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.AnnotationSetting.KIND;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupKind;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"\", version = \"v1alpha1\", kind = KIND,\n plural = \"annotationsettings\", singular = \"annotationsetting\")\npublic class AnnotationSetting extends AbstractExtension {\n public static final String TARGET_REF_LABEL = \"halo.run/target-ref\";\n\n public static final String KIND = \"AnnotationSetting\";\n\n @Schema(requiredMode = REQUIRED)\n private AnnotationSettingSpec spec;\n\n @Data\n public static class AnnotationSettingSpec {\n @Schema(requiredMode = REQUIRED)\n private GroupKind targetRef;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private List formSchema;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/AuthProvider.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.Getter;\nimport lombok.ToString;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * Auth provider extension.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@ToString(callSuper = true)\n@GVK(group = \"auth.halo.run\", version = \"v1alpha1\", kind = \"AuthProvider\",\n singular = \"authprovider\", plural = \"authproviders\")\npublic class AuthProvider extends AbstractExtension {\n\n public static final String AUTH_BINDING_LABEL = \"auth.halo.run/auth-binding\";\n\n public static final String PRIVILEGED_LABEL = \"auth.halo.run/privileged\";\n\n @Schema(requiredMode = REQUIRED)\n private AuthProviderSpec spec;\n\n @Data\n @ToString\n public static class AuthProviderSpec {\n\n @Schema(requiredMode = REQUIRED, description = \"Display name of the auth provider\")\n private String displayName;\n\n private String description;\n\n private String logo;\n\n private String website;\n\n private String helpPage;\n\n @Schema(requiredMode = REQUIRED, description = \"Authentication url of the auth provider\")\n private String authenticationUrl;\n\n private String method = \"GET\";\n\n private boolean rememberMeSupport = false;\n\n /**\n * Auth type: form or oauth2.\n */\n @Getter(onMethod_ = @NonNull)\n @Schema(requiredMode = REQUIRED)\n private AuthType authType = AuthType.OAUTH2;\n\n private String bindingUrl;\n\n private String unbindUrl;\n\n @Schema(requiredMode = NOT_REQUIRED)\n private SettingRef settingRef;\n\n @Schema(requiredMode = NOT_REQUIRED)\n private ConfigMapRef configMapRef;\n\n public void setAuthType(AuthType authType) {\n this.authType = (authType == null ? AuthType.OAUTH2 : authType);\n }\n }\n\n @Data\n @ToString\n public static class SettingRef {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String group;\n }\n\n @Data\n @ToString\n public static class ConfigMapRef {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n }\n\n public enum AuthType {\n FORM,\n OAUTH2\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Counter.java", "content": "package run.halo.app.core.extension;\n\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Metadata;\n\n/**\n * A counter for number of requests by extension resource name.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@GVK(group = \"metrics.halo.run\", version = \"v1alpha1\", kind = \"Counter\", plural = \"counters\",\n singular = \"counter\")\n@EqualsAndHashCode(callSuper = true)\npublic class Counter extends AbstractExtension {\n\n private Integer visit;\n\n private Integer upvote;\n\n private Integer downvote;\n\n private Integer totalComment;\n\n private Integer approvedComment;\n\n public static Counter emptyCounter(String name) {\n Counter counter = new Counter();\n counter.setMetadata(new Metadata());\n counter.getMetadata().setName(name);\n counter.setUpvote(0);\n counter.setTotalComment(0);\n counter.setApprovedComment(0);\n counter.setVisit(0);\n return counter;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Device.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.Getter;\nimport lombok.experimental.Accessors;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = Device.GROUP, version = Device.VERSION, kind = Device.KIND, plural = \"devices\",\n singular = \"device\")\npublic class Device extends AbstractExtension {\n public static final String GROUP = \"security.halo.run\";\n public static final String VERSION = \"v1alpha1\";\n public static final String KIND = \"Device\";\n\n @Schema(requiredMode = REQUIRED)\n private Spec spec;\n\n @Getter(onMethod_ = @NonNull)\n private Status status = new Status();\n\n public void setStatus(Status status) {\n this.status = (status == null ? new Status() : status);\n }\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"DeviceSpec\")\n public static class Spec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String sessionId;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String principalName;\n\n @Schema(requiredMode = REQUIRED, maxLength = 129)\n private String ipAddress;\n\n @Schema(maxLength = 500)\n private String userAgent;\n\n private String rememberMeSeriesId;\n\n private Instant lastAccessedTime;\n\n private Instant lastAuthenticatedTime;\n }\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"DeviceStatus\")\n public static class Status {\n private String browser;\n private String os;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Menu.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.ArraySchema;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.LinkedHashSet;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"\", version = \"v1alpha1\", kind = \"Menu\", plural = \"menus\", singular = \"menu\")\npublic class Menu extends AbstractExtension {\n\n @Schema(description = \"The spec of menu.\", requiredMode = REQUIRED)\n private Spec spec;\n\n @Data\n @Schema(name = \"MenuSpec\")\n public static class Spec {\n\n @Schema(description = \"The display name of the menu.\", requiredMode = REQUIRED)\n private String displayName;\n\n @ArraySchema(\n uniqueItems = true,\n arraySchema = @Schema(description = \"Menu items of this menu.\"),\n schema = @Schema(description = \"Name of menu item.\")\n )\n private LinkedHashSet menuItems;\n\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/MenuItem.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonValue;\nimport io.swagger.v3.oas.annotations.media.ArraySchema;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.LinkedHashSet;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Ref;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"\", version = \"v1alpha1\", kind = \"MenuItem\",\n plural = \"menuitems\", singular = \"menuitem\")\npublic class MenuItem extends AbstractExtension {\n\n @Schema(description = \"The spec of menu item.\", requiredMode = REQUIRED)\n private MenuItemSpec spec;\n\n @Schema(description = \"The status of menu item.\")\n private MenuItemStatus status;\n\n public enum Target {\n BLANK(\"_blank\"),\n SELF(\"_self\"),\n PARENT(\"_parent\"),\n TOP(\"_top\");\n\n private final String value;\n\n @JsonCreator\n Target(String value) {\n this.value = value;\n }\n\n @JsonValue\n public String getValue() {\n return value;\n }\n }\n\n @Data\n public static class MenuItemSpec {\n\n @Schema(description = \"The display name of menu item.\")\n private String displayName;\n\n @Schema(description = \"The href of this menu item.\")\n private String href;\n\n @Schema(description = \"The target attribute of this menu item.\")\n private Target target;\n\n @Schema(description = \"The priority is for ordering.\")\n private Integer priority;\n\n @ArraySchema(\n uniqueItems = true,\n arraySchema = @Schema(description = \"Children of this menu item\"),\n schema = @Schema(description = \"The name of menu item child\"))\n private LinkedHashSet children;\n\n @Schema(description = \"Target reference. Like Category, Tag, Post or SinglePage\")\n private Ref targetRef;\n\n }\n\n @Data\n public static class MenuItemStatus {\n\n @Schema(description = \"Calculated Display name of menu item.\")\n private String displayName;\n\n @Schema(description = \"Calculated href of manu item.\")\n private String href;\n\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Plugin.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.net.URI;\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.pf4j.PluginState;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.infra.ConditionList;\n\n/**\n * A custom resource for Plugin.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = \"plugin.halo.run\", version = \"v1alpha1\", kind = \"Plugin\", plural = \"plugins\",\n singular = \"plugin\")\n@EqualsAndHashCode(callSuper = true)\npublic class Plugin extends AbstractExtension {\n\n public static final String SYSTEM_RESERVED_LABEL_KEY = \"plugin.halo.run/system-reserved\";\n\n public static final String BUILT_IN_KEEPER_FINALIZER = \"plugin.halo.run/built-in-keeper\";\n\n @Schema(requiredMode = REQUIRED)\n private PluginSpec spec;\n\n private PluginStatus status;\n\n /**\n * Gets plugin status.\n *\n * @return empty object if status is null.\n */\n @NonNull\n @JsonIgnore\n public PluginStatus statusNonNull() {\n if (this.status == null) {\n this.status = new PluginStatus();\n }\n return status;\n }\n\n @Data\n public static class PluginSpec {\n\n private String displayName;\n\n /**\n * plugin version.\n *\n * @see semantic version\n */\n @Schema(requiredMode = REQUIRED,\n pattern = \"^(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)(?:-(\"\n + \"(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\\\.\"\n + \"(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\\\+([0-9a-zA-Z-]+(?:\\\\\"\n + \".[0-9a-zA-Z-]+)*))?$\")\n private String version;\n\n private PluginAuthor author;\n\n private String logo;\n\n private Map pluginDependencies = new HashMap<>(4);\n\n private String homepage;\n\n private String repo;\n\n private String issues;\n\n private String description;\n\n private List license;\n\n /**\n * SemVer format.\n */\n private String requires = \"*\";\n\n private Boolean enabled = false;\n\n private String settingName;\n\n private String configMapName;\n }\n\n /**\n * In the future, we may consider using {@link run.halo.app.infra.model.License} instead of it.\n * But now, replace it will lead to incompatibility with downstream.\n */\n @Data\n public static class License {\n private String name;\n private String url;\n }\n\n @Data\n public static class PluginStatus {\n\n private Phase phase;\n\n private ConditionList conditions;\n\n private Instant lastStartTime;\n\n private PluginState lastProbeState;\n\n private String entry;\n\n private String stylesheet;\n\n private String logo;\n\n @Schema(description = \"Load location of the plugin, often a path.\")\n private URI loadLocation;\n\n public static ConditionList nullSafeConditions(@NonNull PluginStatus status) {\n Assert.notNull(status, \"The status must not be null.\");\n if (status.getConditions() == null) {\n status.setConditions(new ConditionList());\n }\n return status.getConditions();\n }\n }\n\n public enum Phase {\n PENDING,\n STARTING,\n CREATED,\n DISABLING,\n DISABLED,\n RESOLVED,\n STARTED,\n STOPPED,\n FAILED,\n UNKNOWN,\n ;\n }\n\n @Data\n @ToString\n public static class PluginAuthor {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n\n private String website;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/RememberMeToken.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.experimental.Accessors;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"security.halo.run\", version = \"v1alpha1\", kind = \"RememberMeToken\", plural =\n \"remembermetokens\", singular = \"remembermetoken\")\npublic class RememberMeToken extends AbstractExtension {\n\n @Schema(requiredMode = REQUIRED)\n private Spec spec;\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"RememberMeTokenSpec\")\n public static class Spec {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String username;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String series;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String tokenValue;\n\n private Instant lastUsed;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/ReverseProxy.java", "content": "package run.halo.app.core.extension;\n\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n *

The reverse proxy custom resource is used to configure a path to proxy it to a directory or\n * file.

\n *

HTTP proxy may be added in the future.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"plugin.halo.run\", kind = \"ReverseProxy\", version = \"v1alpha1\",\n plural = \"reverseproxies\", singular = \"reverseproxy\")\npublic class ReverseProxy extends AbstractExtension {\n private List rules;\n\n public record ReverseProxyRule(String path, FileReverseProxyProvider file) {\n }\n\n public record FileReverseProxyProvider(String directory, String filename) {\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Role.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static java.util.Arrays.compare;\nimport static run.halo.app.core.extension.Role.GROUP;\nimport static run.halo.app.core.extension.Role.KIND;\nimport static run.halo.app.core.extension.Role.VERSION;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.Getter;\nimport lombok.ToString;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@ToString(callSuper = true)\n@GVK(group = GROUP,\n version = VERSION,\n kind = KIND,\n plural = \"roles\",\n singular = \"role\")\npublic class Role extends AbstractExtension {\n public static final String ROLE_DEPENDENCY_RULES =\n \"rbac.authorization.halo.run/dependency-rules\";\n public static final String ROLE_AGGREGATE_LABEL_PREFIX =\n \"rbac.authorization.halo.run/aggregate-to-\";\n public static final String ROLE_DEPENDENCIES_ANNO = \"rbac.authorization.halo.run/dependencies\";\n public static final String UI_PERMISSIONS_ANNO = \"rbac.authorization.halo.run/ui-permissions\";\n\n public static final String SYSTEM_RESERVED_LABELS =\n \"rbac.authorization.halo.run/system-reserved\";\n public static final String HIDDEN_LABEL_NAME = \"halo.run/hidden\";\n public static final String TEMPLATE_LABEL_NAME = \"halo.run/role-template\";\n public static final String UI_PERMISSIONS_AGGREGATED_ANNO =\n \"rbac.authorization.halo.run/ui-permissions-aggregated\";\n\n public static final String GROUP = \"\";\n public static final String VERSION = \"v1alpha1\";\n public static final String KIND = \"Role\";\n\n @Schema(requiredMode = REQUIRED)\n List rules;\n\n /**\n * PolicyRule holds information that describes a policy rule, but does not contain information\n * about whom the rule applies to or which namespace the rule applies to.\n *\n * @author guqing\n * @since 2.0.0\n */\n @Getter\n @EqualsAndHashCode\n public static class PolicyRule implements Comparable {\n /**\n * APIGroups is the name of the APIGroup that contains the resources.\n * If multiple API groups are specified, any action requested against one of the enumerated\n * resources in any API group will be allowed.\n */\n final String[] apiGroups;\n\n /**\n * Resources is a list of resources this rule applies to. '*' represents all resources in\n * the specified apiGroups.\n * '*/foo' represents the subresource 'foo' for all resources in the specified\n * apiGroups.\n */\n final String[] resources;\n\n /**\n * ResourceNames is an optional white list of names that the rule applies to. An empty set\n * means that everything is allowed.\n */\n final String[] resourceNames;\n\n /**\n * NonResourceURLs is a set of partial urls that a user should have access to.\n * *s are allowed, but only as the full, final step in the path\n * If an action is not a resource API request, then the URL is split on '/' and is checked\n * against the NonResourceURLs to look for a match.\n * Since non-resource URLs are not namespaced, this field is only applicable for\n * ClusterRoles referenced from a ClusterRoleBinding.\n * Rules can either apply to API resources (such as \"pods\" or \"secrets\") or non-resource\n * URL paths (such as \"/api\"), but not both.\n */\n final String[] nonResourceURLs;\n\n /**\n * about who the rule applies to or which namespace the rule applies to.\n */\n final String[] verbs;\n\n public PolicyRule() {\n this(null, null, null, null, null);\n }\n\n public PolicyRule(String[] apiGroups, String[] resources,\n String[] resourceNames,\n String[] nonResourceURLs, String[] verbs) {\n this.apiGroups = nullElseEmpty(apiGroups);\n this.resources = nullElseEmpty(resources);\n this.resourceNames = nullElseEmpty(resourceNames);\n this.nonResourceURLs = nullElseEmpty(nonResourceURLs);\n this.verbs = nullElseEmpty(verbs);\n }\n\n String[] nullElseEmpty(String... items) {\n if (items == null) {\n return new String[] {};\n }\n return items;\n }\n\n @Override\n public int compareTo(@NonNull PolicyRule other) {\n int result = compare(apiGroups, other.apiGroups);\n if (result != 0) {\n return result;\n }\n result = compare(resources, other.resources);\n if (result != 0) {\n return result;\n }\n result = compare(resourceNames, other.resourceNames);\n if (result != 0) {\n return result;\n }\n result = compare(nonResourceURLs, other.nonResourceURLs);\n if (result != 0) {\n return result;\n }\n result = compare(verbs, other.verbs);\n return result;\n }\n\n public static class Builder {\n String[] apiGroups;\n\n String[] resources;\n\n String[] resourceNames;\n\n String[] nonResourceURLs;\n\n String[] verbs;\n\n public Builder apiGroups(String... apiGroups) {\n this.apiGroups = apiGroups;\n return this;\n }\n\n public Builder resources(String... resources) {\n this.resources = resources;\n return this;\n }\n\n public Builder resourceNames(String... resourceNames) {\n this.resourceNames = resourceNames;\n return this;\n }\n\n public Builder nonResourceURLs(String... nonResourceURLs) {\n this.nonResourceURLs = nonResourceURLs;\n return this;\n }\n\n public Builder verbs(String... verbs) {\n this.verbs = verbs;\n return this;\n }\n\n public PolicyRule build() {\n return new PolicyRule(apiGroups, resources, resourceNames,\n nonResourceURLs,\n verbs);\n }\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/RoleBinding.java", "content": "package run.halo.app.core.extension;\n\nimport static run.halo.app.core.extension.RoleBinding.GROUP;\nimport static run.halo.app.core.extension.RoleBinding.KIND;\nimport static run.halo.app.core.extension.RoleBinding.VERSION;\n\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Set;\nimport java.util.function.Predicate;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.NoArgsConstructor;\nimport lombok.ToString;\nimport org.springframework.util.StringUtils;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.ExtensionOperator;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Metadata;\n\n/**\n * RoleBinding references a role, but does not contain it.\n * It can reference a Role in the global.\n * It adds who information via Subjects.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@ToString(callSuper = true)\n@GVK(group = GROUP,\n version = VERSION,\n kind = KIND,\n plural = \"rolebindings\",\n singular = \"rolebinding\")\npublic class RoleBinding extends AbstractExtension {\n\n public static final String GROUP = \"\";\n\n public static final String VERSION = \"v1alpha1\";\n\n public static final String KIND = \"RoleBinding\";\n\n /**\n * Subjects holds references to the objects the role applies to.\n */\n List subjects;\n\n /**\n * RoleRef can reference a Role in the current namespace or a ClusterRole in the global\n * namespace.\n * If the RoleRef cannot be resolved, the Authorizer must return an error.\n */\n RoleRef roleRef;\n\n /**\n * RoleRef contains information that points to the role being used.\n *\n * @author guqing\n * @since 2.0.0\n */\n @Data\n public static class RoleRef {\n\n /**\n * Kind is the type of resource being referenced.\n */\n String kind;\n\n /**\n * Name is the name of resource being referenced.\n */\n String name;\n\n /**\n * APIGroup is the group for the resource being referenced.\n */\n String apiGroup;\n }\n\n /**\n * @author guqing\n * @since 2.0.0\n */\n @Data\n @NoArgsConstructor\n @AllArgsConstructor\n public static class Subject {\n /**\n * Kind of object being referenced. Values defined by this API group are \"User\", \"Group\",\n * and \"ServiceAccount\".\n * If the Authorizer does not recognize the kind value, the Authorizer should report\n * an error.\n */\n String kind;\n\n /**\n * Name of the object being referenced.\n */\n String name;\n\n /**\n * APIGroup holds the API group of the referenced subject.\n * Defaults to \"\" for ServiceAccount subjects.\n * Defaults to \"rbac.authorization.halo.run\" for User and Group subjects.\n */\n String apiGroup;\n\n public static Predicate isUser(String username) {\n return subject -> User.KIND.equals(subject.getKind())\n && User.GROUP.equals(subject.getApiGroup())\n && username.equals(subject.getName());\n }\n\n public static Predicate containsUser(Set usernames) {\n return subject -> User.KIND.equals(subject.getKind())\n && User.GROUP.equals(subject.apiGroup)\n && usernames.contains(subject.getName());\n }\n\n @Override\n public String toString() {\n if (StringUtils.hasText(apiGroup)) {\n return apiGroup + \"/\" + kind + \"/\" + name;\n }\n return kind + \"/\" + name;\n }\n }\n\n public static RoleBinding create(String username, String roleName) {\n var metadata = new Metadata();\n metadata.setName(String.join(\"-\", username, roleName, \"binding\"));\n\n var roleRef = new RoleRef();\n roleRef.setKind(Role.KIND);\n roleRef.setName(roleName);\n roleRef.setApiGroup(Role.GROUP);\n\n var subject = new Subject();\n subject.setKind(User.KIND);\n subject.setName(username);\n subject.setApiGroup(User.GROUP);\n\n var binding = new RoleBinding();\n binding.setMetadata(metadata);\n binding.setRoleRef(roleRef);\n\n // keep the subjects mutable\n var subjects = new LinkedList();\n subjects.add(subject);\n\n binding.setSubjects(subjects);\n return binding;\n }\n\n public static Predicate containsUser(String username) {\n return ExtensionOperator.isNotDeleted().and(\n binding -> binding.getSubjects().stream()\n .anyMatch(Subject.isUser(username)));\n }\n\n public static Predicate containsUser(Set usernames) {\n return ExtensionOperator.isNotDeleted()\n .and(binding -> binding.getSubjects().stream()\n .anyMatch(Subject.containsUser(usernames)));\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Setting.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.extension.GroupVersionKind.fromExtension;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * {@link Setting} is a custom extension to generate forms based on configuration.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"\", version = \"v1alpha1\", kind = Setting.KIND,\n plural = \"settings\", singular = \"setting\")\npublic class Setting extends AbstractExtension {\n\n public static final String KIND = \"Setting\";\n\n public static final GroupVersionKind GVK = fromExtension(Setting.class);\n\n @Schema(requiredMode = REQUIRED)\n private SettingSpec spec;\n\n @Data\n public static class SettingSpec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private List forms;\n }\n\n @Data\n public static class SettingForm {\n\n @Schema(requiredMode = REQUIRED)\n private String group;\n\n private String label;\n\n @Schema(requiredMode = REQUIRED)\n private List formSchema;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/Theme.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport java.util.Objects;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.infra.ConditionList;\nimport run.halo.app.infra.model.License;\n\n/**\n *

Theme extension.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"theme.halo.run\", version = \"v1alpha1\", kind = Theme.KIND,\n plural = \"themes\", singular = \"theme\")\npublic class Theme extends AbstractExtension {\n\n public static final String KIND = \"Theme\";\n\n public static final String THEME_NAME_LABEL = \"theme.halo.run/theme-name\";\n\n @Schema(requiredMode = REQUIRED)\n private ThemeSpec spec;\n\n private ThemeStatus status;\n\n @Data\n @ToString\n public static class ThemeSpec {\n private static final String WILDCARD = \"*\";\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String displayName;\n\n @Schema(requiredMode = REQUIRED)\n private Author author;\n\n private String description;\n\n private String logo;\n\n private String homepage;\n\n private String repo;\n\n private String issues;\n\n private String version = WILDCARD;\n\n @Schema(requiredMode = NOT_REQUIRED)\n private String requires = WILDCARD;\n\n private String settingName;\n\n private String configMapName;\n\n private List license;\n\n @Schema\n private CustomTemplates customTemplates;\n\n }\n\n @Data\n public static class ThemeStatus {\n private ThemePhase phase;\n private ConditionList conditions;\n private String location;\n }\n\n /**\n * Null-safe get {@link ConditionList} from theme status.\n *\n * @param theme theme must not be null\n * @return condition list\n */\n public static ConditionList nullSafeConditionList(Theme theme) {\n Assert.notNull(theme, \"The theme must not be null\");\n var status = Objects.requireNonNullElseGet(theme.getStatus(), ThemeStatus::new);\n theme.setStatus(status);\n\n var conditions = Objects.requireNonNullElseGet(status.getConditions(), ConditionList::new);\n status.setConditions(conditions);\n return conditions;\n }\n\n public enum ThemePhase {\n READY,\n FAILED,\n UNKNOWN,\n }\n\n @Data\n @ToString\n public static class Author {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n\n private String website;\n }\n\n @Data\n public static class CustomTemplates {\n private List post;\n private List category;\n private List page;\n }\n\n /**\n * Type used to describe custom template page.\n *\n * @author guqing\n * @since 2.0.0\n */\n @Data\n public static class TemplateDescriptor {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n\n private String description;\n\n private String screenshot;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String file;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/User.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.User.GROUP;\nimport static run.halo.app.core.extension.User.KIND;\nimport static run.halo.app.core.extension.User.VERSION;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * The extension represents user details of Halo.\n *\n * @author johnniang\n */\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = GROUP,\n version = VERSION,\n kind = KIND,\n singular = \"user\",\n plural = \"users\")\npublic class User extends AbstractExtension {\n\n public static final String GROUP = \"\";\n public static final String VERSION = \"v1alpha1\";\n public static final String KIND = \"User\";\n\n public static final String USER_RELATED_ROLES_INDEX = \"roles\";\n\n public static final String ROLE_NAMES_ANNO = \"rbac.authorization.halo.run/role-names\";\n\n public static final String EMAIL_TO_VERIFY = \"halo.run/email-to-verify\";\n\n public static final String LAST_AVATAR_ATTACHMENT_NAME_ANNO =\n \"halo.run/last-avatar-attachment-name\";\n\n public static final String AVATAR_ATTACHMENT_NAME_ANNO = \"halo.run/avatar-attachment-name\";\n\n public static final String HIDDEN_USER_LABEL = \"halo.run/hidden-user\";\n\n public static final String REQUEST_TO_UPDATE = \"halo.run/request-to-update\";\n\n @Schema(requiredMode = REQUIRED)\n private UserSpec spec = new UserSpec();\n\n private UserStatus status = new UserStatus();\n\n @Data\n public static class UserSpec {\n\n @Schema(requiredMode = REQUIRED)\n private String displayName;\n\n private String avatar;\n\n @Schema(requiredMode = REQUIRED)\n private String email;\n\n private boolean emailVerified;\n\n private String phone;\n\n private String password;\n\n private String bio;\n\n private Instant registeredAt;\n\n private Boolean twoFactorAuthEnabled;\n\n private String totpEncryptedSecret;\n\n private Boolean disabled;\n\n private Integer loginHistoryLimit;\n\n }\n\n @Data\n public static class UserStatus {\n\n private String permalink;\n\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/UserConnection.java", "content": "package run.halo.app.core.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Metadata;\n\n/**\n * User connection extension.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"auth.halo.run\", version = \"v1alpha1\", kind = \"UserConnection\",\n singular = \"userconnection\", plural = \"userconnections\")\npublic class UserConnection extends AbstractExtension {\n\n @Schema(requiredMode = REQUIRED)\n private UserConnectionSpec spec;\n\n @Data\n public static class UserConnectionSpec {\n\n /**\n * The name of the OAuth provider (e.g. Google, Facebook, Twitter).\n */\n @Schema(requiredMode = REQUIRED)\n private String registrationId;\n\n /**\n * The {@link Metadata#getName()} of the user associated with the OAuth connection.\n */\n @Schema(requiredMode = REQUIRED)\n private String username;\n\n /**\n * The unique identifier for the user's connection to the OAuth provider.\n * for example, the user's GitHub id.\n */\n @Schema(requiredMode = REQUIRED)\n private String providerUserId;\n\n /**\n * The time when the user connection was last updated.\n */\n private Instant updatedAt;\n\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/Attachment.java", "content": "package run.halo.app.core.extension.attachment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.attachment.Attachment.KIND;\n\nimport io.swagger.v3.oas.annotations.media.ArraySchema;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.Map;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.jspecify.annotations.Nullable;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = KIND,\n plural = \"attachments\", singular = \"attachment\")\npublic class Attachment extends AbstractExtension {\n\n public static final String KIND = \"Attachment\";\n\n @Schema(requiredMode = REQUIRED)\n private AttachmentSpec spec;\n\n private AttachmentStatus status;\n\n @Data\n public static class AttachmentSpec {\n\n @Schema(description = \"Display name of attachment\")\n private String displayName;\n\n @Schema(description = \"Group name\")\n private String groupName;\n\n @Schema(description = \"Policy name\")\n private String policyName;\n\n @Schema(description = \"Name of User who uploads the attachment\")\n private String ownerName;\n\n @Schema(description = \"Media type of attachment\")\n @Nullable\n private String mediaType;\n\n @Schema(description = \"Size of attachment. Unit is Byte\", minimum = \"0\")\n private Long size;\n\n @ArraySchema(\n arraySchema = @Schema(description = \"Tags of attachment\"),\n schema = @Schema(description = \"Tag name\"))\n private Set tags;\n\n }\n\n @Data\n public static class AttachmentStatus {\n\n @Schema(description = \"\"\"\n Permalink of attachment.\n If it is in local storage, the public URL will be set.\n If it is in s3 storage, the Object URL will be set.\n \"\"\")\n private String permalink;\n\n private Map thumbnails;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/Constant.java", "content": "package run.halo.app.core.extension.attachment;\n\nimport run.halo.app.core.extension.attachment.endpoint.AttachmentHandler;\n\npublic enum Constant {\n ;\n\n public static final String GROUP = \"storage.halo.run\";\n public static final String VERSION = \"v1alpha1\";\n /**\n * The relative path starting from attachments folder is for deletion.\n */\n public static final String LOCAL_REL_PATH_ANNO_KEY = GROUP + \"/local-relative-path\";\n /**\n * The encoded URI is for building external url.\n */\n public static final String URI_ANNO_KEY = GROUP + \"/uri\";\n\n /**\n * Do not use this key to set external link. You could implement\n * {@link AttachmentHandler#getPermalink} by your self.\n *

\n */\n public static final String EXTERNAL_LINK_ANNO_KEY = GROUP + \"/external-link\";\n\n public static final String FINALIZER_NAME = \"attachment-manager\";\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/Group.java", "content": "package run.halo.app.core.extension.attachment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.attachment.Group.KIND;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = KIND,\n plural = \"groups\", singular = \"group\")\npublic class Group extends AbstractExtension {\n\n public static final String KIND = \"Group\";\n public static final String HIDDEN_LABEL = \"halo.run/hidden\";\n\n @Schema(requiredMode = REQUIRED)\n private GroupSpec spec;\n\n private GroupStatus status;\n\n @Data\n public static class GroupSpec {\n\n @Schema(requiredMode = REQUIRED, description = \"Display name of group\")\n private String displayName;\n\n }\n\n @Data\n public static class GroupStatus {\n\n @Schema(description = \"Update timestamp of the group\")\n private Instant updateTimestamp;\n\n @Schema(description = \"Total of attachments under the current group\", minimum = \"0\")\n private Long totalAttachments;\n\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/Policy.java", "content": "package run.halo.app.core.extension.attachment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.attachment.Policy.KIND;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = KIND,\n plural = \"policies\", singular = \"policy\")\npublic class Policy extends AbstractExtension {\n public static final String POLICY_OWNER_LABEL = \"storage.halo.run/policy-owner\";\n\n public static final String KIND = \"Policy\";\n\n @Schema(requiredMode = REQUIRED)\n private PolicySpec spec;\n\n @Data\n public static class PolicySpec {\n\n @Schema(requiredMode = REQUIRED, description = \"Display name of policy\")\n private String displayName;\n\n @Schema(requiredMode = REQUIRED, description = \"Reference name of PolicyTemplate\")\n private String templateName;\n\n @Schema(description = \"Reference name of ConfigMap extension\")\n private String configMapName;\n\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/PolicyTemplate.java", "content": "package run.halo.app.core.extension.attachment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.attachment.PolicyTemplate.KIND;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = KIND,\n plural = \"policytemplates\", singular = \"policytemplate\")\npublic class PolicyTemplate extends AbstractExtension {\n\n public static final String KIND = \"PolicyTemplate\";\n\n private PolicyTemplateSpec spec;\n\n @Data\n public static class PolicyTemplateSpec {\n\n private String displayName;\n\n @Schema(requiredMode = REQUIRED)\n private String settingName;\n\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/endpoint/AttachmentHandler.java", "content": "package run.halo.app.core.extension.attachment.endpoint;\n\nimport java.net.URI;\nimport java.time.Duration;\nimport java.util.Map;\nimport org.jspecify.annotations.Nullable;\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.http.codec.multipart.FilePart;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Group;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\n\npublic interface AttachmentHandler extends ExtensionPoint {\n\n Mono upload(UploadContext context);\n\n Mono delete(DeleteContext context);\n\n /**\n * Gets a shared URL which could be accessed publicly.\n * 1. If the attachment is in local storage, the permalink will be returned.\n * 2. If the attachment is in s3 storage, the Presigned URL will be returned.\n *

\n * Please note that the default implementation is only for back compatibility.\n *\n * @param attachment contains detail of attachment.\n * @param policy is storage policy.\n * @param configMap contains configuration needed by handler.\n * @param ttl indicates how long the URL is alive.\n * @return shared URL which could be accessed publicly. Might be relative URL.\n */\n default Mono getSharedURL(Attachment attachment,\n Policy policy,\n ConfigMap configMap,\n Duration ttl) {\n return Mono.empty();\n }\n\n /**\n * Gets a permalink representing a unique attachment.\n * If the attachment is in local storage, the permalink will be returned.\n * If the attachment is in s3 storage, the Object URL will be returned.\n *

\n * Please note that the default implementation is only for back compatibility.\n *\n * @param attachment contains detail of attachment.\n * @param policy is storage policy.\n * @param configMap contains configuration needed by handler.\n * @return permalink representing a unique attachment. Might be relative URL.\n */\n default Mono getPermalink(Attachment attachment,\n Policy policy,\n ConfigMap configMap) {\n return Mono.empty();\n }\n\n /**\n * Gets thumbnail links for given attachment.\n *\n * @param attachment the attachment\n * @param policy the policy\n * @param configMap the config map\n * @return a map of thumbnail sizes to their respective URIs\n */\n default Mono> getThumbnailLinks(Attachment attachment,\n Policy policy,\n ConfigMap configMap) {\n return Mono.empty();\n }\n\n interface UploadContext {\n\n FilePart file();\n\n Policy policy();\n\n ConfigMap configMap();\n\n /**\n * Gets the group info if available.\n *\n * @return the group info, or null if not available\n */\n @Nullable\n default Group group() {\n return null;\n }\n\n }\n\n interface DeleteContext {\n Attachment attachment();\n\n Policy policy();\n\n ConfigMap configMap();\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/endpoint/DeleteOption.java", "content": "package run.halo.app.core.extension.attachment.endpoint;\n\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\n\npublic record DeleteOption(Attachment attachment, Policy policy, ConfigMap configMap)\n implements AttachmentHandler.DeleteContext {\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/endpoint/SimpleFilePart.java", "content": "package run.halo.app.core.extension.attachment.endpoint;\n\nimport java.nio.file.Path;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\n/**\n * SimpleFilePart is an adapter of simple data for uploading.\n *\n * @param filename is name of the attachment file.\n * @param content is binary data of the attachment file.\n * @param mediaType is media type of the attachment file.\n */\npublic record SimpleFilePart(\n String filename,\n Flux content,\n MediaType mediaType\n) implements FilePart {\n @Override\n public Mono transferTo(Path dest) {\n return DataBufferUtils.write(content(), dest);\n }\n\n @Override\n public String name() {\n return filename();\n }\n\n @Override\n public HttpHeaders headers() {\n var headers = new HttpHeaders();\n headers.setContentType(mediaType);\n return HttpHeaders.readOnlyHttpHeaders(headers);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/attachment/endpoint/UploadOption.java", "content": "package run.halo.app.core.extension.attachment.endpoint;\n\nimport lombok.Builder;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.core.extension.attachment.Group;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\n\n@Builder\npublic record UploadOption(FilePart file,\n Policy policy,\n ConfigMap configMap,\n @Nullable Group group) implements AttachmentHandler.UploadContext {\n\n public static UploadOption from(String filename,\n Flux content,\n MediaType mediaType,\n Policy policy,\n ConfigMap configMap) {\n var filePart = new SimpleFilePart(filename, content, mediaType);\n return new UploadOption(filePart, policy, configMap, null);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Category.java", "content": "package run.halo.app.core.extension.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static run.halo.app.core.extension.content.Category.KIND;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * @author guqing\n * @see issue#2322\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION,\n kind = KIND, plural = \"categories\", singular = \"category\")\n@EqualsAndHashCode(callSuper = true)\npublic class Category extends AbstractExtension {\n\n public static final String KIND = \"Category\";\n public static final String LAST_HIDDEN_STATE_ANNO = \"content.halo.run/last-hidden-state\";\n\n public static final GroupVersionKind GVK = GroupVersionKind.fromExtension(Category.class);\n\n @Schema(requiredMode = REQUIRED)\n private CategorySpec spec;\n\n @Schema\n private CategoryStatus status;\n\n @JsonIgnore\n public boolean isDeleted() {\n return getMetadata().getDeletionTimestamp() != null;\n }\n\n @Data\n public static class CategorySpec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String displayName;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String slug;\n\n private String description;\n\n private String cover;\n\n @Schema(requiredMode = NOT_REQUIRED, maxLength = 255)\n private String template;\n\n /**\n *

Used to specify the template for the posts associated with the category.

\n *

The priority is not as high as that of the post.

\n *

If the post also specifies a template, the post's template will prevail.

\n */\n @Schema(requiredMode = NOT_REQUIRED, maxLength = 255)\n private String postTemplate;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"0\")\n private Integer priority;\n\n private List children;\n\n /**\n *

if a category is queried for related posts, the default behavior is to\n * query all posts under the category including its subcategories, but if this field is\n * set to true, cascade query behavior will be terminated here.

\n *

For example, if a category has subcategories A and B, and A has subcategories C and\n * D and C marked this field as true, when querying posts under A category,all posts under A\n * and B will be queried, but C and D will not be queried.

\n */\n private boolean preventParentPostCascadeQuery;\n\n /**\n *

Whether to hide the category from the category list.

\n *

When set to true, the category including its subcategories and related posts will\n * not be displayed in the category list, but it can still be accessed by permalink.

\n *

Limitation: It only takes effect on the theme-side categorized list and it only\n * allows to be set to true on the first level(root node) of categories.

\n */\n private boolean hideFromList;\n }\n\n @JsonIgnore\n public CategoryStatus getStatusOrDefault() {\n if (this.status == null) {\n this.status = new CategoryStatus();\n }\n return this.status;\n }\n\n @Data\n public static class CategoryStatus {\n\n private String permalink;\n\n /**\n * 包括当前和其下所有层级的文章数量 (depth=max).\n */\n public Integer postCount;\n\n /**\n * 包括当前和其下所有层级的已发布且公开的文章数量 (depth=max).\n */\n public Integer visiblePostCount;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Comment.java", "content": "package run.halo.app.core.extension.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Ref;\n\n/**\n * @author guqing\n * @see issue#2322\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = Comment.KIND,\n plural = \"comments\", singular = \"comment\")\n@EqualsAndHashCode(callSuper = true)\npublic class Comment extends AbstractExtension {\n\n public static final String KIND = \"Comment\";\n\n public static final String REQUIRE_SYNC_ON_STARTUP_INDEX_NAME = \"requireSyncOnStartup\";\n\n @Schema(requiredMode = REQUIRED)\n private CommentSpec spec;\n\n @Schema\n private CommentStatus status;\n\n @JsonIgnore\n public CommentStatus getStatusOrDefault() {\n if (this.status == null) {\n this.status = new CommentStatus();\n }\n return this.status;\n }\n\n @Data\n @ToString(callSuper = true)\n @EqualsAndHashCode(callSuper = true)\n public static class CommentSpec extends BaseCommentSpec {\n\n @Schema(requiredMode = REQUIRED)\n private Ref subjectRef;\n\n private Instant lastReadTime;\n }\n\n @Data\n public static class BaseCommentSpec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String raw;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String content;\n\n @Schema(requiredMode = REQUIRED)\n private CommentOwner owner;\n\n private String userAgent;\n\n private String ipAddress;\n\n private Instant approvedTime;\n\n /**\n * The user-defined creation time default is metadata.creationTimestamp.\n */\n private Instant creationTime;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"0\")\n private Integer priority;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"false\")\n private Boolean top;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"true\")\n private Boolean allowNotification;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"false\")\n private Boolean approved;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"false\")\n private Boolean hidden;\n }\n\n @Data\n public static class CommentOwner {\n public static final String KIND_EMAIL = \"Email\";\n public static final String AVATAR_ANNO = \"avatar\";\n public static final String WEBSITE_ANNO = \"website\";\n public static final String EMAIL_HASH_ANNO = \"email-hash\";\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String kind;\n\n @Schema(requiredMode = REQUIRED, maxLength = 64)\n private String name;\n\n private String displayName;\n\n private Map annotations;\n\n @Nullable\n @JsonIgnore\n public String getAnnotation(String key) {\n return annotations == null ? null : annotations.get(key);\n }\n\n public static String ownerIdentity(String kind, String name) {\n return kind + \"#\" + name;\n }\n }\n\n @Data\n public static class CommentStatus {\n\n private Instant lastReplyTime;\n\n private Integer replyCount;\n\n private Integer visibleReplyCount;\n\n private Integer unreadReplyCount;\n\n private Boolean hasNewReply;\n\n private Long observedVersion;\n }\n\n public static String toSubjectRefKey(Ref subjectRef) {\n return subjectRef.getGroup() + \"/\" + subjectRef.getKind() + \"/\" + subjectRef.getName();\n }\n\n public static int getUnreadReplyCount(List replies, Instant lastReadTime) {\n if (CollectionUtils.isEmpty(replies)) {\n return 0;\n }\n long unreadReplyCount = replies.stream()\n .filter(existingReply -> {\n if (lastReadTime == null) {\n return true;\n }\n Instant creationTime = defaultIfNull(existingReply.getSpec().getCreationTime(),\n existingReply.getMetadata().getCreationTimestamp());\n return creationTime.isAfter(lastReadTime);\n })\n .count();\n return (int) unreadReplyCount;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Constant.java", "content": "package run.halo.app.core.extension.content;\n\npublic enum Constant {\n ;\n\n public static final String GROUP = \"content.halo.run\";\n public static final String VERSION = \"v1alpha1\";\n\n public static final String LAST_READ_TIME_ANNO = \"content.halo.run/last-read-time\";\n public static final String PERMALINK_PATTERN_ANNO = \"content.halo.run/permalink-pattern\";\n\n public static final String CHECKSUM_CONFIG_ANNO = \"checksum/config\";\n\n public static final String CONTENT_CHECKSUM_ANNO = \"checksum/content\";\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Post.java", "content": "package run.halo.app.core.extension.content;\n\nimport static java.lang.Boolean.parseBoolean;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport io.swagger.v3.oas.annotations.media.Schema.RequiredMode;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.infra.ConditionList;\n\n/**\n *

Post extension.

\n *\n * @author guqing\n * @see issue#2322\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = Post.KIND,\n plural = \"posts\", singular = \"post\")\n@EqualsAndHashCode(callSuper = true)\npublic class Post extends AbstractExtension {\n\n public static final String KIND = \"Post\";\n\n public static final String REQUIRE_SYNC_ON_STARTUP_INDEX_NAME = \"requireSyncOnStartup\";\n\n public static final GroupVersionKind GVK = GroupVersionKind.fromExtension(Post.class);\n\n public static final String CATEGORIES_ANNO = \"content.halo.run/categories\";\n public static final String LAST_RELEASED_SNAPSHOT_ANNO =\n \"content.halo.run/last-released-snapshot\";\n public static final String LAST_ASSOCIATED_TAGS_ANNO = \"content.halo.run/last-associated-tags\";\n public static final String LAST_ASSOCIATED_CATEGORIES_ANNO =\n \"content.halo.run/last-associated-categories\";\n\n public static final String STATS_ANNO = \"content.halo.run/stats\";\n\n /**\n *

The key of the label that indicates that the post is scheduled to be published.

\n *

Can be used to query posts that are scheduled to be published.

\n */\n public static final String SCHEDULING_PUBLISH_LABEL = \"content.halo.run/scheduling-publish\";\n\n public static final String DELETED_LABEL = \"content.halo.run/deleted\";\n public static final String PUBLISHED_LABEL = \"content.halo.run/published\";\n public static final String OWNER_LABEL = \"content.halo.run/owner\";\n public static final String VISIBLE_LABEL = \"content.halo.run/visible\";\n\n public static final String ARCHIVE_YEAR_LABEL = \"content.halo.run/archive-year\";\n\n public static final String ARCHIVE_MONTH_LABEL = \"content.halo.run/archive-month\";\n public static final String ARCHIVE_DAY_LABEL = \"content.halo.run/archive-day\";\n\n @Schema(requiredMode = RequiredMode.REQUIRED)\n private PostSpec spec;\n\n @Schema\n private PostStatus status;\n\n @JsonIgnore\n public PostStatus getStatusOrDefault() {\n if (this.status == null) {\n this.status = new PostStatus();\n }\n return status;\n }\n\n @JsonIgnore\n public boolean isDeleted() {\n return Objects.equals(true, spec.getDeleted())\n || getMetadata().getDeletionTimestamp() != null;\n }\n\n @JsonIgnore\n public boolean isPublished() {\n return isPublished(this.getMetadata());\n }\n\n public static boolean isPublished(MetadataOperator metadata) {\n var labels = metadata.getLabels();\n return labels != null && parseBoolean(labels.getOrDefault(PUBLISHED_LABEL, \"false\"));\n }\n\n public static boolean isRecycled(MetadataOperator metadata) {\n var labels = metadata.getLabels();\n return labels != null && parseBoolean(labels.getOrDefault(DELETED_LABEL, \"false\"));\n }\n\n public static boolean isPublic(PostSpec spec) {\n return spec.getVisible() == null || VisibleEnum.PUBLIC.equals(spec.getVisible());\n }\n\n @Data\n public static class PostSpec {\n @Schema(requiredMode = RequiredMode.REQUIRED, minLength = 1)\n private String title;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, minLength = 1)\n private String slug;\n\n /**\n * 文章引用到的已发布的内容，用于主题端显示.\n */\n private String releaseSnapshot;\n\n private String headSnapshot;\n\n private String baseSnapshot;\n\n private String owner;\n\n private String template;\n\n private String cover;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"false\")\n private Boolean deleted;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"false\")\n private Boolean publish;\n\n private Instant publishTime;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"false\")\n private Boolean pinned;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"true\")\n private Boolean allowComment;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"PUBLIC\")\n private VisibleEnum visible;\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"0\")\n private Integer priority;\n\n @Schema(requiredMode = RequiredMode.REQUIRED)\n private Excerpt excerpt;\n\n private List categories;\n\n private List tags;\n\n private List> htmlMetas;\n }\n\n @Data\n public static class PostStatus {\n private String phase;\n\n @Schema\n private ConditionList conditions;\n\n private String permalink;\n\n private String excerpt;\n\n private Boolean inProgress;\n\n private Integer commentsCount;\n\n private List contributors;\n\n /**\n * see {@link Category.CategorySpec#isHideFromList()}.\n */\n private Boolean hideFromList;\n\n private Instant lastModifyTime;\n\n private Long observedVersion;\n\n @JsonIgnore\n public ConditionList getConditionsOrDefault() {\n if (this.conditions == null) {\n this.conditions = new ConditionList();\n }\n return conditions;\n }\n }\n\n @Data\n public static class Excerpt {\n\n @Schema(requiredMode = RequiredMode.REQUIRED, defaultValue = \"true\")\n private Boolean autoGenerate;\n\n private String raw;\n }\n\n public enum PostPhase {\n DRAFT,\n PENDING_APPROVAL,\n PUBLISHED,\n FAILED;\n\n /**\n * Convert string value to {@link PostPhase}.\n *\n * @param value enum value string\n * @return {@link PostPhase} if found, otherwise null\n */\n public static PostPhase from(String value) {\n for (PostPhase phase : PostPhase.values()) {\n if (phase.name().equalsIgnoreCase(value)) {\n return phase;\n }\n }\n return null;\n }\n }\n\n public enum VisibleEnum {\n PUBLIC,\n INTERNAL,\n PRIVATE;\n\n /**\n * Convert value string to {@link VisibleEnum}.\n *\n * @param value enum value string\n * @return {@link VisibleEnum} if found, otherwise null\n */\n public static VisibleEnum from(String value) {\n for (VisibleEnum visible : VisibleEnum.values()) {\n if (visible.name().equalsIgnoreCase(value)) {\n return visible;\n }\n }\n return null;\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Reply.java", "content": "package run.halo.app.core.extension.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.Getter;\nimport lombok.ToString;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * @author guqing\n * @see issue#2322\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = Reply.KIND,\n plural = \"replies\", singular = \"reply\")\n@EqualsAndHashCode(callSuper = true)\npublic class Reply extends AbstractExtension {\n\n public static final String KIND = \"Reply\";\n\n public static final String REQUIRE_SYNC_ON_STARTUP_INDEX_NAME = \"requireSyncOnStartup\";\n\n @Schema(requiredMode = REQUIRED)\n private ReplySpec spec;\n\n @Schema\n @Getter(onMethod_ = @NonNull)\n private Status status = new Status();\n\n @Data\n @EqualsAndHashCode(callSuper = true)\n public static class ReplySpec extends Comment.BaseCommentSpec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String commentName;\n\n private String quoteReply;\n }\n\n @Data\n @Schema(name = \"ReplyStatus\")\n public static class Status {\n private Long observedVersion;\n }\n\n public void setStatus(Status status) {\n this.status = status == null ? new Status() : status;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/SinglePage.java", "content": "package run.halo.app.core.extension.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.MetadataUtil;\n\n/**\n *

Single page extension.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = SinglePage.KIND,\n plural = \"singlepages\", singular = \"singlepage\")\n@EqualsAndHashCode(callSuper = true)\npublic class SinglePage extends AbstractExtension {\n\n public static final String KIND = \"SinglePage\";\n\n public static final GroupVersionKind GVK = GroupVersionKind.fromExtension(SinglePage.class);\n public static final String DELETED_LABEL = \"content.halo.run/deleted\";\n public static final String PUBLISHED_LABEL = \"content.halo.run/published\";\n public static final String LAST_RELEASED_SNAPSHOT_ANNO =\n \"content.halo.run/last-released-snapshot\";\n public static final String OWNER_LABEL = \"content.halo.run/owner\";\n public static final String VISIBLE_LABEL = \"content.halo.run/visible\";\n\n @Schema(requiredMode = REQUIRED)\n private SinglePageSpec spec;\n\n @Schema\n private SinglePageStatus status;\n\n @JsonIgnore\n public SinglePageStatus getStatusOrDefault() {\n if (this.status == null) {\n this.status = new SinglePageStatus();\n }\n return this.status;\n }\n\n @JsonIgnore\n public boolean isPublished() {\n Map labels = getMetadata().getLabels();\n return labels != null && labels.getOrDefault(PUBLISHED_LABEL, \"false\").equals(\"true\");\n }\n\n @Data\n public static class SinglePageSpec {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String title;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String slug;\n\n /**\n * 引用到的已发布的内容，用于主题端显示.\n */\n private String releaseSnapshot;\n\n private String headSnapshot;\n\n private String baseSnapshot;\n\n private String owner;\n\n private String template;\n\n private String cover;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"false\")\n private Boolean deleted;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"false\")\n private Boolean publish;\n\n private Instant publishTime;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"false\")\n private Boolean pinned;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"true\")\n private Boolean allowComment;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"PUBLIC\")\n private Post.VisibleEnum visible;\n\n @Schema(requiredMode = REQUIRED, defaultValue = \"0\")\n private Integer priority;\n\n @Schema(requiredMode = REQUIRED)\n private Post.Excerpt excerpt;\n\n private List> htmlMetas;\n }\n\n @Data\n @EqualsAndHashCode(callSuper = true)\n public static class SinglePageStatus extends Post.PostStatus {\n\n }\n\n public static void changePublishedState(SinglePage page, boolean value) {\n Map labels = MetadataUtil.nullSafeLabels(page);\n labels.put(PUBLISHED_LABEL, String.valueOf(value));\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Snapshot.java", "content": "package run.halo.app.core.extension.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport java.util.LinkedHashSet;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Ref;\n\n/**\n * @author guqing\n * @see issue#2322\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION, kind = Snapshot.KIND,\n plural = \"snapshots\", singular = \"snapshot\")\n@EqualsAndHashCode(callSuper = true)\npublic class Snapshot extends AbstractExtension {\n public static final String KIND = \"Snapshot\";\n public static final String KEEP_RAW_ANNO = \"content.halo.run/keep-raw\";\n public static final String PATCHED_CONTENT_ANNO = \"content.halo.run/patched-content\";\n public static final String PATCHED_RAW_ANNO = \"content.halo.run/patched-raw\";\n\n @Schema(requiredMode = REQUIRED)\n private SnapShotSpec spec;\n\n @Data\n public static class SnapShotSpec {\n\n @Schema(requiredMode = REQUIRED)\n private Ref subjectRef;\n\n /**\n * such as: markdown | html | json | asciidoc | latex.\n */\n @Schema(requiredMode = REQUIRED, minLength = 1, maxLength = 50)\n private String rawType;\n\n private String rawPatch;\n\n private String contentPatch;\n\n private String parentSnapshotName;\n\n private Instant lastModifyTime;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String owner;\n\n private Set contributors;\n }\n\n public static void addContributor(Snapshot snapshot, String name) {\n Assert.notNull(name, \"The username must not be null.\");\n Set contributors = snapshot.getSpec().getContributors();\n if (contributors == null) {\n contributors = new LinkedHashSet<>();\n snapshot.getSpec().setContributors(contributors);\n }\n contributors.add(name);\n }\n\n /**\n * Check if the given snapshot is a base snapshot.\n *\n * @param snapshot must not be null.\n * @return true if the given snapshot is a base snapshot; false otherwise.\n */\n public static boolean isBaseSnapshot(@NonNull Snapshot snapshot) {\n var annotations = snapshot.getMetadata().getAnnotations();\n if (annotations == null) {\n return false;\n }\n return Boolean.parseBoolean(annotations.get(Snapshot.KEEP_RAW_ANNO));\n }\n\n public static String toSubjectRefKey(Ref subjectRef) {\n return subjectRef.getGroup() + \"/\" + subjectRef.getKind() + \"/\" + subjectRef.getName();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/content/Tag.java", "content": "package run.halo.app.core.extension.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * @author guqing\n * @see issue#2322\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@GVK(group = Constant.GROUP, version = Constant.VERSION,\n kind = Tag.KIND, plural = \"tags\", singular = \"tag\")\n@EqualsAndHashCode(callSuper = true)\npublic class Tag extends AbstractExtension {\n\n public static final String KIND = \"Tag\";\n\n public static final GroupVersionKind GVK = GroupVersionKind.fromExtension(Tag.class);\n\n public static final String REQUIRE_SYNC_ON_STARTUP_INDEX_NAME = \"requireSyncOnStartup\";\n\n @Schema(requiredMode = REQUIRED)\n private TagSpec spec;\n\n @Schema\n private TagStatus status;\n\n @Data\n public static class TagSpec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String displayName;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String slug;\n\n private String description;\n\n /**\n * Color regex explanation.\n * 
\n         * ^                 # start of the line\n         * #                 # start with a number sign `#`\n         * (                 # start of (group 1)\n         *   [a-fA-F0-9]{6}  # support z-f, A-F and 0-9, with a length of 6\n         *   |               # or\n         *   [a-fA-F0-9]{3}  # support z-f, A-F and 0-9, with a length of 3\n         * )                 # end of (group 1)\n         * $                 # end of the line\n         *
\n */\n @Schema(pattern = \"^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$\")\n private String color;\n\n private String cover;\n }\n\n @JsonIgnore\n public TagStatus getStatusOrDefault() {\n if (this.status == null) {\n this.status = new TagStatus();\n }\n return this.status;\n }\n\n @Data\n public static class TagStatus {\n\n private String permalink;\n\n public Integer visiblePostCount;\n\n public Integer postCount;\n\n private Long observedVersion;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/endpoint/CustomEndpoint.java", "content": "package run.halo.app.core.extension.endpoint;\n\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * RouterFunction provider for custom endpoints.\n *\n * @author johnniang\n */\npublic interface CustomEndpoint {\n\n RouterFunction endpoint();\n\n default GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"api.console.halo.run/v1alpha1\");\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/endpoint/SortResolver.java", "content": "package run.halo.app.core.extension.endpoint;\n\nimport org.springframework.core.MethodParameter;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.data.web.ReactiveSortHandlerMethodArgumentResolver;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebExchange;\n\npublic interface SortResolver {\n\n SortResolver defaultInstance = new DefaultSortResolver();\n\n @NonNull\n Sort resolve(@NonNull ServerWebExchange exchange);\n\n class DefaultSortResolver extends ReactiveSortHandlerMethodArgumentResolver\n implements SortResolver {\n\n @Override\n @NonNull\n protected Sort getDefaultFromAnnotationOrFallback(@Nullable MethodParameter parameter) {\n return Sort.unsorted();\n }\n\n @Override\n public Sort resolve(ServerWebExchange exchange) {\n return resolveArgumentValue(null, null, exchange);\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/notification/Notification.java", "content": "package run.halo.app.core.extension.notification;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n *

{@link Notification} is a custom extension that used to store notification information for\n * inner use, it's on-site notification.

\n *\n *

Supports the following operations:

\n *
    \n *
  • Marked as read: {@link NotificationSpec#setUnread(boolean)}
    • \n *
  • Get the last read time: {@link NotificationSpec#getLastReadAt()}
    • \n *
  • Filter by recipient: {@link NotificationSpec#getRecipient()}
    • \n *
\n *\n * @author guqing\n * @see Reason\n * @see ReasonType\n * @since 2.10.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"notification.halo.run\", version = \"v1alpha1\", kind = \"Notification\", plural =\n \"notifications\", singular = \"notification\")\npublic class Notification extends AbstractExtension {\n\n @Schema\n private NotificationSpec spec;\n\n @Data\n public static class NotificationSpec {\n @Schema(requiredMode = REQUIRED, minLength = 1, description = \"The name of user\")\n private String recipient;\n\n @Schema(requiredMode = REQUIRED, minLength = 1, description = \"The name of reason\")\n private String reason;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String title;\n\n @Schema(requiredMode = REQUIRED)\n private String rawContent;\n\n @Schema(requiredMode = REQUIRED)\n private String htmlContent;\n\n private boolean unread;\n\n private Instant lastReadAt;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/notification/NotificationTemplate.java", "content": "package run.halo.app.core.extension.notification;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n *

{@link NotificationTemplate} is a custom extension that defines a notification template.

\n *

It describes the notification template's name, description, and the template content.

\n *

{@link Spec#getReasonSelector()} is used to select the template by reasonType and language,\n * if multiple templates are matched, the best match will be selected. This is useful when you\n * want to override the default template.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"notification.halo.run\", version = \"v1alpha1\", kind = \"NotificationTemplate\",\n plural = \"notificationtemplates\", singular = \"notificationtemplate\")\npublic class NotificationTemplate extends AbstractExtension {\n\n @Schema\n private Spec spec;\n\n @Data\n @Schema(name = \"NotificationTemplateSpec\")\n public static class Spec {\n @Schema\n private ReasonSelector reasonSelector;\n\n @Schema\n private Template template;\n }\n\n @Data\n @Schema(name = \"TemplateContent\")\n public static class Template {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String title;\n\n private String htmlBody;\n\n private String rawBody;\n }\n\n @Data\n public static class ReasonSelector {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String reasonType;\n\n @Schema(requiredMode = REQUIRED, minLength = 1, defaultValue = \"default\")\n private String language;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/notification/NotifierDescriptor.java", "content": "package run.halo.app.core.extension.notification;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n *

{@link NotifierDescriptor} is a custom extension that defines a notifier.

\n *

It describes the notifier's name, description, and the extension name of the notifier to\n * let the user know what the notifier is and what it can do in the UI and also let the\n * {@code NotificationCenter} know how to load the notifier and prepare the notifier's settings.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"notification.halo.run\", version = \"v1alpha1\", kind = \"NotifierDescriptor\",\n plural = \"notifierDescriptors\", singular = \"notifierDescriptor\")\npublic class NotifierDescriptor extends AbstractExtension {\n\n @Schema\n private Spec spec;\n\n @Data\n @Schema(name = \"NotifierDescriptorSpec\")\n public static class Spec {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String displayName;\n\n private String description;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String notifierExtName;\n\n private SettingRef senderSettingRef;\n\n private SettingRef receiverSettingRef;\n }\n\n @Data\n @Schema(name = \"NotifierSettingRef\")\n public static class SettingRef {\n @Schema(requiredMode = REQUIRED)\n private String name;\n\n @Schema(requiredMode = REQUIRED)\n private String group;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/notification/Reason.java", "content": "package run.halo.app.core.extension.notification;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.AllArgsConstructor;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.NoArgsConstructor;\nimport lombok.experimental.Accessors;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.notification.ReasonAttributes;\n\n/**\n *

{@link Reason} is a custom extension that defines a reason for a notification, It represents\n * an instance of a {@link ReasonType}.

\n *

It can be understood as an event that triggers a notification.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"notification.halo.run\", version = \"v1alpha1\", kind = \"Reason\", plural =\n \"reasons\", singular = \"reason\")\npublic class Reason extends AbstractExtension {\n\n @Schema\n private Spec spec;\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"ReasonSpec\")\n public static class Spec {\n @Schema(requiredMode = REQUIRED)\n private String reasonType;\n\n @Schema(requiredMode = REQUIRED)\n private Subject subject;\n\n @Schema(requiredMode = REQUIRED)\n private String author;\n\n @Schema(implementation = ReasonAttributes.class, requiredMode = NOT_REQUIRED,\n description = \"Attributes used to transfer data\")\n private ReasonAttributes attributes;\n }\n\n @Data\n @Builder\n @NoArgsConstructor\n @AllArgsConstructor\n @Schema(name = \"ReasonSubject\")\n public static class Subject {\n @Schema(requiredMode = REQUIRED)\n private String apiVersion;\n\n @Schema(requiredMode = REQUIRED)\n private String kind;\n\n @Schema(requiredMode = REQUIRED)\n private String name;\n\n @Schema(requiredMode = REQUIRED)\n private String title;\n\n private String url;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/notification/ReasonType.java", "content": "package run.halo.app.core.extension.notification;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n *

{@link ReasonType} is a custom extension that defines a type of reason.

\n *

One {@link ReasonType} can have multiple {@link Reason}s to notify.

\n *\n * @author guqing\n * @see NotificationTemplate\n * @see Reason\n * @since 2.10.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"notification.halo.run\", version = \"v1alpha1\", kind = \"ReasonType\",\n plural = \"reasontypes\", singular = \"reasontype\")\npublic class ReasonType extends AbstractExtension {\n public static final String LOCALIZED_RESOURCE_NAME_ANNO =\n \"notification.halo.run/localized-resource-name\";\n\n @Schema\n private Spec spec;\n\n @Data\n @Schema(name = \"ReasonTypeSpec\")\n public static class Spec {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String displayName;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String description;\n\n private List properties;\n }\n\n @Data\n public static class ReasonProperty {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String type;\n\n private String description;\n\n @Schema(defaultValue = \"false\")\n private boolean optional;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/notification/Subscription.java", "content": "package run.halo.app.core.extension.notification;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.apache.commons.lang3.StringUtils.defaultString;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.UUID;\nimport lombok.AllArgsConstructor;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.NoArgsConstructor;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n *

{@link Subscription} is a custom extension that defines a subscriber to be notified when a\n * certain {@link Reason} is triggered.

\n *

It holds a {@link Subscriber} to the user to be notified, a {@link InterestReason} to\n * subscribe to.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"notification.halo.run\", version = \"v1alpha1\", kind = \"Subscription\",\n plural = \"subscriptions\", singular = \"subscription\")\npublic class Subscription extends AbstractExtension {\n\n @Schema\n private Spec spec;\n\n @Data\n @Schema(name = \"SubscriptionSpec\")\n public static class Spec {\n @Schema(requiredMode = REQUIRED, description = \"The subscriber to be notified\")\n private Subscriber subscriber;\n\n @Schema(requiredMode = REQUIRED, description = \"The token to unsubscribe\")\n private String unsubscribeToken;\n\n @Schema(requiredMode = REQUIRED, description = \"The reason to be interested in\")\n private InterestReason reason;\n\n @Schema(description = \"Perhaps users need to unsubscribe and \"\n + \"interact without receiving notifications again\")\n private boolean disabled;\n }\n\n @Data\n public static class InterestReason {\n @Schema(requiredMode = REQUIRED, description = \"The name of the reason definition to be \"\n + \"interested in\")\n private String reasonType;\n\n @Schema(requiredMode = REQUIRED, description = \"The subject name of reason type to be\"\n + \" interested in\")\n private ReasonSubject subject;\n\n @Schema(requiredMode = NOT_REQUIRED, description = \"The expression to be interested in\")\n private String expression;\n\n /**\n *

Since 2.15.0, we have added a new field expression to the\n * InterestReason object, so subject can be null.

\n *

In this particular scenario, when the subject is null, we assign it a\n * default ReasonSubject object. The properties of this object are set to\n * specific values that do not occur in actual applications, thus we can consider this as\n * nonexistent data.\n * The purpose of this approach is to maintain backward compatibility, even if the\n * subject can be null in the new version of the code.

\n */\n public static void ensureSubjectHasValue(InterestReason interestReason) {\n if (interestReason.getSubject() == null) {\n interestReason.setSubject(createFallbackSubject());\n }\n }\n\n /**\n * Check if the given reason subject is a fallback subject.\n */\n public static boolean isFallbackSubject(ReasonSubject reasonSubject) {\n if (reasonSubject == null) {\n return true;\n }\n var fallback = createFallbackSubject();\n return fallback.getKind().equals(reasonSubject.getKind())\n && fallback.getApiVersion().equals(reasonSubject.getApiVersion());\n }\n\n static ReasonSubject createFallbackSubject() {\n return ReasonSubject.builder()\n .apiVersion(\"notification.halo.run/v1alpha1\")\n .kind(\"NonexistentKind\")\n .build();\n }\n }\n\n @Data\n @Builder\n @AllArgsConstructor\n @NoArgsConstructor\n @Schema(name = \"InterestReasonSubject\")\n public static class ReasonSubject {\n\n @Schema(requiredMode = NOT_REQUIRED, description = \"if name is not specified, it presents \"\n + \"all subjects of the specified reason type and custom resources\")\n private String name;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String apiVersion;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String kind;\n\n @Override\n public String toString() {\n return kind + \"#\" + apiVersion + \"/\" + defaultString(name);\n }\n }\n\n @Data\n @Schema(name = \"SubscriptionSubscriber\")\n public static class Subscriber {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String name;\n\n @Override\n public String toString() {\n return name;\n }\n }\n\n /**\n * Generate unsubscribe token for unsubscribe.\n *\n * @return unsubscribe token\n */\n public static String generateUnsubscribeToken() {\n return UUID.randomUUID().toString();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/extension/service/AttachmentService.java", "content": "package run.halo.app.core.extension.service;\n\nimport java.net.URI;\nimport java.net.URL;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.function.Consumer;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.extension.attachment.Attachment;\n\n/**\n * AttachmentService.\n *\n * @author johnniang\n * @since 2.5.0\n */\npublic interface AttachmentService {\n\n /**\n * Uploads the given attachment to specific storage using handlers in plugins.\n *

\n * If no handler can be found to upload the given attachment, ServerError exception will be\n * thrown.\n *\n * @param policyName is attachment policy name.\n * @param groupName is group name the attachment belongs.\n * @param filePart contains filename, content and media type.\n * @param beforeCreating is an attachment modifier before creating.\n * @return attachment.\n */\n Mono upload(\n @NonNull String username,\n @NonNull String policyName,\n @Nullable String groupName,\n @NonNull FilePart filePart,\n @Nullable Consumer beforeCreating);\n\n /**\n * Uploads the given attachment to specific storage using handlers in plugins. Please note\n * that we will make sure the request is authenticated, or an unauthorized exception throws.\n *

\n * If no handler can be found to upload the given attachment, ServerError exception will be\n * thrown.\n *\n * @param policyName is attachment policy name.\n * @param groupName is group name the attachment belongs.\n * @param filename is filename of the attachment.\n * @param content is binary data of the attachment.\n * @param mediaType is media type of the attachment.\n * @return attachment.\n */\n Mono upload(@NonNull String policyName,\n @Nullable String groupName,\n @NonNull String filename,\n @NonNull Flux content,\n @Nullable MediaType mediaType);\n\n /**\n * Deletes an attachment using handlers in plugins.\n *

\n * If no handler can be found to delete the given attachment, Mono.empty() will return.\n *\n * @param attachment is to be deleted.\n * @return deleted attachment.\n */\n Mono delete(Attachment attachment);\n\n /**\n * Gets permalink using handlers in plugins.\n *

\n * If no handler can be found to delete the given attachment, Mono.empty() will return.\n *\n * @param attachment is created attachment.\n * @return permalink\n */\n Mono getPermalink(Attachment attachment);\n\n /**\n * Gets shared URL using handlers in plugins.\n *

\n * If no handler can be found to delete the given attachment, Mono.empty() will return.\n *\n * @param attachment is created attachment.\n * @param ttl is time to live of the shared URL.\n * @return time-to-live shared URL. Please note that, if the attachment is stored in local, the\n * shared URL is equal to permalink.\n */\n Mono getSharedURL(Attachment attachment, Duration ttl);\n\n /**\n * Gets thumbnail links using handlers in plugins. Please make sure the attachment has\n * permalink.\n *\n * @param attachment is created attachment.\n * @return thumbnail links\n */\n Mono> getThumbnailLinks(Attachment attachment);\n\n /**\n * Transfer external links to attachments.\n *\n * @param url external url\n * @param policyName policy name\n * @param groupName group name\n * @param filename filename\n * @return attachment\n */\n Mono uploadFromUrl(@NonNull URL url, @NonNull String policyName,\n String groupName, String filename);\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/user/service/RoleService.java", "content": "package run.halo.app.core.user.service;\n\nimport java.util.Collection;\nimport java.util.Map;\nimport java.util.Set;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.extension.RoleBinding.Subject;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic interface RoleService {\n\n Flux listRoleBindings(Subject subject);\n\n Flux getRolesByUsername(String username);\n\n Mono>> getRolesByUsernames(Collection usernames);\n\n Mono contains(Collection source, Collection candidates);\n\n /**\n * This method lists all role templates as permissions recursively according to given role\n * name set.\n *\n * @param names is role name set.\n * @return an array of permissions.\n */\n Flux listPermissions(Set names);\n\n Flux listDependenciesFlux(Set names);\n\n /**\n * List roles by role names.\n *\n * @param roleNames role names\n * @return roles\n */\n Flux list(Set roleNames);\n\n /**\n * List roles by role names.\n *\n * @param roleNames role names\n * @param excludeHidden should exclude hidden roles\n * @return roles\n */\n Flux list(Set roleNames, boolean excludeHidden);\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/user/service/SignUpData.java", "content": "package run.halo.app.core.user.service;\n\nimport jakarta.validation.Constraint;\nimport jakarta.validation.ConstraintValidator;\nimport jakarta.validation.ConstraintValidatorContext;\nimport jakarta.validation.Payload;\nimport jakarta.validation.constraints.Email;\nimport jakarta.validation.constraints.NotBlank;\nimport jakarta.validation.constraints.Pattern;\nimport jakarta.validation.constraints.Size;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\nimport java.util.Objects;\nimport lombok.Data;\nimport run.halo.app.infra.ValidationUtils;\n\n/**\n * Sign up data.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Data\n@SignUpData.SignUpDataConstraint\npublic class SignUpData {\n\n @NotBlank\n @Size(min = 4, max = 63)\n @Pattern(regexp = ValidationUtils.NAME_REGEX,\n message = \"{validation.error.username.pattern}\")\n private String username;\n\n @NotBlank\n private String displayName;\n\n @Email\n private String email;\n\n private String emailCode;\n\n @NotBlank\n @Size(min = 5, max = 257)\n @Pattern(regexp = ValidationUtils.PASSWORD_REGEX,\n message = \"{validation.error.password.pattern}\")\n private String password;\n\n @NotBlank\n private String confirmPassword;\n\n @Target({ElementType.TYPE})\n @Retention(RetentionPolicy.RUNTIME)\n @Constraint(validatedBy = {SignUpDataConstraintValidator.class})\n public @interface SignUpDataConstraint {\n\n String message() default \"\";\n\n Class[] groups() default {};\n\n Class[] payload() default {};\n\n }\n\n private static class SignUpDataConstraintValidator\n implements ConstraintValidator {\n\n @Override\n public boolean isValid(SignUpData signUpData, ConstraintValidatorContext context) {\n var isValid = Objects.equals(signUpData.getPassword(), signUpData.getConfirmPassword());\n if (!isValid) {\n context.disableDefaultConstraintViolation();\n context.buildConstraintViolationWithTemplate(\n \"{signup.error.confirm-password-not-match}\"\n )\n .addPropertyNode(\"confirmPassword\")\n .addConstraintViolation();\n }\n return isValid;\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/user/service/UserPostCreatingHandler.java", "content": "package run.halo.app.core.user.service;\n\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\n\n/**\n * User post-creating handler.\n *\n * @author johnniang\n * @since 2.20.8\n */\npublic interface UserPostCreatingHandler extends ExtensionPoint {\n\n /**\n * Do something after creating user.\n *\n * @param user create user.\n * @return {@code Mono.empty()} if handling successfully.\n */\n Mono postCreating(User user);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/user/service/UserPreCreatingHandler.java", "content": "package run.halo.app.core.user.service;\n\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\n\n/**\n * User pre-creating handler.\n *\n * @author johnniang\n * @since 2.20.8\n */\npublic interface UserPreCreatingHandler extends ExtensionPoint {\n\n /**\n * Do something before user creating.\n *\n * @param user modifiable user detail\n * @return {@code Mono.empty()} if handling successfully.\n */\n Mono preCreating(User user);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/core/user/service/UserService.java", "content": "package run.halo.app.core.user.service;\n\nimport java.util.Collection;\nimport java.util.Set;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\n\npublic interface UserService {\n\n String GHOST_USER_NAME = \"ghost\";\n\n /**\n * Get user by username.\n *\n * @param username username\n * @return the mono user or user not found error\n */\n Mono getUser(String username);\n\n /**\n * Get user by verified email.\n *\n * @param email the verified email\n * @return the mono user or empty if not found\n */\n Mono findUserByVerifiedEmail(String email);\n\n Mono getUserOrGhost(String username);\n\n Flux getUsersOrGhosts(Collection names);\n\n Mono updatePassword(String username, String newPassword);\n\n Mono updateWithRawPassword(String username, String rawPassword);\n\n Mono grantRoles(String username, Set roles);\n\n /**\n * Check if the user has sufficient roles.\n *\n * @param roles roles to check\n * @return a Mono that emits true if the user has all the roles, false otherwise\n */\n Mono hasSufficientRoles(Collection roles);\n\n Mono signUp(SignUpData signUpData);\n\n Mono createUser(User user, Set roles);\n\n Mono confirmPassword(String username, String rawPassword);\n\n Flux listByEmail(String email);\n\n Mono checkEmailAlreadyVerified(String email);\n\n String encryptPassword(String rawPassword);\n\n Mono disable(String username);\n\n Mono enable(String username);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/post/PostDeletedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class PostDeletedEvent extends PostEvent {\n\n private final Post post;\n\n public PostDeletedEvent(Object source, Post post) {\n super(source, post.getMetadata().getName());\n this.post = post;\n }\n\n /**\n * Get original post.\n *\n * @return original post.\n */\n public Post getPost() {\n return post;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/post/PostEvent.java", "content": "package run.halo.app.event.post;\n\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * An abstract class for post events.\n *\n * @author johnniang\n */\npublic abstract class PostEvent extends ApplicationEvent {\n\n private final String name;\n\n public PostEvent(Object source, String name) {\n super(source);\n this.name = name;\n }\n\n /**\n * Gets post metadata name.\n *\n * @return post metadata name\n */\n public String getName() {\n return name;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/post/PostPublishedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class PostPublishedEvent extends PostEvent {\n\n public PostPublishedEvent(Object source, String postName) {\n super(source, postName);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/post/PostUnpublishedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class PostUnpublishedEvent extends PostEvent {\n\n public PostUnpublishedEvent(Object source, String postName) {\n super(source, postName);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/post/PostUpdatedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class PostUpdatedEvent extends PostEvent {\n\n public PostUpdatedEvent(Object source, String postName) {\n super(source, postName);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/post/PostVisibleChangedEvent.java", "content": "package run.halo.app.event.post;\n\nimport org.springframework.lang.Nullable;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class PostVisibleChangedEvent extends PostEvent {\n\n @Nullable\n private final Post.VisibleEnum oldVisible;\n\n private final Post.VisibleEnum newVisible;\n\n public PostVisibleChangedEvent(Object source, String postName,\n @Nullable Post.VisibleEnum oldVisible, Post.VisibleEnum newVisible) {\n super(source, postName);\n this.oldVisible = oldVisible;\n this.newVisible = newVisible;\n }\n\n @Nullable\n public Post.VisibleEnum getOldVisible() {\n return oldVisible;\n }\n\n public Post.VisibleEnum getNewVisible() {\n return newVisible;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/user/UserConnectionDisconnectedEvent.java", "content": "package run.halo.app.event.user;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.plugin.SharedEvent;\n\n/**\n * An event that will be triggered after a user connection is disconnected.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@SharedEvent\npublic class UserConnectionDisconnectedEvent extends ApplicationEvent {\n\n @Getter\n private final UserConnection userConnection;\n\n public UserConnectionDisconnectedEvent(Object source, UserConnection userConnection) {\n super(source);\n this.userConnection = userConnection;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/user/UserLoginEvent.java", "content": "package run.halo.app.event.user;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.plugin.SharedEvent;\n\n/**\n * User login event.\n *\n * @author lywq\n **/\n@SharedEvent\npublic class UserLoginEvent extends ApplicationEvent {\n\n @Getter\n private final User user;\n\n public UserLoginEvent(Object source, User user) {\n super(source);\n this.user = user;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/event/user/UserLogoutEvent.java", "content": "package run.halo.app.event.user;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.plugin.SharedEvent;\n\n/**\n * User logout event.\n *\n * @author lywq\n **/\n@SharedEvent\npublic class UserLogoutEvent extends ApplicationEvent {\n\n @Getter\n private final User user;\n\n public UserLogoutEvent(Object source, User user) {\n super(source);\n this.user = user;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/AbstractExtension.java", "content": "package run.halo.app.extension;\n\nimport lombok.Data;\n\n/**\n * AbstractExtension contains basic structure of Extension and implements the Extension interface.\n *\n * @author johnniang\n */\n@Data\npublic abstract class AbstractExtension implements Extension {\n\n private String apiVersion;\n\n private String kind;\n\n private MetadataOperator metadata;\n\n @Override\n public String getApiVersion() {\n var apiVersionFromGvk = Extension.super.getApiVersion();\n return apiVersionFromGvk != null ? apiVersionFromGvk : this.apiVersion;\n }\n\n @Override\n public String getKind() {\n var kindFromGvk = Extension.super.getKind();\n return kindFromGvk != null ? kindFromGvk : this.kind;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Comparators.java", "content": "package run.halo.app.extension;\n\nimport java.time.Instant;\nimport java.util.Comparator;\n\npublic enum Comparators {\n ;\n\n public static Comparator compareCreationTimestamp(boolean asc) {\n var comparator =\n Comparator.comparing(e -> e.getMetadata().getCreationTimestamp());\n return asc ? comparator : comparator.reversed();\n }\n\n public static Comparator compareName(boolean asc) {\n var comparator = Comparator.comparing(e -> e.getMetadata().getName());\n return asc ? comparator : comparator.reversed();\n }\n\n public static Comparator defaultComparator() {\n Comparator comparator = compareCreationTimestamp(false);\n comparator = comparator.thenComparing(compareName(true));\n return comparator;\n }\n\n /**\n * Get a nulls comparator.\n *\n * @param isAscending is ascending\n * @return if ascending, return nulls high, else return nulls low\n */\n public static Comparator nullsComparator(boolean isAscending) {\n return isAscending\n ? org.springframework.util.comparator.Comparators.nullsHigh()\n : org.springframework.util.comparator.Comparators.nullsLow();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ConfigMap.java", "content": "package run.halo.app.extension;\n\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.jspecify.annotations.Nullable;\n\n/**\n *

ConfigMap holds configuration data to consume.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"\", version = \"v1alpha1\", kind = ConfigMap.KIND, plural = \"configmaps\",\n singular = \"configmap\")\npublic class ConfigMap extends AbstractExtension {\n\n public static final String KIND = \"ConfigMap\";\n\n @Nullable\n private Map data;\n\n public ConfigMap putDataItem(String key, String dataItem) {\n if (this.data == null) {\n this.data = new LinkedHashMap<>();\n }\n this.data.put(key, dataItem);\n return this;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/DefaultExtensionMatcher.java", "content": "package run.halo.app.extension;\n\nimport lombok.Builder;\nimport lombok.Getter;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\n\n@Getter\n@RequiredArgsConstructor\n@Builder(builderMethodName = \"internalBuilder\")\npublic class DefaultExtensionMatcher implements ExtensionMatcher {\n private final ExtensionClient client;\n private final GroupVersionKind gvk;\n private final LabelSelector labelSelector;\n private final FieldSelector fieldSelector;\n\n public static DefaultExtensionMatcherBuilder builder(ExtensionClient client,\n GroupVersionKind gvk) {\n return internalBuilder().client(client).gvk(gvk);\n }\n\n /**\n * Match the given extension with the current matcher.\n *\n * @param extension extension to match\n * @return true if the extension matches the current matcher\n */\n @Override\n public boolean match(Extension extension) {\n if (!gvk.equals(extension.groupVersionKind())) {\n return false;\n }\n if (!hasFieldSelector() && !hasLabelSelector()) {\n return true;\n }\n var listOptions = new ListOptions();\n listOptions.setLabelSelector(labelSelector);\n var fieldQuery = Queries.equal(\"metadata.name\", extension.getMetadata().getName());\n if (hasFieldSelector()) {\n fieldQuery = fieldQuery.and((Condition) fieldSelector.query());\n }\n listOptions.setFieldSelector(new FieldSelector(fieldQuery));\n return client.countBy(extension.getClass(), listOptions) > 0;\n }\n\n boolean hasFieldSelector() {\n return fieldSelector != null && fieldSelector.query() != null;\n }\n\n boolean hasLabelSelector() {\n return labelSelector != null && !CollectionUtils.isEmpty(labelSelector.getConditions());\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Extension.java", "content": "package run.halo.app.extension;\n\nimport java.util.Comparator;\nimport java.util.Objects;\n\n/**\n * Extension is an interface which represents an Extension. It contains setters and getters of\n * GroupVersionKind and Metadata.\n */\npublic interface Extension extends ExtensionOperator, Comparable {\n\n @Override\n default int compareTo(Extension another) {\n if (another == null || another.getMetadata() == null) {\n return 1;\n }\n if (getMetadata() == null) {\n return -1;\n }\n return Objects.compare(getMetadata().getName(), another.getMetadata().getName(),\n Comparator.naturalOrder());\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ExtensionClient.java", "content": "package run.halo.app.extension;\n\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.function.Predicate;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.index.IndexedQueryEngine;\n\n/**\n * ExtensionClient is an interface which contains some operations on Extension instead of\n * ExtensionStore.\n *

\n * Please note that this client can only use in non-reactive environment. If you want to\n * use Extension client in reactive environment, please use {@link ReactiveExtensionClient} instead.\n *\n * @author johnniang\n */\npublic interface ExtensionClient {\n\n /**\n * Lists Extensions by Extension type, filter and sorter.\n *\n * @param type is the class type of Extension.\n * @param predicate filters the reEnqueue.\n * @param comparator sorts the reEnqueue.\n * @param is Extension type.\n * @return all filtered and sorted Extensions.\n */\n List list(Class type, Predicate predicate,\n Comparator comparator);\n\n /**\n * Lists Extensions by Extension type, filter, sorter and page info.\n *\n * @param type is the class type of Extension.\n * @param predicate filters the reEnqueue.\n * @param comparator sorts the reEnqueue.\n * @param page is page number which starts from 0.\n * @param size is page size.\n * @param is Extension type.\n * @return a list of Extensions.\n * @deprecated use {@link #listAll(Class, ListOptions, Sort)} instead.\n */\n @Deprecated\n ListResult list(Class type, Predicate predicate,\n Comparator comparator, int page, int size);\n\n List listAll(Class type, ListOptions options, Sort sort);\n\n List listAllNames(Class type, ListOptions options, Sort sort);\n\n List listTopNames(Class type, ListOptions options, Sort sort,\n int topN);\n\n ListResult listBy(Class type, ListOptions options,\n PageRequest page);\n\n ListResult listNamesBy(Class type, ListOptions options,\n PageRequest page);\n\n long countBy(Class type, ListOptions options);\n\n /**\n * Fetches Extension by its type and name.\n *\n * @param type is Extension type.\n * @param name is Extension name.\n * @param is Extension type.\n * @return an optional Extension.\n */\n Optional fetch(Class type, String name);\n\n Optional fetch(GroupVersionKind gvk, String name);\n\n\n /**\n * Creates an Extension.\n *\n * @param extension is fresh Extension to be created. Please make sure the Extension name does\n * not exist.\n * @param is Extension type.\n */\n void create(E extension);\n\n /**\n * Updates an Extension.\n *\n * @param extension is an Extension to be updated. Please make sure the resource version is\n * latest.\n * @param is Extension type.\n */\n void update(E extension);\n\n /**\n * Deletes an Extension.\n *\n * @param extension is an Extension to be deleted. Please make sure the resource version is\n * latest.\n * @param is Extension type.\n */\n void delete(E extension);\n\n @Deprecated(forRemoval = true, since = \"2.22.0\")\n IndexedQueryEngine indexedQueryEngine();\n\n void watch(Watcher watcher);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ExtensionMatcher.java", "content": "package run.halo.app.extension;\n\n@FunctionalInterface\npublic interface ExtensionMatcher {\n\n boolean match(Extension extension);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ExtensionOperator.java", "content": "package run.halo.app.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.function.Predicate;\nimport org.springframework.util.StringUtils;\n\n/**\n * ExtensionOperator contains some getters and setters for required fields of Extension.\n *\n * @author johnniang\n */\npublic interface ExtensionOperator {\n\n @Schema(requiredMode = REQUIRED)\n @JsonProperty(\"apiVersion\")\n default String getApiVersion() {\n final var gvk = getClass().getAnnotation(GVK.class);\n if (gvk == null) {\n // return null if having no GVK annotation\n return null;\n }\n if (StringUtils.hasText(gvk.group())) {\n return gvk.group() + \"/\" + gvk.version();\n }\n return gvk.version();\n }\n\n @Schema(requiredMode = REQUIRED)\n @JsonProperty(\"kind\")\n default String getKind() {\n final var gvk = getClass().getAnnotation(GVK.class);\n if (gvk == null) {\n // return null if having no GVK annotation\n return null;\n }\n return gvk.kind();\n }\n\n @Schema(requiredMode = REQUIRED, implementation = Metadata.class)\n @JsonProperty(\"metadata\")\n MetadataOperator getMetadata();\n\n void setApiVersion(String apiVersion);\n\n void setKind(String kind);\n\n void setMetadata(MetadataOperator metadata);\n\n /**\n * Sets GroupVersionKind of the Extension.\n *\n * @param gvk is GroupVersionKind data.\n */\n default void groupVersionKind(GroupVersionKind gvk) {\n setApiVersion(gvk.groupVersion().toString());\n setKind(gvk.kind());\n }\n\n /**\n * Gets GroupVersionKind of the Extension.\n *\n * @return GroupVersionKind of the Extension.\n */\n @JsonIgnore\n default GroupVersionKind groupVersionKind() {\n return GroupVersionKind.fromAPIVersionAndKind(getApiVersion(), getKind());\n }\n\n static Predicate isNotDeleted() {\n return ext -> ext.getMetadata().getDeletionTimestamp() == null;\n }\n\n static boolean isDeleted(ExtensionOperator extension) {\n return ExtensionUtil.isDeleted(extension);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ExtensionUtil.java", "content": "package run.halo.app.extension;\n\nimport static org.springframework.data.domain.Sort.Order.asc;\nimport static org.springframework.data.domain.Sort.Order.desc;\n\nimport java.util.Collections;\nimport java.util.HashSet;\nimport java.util.Set;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.index.query.Query;\n\npublic enum ExtensionUtil {\n ;\n\n /**\n * Label to mark an extension resource should not be overwritten during initialization.\n */\n public static final String DO_NOT_OVERWRITE_LABEL = \"halo.run/do-not-overwrite\";\n\n /**\n * Check if the extension has the do-not-overwrite label. If the label is present and set to\n * true, it indicates that the extension should not be overwritten during initialization.\n *\n * @param extension the extension\n * @return true if it has the label, false otherwise\n */\n public static boolean hasDoNotOverwriteLabel(ExtensionOperator extension) {\n if (extension.getMetadata() == null) {\n return false;\n }\n var labels = extension.getMetadata().getLabels();\n return labels != null && Boolean.parseBoolean(labels.get(DO_NOT_OVERWRITE_LABEL));\n }\n\n public static boolean isDeleted(ExtensionOperator extension) {\n return extension.getMetadata() != null\n && extension.getMetadata().getDeletionTimestamp() != null;\n }\n\n public static boolean addFinalizers(MetadataOperator metadata, Set finalizers) {\n var modifiableFinalizers = new HashSet<>(\n metadata.getFinalizers() == null ? Collections.emptySet() : metadata.getFinalizers());\n var added = modifiableFinalizers.addAll(finalizers);\n if (added) {\n metadata.setFinalizers(modifiableFinalizers);\n }\n return added;\n }\n\n public static boolean removeFinalizers(MetadataOperator metadata, Set finalizers) {\n if (metadata.getFinalizers() == null) {\n return false;\n }\n var existingFinalizers = new HashSet<>(metadata.getFinalizers());\n var removed = existingFinalizers.removeAll(finalizers);\n if (removed) {\n metadata.setFinalizers(existingFinalizers);\n }\n return removed;\n }\n\n /**\n * Query for not deleting.\n *\n * @return Query\n */\n public static Query notDeleting() {\n return Queries.isNull(\"metadata.deletionTimestamp\");\n }\n\n /**\n * Default sort by creation timestamp desc and name asc.\n *\n * @return Sort\n */\n public static Sort defaultSort() {\n return Sort.by(\n desc(\"metadata.creationTimestamp\"),\n asc(\"metadata.name\")\n );\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/GVK.java", "content": "package run.halo.app.extension;\n\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n/**\n * GVK is an annotation to specific metadata of Extension.\n *\n * @author johnniang\n */\n@Retention(RetentionPolicy.RUNTIME)\n@Target(ElementType.TYPE)\npublic @interface GVK {\n\n /**\n * @return group name of Extension.\n */\n String group();\n\n /**\n * @return version name of Extension.\n */\n String version();\n\n /**\n * @return kind name of Extension.\n */\n String kind();\n\n /**\n * @return plural name of Extension.\n */\n String plural();\n\n /**\n * @return singular name of Extension.\n */\n String singular();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/GroupKind.java", "content": "package run.halo.app.extension;\n\n/**\n * GroupKind contains group and kind data only.\n *\n * @param group is group name of Extension.\n * @param kind is kind name of Extension.\n * @author johnniang\n */\npublic record GroupKind(String group, String kind) {\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/GroupVersion.java", "content": "package run.halo.app.extension;\n\nimport org.springframework.util.Assert;\nimport org.springframework.util.StringUtils;\n\n/**\n * GroupVersion contains group and version name of an Extension only.\n *\n * @param group is group name of Extension.\n * @param version is version name of Extension.\n * @author johnniang\n */\npublic record GroupVersion(String group, String version) {\n\n @Override\n public String toString() {\n return StringUtils.hasText(group) ? group + \"/\" + version : version;\n }\n\n /**\n * Parses APIVersion into GroupVersion record.\n *\n * @param apiVersion must not be blank.\n * 1. If the given apiVersion does not contain any \"/\", we treat the group is empty.\n * 2. If the given apiVersion contains more than 1 \"/\", we will throw an\n * IllegalArgumentException.\n * @return record contains group and version.\n */\n public static GroupVersion parseAPIVersion(String apiVersion) {\n Assert.hasText(apiVersion, \"API version must not be blank\");\n\n var groupVersion = apiVersion.split(\"/\");\n return switch (groupVersion.length) {\n case 1 -> new GroupVersion(\"\", apiVersion);\n case 2 -> new GroupVersion(groupVersion[0], groupVersion[1]);\n default ->\n throw new IllegalArgumentException(\"Unexpected APIVersion string: \" + apiVersion);\n };\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/GroupVersionKind.java", "content": "package run.halo.app.extension;\n\nimport org.springframework.util.Assert;\nimport org.springframework.util.StringUtils;\n\n/**\n * GroupVersionKind contains group, version and kind name of an Extension.\n *\n * @param group is group name of Extension.\n * @param version is version name of Extension.\n * @param kind is kind name of Extension.\n * @author johnniang\n */\npublic record GroupVersionKind(String group, String version, String kind) {\n\n public GroupVersionKind {\n Assert.hasText(version, \"Version must not be blank\");\n Assert.hasText(kind, \"Kind must not be blank\");\n }\n\n /**\n * Gets group and version name of Extension.\n *\n * @return group and version name of Extension.\n */\n public GroupVersion groupVersion() {\n return new GroupVersion(group, version);\n }\n\n public GroupKind groupKind() {\n return new GroupKind(group, kind);\n }\n\n public boolean hasGroup() {\n return StringUtils.hasText(group);\n }\n\n /**\n * Composes GroupVersionKind from API version and kind name.\n *\n * @param apiVersion is API version. Like \"core.halo.run/v1alpha1\"\n * @param kind is kind name of Extension.\n * @return GroupVersionKind of an Extension.\n */\n public static GroupVersionKind fromAPIVersionAndKind(String apiVersion, String kind) {\n Assert.hasText(kind, \"Kind must not be blank\");\n\n var gv = GroupVersion.parseAPIVersion(apiVersion);\n return new GroupVersionKind(gv.group(), gv.version(), kind);\n }\n\n public static GroupVersionKind fromExtension(Class extension) {\n GVK gvk = extension.getAnnotation(GVK.class);\n return new GroupVersionKind(gvk.group(), gvk.version(), gvk.kind());\n }\n\n @Override\n public String toString() {\n if (hasGroup()) {\n return group + \"/\" + version + \"/\" + kind;\n }\n return version + \"/\" + kind;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/JsonExtension.java", "content": "package run.halo.app.extension;\n\nimport com.fasterxml.jackson.core.JsonGenerator;\nimport com.fasterxml.jackson.core.JsonParser;\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport com.fasterxml.jackson.databind.DeserializationContext;\nimport com.fasterxml.jackson.databind.JsonDeserializer;\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.JsonSerializer;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.SerializerProvider;\nimport com.fasterxml.jackson.databind.annotation.JsonDeserialize;\nimport com.fasterxml.jackson.databind.annotation.JsonSerialize;\nimport com.fasterxml.jackson.databind.node.LongNode;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport com.fasterxml.jackson.databind.node.TextNode;\nimport java.io.IOException;\nimport java.time.Instant;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\n\n/**\n * JsonExtension is representation an extension using ObjectNode. This extension is preparing for\n * patching in the future.\n *\n * @author johnniang\n */\n@JsonSerialize(using = JsonExtension.ObjectNodeExtensionSerializer.class)\n@JsonDeserialize(using = JsonExtension.ObjectNodeExtensionDeSerializer.class)\n@Deprecated(forRemoval = true, since = \"2.23.0\")\npublic class JsonExtension implements Extension {\n\n private final ObjectMapper objectMapper;\n\n private final ObjectNode objectNode;\n\n public JsonExtension(ObjectMapper objectMapper) {\n this(objectMapper, objectMapper.createObjectNode());\n }\n\n public JsonExtension(ObjectMapper objectMapper, ObjectNode objectNode) {\n this.objectMapper = objectMapper;\n this.objectNode = objectNode;\n }\n\n public JsonExtension(ObjectMapper objectMapper, Extension e) {\n this(objectMapper, (ObjectNode) objectMapper.valueToTree(e));\n }\n\n @Override\n public MetadataOperator getMetadata() {\n var metadataNode = objectNode.get(\"metadata\");\n if (metadataNode == null) {\n return null;\n }\n return new ObjectNodeMetadata((ObjectNode) metadataNode);\n }\n\n @Override\n public String getApiVersion() {\n var apiVersionNode = objectNode.get(\"apiVersion\");\n return apiVersionNode == null ? null : apiVersionNode.asText();\n }\n\n @Override\n public String getKind() {\n return objectNode.get(\"kind\").asText();\n }\n\n @Override\n public void setApiVersion(String apiVersion) {\n objectNode.set(\"apiVersion\", new TextNode(apiVersion));\n }\n\n @Override\n public void setKind(String kind) {\n objectNode.set(\"kind\", new TextNode(kind));\n }\n\n @Override\n public void setMetadata(MetadataOperator metadata) {\n objectNode.set(\"metadata\", objectMapper.valueToTree(metadata));\n }\n\n public static class ObjectNodeExtensionSerializer extends JsonSerializer {\n\n @Override\n public void serialize(JsonExtension value, JsonGenerator gen,\n SerializerProvider serializers) throws IOException {\n gen.writeTree(value.objectNode);\n }\n }\n\n public static class ObjectNodeExtensionDeSerializer\n extends JsonDeserializer {\n\n @Override\n public JsonExtension deserialize(JsonParser p, DeserializationContext ctxt)\n throws IOException {\n var mapper = (ObjectMapper) p.getCodec();\n var treeNode = mapper.readTree(p);\n return new JsonExtension(mapper, (ObjectNode) treeNode);\n }\n }\n\n /**\n * Get internal representation.\n *\n * @return internal representation\n */\n public ObjectNode getInternal() {\n return objectNode;\n }\n\n /**\n * Get object mapper.\n *\n * @return object mapper\n */\n public ObjectMapper getObjectMapper() {\n return objectMapper;\n }\n\n public MetadataOperator getMetadataOrCreate() {\n var metadataNode = objectMapper.createObjectNode();\n objectNode.set(\"metadata\", metadataNode);\n return new ObjectNodeMetadata(metadataNode);\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n JsonExtension that = (JsonExtension) o;\n return Objects.equals(objectNode, that.objectNode);\n }\n\n @Override\n public int hashCode() {\n return Objects.hash(objectNode);\n }\n\n class ObjectNodeMetadata implements MetadataOperator {\n\n private final ObjectNode objectNode;\n\n public ObjectNodeMetadata(ObjectNode objectNode) {\n this.objectNode = objectNode;\n }\n\n @Override\n public String getName() {\n var nameNode = objectNode.get(\"name\");\n return objectMapper.convertValue(nameNode, String.class);\n }\n\n @Override\n public String getGenerateName() {\n var generateNameNode = objectNode.get(\"generateName\");\n return objectMapper.convertValue(generateNameNode, String.class);\n }\n\n @Override\n public Map getLabels() {\n var labelsNode = objectNode.get(\"labels\");\n return objectMapper.convertValue(labelsNode, new TypeReference<>() {\n });\n }\n\n @Override\n public Map getAnnotations() {\n var annotationsNode = objectNode.get(\"annotations\");\n return objectMapper.convertValue(annotationsNode, new TypeReference<>() {\n });\n }\n\n @Override\n public Long getVersion() {\n JsonNode versionNode = objectNode.get(\"version\");\n return objectMapper.convertValue(versionNode, Long.class);\n }\n\n @Override\n public Instant getCreationTimestamp() {\n return objectMapper.convertValue(objectNode.get(\"creationTimestamp\"), Instant.class);\n }\n\n @Override\n public Instant getDeletionTimestamp() {\n return objectMapper.convertValue(objectNode.get(\"deletionTimestamp\"), Instant.class);\n }\n\n @Override\n public Set getFinalizers() {\n return objectMapper.convertValue(objectNode.get(\"finalizers\"), new TypeReference<>() {\n });\n }\n\n @Override\n public void setName(String name) {\n if (name != null) {\n objectNode.set(\"name\", TextNode.valueOf(name));\n }\n }\n\n @Override\n public void setGenerateName(String generateName) {\n if (generateName != null) {\n objectNode.set(\"generateName\", TextNode.valueOf(generateName));\n }\n }\n\n @Override\n public void setLabels(Map labels) {\n if (labels != null) {\n objectNode.set(\"labels\", objectMapper.valueToTree(labels));\n }\n }\n\n @Override\n public void setAnnotations(Map annotations) {\n if (annotations != null) {\n objectNode.set(\"annotations\", objectMapper.valueToTree(annotations));\n }\n }\n\n @Override\n public void setVersion(Long version) {\n if (version != null) {\n objectNode.set(\"version\", LongNode.valueOf(version));\n }\n }\n\n @Override\n public void setCreationTimestamp(Instant creationTimestamp) {\n if (creationTimestamp != null) {\n objectNode.set(\"creationTimestamp\", objectMapper.valueToTree(creationTimestamp));\n }\n }\n\n @Override\n public void setDeletionTimestamp(Instant deletionTimestamp) {\n if (deletionTimestamp != null) {\n objectNode.set(\"deletionTimestamp\", objectMapper.valueToTree(deletionTimestamp));\n }\n }\n\n @Override\n public void setFinalizers(Set finalizers) {\n if (finalizers != null) {\n objectNode.set(\"finalizers\", objectMapper.valueToTree(finalizers));\n }\n }\n\n @Override\n public boolean equals(Object o) {\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n\n ObjectNodeMetadata that = (ObjectNodeMetadata) o;\n return Objects.equals(objectNode, that.objectNode);\n }\n\n @Override\n public int hashCode() {\n return Objects.hashCode(objectNode);\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ListOptions.java", "content": "package run.halo.app.extension;\n\nimport java.util.List;\nimport java.util.function.Function;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.LabelCondition;\nimport run.halo.app.extension.index.query.Query;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\n\n@Data\n@Accessors(chain = true)\npublic class ListOptions {\n\n private LabelSelector labelSelector;\n\n private FieldSelector fieldSelector;\n\n @Override\n public String toString() {\n return toCondition().toString();\n }\n\n /**\n * Convert to a single condition.\n *\n * @return the condition, never null\n */\n @NonNull\n public Condition toCondition() {\n Condition condition = null;\n var fieldSelector = getFieldSelector();\n if (fieldSelector != null && fieldSelector.query() != null) {\n var query = fieldSelector.query();\n if (!(query instanceof Condition fieldCondition)) {\n throw new IllegalArgumentException(\"Only support condition query\");\n }\n condition = fieldCondition;\n }\n var labelSelector = getLabelSelector();\n if (labelSelector != null) {\n var labelCondition = labelSelector.getConditions().stream()\n .map(Function.identity())\n .reduce(Condition::and)\n .orElse(null);\n if (labelCondition != null) {\n if (condition == null) {\n condition = labelCondition;\n } else {\n condition = condition.and(labelCondition);\n }\n }\n }\n return condition == null ? Condition.empty() : condition;\n }\n\n public static ListOptionsBuilder builder() {\n return new ListOptionsBuilder();\n }\n\n public static ListOptionsBuilder builder(ListOptions listOptions) {\n return new ListOptionsBuilder(listOptions);\n }\n\n public static class ListOptionsBuilder {\n private LabelSelectorBuilder labelSelectorBuilder;\n private Query query;\n\n public ListOptionsBuilder() {\n }\n\n /**\n * Create a new list options builder with the given list options.\n */\n public ListOptionsBuilder(ListOptions listOptions) {\n if (listOptions.getLabelSelector() != null) {\n this.labelSelectorBuilder = new LabelSelectorBuilder(\n listOptions.getLabelSelector().getConditions(), this);\n }\n if (listOptions.getFieldSelector() != null) {\n this.query = listOptions.getFieldSelector().query();\n }\n }\n\n /**\n * Create a new label selector builder.\n */\n public LabelSelectorBuilder labelSelector() {\n if (labelSelectorBuilder == null) {\n labelSelectorBuilder = new LabelSelectorBuilder(this);\n }\n return labelSelectorBuilder;\n }\n\n public ListOptionsBuilder fieldQuery(Query query) {\n this.query = query;\n return this;\n }\n\n /**\n * And the given query to the current query.\n */\n public ListOptionsBuilder andQuery(Query query) {\n if (!(query instanceof Condition condition)) {\n throw new IllegalArgumentException(\"Given query must be an instance of Condition\");\n }\n if (this.query == null) {\n this.query = condition;\n } else {\n if (!(this.query instanceof Condition currentCondition)) {\n throw new IllegalArgumentException(\n \"Current query must be an instance of Condition\"\n );\n }\n this.query = currentCondition.and(condition);\n }\n return this;\n }\n\n /**\n * Or the given query to the current query.\n */\n public ListOptionsBuilder orQuery(Query query) {\n if (!(query instanceof Condition condition)) {\n throw new IllegalArgumentException(\"Given query must be an instance of Condition\");\n }\n if (this.query == null) {\n this.query = condition;\n } else {\n if (!(this.query instanceof Condition currentCondition)) {\n throw new IllegalArgumentException(\n \"Current query must be an instance of Condition\"\n );\n }\n this.query = currentCondition.or(condition);\n }\n return this;\n }\n\n /**\n * Build the list options.\n */\n public ListOptions build() {\n var listOptions = new ListOptions();\n if (labelSelectorBuilder != null) {\n listOptions.setLabelSelector(labelSelectorBuilder.build());\n }\n if (query != null) {\n listOptions.setFieldSelector(FieldSelector.of(query));\n }\n return listOptions;\n }\n }\n\n public static class LabelSelectorBuilder\n extends LabelSelector.LabelSelectorBuilder {\n private final ListOptionsBuilder listOptionsBuilder;\n\n public LabelSelectorBuilder(List conditions,\n ListOptionsBuilder listOptionsBuilder) {\n super(conditions);\n this.listOptionsBuilder = listOptionsBuilder;\n }\n\n public LabelSelectorBuilder(ListOptionsBuilder listOptionsBuilder) {\n this.listOptionsBuilder = listOptionsBuilder;\n }\n\n public ListOptionsBuilder end() {\n return this.listOptionsBuilder;\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ListResult.java", "content": "package run.halo.app.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.Iterator;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.function.Supplier;\nimport java.util.stream.Stream;\nimport lombok.Data;\nimport org.springframework.util.Assert;\nimport run.halo.app.infra.utils.GenericClassUtils;\n\n@Data\npublic class ListResult implements Iterable, Supplier> {\n\n @Schema(description = \"Page number, starts from 1. If not set or equal to 0, it means no \"\n + \"pagination.\", requiredMode = REQUIRED)\n private final int page;\n\n @Schema(description = \"Size of each page. If not set or equal to 0, it means no pagination.\",\n requiredMode = REQUIRED)\n private final int size;\n\n @Schema(description = \"Total elements.\", requiredMode = REQUIRED)\n private final long total;\n\n @Schema(description = \"A chunk of items.\", requiredMode = REQUIRED)\n private final List items;\n\n @JsonCreator\n public ListResult(\n @JsonProperty(\"page\") int page,\n @JsonProperty(\"size\") int size,\n @JsonProperty(\"total\") long total,\n @JsonProperty(\"items\") List items) {\n Assert.isTrue(total >= 0, \"Total elements must be greater than or equal to 0\");\n if (page < 0) {\n page = 0;\n }\n if (size < 0) {\n size = 0;\n }\n if (items == null) {\n items = Collections.emptyList();\n }\n this.page = page;\n this.size = size;\n this.total = total;\n this.items = items;\n }\n\n public ListResult(List items) {\n this(0, 0, items.size(), items);\n }\n\n @Schema(description = \"Indicates whether current page is the first page.\",\n requiredMode = REQUIRED)\n public boolean isFirst() {\n return !hasPrevious();\n }\n\n @Schema(description = \"Indicates whether current page is the last page.\",\n requiredMode = REQUIRED)\n public boolean isLast() {\n return !hasNext();\n }\n\n @Schema(description = \"Indicates whether current page has previous page.\",\n requiredMode = REQUIRED)\n @JsonProperty(\"hasNext\")\n public boolean hasNext() {\n if (page <= 0) {\n return false;\n }\n return page < getTotalPages();\n }\n\n @Schema(description = \"Indicates whether current page has previous page.\",\n requiredMode = REQUIRED)\n @JsonProperty(\"hasPrevious\")\n public boolean hasPrevious() {\n return page > 1;\n }\n\n @Override\n public Iterator iterator() {\n return items.iterator();\n }\n\n @Schema(description = \"Indicates total pages.\", requiredMode = REQUIRED)\n @JsonProperty(\"totalPages\")\n public long getTotalPages() {\n return size == 0 ? 1 : (total + size - 1) / size;\n }\n\n /**\n * Generate generic ListResult class. Like {@code ListResult}, {@code ListResult},\n * etc.\n *\n * @param scheme scheme of the generic type.\n * @return generic ListResult class.\n */\n public static Class generateGenericClass(Scheme scheme) {\n return GenericClassUtils.generateConcreteClass(ListResult.class,\n scheme.type(),\n () -> {\n var pkgName = scheme.type().getPackageName();\n return pkgName + '.' + scheme.groupVersionKind().kind() + \"List\";\n });\n }\n\n /**\n * Generate generic ListResult class. Like {@code ListResult}, {@code ListResult},\n * etc.\n *\n * @param type the generic type of {@link ListResult}.\n * @return generic ListResult class.\n */\n public static Class generateGenericClass(Class type) {\n return GenericClassUtils.generateConcreteClass(ListResult.class, type,\n () -> type.getName() + \"List\");\n }\n\n public static ListResult emptyResult() {\n return new ListResult<>(List.of());\n }\n\n /**\n * Manually paginate the List collection.\n */\n public static List subList(List list, int page, int size) {\n if (page < 1) {\n page = 1;\n }\n if (size < 1) {\n return list;\n }\n List listSort = new ArrayList<>();\n int total = list.size();\n int pageStart = page == 1 ? 0 : (page - 1) * size;\n int pageEnd = Math.min(total, page * size);\n if (total > pageStart) {\n listSort = list.subList(pageStart, pageEnd);\n }\n return listSort;\n }\n\n /**\n * Gets the first element of the list result.\n */\n public static Optional first(ListResult listResult) {\n return Optional.ofNullable(listResult)\n .map(ListResult::getItems)\n .map(list -> list.isEmpty() ? null : list.get(0));\n }\n\n @Override\n public Stream get() {\n return items.stream();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Metadata.java", "content": "package run.halo.app.extension;\n\nimport java.time.Instant;\nimport java.util.Map;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\n\n/**\n * Metadata of Extension.\n *\n * @author johnniang\n */\n@Data\n@EqualsAndHashCode(exclude = \"version\")\npublic class Metadata implements MetadataOperator {\n\n /**\n * Metadata name. The name is unique globally.\n */\n private String name;\n\n /**\n * Generate name is for generating metadata name automatically.\n */\n private String generateName;\n\n /**\n * Labels are like key-value format.\n */\n private Map labels;\n\n /**\n * Annotations are like key-value format.\n */\n private Map annotations;\n\n /**\n * Current version of the Extension. It will be bumped up every update.\n */\n private Long version;\n\n /**\n * Creation timestamp of the Extension.\n */\n private Instant creationTimestamp;\n\n /**\n * Deletion timestamp of the Extension.\n */\n private Instant deletionTimestamp;\n\n private Set finalizers;\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/MetadataOperator.java", "content": "package run.halo.app.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport com.fasterxml.jackson.databind.annotation.JsonDeserialize;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\n\n/**\n * MetadataOperator contains some getters and setters for required fields of metadata.\n *\n * @author johnniang\n */\n@JsonDeserialize(as = Metadata.class)\n@tools.jackson.databind.annotation.JsonDeserialize(as = Metadata.class)\n@Schema(implementation = Metadata.class)\npublic interface MetadataOperator {\n\n @Schema(name = \"name\", description = \"Metadata name\", requiredMode = REQUIRED)\n @JsonProperty(\"name\")\n String getName();\n\n @Schema(name = \"generateName\", description = \"The name field will be generated automatically \"\n + \"according to the given generateName field\")\n String getGenerateName();\n\n @Schema(name = \"labels\")\n @JsonProperty(\"labels\")\n Map getLabels();\n\n @Schema(name = \"annotations\")\n @JsonProperty(\"annotations\")\n Map getAnnotations();\n\n @Schema(name = \"version\", nullable = true)\n @JsonProperty(\"version\")\n Long getVersion();\n\n @Schema(name = \"creationTimestamp\", nullable = true)\n @JsonProperty(\"creationTimestamp\")\n Instant getCreationTimestamp();\n\n @Schema(name = \"deletionTimestamp\", nullable = true)\n @JsonProperty(\"deletionTimestamp\")\n Instant getDeletionTimestamp();\n\n @Schema(name = \"finalizers\", nullable = true)\n Set getFinalizers();\n\n void setName(String name);\n\n void setGenerateName(String generateName);\n\n void setLabels(Map labels);\n\n void setAnnotations(Map annotations);\n\n void setVersion(Long version);\n\n void setCreationTimestamp(Instant creationTimestamp);\n\n void setDeletionTimestamp(Instant deletionTimestamp);\n\n void setFinalizers(Set finalizers);\n\n /**\n * Equals method for metadata.\n *\n * @param left metadata\n * @param right metadata\n * @return true if equals, false otherwise\n */\n static boolean equals(MetadataOperator left, MetadataOperator right) {\n if (left == null && right == null) {\n return true;\n }\n if (left == null || right == null) {\n return false;\n }\n return Objects.equals(left.getName(), right.getName())\n && Objects.equals(left.getGenerateName(), right.getGenerateName())\n && Objects.equals(left.getLabels(), right.getLabels())\n && Objects.equals(left.getAnnotations(), right.getAnnotations())\n && Objects.equals(left.getCreationTimestamp(), right.getCreationTimestamp())\n && Objects.equals(left.getDeletionTimestamp(), right.getDeletionTimestamp())\n && Objects.equals(left.getVersion(), right.getVersion())\n && Objects.equals(left.getFinalizers(), right.getFinalizers());\n }\n\n /**\n * Hash code for metadata.\n *\n * @param metadata metadata\n * @return hash code\n */\n static int hashCode(MetadataOperator metadata) {\n return Objects.hash(\n metadata.getName(),\n metadata.getGenerateName(),\n metadata.getLabels(),\n metadata.getAnnotations(),\n metadata.getCreationTimestamp(),\n metadata.getDeletionTimestamp(),\n metadata.getVersion(),\n metadata.getFinalizers()\n );\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/MetadataUtil.java", "content": "package run.halo.app.extension;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.springframework.util.Assert;\n\npublic enum MetadataUtil {\n ;\n\n public static final String SYSTEM_FINALIZER = \"system-protection\";\n public static final String HIDDEN_LABEL = \"halo.run/hidden\";\n\n /**\n * Gets extension metadata labels null safe.\n *\n * @param extension extension must not be null\n * @return extension metadata labels\n */\n public static Map nullSafeLabels(AbstractExtension extension) {\n Assert.notNull(extension, \"The extension must not be null.\");\n Assert.notNull(extension.getMetadata(), \"The extension metadata must not be null.\");\n Map labels = extension.getMetadata().getLabels();\n if (labels == null) {\n labels = new HashMap<>();\n extension.getMetadata().setLabels(labels);\n }\n return labels;\n }\n\n /**\n * Gets extension metadata annotations null safe.\n *\n * @param extension extension must not be null\n * @return extension metadata annotations\n */\n public static Map nullSafeAnnotations(AbstractExtension extension) {\n Assert.notNull(extension, \"The extension must not be null.\");\n Assert.notNull(extension.getMetadata(), \"The extension metadata must not be null.\");\n Map annotations = extension.getMetadata().getAnnotations();\n if (annotations == null) {\n annotations = new HashMap<>();\n extension.getMetadata().setAnnotations(annotations);\n }\n return annotations;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/PageRequest.java", "content": "package run.halo.app.extension;\n\nimport org.springframework.data.domain.Sort;\nimport org.springframework.util.Assert;\n\n/**\n *

{@link PageRequest} is an interface for pagination information.

\n *

Page number starts from 1.

\n *

if page size is 0, it means no pagination and all results will be returned.

\n *\n * @author guqing\n * @see PageRequestImpl\n * @since 2.12.0\n */\npublic interface PageRequest {\n int getPageNumber();\n\n int getPageSize();\n\n PageRequest previous();\n\n PageRequest next();\n\n /**\n * Returns the previous {@link PageRequest} or the first {@link PageRequest} if the current one\n * already is the first one.\n *\n * @return a new {@link org.springframework.data.domain.PageRequest} with\n * {@link #getPageNumber()} - 1 as {@link #getPageNumber()}\n */\n PageRequest previousOrFirst();\n\n /**\n * Returns the {@link PageRequest} requesting the first page.\n *\n * @return a new {@link org.springframework.data.domain.PageRequest} with\n * {@link #getPageNumber()} = 1 as {@link #getPageNumber()}\n */\n PageRequest first();\n\n /**\n * Creates a new {@link PageRequest} with {@code pageNumber} applied.\n *\n * @param pageNumber 1-based page index.\n * @return a new {@link org.springframework.data.domain.PageRequest}\n */\n PageRequest withPage(int pageNumber);\n\n PageRequestImpl withSort(Sort sort);\n\n boolean hasPrevious();\n\n Sort getSort();\n\n /**\n * Returns the current {@link Sort} or the given one if the current one is unsorted.\n *\n * @param sort must not be {@literal null}.\n * @return the current {@link Sort} or the given one if the current one is unsorted.\n */\n default Sort getSortOr(Sort sort) {\n Assert.notNull(sort, \"Fallback Sort must not be null\");\n return getSort().isSorted() ? getSort() : sort;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/PageRequestImpl.java", "content": "package run.halo.app.extension;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.util.Assert;\n\n@Slf4j\npublic class PageRequestImpl implements PageRequest {\n\n public static final int MAX_SIZE = 1_000;\n\n private final int pageNumber;\n private final int pageSize;\n private final Sort sort;\n\n public PageRequestImpl(int pageNumber, int pageSize, Sort sort) {\n Assert.notNull(sort, \"Sort must not be null\");\n if (pageNumber < 1) {\n pageNumber = 1;\n }\n if (pageSize <= 0) {\n log.warn(\"Page size must be greater than 0, reset to default {}\", MAX_SIZE);\n pageSize = MAX_SIZE;\n }\n if (pageSize > 1000) {\n log.warn(\"Page size must not be greater than {}, reset to {}\", MAX_SIZE, MAX_SIZE);\n pageSize = MAX_SIZE;\n }\n this.pageNumber = pageNumber;\n this.pageSize = pageSize;\n this.sort = sort;\n }\n\n public static PageRequestImpl of(int pageNumber, int pageSize) {\n return of(pageNumber, pageSize, Sort.unsorted());\n }\n\n public static PageRequestImpl of(int pageNumber, int pageSize, Sort sort) {\n return new PageRequestImpl(pageNumber, pageSize, sort);\n }\n\n public static PageRequestImpl ofSize(int pageSize) {\n return PageRequestImpl.of(1, pageSize);\n }\n\n @Override\n public int getPageNumber() {\n return pageNumber;\n }\n\n @Override\n public int getPageSize() {\n return pageSize;\n }\n\n @Override\n public PageRequest previous() {\n return getPageNumber() == 0 ? this\n : new PageRequestImpl(getPageNumber() - 1, getPageSize(), getSort());\n }\n\n @Override\n public Sort getSort() {\n return sort;\n }\n\n @Override\n public PageRequest next() {\n return new PageRequestImpl(getPageNumber() + 1, getPageSize(), getSort());\n }\n\n @Override\n public PageRequest previousOrFirst() {\n return hasPrevious() ? previous() : first();\n }\n\n @Override\n public PageRequest first() {\n return new PageRequestImpl(1, getPageSize(), getSort());\n }\n\n @Override\n public PageRequest withPage(int pageNumber) {\n return new PageRequestImpl(pageNumber, getPageSize(), getSort());\n }\n\n @Override\n public PageRequestImpl withSort(Sort sort) {\n return new PageRequestImpl(getPageNumber(), getPageSize(),\n defaultIfNull(sort, Sort.unsorted()));\n }\n\n @Override\n public boolean hasPrevious() {\n return pageNumber > 1;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/ReactiveExtensionClient.java", "content": "package run.halo.app.extension;\n\nimport java.util.Comparator;\nimport java.util.function.Predicate;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.index.IndexedQueryEngine;\n\n/**\n * ExtensionClient is an interface which contains some operations on Extension instead of\n * ExtensionStore.\n *\n * @author johnniang\n */\npublic interface ReactiveExtensionClient {\n\n /**\n * Lists Extensions by Extension type, filter and sorter.\n *\n * @param type is the class type of Extension.\n * @param predicate filters the reEnqueue.\n * @param comparator sorts the reEnqueue.\n * @param is Extension type.\n * @return all filtered and sorted Extensions.\n */\n Flux list(Class type, Predicate predicate,\n Comparator comparator);\n\n /**\n * Lists Extensions by Extension type, filter, sorter and page info.\n *\n * @param type is the class type of Extension.\n * @param predicate filters the reEnqueue.\n * @param comparator sorts the reEnqueue.\n * @param page is page number which starts from 0.\n * @param size is page size.\n * @param is Extension type.\n * @return a list of Extensions.\n */\n @Deprecated\n Mono> list(Class type, Predicate predicate,\n Comparator comparator, int page, int size);\n\n Flux listAll(Class type, ListOptions options, Sort sort);\n\n Flux listAllNames(Class type, ListOptions options, Sort sort);\n\n Flux listTopNames(Class type, ListOptions options, Sort sort,\n int topN);\n\n Mono> listBy(Class type, ListOptions options,\n PageRequest pageable);\n\n Mono> listNamesBy(Class type, ListOptions options,\n PageRequest pageable);\n\n Mono countBy(Class type, ListOptions options);\n\n /**\n * Fetches Extension by its type and name.\n *\n * @param type is Extension type.\n * @param name is Extension name.\n * @param is Extension type.\n * @return an optional Extension.\n */\n Mono fetch(Class type, String name);\n\n Mono fetch(GroupVersionKind gvk, String name);\n\n Mono get(Class type, String name);\n\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n Mono getJsonExtension(GroupVersionKind gvk, String name);\n\n /**\n * Creates an Extension.\n *\n * @param extension is fresh Extension to be created. Please make sure the Extension name does\n * not exist.\n * @param is Extension type.\n */\n Mono create(E extension);\n\n /**\n * Updates an Extension.\n *\n * @param extension is an Extension to be updated. Please make sure the resource version is\n * latest.\n * @param is Extension type.\n */\n Mono update(E extension);\n\n /**\n * Deletes an Extension.\n *\n * @param extension is an Extension to be deleted. Please make sure the resource version is\n * latest.\n * @param is Extension type.\n */\n Mono delete(E extension);\n\n @Deprecated(forRemoval = true, since = \"2.22.0\")\n IndexedQueryEngine indexedQueryEngine();\n\n void watch(Watcher watcher);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Ref.java", "content": "package run.halo.app.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.Objects;\nimport lombok.Data;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.lang.NonNull;\n\n@Data\n@Schema(description = \"Extension reference object. The name is mandatory\")\npublic class Ref {\n\n @Schema(description = \"Extension group\", requiredMode = REQUIRED)\n private String group;\n\n @Schema(description = \"Extension version\")\n @Nullable\n private String version;\n\n @Schema(description = \"Extension kind\", requiredMode = REQUIRED)\n private String kind;\n\n @Schema(requiredMode = REQUIRED, description = \"Extension name. This field is mandatory\")\n private String name;\n\n public static Ref of(String name) {\n Ref ref = new Ref();\n ref.setName(name);\n return ref;\n }\n\n public static Ref of(String name, GroupVersionKind gvk) {\n Ref ref = new Ref();\n ref.setName(name);\n ref.setGroup(gvk.group());\n ref.setVersion(gvk.version());\n ref.setKind(gvk.kind());\n return ref;\n }\n\n public static Ref of(Extension extension) {\n var metadata = extension.getMetadata();\n var gvk = extension.groupVersionKind();\n var ref = new Ref();\n ref.setName(metadata.getName());\n ref.setGroup(gvk.group());\n ref.setVersion(gvk.version());\n ref.setKind(gvk.kind());\n return ref;\n }\n\n /**\n * Check the ref has the same group and kind.\n *\n * @param ref is target reference\n * @param gvk is group version kind\n * @return true if they have the same group and kind.\n */\n public static boolean groupKindEquals(Ref ref, GroupVersionKind gvk) {\n return Objects.equals(ref.getGroup(), gvk.group())\n && Objects.equals(ref.getKind(), gvk.kind());\n }\n\n /**\n * Check if the extension is equal to the ref.\n *\n * @param ref must not be null.\n * @param extension must not be null.\n * @return true if they are equal; false otherwise.\n */\n public static boolean equals(@NonNull Ref ref, @NonNull ExtensionOperator extension) {\n var gvk = extension.groupVersionKind();\n var name = extension.getMetadata().getName();\n return groupKindEquals(ref, gvk) && Objects.equals(ref.getName(), name);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Scheme.java", "content": "package run.halo.app.extension;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport io.swagger.v3.core.converter.ModelConverters;\nimport io.swagger.v3.core.util.Json;\nimport java.util.Map;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.exception.ExtensionException;\n\n/**\n * This class represents scheme of an Extension.\n *\n * @param type is Extension type.\n * @param groupVersionKind is GroupVersionKind of Extension.\n * @param plural is plural name of Extension.\n * @param singular is singular name of Extension.\n * @param openApiSchema is JSON schema of Extension.\n * @author johnniang\n */\npublic record Scheme(Class type,\n GroupVersionKind groupVersionKind,\n String plural,\n String singular,\n ObjectNode openApiSchema) {\n public Scheme {\n Assert.notNull(type, \"Type of Extension must not be null\");\n Assert.notNull(groupVersionKind, \"GroupVersionKind of Extension must not be null\");\n Assert.hasText(plural, \"Plural name of Extension must not be blank\");\n Assert.hasText(singular, \"Singular name of Extension must not be blank\");\n Assert.notNull(openApiSchema, \"Json Schema must not be null\");\n }\n\n /**\n * Builds Scheme from type with @GVK annotation.\n *\n * @param type is Extension type with GVK annotation.\n * @return Scheme definition.\n * @throws ExtensionException when the type has not annotated @GVK.\n */\n public static Scheme buildFromType(Class type) {\n // concrete scheme from annotation\n var gvk = getGvkFromType(type);\n\n // TODO Move the generation logic outside.\n // generate OpenAPI schema\n var resolvedSchema = ModelConverters.getInstance().readAllAsResolvedSchema(type);\n var mapper = Json.mapper();\n var schema = (ObjectNode) mapper.valueToTree(resolvedSchema.schema);\n // for schema validation.\n schema.set(\"components\",\n mapper.valueToTree(Map.of(\"schemas\", resolvedSchema.referencedSchemas)));\n\n return new Scheme(type,\n new GroupVersionKind(gvk.group(), gvk.version(), gvk.kind()),\n gvk.plural(),\n gvk.singular(),\n // Deep copy for schema to avoid mutation by others.\n schema.deepCopy());\n }\n\n /**\n * Gets GVK annotation from Extension type.\n *\n * @param type is Extension type with GVK annotation.\n * @return GVK annotation.\n * @throws ExtensionException when the type has not annotated @GVK.\n */\n @NonNull\n public static GVK getGvkFromType(@NonNull Class type) {\n var gvk = type.getAnnotation(GVK.class);\n Assert.notNull(gvk,\n \"Missing annotation \" + GVK.class.getName() + \" on type \" + type.getName());\n return gvk;\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n Scheme scheme = (Scheme) o;\n return groupVersionKind.equals(scheme.groupVersionKind);\n }\n\n @Override\n public int hashCode() {\n return groupVersionKind.hashCode();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/SchemeManager.java", "content": "package run.halo.app.extension;\n\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.function.Consumer;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport run.halo.app.extension.exception.SchemeNotFoundException;\nimport run.halo.app.extension.index.IndexSpecs;\n\npublic interface SchemeManager {\n\n /**\n * Registers an Extension using its type.\n *\n * @param type is Extension type.\n * @param Extension class.\n */\n default void register(Class type) {\n register(type, null);\n }\n\n default void register(Scheme scheme) {\n register(scheme.type(), null);\n }\n\n void register(\n Class type, @Nullable Consumer> specsConsumer\n );\n\n void unregister(@NonNull Scheme scheme);\n\n default int size() {\n return schemes().size();\n }\n\n @NonNull\n List schemes();\n\n @NonNull\n default Optional fetch(@NonNull GroupVersionKind gvk) {\n return schemes().stream()\n .filter(scheme -> Objects.equals(scheme.groupVersionKind(), gvk))\n .findFirst();\n }\n\n @NonNull\n default Scheme get(@NonNull GroupVersionKind gvk) {\n return fetch(gvk).orElseThrow(\n () -> new SchemeNotFoundException(gvk));\n }\n\n @NonNull\n default Scheme get(Class type) {\n var gvk = Scheme.getGvkFromType(type);\n return get(new GroupVersionKind(gvk.group(), gvk.version(), gvk.kind()));\n }\n\n @NonNull\n default Scheme get(Extension ext) {\n var gvk = ext.groupVersionKind();\n return get(gvk);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Secret.java", "content": "package run.halo.app.extension;\n\nimport java.util.Map;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\n\n/**\n * Secret is a small piece of sensitive data which should be kept secret, such as a password,\n * a token, or a key.\n *\n * @author guqing\n * @see\n * kebernetes Secret\n * @since 2.0.0\n */\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"\", version = \"v1alpha1\", kind = Secret.KIND, plural = \"secrets\", singular = \"secret\")\npublic class Secret extends AbstractExtension {\n public static final String KIND = \"Secret\";\n\n public static final String SECRET_TYPE_OPAQUE = \"Opaque\";\n\n public static final int MAX_SECRET_SIZE = 1024 * 1024;\n\n /**\n * Used to facilitate programmatic handling of secret data.\n * More info:\n * secret-types\n */\n private String type;\n\n /**\n *

The total bytes of the values in\n * the Data field must be less than {@link #MAX_SECRET_SIZE} bytes.

\n *

{@code data} contains the secret data. Each key must consist of alphanumeric\n * characters, '-', '_' or '.'. The serialized form of the secret data is a\n * base64 encoded string, representing the arbitrary (possibly non-string)\n * data value here. Described in\n * rfc4648#section-4\n *

\n */\n private Map data;\n\n /**\n * {@code stringData} allows specifying non-binary secret data in string form.\n * It is provided as a write-only input field for convenience.\n * All keys and values are merged into the data field on write, overwriting any existing\n * values.\n * The stringData field is never output when reading from the API.\n */\n private Map stringData;\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Unstructured.java", "content": "package run.halo.app.extension;\n\nimport com.fasterxml.jackson.core.JsonGenerator;\nimport com.fasterxml.jackson.core.JsonParser;\nimport com.fasterxml.jackson.databind.DeserializationContext;\nimport com.fasterxml.jackson.databind.JsonDeserializer;\nimport com.fasterxml.jackson.databind.JsonSerializer;\nimport com.fasterxml.jackson.databind.MapperFeature;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.SerializerProvider;\nimport com.fasterxml.jackson.databind.annotation.JsonDeserialize;\nimport com.fasterxml.jackson.databind.annotation.JsonSerialize;\nimport io.swagger.v3.core.util.Json;\nimport java.io.IOException;\nimport java.time.Instant;\nimport java.util.Arrays;\nimport java.util.Collection;\nimport java.util.HashMap;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.springframework.lang.NonNull;\nimport tools.jackson.core.JacksonException;\nimport tools.jackson.databind.SerializationContext;\nimport tools.jackson.databind.ValueDeserializer;\nimport tools.jackson.databind.ValueSerializer;\n\n/**\n * Unstructured is a generic Extension, which wraps ObjectNode to maintain the Extension data, like\n * apiVersion, kind, metadata and others.\n *\n * @author johnniang\n */\n@JsonSerialize(using = Unstructured.UnstructuredSerializer.class)\n@JsonDeserialize(using = Unstructured.UnstructuredDeserializer.class)\n@tools.jackson.databind.annotation.JsonSerialize(\n using = Unstructured.UnstructuredValueSerializer.class\n)\n@tools.jackson.databind.annotation.JsonDeserialize(\n using = Unstructured.UnstructuredValueDeserializer.class\n)\n@SuppressWarnings(\"rawtypes\")\npublic class Unstructured implements Extension {\n\n @SuppressWarnings(\"deprecation\")\n public static final ObjectMapper OBJECT_MAPPER = Json.mapper()\n // We don't want to change the default mapper\n // so we copy a new one and configure it\n .copy()\n .enable(MapperFeature.ACCEPT_CASE_INSENSITIVE_ENUMS);\n\n private final Map data;\n\n public Unstructured() {\n this(new HashMap());\n }\n\n public Unstructured(Map data) {\n this.data = data;\n }\n\n public Map getData() {\n return data;\n }\n\n @Override\n public String getApiVersion() {\n return (String) data.get(\"apiVersion\");\n }\n\n @Override\n public String getKind() {\n return (String) data.get(\"kind\");\n }\n\n @Override\n public MetadataOperator getMetadata() {\n return getNestedMap(data, \"metadata\")\n .map(UnstructuredMetadata::new)\n .orElse(null);\n }\n\n static class UnstructuredMetadata implements MetadataOperator {\n\n @NonNull\n private final Map metadata;\n\n UnstructuredMetadata(@NonNull Map metadata) {\n this.metadata = metadata;\n }\n\n @Override\n public String getName() {\n return (String) getNestedValue(metadata, \"name\").orElse(null);\n }\n\n @Override\n public String getGenerateName() {\n return (String) getNestedValue(metadata, \"generateName\").orElse(null);\n }\n\n @Override\n public Map getLabels() {\n return getNestedStringStringMap(metadata, \"labels\").orElse(null);\n }\n\n @Override\n public Map getAnnotations() {\n return getNestedStringStringMap(metadata, \"annotations\").orElse(null);\n }\n\n @Override\n public Long getVersion() {\n return getNestedLong(metadata, \"version\").orElse(null);\n }\n\n @Override\n public Instant getCreationTimestamp() {\n return getNestedInstant(metadata, \"creationTimestamp\").orElse(null);\n }\n\n @Override\n public Instant getDeletionTimestamp() {\n return getNestedInstant(metadata, \"deletionTimestamp\").orElse(null);\n }\n\n @Override\n public Set getFinalizers() {\n return getNestedStringSet(metadata, \"finalizers\").orElse(null);\n }\n\n @Override\n public void setName(String name) {\n setNestedValue(metadata, name, \"name\");\n }\n\n @Override\n public void setGenerateName(String generateName) {\n setNestedValue(metadata, generateName, \"generateName\");\n }\n\n @Override\n public void setLabels(Map labels) {\n setNestedValue(metadata, labels, \"labels\");\n }\n\n @Override\n public void setAnnotations(Map annotations) {\n setNestedValue(metadata, annotations, \"annotations\");\n }\n\n @Override\n public void setVersion(Long version) {\n setNestedValue(metadata, version, \"version\");\n }\n\n @Override\n public void setCreationTimestamp(Instant creationTimestamp) {\n setNestedValue(metadata, creationTimestamp, \"creationTimestamp\");\n }\n\n @Override\n public void setDeletionTimestamp(Instant deletionTimestamp) {\n setNestedValue(metadata, deletionTimestamp, \"deletionTimestamp\");\n }\n\n @Override\n public void setFinalizers(Set finalizers) {\n setNestedValue(metadata, finalizers, \"finalizers\");\n }\n\n @Override\n public boolean equals(Object o) {\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n var that = (UnstructuredMetadata) o;\n return Objects.equals(metadata, that.metadata);\n }\n\n @Override\n public int hashCode() {\n return Objects.hashCode(metadata);\n }\n\n }\n\n @Override\n public void setApiVersion(String apiVersion) {\n setNestedValue(data, apiVersion, \"apiVersion\");\n }\n\n @Override\n public void setKind(String kind) {\n setNestedValue(data, kind, \"kind\");\n }\n\n @Override\n @SuppressWarnings(\"unchecked\")\n public void setMetadata(MetadataOperator metadata) {\n Map metadataMap = OBJECT_MAPPER.convertValue(metadata, Map.class);\n data.put(\"metadata\", metadataMap);\n }\n\n public static Optional getNestedValue(Map map, String... fields) {\n if (fields == null || fields.length == 0) {\n return Optional.of(map);\n }\n Map tempMap = map;\n for (int i = 0; i < fields.length - 1; i++) {\n Object value = tempMap.get(fields[i]);\n if (!(value instanceof Map)) {\n return Optional.empty();\n }\n tempMap = (Map) value;\n }\n return Optional.ofNullable(tempMap.get(fields[fields.length - 1]));\n }\n\n @SuppressWarnings(\"unchecked\")\n public static Optional> getNestedStringList(Map map, String... fields) {\n return getNestedValue(map, fields).map(value -> (List) value);\n }\n\n public static Optional> getNestedStringSet(Map map, String... fields) {\n return getNestedValue(map, fields).map(value -> {\n if (value instanceof Collection collection) {\n return new LinkedHashSet<>(collection);\n }\n throw new IllegalArgumentException(\n \"Incorrect value type: \" + value.getClass() + \", expected: \" + Set.class);\n });\n }\n\n @SuppressWarnings(\"unchecked\")\n public static void setNestedValue(Map map, Object value, String... fields) {\n if (fields == null || fields.length == 0) {\n // do nothing when no fields provided\n return;\n }\n var prevFields = Arrays.stream(fields, 0, fields.length - 1)\n .toArray(String[]::new);\n getNestedMap(map, prevFields).ifPresent(m -> {\n var lastField = fields[fields.length - 1];\n m.put(lastField, value);\n });\n }\n\n public static Optional getNestedMap(Map map, String... fields) {\n return getNestedValue(map, fields).map(value -> (Map) value);\n }\n\n @SuppressWarnings(\"unchecked\")\n public static Optional> getNestedStringStringMap(Map map,\n String... fields) {\n return getNestedValue(map, fields)\n .map(labelsObj -> (Map) labelsObj);\n }\n\n public static Optional getNestedInstant(Map map, String... fields) {\n return getNestedValue(map, fields)\n .map(instantValue -> {\n if (instantValue instanceof Instant instant) {\n return instant;\n }\n return Instant.parse(instantValue.toString());\n });\n\n }\n\n public static Optional getNestedLong(Map map, String... fields) {\n return getNestedValue(map, fields)\n .map(longObj -> {\n if (longObj instanceof Long l) {\n return l;\n }\n return Long.valueOf(longObj.toString());\n });\n }\n\n public static class UnstructuredSerializer extends JsonSerializer {\n\n @Override\n public void serialize(Unstructured value, JsonGenerator gen, SerializerProvider serializers)\n throws IOException {\n gen.writeObject(value.data);\n }\n\n }\n\n static class UnstructuredValueSerializer extends ValueSerializer {\n\n @Override\n public void serialize(\n Unstructured value, tools.jackson.core.JsonGenerator gen, SerializationContext ctxt)\n throws JacksonException {\n gen.writePOJO(value.data);\n }\n\n @Override\n public Class handledType() {\n return Unstructured.class;\n }\n }\n\n static class UnstructuredValueDeserializer extends ValueDeserializer {\n\n @Override\n public Unstructured deserialize(tools.jackson.core.JsonParser p,\n tools.jackson.databind.DeserializationContext ctxt) throws JacksonException {\n var map = p.readValueAs(Map.class);\n return new Unstructured(map);\n }\n }\n\n public static class UnstructuredDeserializer extends JsonDeserializer {\n\n @Override\n public Unstructured deserialize(JsonParser p, DeserializationContext ctxt)\n throws IOException {\n Map data = p.getCodec().readValue(p, Map.class);\n return new Unstructured(data);\n }\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n Unstructured that = (Unstructured) o;\n return Objects.equals(data, that.data);\n }\n\n @Override\n public int hashCode() {\n return Objects.hash(data);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/Watcher.java", "content": "package run.halo.app.extension;\n\nimport java.util.List;\nimport java.util.concurrent.CopyOnWriteArrayList;\nimport reactor.core.Disposable;\nimport run.halo.app.extension.controller.Reconciler;\n\npublic interface Watcher extends Disposable {\n\n default void onAdd(Reconciler.Request request) {\n // Do nothing here, just for sync all on start.\n }\n\n default void onAdd(Extension extension) {\n // Do nothing here\n }\n\n default void onUpdate(Extension oldExtension, Extension newExtension) {\n // Do nothing here\n }\n\n default void onDelete(Extension extension) {\n // Do nothing here\n }\n\n default void registerDisposeHook(Runnable dispose) {\n }\n\n class WatcherComposite implements Watcher {\n\n private final List watchers;\n\n private volatile boolean disposed = false;\n\n private Runnable disposeHook;\n\n public WatcherComposite() {\n watchers = new CopyOnWriteArrayList<>();\n }\n\n @Override\n public void onAdd(Extension extension) {\n // TODO Deep copy extension and execute onAdd asynchronously\n watchers.forEach(watcher -> watcher.onAdd(extension));\n }\n\n @Override\n public void onUpdate(Extension oldExtension, Extension newExtension) {\n // TODO Deep copy extension and execute onUpdate asynchronously\n watchers.forEach(watcher -> watcher.onUpdate(oldExtension, newExtension));\n }\n\n @Override\n public void onDelete(Extension extension) {\n // TODO Deep copy extension and execute onDelete asynchronously\n watchers.forEach(watcher -> watcher.onDelete(extension));\n }\n\n public void addWatcher(Watcher watcher) {\n if (!watcher.isDisposed() && !watchers.contains(watcher)) {\n watchers.add(watcher);\n watcher.registerDisposeHook(() -> removeWatcher(watcher));\n }\n }\n\n public void removeWatcher(Watcher watcher) {\n watchers.remove(watcher);\n }\n\n @Override\n public void registerDisposeHook(Runnable dispose) {\n this.disposeHook = dispose;\n }\n\n @Override\n public void dispose() {\n this.disposed = true;\n this.watchers.clear();\n if (this.disposeHook != null) {\n this.disposeHook.run();\n }\n }\n\n @Override\n public boolean isDisposed() {\n return this.disposed;\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/WatcherExtensionMatchers.java", "content": "package run.halo.app.extension;\n\nimport java.util.Objects;\nimport lombok.Builder;\nimport lombok.Getter;\nimport org.springframework.util.Assert;\n\npublic class WatcherExtensionMatchers {\n @Getter\n private final ExtensionClient client;\n private final GroupVersionKind gvk;\n private final ExtensionMatcher onAddMatcher;\n private final ExtensionMatcher onUpdateMatcher;\n private final ExtensionMatcher onDeleteMatcher;\n\n /**\n * Constructs a new {@link WatcherExtensionMatchers} with the given\n * {@link DefaultExtensionMatcher}.\n */\n @Builder(builderMethodName = \"internalBuilder\")\n public WatcherExtensionMatchers(ExtensionClient client,\n GroupVersionKind gvk, ExtensionMatcher onAddMatcher,\n ExtensionMatcher onUpdateMatcher, ExtensionMatcher onDeleteMatcher) {\n Assert.notNull(client, \"The client must not be null.\");\n Assert.notNull(gvk, \"The gvk must not be null.\");\n this.client = client;\n this.gvk = gvk;\n this.onAddMatcher =\n Objects.requireNonNullElseGet(onAddMatcher, () -> emptyMatcher(client, gvk));\n this.onUpdateMatcher =\n Objects.requireNonNullElseGet(onUpdateMatcher, () -> emptyMatcher(client, gvk));\n this.onDeleteMatcher =\n Objects.requireNonNullElseGet(onDeleteMatcher, () -> emptyMatcher(client, gvk));\n }\n\n public GroupVersionKind getGroupVersionKind() {\n return this.gvk;\n }\n\n public ExtensionMatcher onAddMatcher() {\n return delegateExtensionMatcher(this.onAddMatcher);\n }\n\n public ExtensionMatcher onUpdateMatcher() {\n return delegateExtensionMatcher(this.onUpdateMatcher);\n }\n\n public ExtensionMatcher onDeleteMatcher() {\n return delegateExtensionMatcher(this.onDeleteMatcher);\n }\n\n public static WatcherExtensionMatchersBuilder builder(ExtensionClient client,\n GroupVersionKind gvk) {\n return internalBuilder().gvk(gvk).client(client);\n }\n\n static ExtensionMatcher emptyMatcher(ExtensionClient client,\n GroupVersionKind gvk) {\n return DefaultExtensionMatcher.builder(client, gvk).build();\n }\n\n ExtensionMatcher delegateExtensionMatcher(ExtensionMatcher matcher) {\n return extension -> extension.groupVersionKind().equals(gvk) && matcher.match(extension);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/WatcherPredicates.java", "content": "package run.halo.app.extension;\n\nimport java.util.function.BiPredicate;\nimport java.util.function.Predicate;\n\npublic class WatcherPredicates {\n\n static final Predicate EMPTY_PREDICATE = (e) -> true;\n\n static final BiPredicate EMPTY_BI_PREDICATE = (oldExt, newExt) -> true;\n private final Predicate onAddPredicate;\n private final BiPredicate onUpdatePredicate;\n private final Predicate onDeletePredicate;\n\n public WatcherPredicates(Predicate onAddPredicate,\n BiPredicate onUpdatePredicate,\n Predicate onDeletePredicate) {\n this.onAddPredicate = onAddPredicate;\n this.onUpdatePredicate = onUpdatePredicate;\n this.onDeletePredicate = onDeletePredicate;\n }\n\n public Predicate onAddPredicate() {\n if (onAddPredicate == null) {\n return EMPTY_PREDICATE;\n }\n return onAddPredicate;\n }\n\n public BiPredicate onUpdatePredicate() {\n if (onUpdatePredicate == null) {\n return EMPTY_BI_PREDICATE;\n }\n return onUpdatePredicate;\n }\n\n public Predicate onDeletePredicate() {\n if (onDeletePredicate == null) {\n return EMPTY_PREDICATE;\n }\n return onDeletePredicate;\n }\n\n public static final class Builder {\n\n private Predicate onAddPredicate;\n private BiPredicate onUpdatePredicate;\n private Predicate onDeletePredicate;\n\n private GroupVersionKind gvk;\n\n public Builder withGroupVersionKind(GroupVersionKind gvk) {\n this.gvk = gvk;\n return this;\n }\n\n public Builder onAddPredicate(Predicate onAddPredicate) {\n this.onAddPredicate = onAddPredicate;\n return this;\n }\n\n public Builder onUpdatePredicate(\n BiPredicate onUpdatePredicate) {\n this.onUpdatePredicate = onUpdatePredicate;\n return this;\n }\n\n public Builder onDeletePredicate(Predicate onDeletePredicate) {\n this.onDeletePredicate = onDeletePredicate;\n return this;\n }\n\n public WatcherPredicates build() {\n Predicate gvkPredicate = EMPTY_PREDICATE;\n BiPredicate gvkBiPredicate = EMPTY_BI_PREDICATE;\n if (gvk != null) {\n gvkPredicate = e -> gvk.equals(e.groupVersionKind());\n gvkBiPredicate = (oldE, newE) -> oldE.groupVersionKind().equals(gvk)\n && newE.groupVersionKind().equals(gvk);\n }\n if (onAddPredicate == null) {\n onAddPredicate = EMPTY_PREDICATE;\n }\n if (onUpdatePredicate == null) {\n onUpdatePredicate = EMPTY_BI_PREDICATE;\n }\n if (onDeletePredicate == null) {\n onDeletePredicate = EMPTY_PREDICATE;\n }\n\n onAddPredicate = gvkPredicate.and(onAddPredicate);\n onUpdatePredicate = gvkBiPredicate.and(onUpdatePredicate);\n onDeletePredicate = gvkPredicate.and(onDeletePredicate);\n\n return new WatcherPredicates(onAddPredicate, onUpdatePredicate, onDeletePredicate);\n }\n\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/Controller.java", "content": "package run.halo.app.extension.controller;\n\nimport reactor.core.Disposable;\n\npublic interface Controller extends Disposable {\n\n String getName();\n\n void start();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/ControllerBuilder.java", "content": "package run.halo.app.extension.controller;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.function.Supplier;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionMatcher;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.WatcherExtensionMatchers;\nimport run.halo.app.extension.controller.Reconciler.Request;\n\npublic class ControllerBuilder {\n\n private final String name;\n\n private Duration minDelay;\n\n private Duration maxDelay;\n\n private final Reconciler reconciler;\n\n private Supplier nowSupplier;\n\n private Extension extension;\n\n private ExtensionMatcher onAddMatcher;\n\n private ExtensionMatcher onDeleteMatcher;\n\n private ExtensionMatcher onUpdateMatcher;\n\n private ListOptions syncAllListOptions;\n\n private final ExtensionClient client;\n\n private boolean syncAllOnStart = true;\n\n private int workerCount = 1;\n\n public ControllerBuilder(Reconciler reconciler, ExtensionClient client) {\n Assert.notNull(reconciler, \"Reconciler must not be null\");\n Assert.notNull(client, \"Extension client must not be null\");\n this.name = reconciler.getClass().getName();\n this.reconciler = reconciler;\n this.client = client;\n }\n\n public ControllerBuilder minDelay(Duration minDelay) {\n this.minDelay = minDelay;\n return this;\n }\n\n public ControllerBuilder maxDelay(Duration maxDelay) {\n this.maxDelay = maxDelay;\n return this;\n }\n\n public ControllerBuilder nowSupplier(Supplier nowSupplier) {\n this.nowSupplier = nowSupplier;\n return this;\n }\n\n public ControllerBuilder extension(Extension extension) {\n this.extension = extension;\n return this;\n }\n\n public ControllerBuilder onAddMatcher(ExtensionMatcher onAddMatcher) {\n this.onAddMatcher = onAddMatcher;\n return this;\n }\n\n public ControllerBuilder onDeleteMatcher(ExtensionMatcher onDeleteMatcher) {\n this.onDeleteMatcher = onDeleteMatcher;\n return this;\n }\n\n public ControllerBuilder onUpdateMatcher(ExtensionMatcher extensionMatcher) {\n this.onUpdateMatcher = extensionMatcher;\n return this;\n }\n\n public ControllerBuilder syncAllOnStart(boolean syncAllAtStart) {\n this.syncAllOnStart = syncAllAtStart;\n return this;\n }\n\n public ControllerBuilder syncAllListOptions(ListOptions syncAllListOptions) {\n this.syncAllListOptions = syncAllListOptions;\n return this;\n }\n\n public ControllerBuilder workerCount(int workerCount) {\n this.workerCount = workerCount;\n return this;\n }\n\n public Controller build() {\n if (nowSupplier == null) {\n nowSupplier = Instant::now;\n }\n if (minDelay == null || minDelay.isNegative() || minDelay.isZero()) {\n minDelay = Duration.ofMillis(5);\n }\n if (maxDelay == null || maxDelay.isNegative() || maxDelay.isZero()) {\n maxDelay = Duration.ofSeconds(1000);\n }\n Assert.isTrue(minDelay.compareTo(maxDelay) <= 0,\n \"Min delay must be less than or equal to max delay\");\n Assert.notNull(extension, \"Extension must not be null\");\n Assert.notNull(reconciler, \"Reconciler must not be null\");\n\n var queue = new DefaultQueue(nowSupplier, minDelay);\n var extensionMatchers = WatcherExtensionMatchers.builder(client,\n extension.groupVersionKind())\n .onAddMatcher(onAddMatcher)\n .onUpdateMatcher(onUpdateMatcher)\n .onDeleteMatcher(onDeleteMatcher)\n .build();\n var watcher = new ExtensionWatcher(queue, extensionMatchers);\n var synchronizer = new RequestSynchronizer(syncAllOnStart,\n client,\n extension,\n watcher,\n determineSyncAllListOptions());\n return new DefaultController<>(name, reconciler, queue, synchronizer, minDelay, maxDelay,\n workerCount);\n }\n\n ListOptions determineSyncAllListOptions() {\n if (syncAllListOptions != null) {\n return syncAllListOptions;\n }\n return new ListOptions();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/DefaultController.java", "content": "package run.halo.app.extension.controller;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.concurrent.Executor;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicLong;\nimport java.util.function.Supplier;\nimport java.util.stream.IntStream;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport org.springframework.util.StopWatch;\nimport run.halo.app.extension.controller.RequestQueue.DelayedEntry;\n\n@Slf4j\npublic class DefaultController implements Controller {\n\n private final String name;\n\n private final Reconciler reconciler;\n\n private final Supplier nowSupplier;\n\n private final RequestQueue queue;\n\n private volatile boolean disposed = false;\n\n private volatile boolean started = false;\n\n private final Executor executor;\n\n @Nullable\n private final Synchronizer synchronizer;\n\n private final Duration minDelay;\n\n private final Duration maxDelay;\n\n private final int workerCount;\n\n private final AtomicLong workerCounter;\n\n public DefaultController(String name,\n Reconciler reconciler,\n RequestQueue queue,\n Synchronizer synchronizer,\n Supplier nowSupplier,\n Duration minDelay,\n Duration maxDelay,\n ExecutorService executor, int workerCount) {\n this(name, reconciler, queue, synchronizer, nowSupplier, minDelay, maxDelay,\n (Executor) executor, workerCount);\n }\n\n public DefaultController(String name,\n Reconciler reconciler,\n RequestQueue queue,\n Synchronizer synchronizer,\n Supplier nowSupplier,\n Duration minDelay,\n Duration maxDelay,\n Executor executor, int workerCount) {\n Assert.isTrue(workerCount > 0, \"Worker count must not be less than 1\");\n this.name = name;\n this.reconciler = reconciler;\n this.nowSupplier = nowSupplier;\n this.queue = queue;\n this.synchronizer = synchronizer;\n this.minDelay = minDelay;\n this.maxDelay = maxDelay;\n this.executor = executor;\n this.workerCount = workerCount;\n this.workerCounter = new AtomicLong();\n }\n\n public DefaultController(String name,\n Reconciler reconciler,\n RequestQueue queue,\n Synchronizer synchronizer,\n Duration minDelay,\n Duration maxDelay) {\n this(name, reconciler, queue, synchronizer, Instant::now, minDelay, maxDelay, 1);\n }\n\n public DefaultController(String name,\n Reconciler reconciler,\n RequestQueue queue,\n Synchronizer synchronizer,\n Duration minDelay,\n Duration maxDelay, int workerCount) {\n this(name, reconciler, queue, synchronizer, Instant::now, minDelay, maxDelay, workerCount);\n }\n\n public DefaultController(String name,\n Reconciler reconciler,\n RequestQueue queue,\n Synchronizer synchronizer,\n Supplier nowSupplier,\n Duration minDelay,\n Duration maxDelay, int workerCount) {\n this(name, reconciler, queue, synchronizer, nowSupplier, minDelay, maxDelay,\n executor(name), workerCount);\n }\n\n private static Executor executor(String name) {\n return Executors.newThreadPerTaskExecutor(Thread.ofVirtual()\n .name(name, 1)\n .uncaughtExceptionHandler(\n (t, e) -> log.error(\"Uncaught exception in thread: {}\", t.getName(), e)\n )\n .factory()\n );\n }\n\n @Override\n public String getName() {\n return name;\n }\n\n public int getWorkerCount() {\n return workerCount;\n }\n\n @Override\n public void start() {\n if (isStarted() || isDisposed()) {\n log.warn(\"Controller {} is already started or disposed.\", getName());\n return;\n }\n this.started = true;\n if (synchronizer != null) {\n executor.execute(synchronizer::start);\n }\n log.info(\"Starting controller {}\", name);\n IntStream.range(0, getWorkerCount())\n .mapToObj(i -> new Worker())\n .forEach(executor::execute);\n }\n\n /**\n * Worker for controller.\n *\n * @author johnniang\n */\n class Worker implements Runnable {\n\n private final String name;\n\n Worker() {\n this.name =\n DefaultController.this.getName() + \"-worker-\" + workerCounter.incrementAndGet();\n }\n\n public String getName() {\n return name;\n }\n\n @Override\n public void run() {\n log.info(\"Controller worker {} started\", this.name);\n while (!isDisposed() && !Thread.currentThread().isInterrupted()) {\n try {\n var entry = queue.take();\n Reconciler.Result result;\n try {\n log.debug(\"{} >>> Reconciling request {} at {}\", this.name,\n entry.getEntry(),\n nowSupplier.get());\n var watch = new StopWatch(this.name + \":reconcile: \" + entry.getEntry());\n watch.start(\"reconciliation\");\n result = reconciler.reconcile(entry.getEntry());\n watch.stop();\n log.debug(\"{} >>> Reconciled request: {} with result: {}, usage: {}\",\n this.name, entry.getEntry(), result, watch.getTotalTimeMillis());\n } catch (Throwable t) {\n result = new Reconciler.Result(true, null);\n if (t instanceof OptimisticLockingFailureException) {\n log.warn(\"Optimistic locking failure when reconciling request: {}/{}\",\n this.name, entry.getEntry());\n } else if (t instanceof RequeueException re) {\n log.warn(\"{}: Requeue {} due to {}\",\n this.name, entry.getEntry(), re.getMessage());\n result = re.getResult();\n } else {\n log.error(\"Reconciler in \" + this.name\n + \" aborted with an error, re-enqueuing...\",\n t);\n }\n } finally {\n queue.done(entry.getEntry());\n }\n if (result == null) {\n result = new Reconciler.Result(false, null);\n }\n if (!result.reEnqueue()) {\n continue;\n }\n var retryAfter = result.retryAfter();\n if (retryAfter == null) {\n retryAfter = entry.getRetryAfter();\n if (retryAfter == null\n || retryAfter.isNegative()\n || retryAfter.isZero()\n || retryAfter.compareTo(minDelay) < 0) {\n // set min retry after\n retryAfter = minDelay;\n } else {\n try {\n // TODO Refactor the retryAfter with ratelimiter\n retryAfter = retryAfter.multipliedBy(2);\n } catch (ArithmeticException e) {\n retryAfter = maxDelay;\n }\n }\n if (retryAfter.compareTo(maxDelay) > 0) {\n retryAfter = maxDelay;\n }\n }\n queue.add(\n new DelayedEntry<>(entry.getEntry(), retryAfter, nowSupplier));\n } catch (InterruptedException e) {\n Thread.currentThread().interrupt();\n log.info(\"Controller worker {} interrupted\", name);\n }\n }\n log.info(\"Controller worker {} is stopped\", name);\n }\n }\n\n @Override\n public void dispose() {\n disposed = true;\n log.info(\"Disposing controller {}\", name);\n\n if (synchronizer != null) {\n synchronizer.dispose();\n }\n\n try {\n // we have to check if the executor is an instance of ExecutorService at first.\n // Because ExecutorService extends AutoCloseable interface in Java 21\n if (executor instanceof ExecutorService executorService) {\n closeExecutorService(executorService);\n } else if (executor instanceof AutoCloseable closeable) {\n closeable.close();\n if (Thread.currentThread().isInterrupted()) {\n log.warn(\"Wait timeout for controller {} shutdown\", name);\n } else {\n log.info(\"Controller {} is disposed\", name);\n }\n }\n } catch (Exception e) {\n log.warn(\"Interrupted while waiting for controller {} shutdown\", name);\n } finally {\n queue.dispose();\n }\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n\n public boolean isStarted() {\n return started;\n }\n\n /**\n * Close executor service.\n *\n * @param executorService executor service to be closed\n */\n private static void closeExecutorService(ExecutorService executorService) {\n boolean terminated = executorService.isTerminated();\n if (!terminated) {\n // Interrupt all running tasks first because of while loop waiting\n executorService.shutdownNow();\n var interrupted = false;\n while (!terminated) {\n try {\n terminated = executorService.awaitTermination(1L, TimeUnit.SECONDS);\n } catch (InterruptedException ignored) {\n interrupted = true;\n }\n if (!terminated) {\n executorService.shutdown();\n }\n }\n if (interrupted) {\n Thread.currentThread().interrupt();\n }\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/DefaultQueue.java", "content": "package run.halo.app.extension.controller;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.HashSet;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.concurrent.DelayQueue;\nimport java.util.concurrent.locks.Lock;\nimport java.util.concurrent.locks.ReentrantLock;\nimport java.util.function.Supplier;\nimport lombok.extern.slf4j.Slf4j;\n\n@Slf4j\npublic class DefaultQueue implements RequestQueue {\n\n private final Lock lock;\n\n private final DelayQueue> queue;\n\n private final Supplier nowSupplier;\n\n private volatile boolean disposed = false;\n\n private final Duration minDelay;\n\n private final Set processing;\n\n private final Set dirty;\n\n public DefaultQueue(Supplier nowSupplier) {\n this(nowSupplier, Duration.ZERO);\n }\n\n public DefaultQueue(Supplier nowSupplier, Duration minDelay) {\n this.lock = new ReentrantLock();\n this.nowSupplier = nowSupplier;\n this.minDelay = minDelay;\n this.processing = new HashSet<>();\n this.dirty = new HashSet<>();\n this.queue = new DelayQueue<>();\n }\n\n @Override\n public boolean addImmediately(R request) {\n log.debug(\"Adding request {} immediately\", request);\n var delayedEntry = new DelayedEntry<>(request, minDelay, nowSupplier);\n return add(delayedEntry);\n }\n\n @Override\n public boolean add(DelayedEntry entry) {\n lock.lock();\n try {\n if (isDisposed()) {\n return false;\n }\n log.debug(\"Adding request {} after {}\", entry.getEntry(), entry.getRetryAfter());\n if (entry.getRetryAfter().compareTo(minDelay) < 0) {\n log.warn(\"Request {} will be retried after {} ms, but minimum delay is {} ms\",\n entry.getEntry(), entry.getRetryAfter().toMillis(), minDelay.toMillis());\n entry = new DelayedEntry<>(entry.getEntry(), minDelay, nowSupplier);\n }\n if (dirty.contains(entry.getEntry())) {\n var oldEntry = findOldEntry(entry);\n if (oldEntry.isEmpty()) {\n return false;\n }\n var oldReadyAt = oldEntry.get().getReadyAt();\n var readyAt = entry.getReadyAt();\n if (!readyAt.isBefore(oldReadyAt)) {\n return false;\n }\n }\n dirty.add(entry.getEntry());\n if (processing.contains(entry.getEntry())) {\n return false;\n }\n\n boolean added = queue.add(entry);\n log.debug(\"Added request {} after {}\", entry.getEntry(), entry.getRetryAfter());\n return added;\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public DelayedEntry take() throws InterruptedException {\n var entry = queue.take();\n log.debug(\"Take request {} at {}\", entry.getEntry(), Instant.now());\n lock.lockInterruptibly();\n try {\n if (isDisposed()) {\n throw new InterruptedException(\n \"Queue has been disposed. Cannot take any elements now\");\n }\n processing.add(entry.getEntry());\n dirty.remove(entry.getEntry());\n return entry;\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public void done(R request) {\n lock.lock();\n try {\n if (isDisposed()) {\n return;\n }\n processing.remove(request);\n if (dirty.contains(request)) {\n queue.add(new DelayedEntry<>(request, minDelay, nowSupplier));\n }\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public long size() {\n return queue.size();\n }\n\n @Override\n public DelayedEntry peek() {\n return queue.peek();\n }\n\n @Override\n public void dispose() {\n lock.lock();\n try {\n disposed = true;\n queue.clear();\n processing.clear();\n dirty.clear();\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public boolean isDisposed() {\n return this.disposed;\n }\n\n private Optional> findOldEntry(DelayedEntry entry) {\n for (DelayedEntry element : queue) {\n if (element.equals(entry)) {\n return Optional.of(element);\n }\n }\n return Optional.empty();\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/ExtensionWatcher.java", "content": "package run.halo.app.extension.controller;\n\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.Watcher;\nimport run.halo.app.extension.WatcherExtensionMatchers;\nimport run.halo.app.extension.controller.Reconciler.Request;\n\npublic class ExtensionWatcher implements Watcher {\n\n private final RequestQueue queue;\n\n private volatile boolean disposed = false;\n\n private Runnable disposeHook;\n\n private final WatcherExtensionMatchers matchers;\n\n public ExtensionWatcher(RequestQueue queue, WatcherExtensionMatchers matchers) {\n this.queue = queue;\n this.matchers = matchers;\n }\n\n @Override\n public void onAdd(Request request) {\n if (isDisposed()) {\n return;\n }\n queue.addImmediately(request);\n }\n\n @Override\n public void onAdd(Extension extension) {\n if (isDisposed() || !matchers.onAddMatcher().match(extension)) {\n return;\n }\n // TODO filter the event\n queue.addImmediately(new Request(extension.getMetadata().getName()));\n }\n\n @Override\n public void onUpdate(Extension oldExtension, Extension newExtension) {\n if (isDisposed() || !matchers.onUpdateMatcher().match(newExtension)) {\n return;\n }\n // TODO filter the event\n queue.addImmediately(new Request(newExtension.getMetadata().getName()));\n }\n\n @Override\n public void onDelete(Extension extension) {\n if (isDisposed() || !matchers.onDeleteMatcher().match(extension)) {\n return;\n }\n // TODO filter the event\n queue.addImmediately(new Request(extension.getMetadata().getName()));\n }\n\n @Override\n public void registerDisposeHook(Runnable dispose) {\n this.disposeHook = dispose;\n }\n\n @Override\n public void dispose() {\n disposed = true;\n if (this.disposeHook != null) {\n this.disposeHook.run();\n }\n }\n\n @Override\n public boolean isDisposed() {\n return this.disposed;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/Reconciler.java", "content": "package run.halo.app.extension.controller;\n\nimport java.time.Duration;\n\npublic interface Reconciler {\n\n Result reconcile(R request);\n\n Controller setupWith(ControllerBuilder builder);\n\n record Request(String name) {\n }\n\n record Result(boolean reEnqueue, Duration retryAfter) {\n\n public static Result doNotRetry() {\n return new Result(false, null);\n }\n\n public static Result requeue(Duration retryAfter) {\n return new Result(true, retryAfter);\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/RequestQueue.java", "content": "package run.halo.app.extension.controller;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Objects;\nimport java.util.concurrent.Delayed;\nimport java.util.concurrent.TimeUnit;\nimport java.util.function.Supplier;\nimport reactor.core.Disposable;\n\npublic interface RequestQueue extends Disposable {\n\n boolean addImmediately(E request);\n\n boolean add(DelayedEntry entry);\n\n DelayedEntry take() throws InterruptedException;\n\n void done(E request);\n\n long size();\n\n DelayedEntry peek();\n\n class DelayedEntry implements Delayed {\n\n private final E entry;\n\n private final Instant readyAt;\n\n private final Supplier nowSupplier;\n\n private final Duration retryAfter;\n\n DelayedEntry(E entry, Duration retryAfter, Supplier nowSupplier) {\n this.entry = entry;\n this.readyAt = nowSupplier.get().plusMillis(retryAfter.toMillis());\n this.nowSupplier = nowSupplier;\n this.retryAfter = retryAfter;\n }\n\n public DelayedEntry(E entry, Instant readyAt, Supplier nowSupplier) {\n this.entry = entry;\n this.readyAt = readyAt;\n this.nowSupplier = nowSupplier;\n this.retryAfter = Duration.between(nowSupplier.get(), readyAt);\n }\n\n @Override\n public long getDelay(TimeUnit unit) {\n Duration diff = Duration.between(nowSupplier.get(), readyAt);\n return unit.convert(diff);\n }\n\n public Duration getRetryAfter() {\n return retryAfter;\n }\n\n public Instant getReadyAt() {\n return readyAt;\n }\n\n @Override\n public int compareTo(Delayed o) {\n return Long.compare(getDelay(TimeUnit.MILLISECONDS), o.getDelay(TimeUnit.MILLISECONDS));\n }\n\n public E getEntry() {\n return entry;\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n DelayedEntry that = (DelayedEntry) o;\n return Objects.equals(entry, that.entry);\n }\n\n @Override\n public int hashCode() {\n return Objects.hash(entry);\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/RequestSynchronizer.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.springframework.data.domain.Sort.Direction.ASC;\n\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Watcher;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.index.query.Queries;\n\n@Slf4j\npublic class RequestSynchronizer implements Synchronizer {\n\n /**\n * Default batch size for listing Extension names.\n */\n private static final Integer DEFAULT_BATCH_SIZE = 100;\n\n private final ExtensionClient client;\n\n private final Class type;\n\n private final boolean syncAllOnStart;\n\n private volatile boolean disposed = false;\n\n private final Watcher watcher;\n\n private final ListOptions listOptions;\n\n @Getter\n private volatile boolean started = false;\n\n public RequestSynchronizer(boolean syncAllOnStart,\n ExtensionClient client,\n Extension extension,\n Watcher watcher,\n ListOptions listOptions) {\n this.syncAllOnStart = syncAllOnStart;\n this.client = client;\n this.type = extension.getClass();\n this.watcher = watcher;\n this.listOptions = listOptions;\n }\n\n @Override\n public void start() {\n if (isDisposed() || started) {\n return;\n }\n log.info(\"Starting request({}) synchronizer...\", type);\n started = true;\n\n if (syncAllOnStart) {\n // list all in batch\n int batchSize = DEFAULT_BATCH_SIZE;\n var sort = Sort.by(ASC, \"metadata.name\");\n // get the first batch to determine the current name\n var names = client.listTopNames(type, listOptions, sort, batchSize);\n names.forEach(name -> watcher.onAdd(new Request(name)));\n while (names.size() == batchSize) {\n var lastName = names.getLast();\n var augmentedOptions = ListOptions.builder(listOptions)\n .andQuery(Queries.greaterThan(\"metadata.name\", lastName))\n .build();\n names = client.listTopNames(type, augmentedOptions, sort, batchSize);\n names.forEach(name -> watcher.onAdd(new Request(name)));\n }\n }\n client.watch(this.watcher);\n log.info(\"Started request({}) synchronizer.\", type);\n }\n\n @Override\n public void dispose() {\n disposed = true;\n watcher.dispose();\n }\n\n @Override\n public boolean isDisposed() {\n return this.disposed;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/RequeueException.java", "content": "package run.halo.app.extension.controller;\n\nimport run.halo.app.extension.controller.Reconciler.Result;\n\n\n/**\n * Requeue with result data after throwing this exception.\n *\n * @author johnniang\n */\npublic class RequeueException extends RuntimeException {\n\n private final Result result;\n\n public RequeueException(Result result) {\n this(result, null);\n }\n\n public RequeueException(Result result, String reason) {\n this(result, reason, null);\n }\n\n public RequeueException(Result result, String reason, Throwable t) {\n super(reason, t);\n this.result = result;\n }\n\n public Result getResult() {\n return result;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/controller/Synchronizer.java", "content": "package run.halo.app.extension.controller;\n\nimport reactor.core.Disposable;\n\npublic interface Synchronizer extends Disposable {\n\n void start();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/exception/ExtensionException.java", "content": "package run.halo.app.extension.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.HttpStatusCode;\nimport org.springframework.web.server.ResponseStatusException;\n\n/**\n * ExtensionException is the superclass of those exceptions that can be thrown by Extension module.\n *\n * @author johnniang\n */\npublic class ExtensionException extends ResponseStatusException {\n\n public ExtensionException(String reason) {\n this(reason, null);\n }\n\n public ExtensionException(String reason, Throwable cause) {\n this(HttpStatus.INTERNAL_SERVER_ERROR, reason, cause, null, new Object[] {reason});\n }\n\n protected ExtensionException(HttpStatusCode status, String reason, Throwable cause,\n String messageDetailCode, Object[] messageDetailArguments) {\n super(status, reason, cause, messageDetailCode, messageDetailArguments);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/exception/NotImplementedException.java", "content": "package run.halo.app.extension.exception;\n\n/**\n * Exception thrown to indicate that the requested operation is not implemented.\n *\n * @author johnniang\n */\npublic class NotImplementedException extends UnsupportedOperationException {\n\n public NotImplementedException() {\n this(\"Not implemented\");\n }\n\n public NotImplementedException(String message) {\n super(message);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/exception/SchemeNotFoundException.java", "content": "package run.halo.app.extension.exception;\n\nimport org.springframework.http.HttpStatus;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * SchemeNotFoundException is thrown while we try to get a scheme but not found.\n *\n * @author johnniang\n */\npublic class SchemeNotFoundException extends ExtensionException {\n\n public SchemeNotFoundException(GroupVersionKind gvk) {\n super(HttpStatus.INTERNAL_SERVER_ERROR, \"Scheme not found for \" + gvk, null, null,\n new Object[] {gvk});\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/AbstractValueIndexSpecBuilder.java", "content": "package run.halo.app.extension.index;\n\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.Extension;\n\n/**\n * Abstract base implementation of {@link IndexSpecBuilder} for value indexes.\n *\n * @param the type of extension\n * @param the type of key\n * @param the type of builder\n * @author johnniang\n * @since 2.22.0\n */\nabstract class AbstractValueIndexSpecBuilder<\n E extends Extension,\n K extends Comparable,\n B extends IndexSpecBuilder\n > implements IndexSpecBuilder {\n\n protected final String name;\n\n protected final Class keyType;\n\n protected boolean unique = false;\n\n protected boolean nullable = true;\n\n protected AbstractValueIndexSpecBuilder(String name, Class keyType) {\n Assert.hasText(name, \"Index name must not be blank\");\n Assert.notNull(keyType, \"Key type must not be null\");\n this.name = name;\n this.keyType = keyType;\n }\n\n public B unique(boolean unique) {\n this.unique = unique;\n return (B) this;\n }\n\n public B nullable(boolean nullable) {\n this.nullable = nullable;\n return (B) this;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/DefaultIndexAttribute.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Function;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.Extension;\n\n@Deprecated(forRemoval = true, since = \"2.22.0\")\nclass DefaultIndexAttribute>\n implements IndexAttribute {\n\n private final Class objectType;\n\n private final Class keyType;\n\n private final Function> valuesFunc;\n\n private final boolean singleValue;\n\n public DefaultIndexAttribute(\n Function> valuesFunc,\n Class objectType,\n Class keyType,\n boolean singleValue\n ) {\n this.singleValue = singleValue;\n Assert.notNull(valuesFunc, \"Values function must not be null\");\n Assert.notNull(objectType, \"Cannot resolve object type\");\n Assert.notNull(keyType, \"Cannot resolve key type\");\n this.valuesFunc = valuesFunc;\n this.objectType = objectType;\n this.keyType = keyType;\n }\n\n @Override\n public Class getObjectType() {\n return objectType;\n }\n\n @Override\n public Class getKeyType() {\n return keyType;\n }\n\n @Override\n public Set getValues(E e) {\n if (!checkType(e)) {\n throw new IllegalArgumentException(\"Object type does not match\");\n }\n return Optional.ofNullable(this.valuesFunc.apply(e)).orElse(Set.of());\n }\n\n private boolean checkType(Extension object) {\n return getObjectType().isInstance(object);\n }\n\n @Override\n public boolean singleValue() {\n return this.singleValue;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/IndexAttribute.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Set;\nimport run.halo.app.extension.Extension;\n\n/**\n *\n * An attribute used for indexing extensions.\n *\n * @param the type of the extension\n * @param the type of the key\n * @deprecated Use {@link ValueIndexSpec} instead.\n */\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic interface IndexAttribute> {\n\n /**\n * Specify this class is belonged to which extension.\n *\n * @return the extension class.\n */\n Class getObjectType();\n\n /**\n * Gets the value type of the attribute.\n *\n * @return the value type of the attribute.\n */\n Class getKeyType();\n\n /**\n * Gets the values of the attribute from the given extension.\n *\n * @param e the extension\n * @return the values of the attribute\n * @throws IllegalArgumentException if the given extension is not of the expected type\n */\n Set getValues(E e);\n\n /**\n * Indicates whether this attribute is single-valued.\n *\n * @return true if single-valued, false otherwise\n */\n boolean singleValue();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/IndexAttributeFactory.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport lombok.experimental.UtilityClass;\nimport run.halo.app.extension.Extension;\n\n/**\n * Factory for creating index attributes.\n *\n * @deprecated Use {@link SingleValueIndexSpec} and {@link MultiValueIndexSpec} instead.\n */\n@Deprecated(forRemoval = true, since = \"2.22.0\")\n@UtilityClass\npublic class IndexAttributeFactory {\n\n public static IndexAttribute simpleAttribute(Class type,\n Function valueFunc) {\n return attribute(type, UnknownKey.class, (E e) -> Optional.ofNullable(valueFunc.apply(e))\n .map(UnknownKey::new)\n .orElse(null));\n }\n\n public static IndexAttribute multiValueAttribute(\n Class type,\n Function> valuesFunc) {\n return attributes(type, UnknownKey.class, (E e) -> Optional.ofNullable(valuesFunc.apply(e))\n .map(values -> values.stream()\n .map(UnknownKey::new)\n .collect(Collectors.toSet())\n )\n .orElse(null));\n }\n\n private static > IndexAttribute attributes(\n Class objectType, Class keyType, Function> valuesFunc\n ) {\n return new DefaultIndexAttribute<>(valuesFunc, objectType, keyType, false);\n }\n\n private static > IndexAttribute attribute(\n Class objectType, Class keyType, Function valueFunc\n ) {\n return new DefaultIndexAttribute<>(\n e -> Optional.ofNullable(valueFunc.apply(e))\n .map(Set::of)\n .orElse(null),\n objectType,\n keyType,\n true);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/IndexSpec.java", "content": "package run.halo.app.extension.index;\n\nimport com.google.common.base.Objects;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.Extension;\n\n/**\n * An implementation of {@link MultiValueIndexSpec}.\n *\n * @param the type of the extension\n * @param the type of the key\n * @deprecated Use {@link IndexSpecs#multi(String, Class)} instead.\n */\n@Data\n@Accessors(chain = true)\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic class IndexSpec>\n implements ValueIndexSpec {\n\n private String name;\n\n private IndexAttribute indexFunc;\n\n private OrderType order;\n\n private boolean unique;\n\n public Set getValues(E extension) {\n return indexFunc.getValues(extension);\n }\n\n public enum OrderType {\n ASC,\n DESC\n }\n\n @Override\n public boolean isNullable() {\n return true;\n }\n\n @Override\n public Class getKeyType() {\n return indexFunc.getKeyType();\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n IndexSpec indexSpec = (IndexSpec) o;\n return Objects.equal(name, indexSpec.name);\n }\n\n @Override\n public int hashCode() {\n return Objects.hashCode(name);\n }\n\n /**\n * Normalize to single or multi value index spec.\n *\n * @return the normalized index spec\n */\n public ValueIndexSpec normalize() {\n if (this.indexFunc.singleValue()) {\n return IndexSpecs.single(name, getKeyType())\n .unique(unique)\n .indexFunc(e -> {\n var values = getValues(e);\n return CollectionUtils.isEmpty(values) ? null : values.iterator().next();\n })\n .build();\n }\n return IndexSpecs.multi(name, getKeyType())\n .unique(unique)\n .indexFunc(this::getValues)\n .build();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/IndexSpecBuilder.java", "content": "package run.halo.app.extension.index;\n\nimport run.halo.app.extension.Extension;\n\n/**\n * Index specification builder.\n *\n * @param the type of extension\n * @param the type of index key\n * @author johnniang\n * @since 2.22.0\n */\npublic interface IndexSpecBuilder<\n E extends Extension,\n K extends Comparable,\n B extends IndexSpecBuilder\n > {\n\n /**\n * Sets whether the index is unique.\n *\n * @param unique whether the index is unique, default is false\n * @return the updated IndexSpecBuilder\n */\n B unique(boolean unique);\n\n /**\n * Sets whether the index allows null values.\n *\n * @param nullable whether the index allows null values, default is true\n * @return the updated IndexSpecBuilder\n */\n B nullable(boolean nullable);\n\n /**\n * Builds the value index specification.\n *\n * @return the value index specification\n */\n ValueIndexSpec build();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/IndexSpecs.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.List;\nimport run.halo.app.extension.Extension;\n\n/**\n * An interface that defines a collection of {@link IndexSpec}, and provides methods to add,\n * remove, and get {@link IndexSpec}.\n *\n * @author guqing\n * @since 2.12.0\n */\npublic interface IndexSpecs {\n\n /**\n * Add a new {@link IndexSpec} to the collection.\n *\n * @param indexSpec the index spec to add.\n * @throws IllegalArgumentException if the index spec with the same name already exists or\n * the index spec is invalid\n */\n default > void add(IndexSpec indexSpec) {\n add(indexSpec.normalize());\n }\n\n > void add(ValueIndexSpec indexSpec);\n\n default > void add(IndexSpecBuilder builder) {\n add(builder.build());\n }\n\n /**\n * Get all {@link IndexSpec} in the collection.\n *\n * @return all index specs\n */\n List> getIndexSpecs();\n\n /***\n * Create a multi-value index spec builder.\n *\n * @param name the name of the index spec\n * @param keyType the type of the keys used in the index spec\n * @param the type of the extension\n * @param the type of the key\n * @return a MultiValueBuilder for the specified index spec\n */\n static > MultiValueIndexSpecBuilder multi(\n String name,\n Class keyType\n ) {\n return new MultiValueBuilder<>(name, keyType);\n }\n\n /**\n * Create a single-value index spec builder.\n *\n * @param name the name of the index spec\n * @param keyType the type of the keys used in the index spec\n * @param the type of the extension\n * @param the type of the key\n * @return a SingleValueBuilder for the specified index spec.\n */\n static > SingleValueIndexSpecBuilder single(\n String name,\n Class keyType\n ) {\n return new SingleValueBuilder<>(name, keyType);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/IndexedQueryEngine.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.List;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n *

An interface for querying indexed object records from the index store.

\n *

It provides a way to retrieve the object records by the given {@link GroupVersionKind} and\n * {@link ListOptions}, the final result will be ordered by the index what {@link ListOptions}\n * used and specified by the {@link PageRequest#getSort()}.

\n *\n * @author guqing\n * @since 2.12.0\n * @deprecated Use {@link ReactiveExtensionClient#listAllNames(Class, ListOptions, Sort)}\n * or {@link ReactiveExtensionClient#countBy(Class, ListOptions)}\n * or {@link ReactiveExtensionClient#listTopNames(Class, ListOptions, Sort, int)} instead\n */\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic interface IndexedQueryEngine {\n\n /**\n * Page retrieve the object records by the given {@link GroupVersionKind} and\n * {@link ListOptions}.\n *\n * @param type the type of the object must exist in\n * {@link run.halo.app.extension.SchemeManager}.\n * @param options the list options to use for retrieving the object records.\n * @param page which page to retrieve and how large the page should be.\n * @return a collection of {@link Metadata#getName()} for the given page.\n */\n ListResult retrieve(GroupVersionKind type, ListOptions options, PageRequest page);\n\n /**\n * Retrieve all the object records by the given {@link GroupVersionKind} and\n * {@link ListOptions}.\n *\n * @param type the type of the object must exist in {@link run.halo.app.extension.SchemeManager}\n * @param options the list options to use for retrieving the object records\n * @param sort the sort to use for retrieving the object records\n * @return a collection of {@link Metadata#getName()}\n */\n List retrieveAll(GroupVersionKind type, ListOptions options, Sort sort);\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/KeyComparator.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Comparator;\nimport org.springframework.lang.Nullable;\n\n@Deprecated(forRemoval = true, since = \"2.22.0\")\nclass KeyComparator implements Comparator {\n public static final KeyComparator INSTANCE = new KeyComparator();\n\n @Override\n public int compare(@Nullable String a, @Nullable String b) {\n if (a == null && b == null) {\n return 0;\n } else if (a == null) {\n // null less than everything\n return 1;\n } else if (b == null) {\n // null less than everything\n return -1;\n }\n return compareStrings(a, b);\n }\n\n private int compareStrings(String a, String b) {\n int i = 0;\n int j = 0;\n while (i < a.length() && j < b.length()) {\n char charA = a.charAt(i);\n char charB = b.charAt(j);\n\n if (Character.isDigit(charA) && Character.isDigit(charB)) {\n // Both characters are digits, compare as numbers\n int compareResult = compareNumbers(a, b, i, j);\n if (compareResult != 0) {\n return compareResult;\n }\n\n // Move indices past the compared number segments\n i = moveIndexToNextNonDigit(a, i);\n j = moveIndexToNextNonDigit(b, j);\n } else if (charA == charB) {\n // Characters are the same, continue\n i++;\n j++;\n } else if (Character.isDigit(charA)) {\n // If charA is digit and charB is not, digit comes first\n return -1;\n } else if (Character.isDigit(charB)) {\n // If charB is digit and charA is not, digit comes first\n return 1;\n } else {\n // Both are non-digits, compare directly\n return Character.compare(charA, charB);\n }\n }\n\n return Integer.compare(a.length(), b.length());\n }\n\n private int compareNumbers(String a, String b, int startA, int startB) {\n int i = startA;\n int j = startB;\n\n // Compare lengths of remaining digits\n int lengthA = countDigits(a, i);\n int lengthB = countDigits(b, j);\n if (lengthA != lengthB) {\n return Integer.compare(lengthA, lengthB);\n }\n\n // Compare digits one by one\n for (int k = 0; k < lengthA && i < a.length() && j < b.length(); k++, i++, j++) {\n char charA = a.charAt(i);\n char charB = b.charAt(j);\n if (charA != charB) {\n return Character.compare(charA, charB);\n }\n }\n\n // If both numbers have decimal points, compare decimal parts\n boolean hasDecimalA = i < a.length() && a.charAt(i) == '.';\n boolean hasDecimalB = j < b.length() && b.charAt(j) == '.';\n if (hasDecimalA || hasDecimalB) {\n return compareDecimalNumbers(a, b, i, j);\n }\n\n return 0;\n }\n\n private int compareDecimalNumbers(String a, String b, int startA, int startB) {\n // Find decimal point positions\n int pointA = a.indexOf('.', startA);\n int pointB = b.indexOf('.', startB);\n\n // Compare integer parts before the decimal point\n int integerComparison = compareIntegerPart(a, b, startA, startB, pointA, pointB);\n if (integerComparison != 0) {\n return integerComparison;\n }\n\n // Compare fractional parts after the decimal point\n return compareFractionalPart(a, b, pointA + 1, pointB + 1);\n }\n\n private int compareIntegerPart(String a, String b, int startA, int startB, int pointA,\n int pointB) {\n int i = startA;\n int j = startB;\n\n int lengthA = pointA - i;\n int lengthB = pointB - j;\n if (lengthA != lengthB) {\n return Integer.compare(lengthA, lengthB);\n }\n\n while (i < pointA && j < pointB) {\n char charA = a.charAt(i);\n char charB = b.charAt(j);\n if (charA != charB) {\n return Character.compare(charA, charB);\n }\n i++;\n j++;\n }\n\n return 0;\n }\n\n private int compareFractionalPart(String a, String b, int i, int j) {\n while (i < a.length() && j < b.length()\n && Character.isDigit(a.charAt(i)) && Character.isDigit(b.charAt(j))) {\n if (a.charAt(i) != b.charAt(j)) {\n return Character.compare(a.charAt(i), b.charAt(j));\n }\n i++;\n j++;\n }\n\n // If one number has more digits left, and they're not all zeroes, it is larger\n while (i < a.length() && Character.isDigit(a.charAt(i))) {\n if (a.charAt(i) != '0') {\n return 1;\n }\n i++;\n }\n while (j < b.length() && Character.isDigit(b.charAt(j))) {\n if (b.charAt(j) != '0') {\n return -1;\n }\n j++;\n }\n\n return 0;\n }\n\n private int countDigits(String s, int start) {\n int count = 0;\n while (start < s.length() && Character.isDigit(s.charAt(start))) {\n count++;\n start++;\n }\n return count;\n }\n\n private int moveIndexToNextNonDigit(String s, int index) {\n while (index < s.length() && (Character.isDigit(s.charAt(index))\n || s.charAt(index) == '.')) {\n index++;\n }\n return index;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/MultiValueBuilder.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Set;\nimport java.util.function.Function;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.Extension;\n\n/**\n * Builder for {@link MultiValueIndexSpec}.\n *\n * @param the type of extension\n * @param the type of index key\n * @author johnniang\n * @since 2.22.0\n */\nclass MultiValueBuilder>\n extends AbstractValueIndexSpecBuilder>\n implements MultiValueIndexSpecBuilder {\n\n private Function> indexFunc;\n\n MultiValueBuilder(String name, Class keyType) {\n super(name, keyType);\n }\n\n @Override\n public MultiValueIndexSpecBuilder indexFunc(Function> indexFunc) {\n this.indexFunc = indexFunc;\n return this;\n }\n\n @Override\n public ValueIndexSpec build() {\n Assert.hasText(name, \"Index name must not be blank\");\n Assert.notNull(keyType, \"Key type must not be null\");\n Assert.notNull(indexFunc, \"Index function must not be null\");\n\n return new MultiValueIndexSpec<>() {\n @Override\n public String getName() {\n return name;\n }\n\n @Override\n public boolean isUnique() {\n return unique;\n }\n\n @Override\n public boolean isNullable() {\n return nullable;\n }\n\n @Override\n public Class getKeyType() {\n return keyType;\n }\n\n @Override\n public Set getValues(E extension) {\n return indexFunc.apply(extension);\n }\n };\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/MultiValueIndexSpec.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Set;\nimport org.springframework.lang.Nullable;\nimport run.halo.app.extension.Extension;\n\n/**\n * Multi value index specification.\n *\n * @param the type of extension\n * @param the type of key\n * @author johnniang\n * @since 2.22.0\n */\ninterface MultiValueIndexSpec>\n extends ValueIndexSpec {\n\n @Nullable\n Set getValues(E extension);\n\n static > MultiValueBuilder builder(\n String name, Class keyType) {\n return new MultiValueBuilder<>(name, keyType);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/MultiValueIndexSpecBuilder.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Set;\nimport java.util.function.Function;\nimport run.halo.app.extension.Extension;\n\n/**\n * Builder for {@link MultiValueIndexSpec}.\n *\n * @param the type of extension\n * @param the type of index key\n * @author johnniang\n * @since 2.22.0\n */\npublic interface MultiValueIndexSpecBuilder>\n extends IndexSpecBuilder> {\n\n /**\n * Sets the index function.\n *\n * @param indexFunc the index function\n * @return the builder itself\n */\n MultiValueIndexSpecBuilder indexFunc(Function> indexFunc);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/SingleValueBuilder.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.function.Function;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.Extension;\n\n/**\n * Single value index specification builder.\n *\n * @param the type of extension\n * @param the type of index key\n * @author johnniang\n * @since 2.22.0\n */\nclass SingleValueBuilder>\n extends AbstractValueIndexSpecBuilder>\n implements SingleValueIndexSpecBuilder {\n\n private Function indexFunc;\n\n SingleValueBuilder(String name, Class keyType) {\n super(name, keyType);\n }\n\n @Override\n public SingleValueBuilder indexFunc(Function indexFunc) {\n this.indexFunc = indexFunc;\n return this;\n }\n\n @Override\n public ValueIndexSpec build() {\n Assert.hasText(name, \"Index name must not be blank\");\n Assert.notNull(keyType, \"Key type must not be null\");\n Assert.notNull(indexFunc, \"Index function must not be null\");\n\n return new SingleValueIndexSpec<>() {\n @Override\n public K getValue(E extension) {\n return indexFunc.apply(extension);\n }\n\n @Override\n public String getName() {\n return name;\n }\n\n @Override\n public boolean isUnique() {\n return unique;\n }\n\n @Override\n public boolean isNullable() {\n return nullable;\n }\n\n @Override\n public Class getKeyType() {\n return keyType;\n }\n };\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/SingleValueIndexSpec.java", "content": "package run.halo.app.extension.index;\n\nimport org.springframework.lang.Nullable;\nimport run.halo.app.extension.Extension;\n\n/**\n * Single value index specification.\n *\n * @param the type of extension\n * @param the type of key\n * @author johnniang\n * @since 2.22.0\n */\ninterface SingleValueIndexSpec>\n extends ValueIndexSpec {\n\n @Nullable\n K getValue(E extension);\n\n static > SingleValueBuilder builder(\n String name, Class keyType\n ) {\n return new SingleValueBuilder<>(name, keyType);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/SingleValueIndexSpecBuilder.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.function.Function;\nimport run.halo.app.extension.Extension;\n\n/**\n * Builder for {@link SingleValueIndexSpec}.\n *\n * @param the type of extension\n * @param the type of index key\n * @author johnniang\n * @since 2.22.0\n */\npublic interface SingleValueIndexSpecBuilder>\n extends IndexSpecBuilder> {\n\n /**\n * Sets the index function.\n *\n * @param indexFunc the index function\n * @return the builder itself\n */\n SingleValueIndexSpecBuilder indexFunc(Function indexFunc);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/UnknownKey.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Objects;\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.lang.Nullable;\n\n/**\n * String key wrapper for nullable string comparison. Only for backward compatibility. May remove\n * in the future.\n *\n * @author johnniang\n * @since 2.22.0\n */\n@Deprecated(forRemoval = true, since = \"2.22.0\")\nrecord UnknownKey(@Nullable String value) implements Comparable {\n\n @Override\n public int compareTo(@NotNull UnknownKey o) {\n return KeyComparator.INSTANCE.compare(this.value, o.value);\n }\n\n @Override\n public boolean equals(Object o) {\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n\n UnknownKey unknownKey = (UnknownKey) o;\n return Objects.equals(value, unknownKey.value);\n }\n\n @NotNull\n @Override\n public String toString() {\n return Objects.toString(value);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/ValueIndexSpec.java", "content": "package run.halo.app.extension.index;\n\nimport run.halo.app.extension.Extension;\n\n/**\n * Specification for a value index on an extension.\n *\n * @param the type of the extension\n * @param the type of the key\n * @author johnniang\n * @since 2.22.0\n */\npublic interface ValueIndexSpec> {\n\n /**\n * Gets the name of this index.\n *\n * @return the name of this index\n */\n String getName();\n\n /**\n * Whether this index is unique.\n *\n * @return true if this index is unique, false otherwise\n */\n boolean isUnique();\n\n /**\n * Whether this index allows null values.\n *\n * @return true if this index allows null values, false otherwise\n */\n boolean isNullable();\n\n /**\n * Gets the type of the key.\n *\n * @return the type of the key\n */\n Class getKeyType();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/AllCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord AllCondition(String indexName) implements Condition {\n\n @Override\n public Condition not() {\n return new NoneCondition(indexName);\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"ALL \" + indexName;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/And.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\n/**\n * This condition is only for backward compatibility.\n *\n * @param left left condition\n * @param right right condition\n * @deprecated Use {@link Condition#and(Condition)} instead.\n */\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic record And(Condition left, Condition right) implements Condition {\n\n @Override\n public Condition not() {\n return left.not().or(right.not());\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"(\" + left + \" AND \" + right + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/AndCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord AndCondition(Condition left, Condition right) implements Condition {\n\n public AndCondition {\n Assert.notNull(left, \"Left condition must not be null\");\n Assert.notNull(right, \"Right condition must not be null\");\n }\n\n @Override\n public Condition not() {\n return left.not().or(right.not());\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"(\" + left + \" AND \" + right + \")\";\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/BetweenCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord BetweenCondition(\n String indexName, Object fromKey, boolean fromInclusive, Object toKey, boolean toInclusive)\n implements IndexCondition {\n\n @Override\n public Condition not() {\n return new NotBetweenCondition(indexName, fromKey, !fromInclusive, toKey, !toInclusive);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" BETWEEN \"\n + (fromInclusive ? \"[\" : \"(\")\n + fromKey\n + \", \"\n + toKey\n + (toInclusive ? \"]\" : \")\");\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/Condition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.springframework.data.relational.core.sql.Visitable;\n\n/**\n * A condition used in querying index.\n * e.g.: {@code metadata.name = 'halo' AND status.published = true}\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface Condition extends Visitable, Query {\n\n /**\n * Combine with another condition using AND operator.\n *\n * @param another another condition\n * @return the combined condition\n */\n default Condition and(Condition another) {\n return new AndCondition(this, another);\n }\n\n /**\n * Combine with another condition using OR operator.\n *\n * @param another another condition\n * @return the combined condition\n */\n default Condition or(Condition another) {\n return new OrCondition(this, another);\n }\n\n /**\n * Negate this condition.\n *\n * @return the negated condition\n */\n default Condition not() {\n return new NotCondition(this);\n }\n\n /**\n * Creates an empty condition.\n *\n * @return an empty condition\n */\n static Condition empty() {\n return new EmptyCondition();\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/EmptyCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord EmptyCondition() implements Condition {\n\n @NotNull\n @Override\n public String toString() {\n return \"EMPTY\";\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/EqualCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord EqualCondition(String indexName, Object key) implements IndexCondition {\n\n public EqualCondition {\n Assert.notNull(key, \"Key of \" + indexName + \" must not be null\");\n }\n\n @Override\n public Condition not() {\n return new NotEqualCondition(indexName, key);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" = \" + key;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/GreaterThanCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord GreaterThanCondition(String indexName, Object lowerBound, boolean inclusive)\n implements IndexCondition {\n\n @Override\n public Condition not() {\n return new LessThanCondition(indexName, lowerBound, !inclusive);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + (inclusive ? \" >= \" : \" > \") + lowerBound;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/InCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.Collection;\nimport java.util.stream.Collectors;\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord InCondition(String indexName, Collection keys) implements IndexCondition {\n\n public InCondition {\n Assert.notNull(keys, \"Keys of \" + indexName + \" must not be empty\");\n }\n\n @Override\n public Condition not() {\n return new NotInCondition(indexName, keys);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" IN (\"\n + keys.stream().map(Object::toString).collect(Collectors.joining(\", \"))\n + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/IndexCondition.java", "content": "package run.halo.app.extension.index.query;\n\n/**\n * Index condition interface for index-based queries.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface IndexCondition extends Condition {\n\n /**\n * Get the index name.\n *\n * @return the index name\n */\n String indexName();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/IsNotNullCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord IsNotNullCondition(String indexName) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new IsNullCondition(indexName);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" IS NOT NULL\";\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/IsNullCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord IsNullCondition(String indexName) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new IsNotNullCondition(indexName);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" IS NULL\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelCondition.java", "content": "package run.halo.app.extension.index.query;\n\n/**\n * Label condition interface for label-based queries.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface LabelCondition extends Condition {\n\n String INDEX_NAME = \"metadata.labels\";\n\n /**\n * Get the label key.\n *\n * @return the label key\n */\n String labelKey();\n\n @Override\n LabelCondition not();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelEqualsCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord LabelEqualsCondition(String labelKey, String labelValue) implements LabelCondition {\n\n @Override\n public LabelCondition not() {\n return new LabelNotEqualsCondition(labelKey, labelValue);\n }\n\n @NotNull\n @Override\n public String toString() {\n return INDEX_NAME + \"['\" + labelKey + \"'] = '\" + labelValue + \"'\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelExistsCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord LabelExistsCondition(String labelKey) implements LabelCondition {\n\n @Override\n public LabelCondition not() {\n return new LabelNotExistsCondition(labelKey);\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"EXISTS \" + INDEX_NAME + \"['\" + labelKey + \"']\";\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelInCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.Collection;\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord LabelInCondition(String labelKey, Collection labelValues) implements LabelCondition {\n\n public LabelInCondition {\n Assert.notNull(labelValues, \"labelValues of \" + labelKey + \" must not be null\");\n }\n\n @Override\n public LabelCondition not() {\n return new LabelNotInCondition(labelKey, labelValues);\n }\n\n @NotNull\n @Override\n public String toString() {\n return INDEX_NAME + \"['\" + labelKey + \"'] IN (\"\n + String.join(\", \", labelValues.stream().map(v -> \"'\" + v + \"'\").toList())\n + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelNotEqualsCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord LabelNotEqualsCondition(String labelKey, String labelValue) implements LabelCondition {\n\n @Override\n public LabelCondition not() {\n return new LabelEqualsCondition(labelKey, labelValue);\n }\n\n @NotNull\n @Override\n public String toString() {\n return INDEX_NAME + \"['\" + labelKey + \"'] <> '\" + labelValue + \"'\";\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelNotExistsCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord LabelNotExistsCondition(String labelKey) implements LabelCondition {\n\n @Override\n public LabelCondition not() {\n return new LabelExistsCondition(labelKey);\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"NOT EXISTS \" + INDEX_NAME + \"['\" + labelKey + \"']\";\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LabelNotInCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.Collection;\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord LabelNotInCondition(String labelKey, Collection labelValues)\n implements LabelCondition {\n\n public LabelNotInCondition {\n Assert.notNull(labelValues, \"labelValues of \" + labelKey + \" must not be null\");\n }\n\n @Override\n public LabelCondition not() {\n return new LabelInCondition(labelKey, labelValues);\n }\n\n @NotNull\n @Override\n public String toString() {\n return INDEX_NAME + \"['\" + labelKey + \"'] NOT IN (\"\n + String.join(\", \", labelValues.stream().map(v -> \"'\" + v + \"'\").toList())\n + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/LessThanCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord LessThanCondition(String indexName, Object upperBound, boolean inclusive)\n implements IndexCondition {\n\n @Override\n public Condition not() {\n return new GreaterThanCondition(indexName, upperBound, !inclusive);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + (inclusive ? \" <= \" : \" < \") + upperBound;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/NoneCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord NoneCondition(String indexName) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new AllCondition(indexName);\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"NONE \" + indexName;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/NotBetweenCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord NotBetweenCondition(\n String indexName, Object fromKey, boolean fromInclusive, Object toKey, boolean toInclusive)\n implements IndexCondition {\n\n @Override\n public Condition not() {\n return new BetweenCondition(indexName, fromKey, !fromInclusive, toKey, !toInclusive);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" NOT BETWEEN \"\n + (fromInclusive ? \"[\" : \"(\")\n + fromKey\n + \", \"\n + toKey\n + (toInclusive ? \"]\" : \")\");\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/NotCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord NotCondition(Condition condition) implements Condition {\n\n public NotCondition {\n Assert.notNull(condition, \"Condition must not be null\");\n }\n\n @Override\n public Condition not() {\n return condition;\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"NOT (\" + condition + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/NotEqualCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord NotEqualCondition(String indexName, Object key) implements IndexCondition {\n\n\n public NotEqualCondition {\n Assert.notNull(key, \"Key of \" + indexName + \" must not be null\");\n }\n\n @Override\n public Condition not() {\n return new EqualCondition(indexName, key);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" != \" + key;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/NotInCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.Collection;\nimport java.util.stream.Collectors;\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord NotInCondition(String indexName, Collection keys) implements IndexCondition {\n\n public NotInCondition {\n Assert.notNull(keys, \"Keys of \" + indexName + \" must not be empty\");\n }\n\n @Override\n public Condition not() {\n return new InCondition(indexName, keys);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" NOT IN (\"\n + keys.stream().map(Object::toString).collect(Collectors.joining(\", \"))\n + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/OrCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\nimport org.springframework.util.Assert;\n\nrecord OrCondition(Condition left, Condition right) implements Condition {\n\n public OrCondition {\n Assert.notNull(left, \"Left condition must not be null\");\n Assert.notNull(right, \"Right condition must not be null\");\n }\n\n @Override\n public Condition not() {\n return left.not().and(right.not());\n }\n\n @NotNull\n @Override\n public String toString() {\n return \"(\" + left + \" OR \" + right + \")\";\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/Queries.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.Collection;\nimport org.springframework.util.Assert;\n\n/**\n * A utility class for building query conditions.\n *\n *

\n * Use {@link Condition#not()} to create negated conditions.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic enum Queries {\n ;\n\n /**\n * Combines multiple conditions with a logical AND.\n *\n * @param condition the first condition, must not be null\n * @param additionalConditions additional conditions to combine\n * @return the combined condition\n */\n public static Condition and(Condition condition, Condition... additionalConditions) {\n Assert.notNull(condition, \"Condition must not be null\");\n return Arrays.stream(additionalConditions)\n .reduce(condition, Condition::and);\n }\n\n /**\n * Combines multiple conditions with a logical OR.\n *\n * @param condition the first condition, must not be null\n * @param additionalConditions additional conditions to combine\n * @return the combined condition\n */\n public static Condition or(Condition condition, Condition... additionalConditions) {\n Assert.notNull(condition, \"Condition must not be null\");\n return Arrays.stream(additionalConditions)\n .reduce(condition, Condition::or);\n }\n\n /**\n * Negates the specified condition.\n *\n * @param condition the condition to negate, must not be null\n * @return the negated condition\n */\n public static Condition not(Condition condition) {\n Assert.notNull(condition, \"Condition must not be null\");\n return condition.not();\n }\n\n /**\n * Creates a \"between\" condition for the specified field name and range values.\n *\n * @param fieldName the name of the field\n * @param fromValue the start value of the range\n * @param fromInclusive whether the start value is inclusive\n * @param toValue the end value of the range\n * @param toInclusive whether the end value is inclusive\n * @return the \"between\" condition\n */\n public static Condition between(String fieldName,\n Object fromValue, boolean fromInclusive, Object toValue, boolean toInclusive) {\n return new BetweenCondition(fieldName, fromValue, fromInclusive, toValue, toInclusive);\n }\n\n /**\n * Creates an empty condition that matches all records.\n *\n * @return the empty condition\n */\n public static Condition empty() {\n return new EmptyCondition();\n }\n\n /**\n * Creates an \"all\" condition for the specified field name.\n *\n * @param fieldName the name of the field\n * @return the \"all\" condition\n */\n public static Condition all(String fieldName) {\n return new AllCondition(fieldName);\n }\n\n /**\n * Creates an \"is null\" condition for the specified field name.\n *\n * @param fieldName the name of the field\n * @return the \"is null\" condition\n */\n public static Condition isNull(String fieldName) {\n return new IsNullCondition(fieldName);\n }\n\n /**\n * Creates an \"equal\" condition for the specified field name and attribute value.\n *\n * @param fieldName the name of the field\n * @param attributeValue the attribute value, must not be null\n * @return the \"equal\" condition\n */\n public static Condition equal(String fieldName, Object attributeValue) {\n Assert.notNull(attributeValue,\n \"Attribute key of field \" + fieldName + \" must not be null\"\n );\n return new EqualCondition(fieldName, attributeValue);\n }\n\n /**\n * Creates a \"greater than\" condition for the specified field name and attribute value.\n *\n * @param fieldName the name of the field\n * @param attributeValue the attribute value, must not be null\n * @param inclusive whether the comparison is inclusive\n * @return the \"greater than\" condition\n */\n public static Condition greaterThan(\n String fieldName, Object attributeValue, boolean inclusive) {\n return new GreaterThanCondition(fieldName, attributeValue, inclusive);\n }\n\n /**\n * Creates a \"greater than\" condition for the specified field name and attribute value.\n *\n * @param fieldName the name of the field\n * @param attributeValue the attribute value, must not be null. Which is not inclusive.\n * @return the \"greater than\" condition\n */\n public static Condition greaterThan(String fieldName, Object attributeValue) {\n return greaterThan(fieldName, attributeValue, false);\n }\n\n /**\n * Creates an \"in\" condition for the specified field name and attribute values.\n *\n * @param fieldName the name of the field\n * @param attributeValue the first attribute value, must not be null. If it's a collection,\n * it will be treated as the collection of values for the \"in\" condition.\n * @param additionalValues additional attribute values\n * @return the \"in\" condition\n */\n @SuppressWarnings(\"unchecked\")\n public static Condition in(\n String fieldName, Object attributeValue, Object... additionalValues) {\n Assert.notNull(attributeValue,\n \"Attribute key of field \" + fieldName + \" must not be null\"\n );\n if (attributeValue instanceof Collection collection) {\n // Allow passing a collection directly\n return in(fieldName, (Collection) collection);\n }\n if (additionalValues == null) {\n return equal(fieldName, attributeValue);\n }\n var values = new ArrayList<>(additionalValues.length + 1);\n values.add(attributeValue);\n values.addAll(Arrays.asList(additionalValues));\n return in(fieldName, values);\n }\n\n /**\n * Creates an \"in\" condition for the specified field name and collection of values.\n *\n * @param fieldName the name of the field\n * @param values the collection of values, must not be null\n * @return the \"in\" condition\n */\n public static Condition in(String fieldName, Collection values) {\n Assert.notNull(values, \"Values must not be null\");\n if (values.size() == 1) {\n var value = values.iterator().next();\n return equal(fieldName, value);\n }\n return new InCondition(fieldName, values);\n }\n\n /**\n * Creates a \"less than\" condition for the specified field name and attribute value.\n *\n * @param fieldName the name of the field\n * @param attributeValue the attribute value, must not be null\n * @param inclusive whether the comparison is inclusive\n * @return the \"less than\" condition\n */\n public static Condition lessThan(String fieldName, Object attributeValue, boolean inclusive) {\n return new LessThanCondition(fieldName, attributeValue, inclusive);\n }\n\n /**\n * Creates a \"less than\" condition for the specified field name and attribute value.\n *\n * @param fieldName the name of the field\n * @param attributeValue the attribute value, must not be null. Which is not inclusive.\n * @return the \"less than\" condition\n */\n public static Condition lessThan(String fieldName, Object attributeValue) {\n return lessThan(fieldName, attributeValue, false);\n }\n\n /**\n * Creates a \"not equal\" condition for the specified field name and attribute value.\n *\n * @param fieldName the name of the field\n * @param attributeValue the attribute value, must not be null\n * @return the \"not equal\" condition\n */\n public static Condition notEqual(String fieldName, Object attributeValue) {\n return new NotEqualCondition(fieldName, attributeValue);\n }\n\n /**\n * Creates a \"starts with\" condition for the specified field name and prefix value.\n *\n * @param fieldName the name of the field\n * @param prefix the prefix value, must not be null\n * @return the \"starts with\" condition\n */\n public static Condition startsWith(String fieldName, String prefix) {\n return new StringStartsWithCondition(fieldName, prefix);\n }\n\n /**\n * Creates an \"ends with\" condition for the specified field name and suffix value.\n *\n * @param fieldName the name of the field\n * @param suffix the suffix value, must not be null\n * @return the \"ends with\" condition\n */\n public static Condition endsWith(String fieldName, String suffix) {\n return new StringEndsWithCondition(fieldName, suffix);\n }\n\n /**\n * Creates a \"contains\" condition for the specified field name and substring value.\n *\n * @param fieldName the name of the field\n * @param substring the substring value, must not be null\n * @return the \"contains\" condition\n */\n public static Condition contains(String fieldName, String substring) {\n return new StringContainsCondition(fieldName, substring);\n }\n\n /**\n * Creates a label condition that checks for the existence of a label with the specified key.\n *\n * @param labelKey the label key, must not be null\n * @return the label existence condition\n */\n public static LabelCondition labelExists(String labelKey) {\n return new LabelExistsCondition(labelKey);\n }\n\n /**\n * Creates a label condition that checks for equality of a label with the specified key and\n * value.\n *\n * @param labelKey the label key, must not be null\n * @param labelValue the label value, must not be null\n * @return the label equality condition\n */\n public static LabelCondition labelEqual(String labelKey, String labelValue) {\n return new LabelEqualsCondition(labelKey, labelValue);\n }\n\n /**\n * Creates a label condition that checks if a label with the specified key has a value within\n * the given collection of values.\n *\n * @param labelKey the label key, must not be null\n * @param labelValues the collection of label values, must not be null\n * @return the label \"in\" condition\n */\n public static LabelCondition labelIn(String labelKey, Collection labelValues) {\n return new LabelInCondition(labelKey, labelValues);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/Query.java", "content": "package run.halo.app.extension.index.query;\n\n/**\n * A {@link Query} is used to build queries for searching indexed objects.\n *\n *

\n * Keep this interface is only for backward compatibility.\n *\n * @author guqing\n * @since 2.12.0\n * @deprecated Use {@link Condition} instead.\n */\n@Deprecated(since = \"2.22.0\", forRemoval = true)\npublic interface Query {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/QueryFactory.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport lombok.experimental.UtilityClass;\nimport org.springframework.util.Assert;\n\n/**\n * Query factory utility class.\n *\n * @deprecated Use {@link Queries} instead.\n */\n@Deprecated(since = \"2.22.0\", forRemoval = true)\n@UtilityClass\npublic class QueryFactory {\n\n public static Query all() {\n return new EmptyCondition();\n }\n\n public static Query all(String fieldName) {\n return new AllCondition(fieldName);\n }\n\n public static Query isNull(String fieldName) {\n return new IsNullCondition(fieldName);\n }\n\n public static Query isNotNull(String fieldName) {\n return new IsNotNullCondition(fieldName);\n }\n\n public static Query notEqual(String fieldName, String attributeValue) {\n return Queries.notEqual(fieldName, attributeValue);\n }\n\n public static Query equal(String fieldName, String attributeValue) {\n return Queries.equal(fieldName, attributeValue);\n }\n\n public static Query lessThan(String fieldName, String attributeValue) {\n return Queries.lessThan(fieldName, attributeValue);\n }\n\n public static Query lessThanOrEqual(String fieldName, String attributeValue) {\n return Queries.lessThan(fieldName, attributeValue, true);\n }\n\n public static Query greaterThan(String fieldName, String attributeValue) {\n return Queries.greaterThan(fieldName, attributeValue);\n }\n\n public static Query greaterThanOrEqual(String fieldName, String attributeValue) {\n return Queries.greaterThan(fieldName, attributeValue, true);\n }\n\n public static Query in(String fieldName, String... attributeValues) {\n return Queries.in(fieldName, Set.of(attributeValues));\n }\n\n public static Query in(String fieldName, Collection values) {\n var convertedValues = values.stream()\n .map(v -> (Object) v)\n .collect(Collectors.toSet());\n return Queries.in(fieldName, convertedValues);\n }\n\n public static Query and(Collection queries) {\n Assert.notEmpty(queries, \"Queries must not be empty\");\n if (queries.size() == 1) {\n return queries.iterator().next();\n }\n return queries.stream()\n .peek(query -> {\n if (!(query instanceof Condition)) {\n throw new IllegalArgumentException(\n \"Only Condition instances are supported in AND operations\");\n }\n })\n .map(query -> (Condition) query)\n .reduce(Condition::and)\n .orElseThrow(() -> new IllegalArgumentException(\"No Condition found in queries\"));\n }\n\n public static And and(Query left, Query right) {\n Assert.isInstanceOf(Condition.class, left,\n \"Only Condition instances are supported in AND operations\");\n Assert.isInstanceOf(Condition.class, right,\n \"Only Condition instances are supported in AND operations\");\n return new And((Condition) left, (Condition) right);\n }\n\n public static Query and(Query left, Query right, Query... additionalQueries) {\n var queries = new ArrayList(2 + additionalQueries.length);\n queries.add(left);\n queries.add(right);\n Collections.addAll(queries, additionalQueries);\n return and(queries);\n }\n\n public static Query and(Query left, Query right, Collection additionalQueries) {\n var queries = new ArrayList(2 + additionalQueries.size());\n queries.add(left);\n queries.add(right);\n queries.addAll(additionalQueries);\n return and(queries);\n }\n\n private static Query or(Collection queries) {\n Assert.notEmpty(queries, \"Queries must not be empty\");\n if (queries.size() == 1) {\n return queries.iterator().next();\n }\n return queries.stream()\n .peek(query -> {\n if (!(query instanceof Condition)) {\n throw new IllegalArgumentException(\n \"Only Condition instances are supported in OR operations\");\n }\n })\n .map(query -> (Condition) query)\n .reduce(Condition::or)\n .orElseThrow(() -> new IllegalArgumentException(\"No Condition found in queries\"));\n }\n\n public static Query or(Query left, Query right) {\n return or(List.of(left, right));\n }\n\n public static Query or(Query query1, Query query2, Query... additionalQueries) {\n var queries = new ArrayList(2 + additionalQueries.length);\n queries.add(query1);\n queries.add(query2);\n Collections.addAll(queries, additionalQueries);\n return or(queries);\n }\n\n public static Query or(Query query1, Query query2, Collection additionalQueries) {\n var queries = new ArrayList(2 + additionalQueries.size());\n queries.add(query1);\n queries.add(query2);\n queries.addAll(additionalQueries);\n return or(queries);\n }\n\n public static Query not(Query query) {\n Assert.isInstanceOf(Condition.class, query,\n \"Only Condition instances are supported in NOT operations\");\n return ((Condition) query).not();\n }\n\n public static Query betweenLowerExclusive(String fieldName, String lowerValue,\n String upperValue) {\n return Queries.between(fieldName, lowerValue, false, upperValue, true);\n }\n\n public static Query betweenUpperExclusive(String fieldName, String lowerValue,\n String upperValue) {\n return Queries.between(fieldName, lowerValue, true, upperValue, false);\n }\n\n public static Query betweenExclusive(String fieldName, String lowerValue,\n String upperValue) {\n return Queries.between(fieldName, lowerValue, false, upperValue, false);\n }\n\n public static Query between(String fieldName, String lowerValue, String upperValue) {\n return Queries.between(fieldName, lowerValue, true, upperValue, true);\n }\n\n public static Query startsWith(String fieldName, String value) {\n return Queries.startsWith(fieldName, value);\n }\n\n public static Query endsWith(String fieldName, String value) {\n return Queries.endsWith(fieldName, value);\n }\n\n public static Query contains(String fieldName, String value) {\n return Queries.contains(fieldName, value);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/StringContainsCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord StringContainsCondition(String indexName, String keyword) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new StringNotContainsCondition(indexName, keyword);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" CONTAINS \" + keyword;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/StringEndsWithCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord StringEndsWithCondition(String indexName, String suffix) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new StringNotEndsWithCondition(indexName, suffix);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" ENDS WITH \" + suffix;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/StringNotContainsCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord StringNotContainsCondition(String indexName, String keyword) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new StringContainsCondition(indexName, keyword);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" NOT CONTAINS \" + keyword;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/StringNotEndsWithCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord StringNotEndsWithCondition(String indexName, String suffix) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new StringEndsWithCondition(indexName, suffix);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" NOT ENDS WITH \" + suffix;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/StringNotStartsWithCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord StringNotStartsWithCondition(String indexName, String prefix) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new StringStartsWithCondition(indexName, prefix);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" NOT STARTS WITH \" + prefix;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/index/query/StringStartsWithCondition.java", "content": "package run.halo.app.extension.index.query;\n\nimport org.jetbrains.annotations.NotNull;\n\nrecord StringStartsWithCondition(String indexName, String prefix) implements IndexCondition {\n\n @Override\n public Condition not() {\n return new StringNotStartsWithCondition(indexName, prefix);\n }\n\n @NotNull\n @Override\n public String toString() {\n return indexName + \" STARTS WITH \" + prefix;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/IListRequest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.Collections;\nimport java.util.List;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.boot.convert.ApplicationConversionService;\nimport org.springframework.core.convert.ConversionService;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.util.StringUtils;\nimport run.halo.app.extension.PageRequestImpl;\n\npublic interface IListRequest {\n\n @Schema(description = \"The page number. Zero indicates no page.\")\n Integer getPage();\n\n @Schema(description = \"Size of one page. Zero indicates no limit.\")\n Integer getSize();\n\n @Schema(description = \"Label selector for filtering.\")\n List getLabelSelector();\n\n @Schema(description = \"Field selector for filtering.\")\n List getFieldSelector();\n\n class QueryListRequest implements IListRequest {\n\n protected final MultiValueMap queryParams;\n\n private final ConversionService conversionService =\n ApplicationConversionService.getSharedInstance();\n\n public QueryListRequest(MultiValueMap queryParams) {\n this.queryParams = queryParams;\n }\n\n @Override\n public Integer getPage() {\n var page = queryParams.getFirst(\"page\");\n if (StringUtils.hasText(page)) {\n return conversionService.convert(page, Integer.class);\n }\n return 0;\n }\n\n @Override\n public Integer getSize() {\n var size = queryParams.getFirst(\"size\");\n if (StringUtils.hasText(size)) {\n return conversionService.convert(size, Integer.class);\n }\n return PageRequestImpl.MAX_SIZE;\n }\n\n @Override\n public List getLabelSelector() {\n return queryParams.getOrDefault(\"labelSelector\", Collections.emptyList());\n }\n\n @Override\n public List getFieldSelector() {\n return queryParams.getOrDefault(\"fieldSelector\", Collections.emptyList());\n }\n }\n\n static void buildParameters(Builder builder) {\n builder.parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"page\")\n .implementation(Integer.class)\n .required(false)\n .description(\"Page number. Default is 0.\"))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"size\")\n .implementation(Integer.class)\n .required(false)\n .description(\"Size number. Default is 0.\"))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"labelSelector\")\n .required(false)\n .description(\"Label selector. e.g.: hidden!=true\")\n .implementationArray(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"fieldSelector\")\n .required(false)\n .description(\"Field selector. e.g.: metadata.name==halo\")\n .implementationArray(String.class)\n );\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/QueryParamBuildUtil.java", "content": "package run.halo.app.extension.router;\n\nimport static org.springdoc.core.fn.builders.arrayschema.Builder.arraySchemaBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.experimental.UtilityClass;\nimport lombok.extern.slf4j.Slf4j;\n\n@Slf4j\n@UtilityClass\npublic class QueryParamBuildUtil {\n\n public static org.springdoc.core.fn.builders.parameter.Builder sortParameter() {\n return parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"sort\")\n .required(false)\n .description(\"\"\"\n Sorting criteria in the format: property,(asc|desc). \\\n Default sort order is ascending. Multiple sort criteria are supported.\\\n \"\"\")\n .array(arraySchemaBuilder().schema(schemaBuilder().type(\"string\")));\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/SortableRequest.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.Comparators.compareCreationTimestamp;\nimport static run.halo.app.extension.Comparators.compareName;\nimport static run.halo.app.extension.Comparators.nullsComparator;\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\nimport static run.halo.app.extension.router.selector.SelectorUtil.labelAndFieldSelectorToListOptions;\n\nimport io.swagger.v3.oas.annotations.media.ArraySchema;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.Comparator;\nimport java.util.function.Function;\nimport java.util.stream.Stream;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.beans.BeanWrapper;\nimport org.springframework.beans.BeanWrapperImpl;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.web.server.ServerWebExchange;\nimport run.halo.app.core.extension.endpoint.SortResolver;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\n\npublic class SortableRequest extends IListRequest.QueryListRequest {\n\n protected final ServerWebExchange exchange;\n\n public SortableRequest(ServerWebExchange exchange) {\n super(exchange.getRequest().getQueryParams());\n this.exchange = exchange;\n }\n\n @ArraySchema(uniqueItems = true,\n arraySchema = @Schema(name = \"sort\",\n description = \"Sort property and direction of the list result. Support sorting based \"\n + \"on attribute name path.\"),\n schema = @Schema(description = \"like field,asc or field,desc\",\n implementation = String.class,\n example = \"metadata.creationTimestamp,desc\"))\n public Sort getSort() {\n return SortResolver.defaultInstance.resolve(exchange)\n .and(defaultSort());\n }\n\n /**\n * Build {@link ListOptions} from query params.\n *\n * @return a list options.\n */\n public ListOptions toListOptions() {\n return labelAndFieldSelectorToListOptions(getLabelSelector(), getFieldSelector());\n }\n\n public PageRequest toPageRequest() {\n return PageRequestImpl.of(getPage(), getSize(), getSort());\n }\n\n /**\n * Build comparator from sort.\n *\n * @param Extension type\n * @return comparator\n */\n public Comparator toComparator() {\n var sort = getSort();\n var fallbackComparator = Stream.>of(\n compareCreationTimestamp(false),\n compareName(true)\n );\n var comparatorStream = sort.stream().map(order -> {\n var property = order.getProperty();\n var direction = order.getDirection();\n Function function = extension -> {\n BeanWrapper beanWrapper = new BeanWrapperImpl(extension);\n return beanWrapper.getPropertyValue(property);\n };\n var comparator =\n Comparator.comparing(function, nullsComparator(direction.isAscending()));\n if (direction.isDescending()) {\n comparator = comparator.reversed();\n }\n return comparator;\n });\n return Stream.concat(comparatorStream, fallbackComparator)\n .reduce(Comparator::thenComparing)\n .orElse(null);\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(QueryParamBuildUtil.sortParameter());\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/FieldSelector.java", "content": "package run.halo.app.extension.router.selector;\n\nimport java.util.Objects;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.index.query.Query;\n\npublic record FieldSelector(@Nullable Query query) {\n\n public FieldSelector(Query query) {\n this.query = Objects.requireNonNullElseGet(query, Queries::empty);\n }\n\n public static FieldSelector of(Query query) {\n return new FieldSelector(query);\n }\n\n public static FieldSelector all() {\n return new FieldSelector(Queries.empty());\n }\n\n public FieldSelector andQuery(Query other) {\n Assert.isInstanceOf(Condition.class, other, \"Only Condition query is supported\");\n Assert.isInstanceOf(Condition.class, query, \"Only Condition query is supported\");\n return of(((Condition) query).and((Condition) other));\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/FieldSelectorConverter.java", "content": "package run.halo.app.extension.router.selector;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport java.util.Set;\nimport org.springframework.core.convert.converter.Converter;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.Queries;\n\npublic class FieldSelectorConverter implements Converter {\n\n @NonNull\n @Override\n public Condition convert(@NonNull SelectorCriteria criteria) {\n var key = criteria.key();\n // compatible with old field selector\n if (\"name\".equals(key)) {\n key = \"metadata.name\";\n }\n switch (criteria.operator()) {\n case Equals -> {\n return Queries.equal(key, getSingleValue(criteria));\n }\n case NotEquals -> {\n return Queries.notEqual(key, getSingleValue(criteria));\n }\n // compatible with old field selector\n case IN -> {\n Set valueArr = defaultIfNull(criteria.values(), Set.of());\n return Queries.in(key, valueArr);\n }\n default -> throw new IllegalArgumentException(\n \"Unsupported operator: \" + criteria.operator());\n }\n }\n\n String getSingleValue(SelectorCriteria criteria) {\n if (CollectionUtils.isEmpty(criteria.values())) {\n throw new IllegalArgumentException(\"No value present for label key: \" + criteria.key());\n }\n return criteria.values().iterator().next();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/LabelSelector.java", "content": "package run.halo.app.extension.router.selector;\n\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.LabelCondition;\nimport run.halo.app.extension.index.query.Queries;\n\n@Data\n@Accessors(chain = true)\npublic class LabelSelector {\n\n private List conditions;\n\n @Override\n public String toString() {\n if (CollectionUtils.isEmpty(conditions)) {\n return Condition.empty().toString();\n }\n return conditions.stream()\n .map(c -> (Condition) c)\n .reduce(Condition::and)\n .orElseGet(Condition::empty)\n .toString();\n }\n\n /**\n * Returns a new label selector that is the result of ANDing the current selector with the\n * given selector.\n *\n * @param other the selector to AND with\n * @return a new label selector\n */\n public LabelSelector and(LabelSelector other) {\n var labelSelector = new LabelSelector();\n var newConditions = new ArrayList();\n newConditions.addAll(this.conditions);\n newConditions.addAll(other.conditions);\n labelSelector.setConditions(newConditions);\n return labelSelector;\n }\n\n public static LabelSelectorBuilder builder() {\n return new LabelSelectorBuilder<>();\n }\n\n public static class LabelSelectorBuilder> {\n private final List conditions = new ArrayList<>();\n\n public LabelSelectorBuilder() {\n }\n\n /**\n * Create a new label selector builder with the given matchers.\n */\n public LabelSelectorBuilder(List conditions) {\n if (conditions != null) {\n this.conditions.addAll(conditions);\n }\n }\n\n @SuppressWarnings(\"unchecked\")\n private T self() {\n return (T) this;\n }\n\n public T eq(String key, String value) {\n conditions.add(Queries.labelEqual(key, value));\n return self();\n }\n\n public T notEq(String key, String value) {\n conditions.add(Queries.labelEqual(key, value).not());\n return self();\n }\n\n public T in(String key, String... values) {\n conditions.add(Queries.labelIn(key, Arrays.asList(values)));\n return self();\n }\n\n public T notIn(String key, String... values) {\n conditions.add(Queries.labelIn(key, Arrays.asList(values)).not());\n return self();\n }\n\n public T exists(String key) {\n conditions.add(Queries.labelExists(key));\n return self();\n }\n\n public T notExists(String key) {\n conditions.add(Queries.labelExists(key).not());\n return self();\n }\n\n /**\n * Build the label selector.\n */\n public LabelSelector build() {\n var labelSelector = new LabelSelector();\n labelSelector.setConditions(conditions);\n return labelSelector;\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/LabelSelectorConverter.java", "content": "package run.halo.app.extension.router.selector;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport java.util.Set;\nimport org.springframework.core.convert.converter.Converter;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.index.query.LabelCondition;\nimport run.halo.app.extension.index.query.Queries;\n\npublic class LabelSelectorConverter implements Converter {\n\n @NonNull\n @Override\n public LabelCondition convert(@NonNull SelectorCriteria criteria) {\n switch (criteria.operator()) {\n case Equals -> {\n return Queries.labelEqual(criteria.key(), getSingleValue(criteria));\n }\n case NotEquals -> {\n return Queries.labelEqual(criteria.key(), getSingleValue(criteria)).not();\n }\n case NotExist -> {\n return Queries.labelExists(criteria.key()).not();\n }\n case Exist -> {\n return Queries.labelExists(criteria.key());\n }\n case IN -> {\n return Queries.labelIn(criteria.key(), defaultIfNull(criteria.values(), Set.of()));\n }\n default ->\n throw new IllegalArgumentException(\"Unsupported operator: \" + criteria.operator());\n }\n }\n\n String getSingleValue(SelectorCriteria criteria) {\n if (CollectionUtils.isEmpty(criteria.values())) {\n throw new IllegalArgumentException(\"No value present for label key: \" + criteria.key());\n }\n return criteria.values().iterator().next();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/Operator.java", "content": "package run.halo.app.extension.router.selector;\n\nimport java.util.Set;\nimport org.springframework.core.convert.converter.Converter;\nimport org.springframework.lang.Nullable;\n\npublic enum Operator implements Converter {\n\n Equals(\"=\", 3) {\n @Override\n @Nullable\n public SelectorCriteria convert(@Nullable String selector) {\n if (preFlightCheck(selector, 3)) {\n var i = selector.indexOf(getOperator());\n if (i > 0 && (i + getOperator().length()) <= selector.length() - 1) {\n String key = selector.substring(0, i);\n String value = selector.substring(i + getOperator().length());\n return new SelectorCriteria(key, this, Set.of(value));\n }\n }\n return null;\n }\n },\n IN(\"=(\", 2) {\n @Override\n public SelectorCriteria convert(String selector) {\n if (preFlightCheck(selector, 5)) {\n var idx = selector.indexOf(getOperator());\n if (idx > 0 && (idx + getOperator().length()) < selector.length() - 2\n && selector.charAt(selector.length() - 1) == ')') {\n var key = selector.substring(0, idx);\n var valuesString =\n selector.substring(idx + getOperator().length(), selector.length() - 1);\n String[] values = valuesString.split(\",\");\n return new SelectorCriteria(key, this, Set.of(values));\n }\n }\n return null;\n }\n },\n NotEquals(\"!=\", 1) {\n @Override\n @Nullable\n public SelectorCriteria convert(@Nullable String selector) {\n if (preFlightCheck(selector, 4)) {\n var i = selector.indexOf(getOperator());\n if (i > 0 && (i + getOperator().length()) < selector.length()) {\n String key = selector.substring(0, i);\n String value = selector.substring(i + getOperator().length());\n return new SelectorCriteria(key, this, Set.of(value));\n }\n }\n return null;\n }\n },\n NotExist(\"!\", 0) {\n @Override\n @Nullable\n public SelectorCriteria convert(@Nullable String selector) {\n if (preFlightCheck(selector, 2)) {\n if (selector.startsWith(getOperator())) {\n return new SelectorCriteria(selector.substring(1), this, Set.of());\n }\n }\n return null;\n }\n },\n Exist(\"\", Integer.MAX_VALUE) {\n @Override\n public SelectorCriteria convert(String selector) {\n if (preFlightCheck(selector, 1)) {\n // TODO validate the source with regex in the future\n return new SelectorCriteria(selector, this, Set.of());\n }\n return null;\n }\n };\n private final String operator;\n\n /**\n * Parse order.\n */\n private final int order;\n\n Operator(String operator, int order) {\n this.operator = operator;\n this.order = order;\n }\n\n public String getOperator() {\n return operator;\n }\n\n public int getOrder() {\n return order;\n }\n\n protected boolean preFlightCheck(String selector, int minLength) {\n return selector != null && selector.length() >= minLength;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/SelectorConverter.java", "content": "package run.halo.app.extension.router.selector;\n\nimport java.util.Arrays;\nimport java.util.Comparator;\nimport java.util.Objects;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.core.convert.converter.Converter;\nimport org.springframework.lang.Nullable;\n\n@Slf4j\npublic class SelectorConverter implements Converter {\n\n @Override\n @Nullable\n public SelectorCriteria convert(@Nullable String selector) {\n return Arrays.stream(Operator.values())\n .sorted(Comparator.comparing(Operator::getOrder))\n .map(operator -> {\n log.debug(\"Resolving selector: {} with operator: {}\", selector, operator);\n return operator.convert(selector);\n })\n .filter(Objects::nonNull)\n .findFirst()\n .orElse(null);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/SelectorCriteria.java", "content": "package run.halo.app.extension.router.selector;\n\nimport java.util.Set;\n\npublic record SelectorCriteria(String key, Operator operator, Set values) {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/extension/router/selector/SelectorUtil.java", "content": "package run.halo.app.extension.router.selector;\n\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.index.query.Condition;\n\npublic final class SelectorUtil {\n\n private SelectorUtil() {\n }\n\n /**\n * Convert label and field selector expressions to {@link ListOptions}.\n *\n * @param labelSelectorTerms label selector expressions\n * @param fieldSelectorTerms field selector expressions\n * @return list options(never null)\n */\n public static ListOptions labelAndFieldSelectorToListOptions(\n List labelSelectorTerms, List fieldSelectorTerms) {\n var selectorConverter = new SelectorConverter();\n\n var labelConverter = new LabelSelectorConverter();\n var labelConditions = Optional.ofNullable(labelSelectorTerms)\n .map(selectors -> selectors.stream()\n .map(selectorConverter::convert)\n .filter(Objects::nonNull)\n .map(labelConverter::convert)\n .toList())\n .orElse(List.of());\n\n var fieldConverter = new FieldSelectorConverter();\n var fieldCondition = Optional.ofNullable(fieldSelectorTerms)\n .map(selectors -> selectors.stream()\n .map(selectorConverter::convert)\n .filter(Objects::nonNull)\n .map(fieldConverter::convert)\n .reduce(Condition::and)\n .orElse(null)\n )\n .orElse(null);\n var listOptions = new ListOptions();\n listOptions.setLabelSelector(new LabelSelector().setConditions(labelConditions));\n if (fieldCondition != null) {\n listOptions.setFieldSelector(FieldSelector.of(fieldCondition));\n } else {\n listOptions.setFieldSelector(FieldSelector.all());\n }\n return listOptions;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/AnonymousUserConst.java", "content": "package run.halo.app.infra;\n\npublic interface AnonymousUserConst {\n String PRINCIPAL = \"anonymousUser\";\n\n String Role = \"anonymous\";\n\n static boolean isAnonymousUser(String principal) {\n return PRINCIPAL.equals(principal);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/BackupRootGetter.java", "content": "package run.halo.app.infra;\n\nimport java.nio.file.Path;\nimport java.util.function.Supplier;\n\n/**\n * Utility of getting backup root path.\n *\n * @author johnniang\n * @since 2.9.0\n */\npublic interface BackupRootGetter extends Supplier {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/Condition.java", "content": "package run.halo.app.infra;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.AllArgsConstructor;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.NoArgsConstructor;\n\n/**\n * EqualsAndHashCode 排除了lastTransitionTime否则失败时，lastTransitionTime 会被更新\n * 导致 equals 为 false，一直被加入队列.\n *\n * @author guqing\n * @see\n * pod-conditions\n * @since 2.0.0\n */\n@Data\n@Builder\n@NoArgsConstructor\n@AllArgsConstructor\n@EqualsAndHashCode(exclude = \"lastTransitionTime\")\npublic class Condition {\n /**\n * type of condition in CamelCase or in foo.example.com/CamelCase.\n * example: Ready, Initialized.\n * maxLength: 316.\n */\n @Schema(requiredMode = REQUIRED, maxLength = 316,\n pattern = \"^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(\"\n + \"([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$\")\n private String type;\n\n /**\n * Status is the status of the condition. Can be True, False, Unknown.\n */\n @Schema(requiredMode = REQUIRED)\n private ConditionStatus status;\n\n /**\n * Last time the condition transitioned from one status to another.\n */\n @Schema(requiredMode = REQUIRED)\n private Instant lastTransitionTime;\n\n /**\n * Human-readable message indicating details about last transition.\n * This may be an empty string.\n */\n @Schema(maxLength = 32768)\n @Builder.Default\n private String message = \"\";\n\n /**\n * Unique, one-word, CamelCase reason for the condition's last transition.\n */\n @Schema(maxLength = 1024,\n pattern = \"^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$\")\n @Builder.Default\n private String reason = \"\";\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/ConditionList.java", "content": "package run.halo.app.infra;\n\nimport java.util.AbstractCollection;\nimport java.util.Deque;\nimport java.util.Iterator;\nimport java.util.LinkedList;\nimport java.util.Objects;\nimport java.util.function.Consumer;\nimport org.springframework.lang.NonNull;\n\n/**\n *

This {@link ConditionList} to stores multiple {@link Condition}.

\n *

The element added after is always the first, the first to be removed is always the first to\n * be added.

\n *

The queue head is the one whose element index is 0

\n * Note that: this class is not thread-safe.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class ConditionList extends AbstractCollection {\n private static final int EVICT_THRESHOLD = 20;\n private final Deque conditions = new LinkedList<>();\n\n @Override\n public boolean add(@NonNull Condition condition) {\n if (isSame(conditions.peekFirst(), condition)) {\n return false;\n }\n return conditions.add(condition);\n }\n\n public boolean addFirst(@NonNull Condition condition) {\n if (isSame(conditions.peekFirst(), condition)) {\n return false;\n }\n conditions.addFirst(condition);\n return true;\n }\n\n /**\n * Add {@param #condition} and evict the first item if the size of conditions is greater than\n * {@link #EVICT_THRESHOLD}.\n *\n * @param condition item to add\n */\n public boolean addAndEvictFIFO(@NonNull Condition condition) {\n return addAndEvictFIFO(condition, EVICT_THRESHOLD);\n }\n\n /**\n * Add {@param #condition} and evict the first item if the size of conditions is greater than\n * {@param evictThreshold}.\n *\n * @param condition item to add\n */\n public boolean addAndEvictFIFO(@NonNull Condition condition, int evictThreshold) {\n var current = getCondition(condition.getType());\n if (current != null) {\n // do not update last transition time if status is not changed\n if (Objects.equals(condition.getStatus(), current.getStatus())) {\n condition.setLastTransitionTime(current.getLastTransitionTime());\n }\n }\n\n conditions.remove(current);\n conditions.addFirst(condition);\n\n while (conditions.size() > evictThreshold) {\n removeLast();\n }\n return true;\n }\n\n private Condition getCondition(String type) {\n for (Condition condition : conditions) {\n if (condition.getType().equals(type)) {\n return condition;\n }\n }\n return null;\n }\n\n\n public void remove(Condition condition) {\n conditions.remove(condition);\n }\n\n /**\n * Retrieves, but does not remove, the head of the queue represented by\n * this deque (in other words, the first element of this deque), or\n * returns {@code null} if this deque is empty.\n *\n *

This method is equivalent to {@link #peekFirst()}.\n *\n * @return the head of the queue represented by this deque, or\n * {@code null} if this deque is empty\n */\n public Condition peek() {\n return peekFirst();\n }\n\n public Condition peekFirst() {\n return conditions.peekFirst();\n }\n\n public Condition removeLast() {\n return conditions.removeLast();\n }\n\n @Override\n public void clear() {\n conditions.clear();\n }\n\n public int size() {\n return conditions.size();\n }\n\n private boolean isSame(Condition a, Condition b) {\n if (a == null || b == null) {\n return false;\n }\n return Objects.equals(a.getType(), b.getType())\n && Objects.equals(a.getStatus(), b.getStatus())\n && Objects.equals(a.getReason(), b.getReason())\n && Objects.equals(a.getMessage(), b.getMessage());\n }\n\n @Override\n public Iterator iterator() {\n return conditions.iterator();\n }\n\n @Override\n public void forEach(Consumer action) {\n conditions.forEach(action);\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n ConditionList that = (ConditionList) o;\n return Objects.equals(conditions, that.conditions);\n }\n\n @Override\n public int hashCode() {\n return Objects.hash(conditions);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/ConditionStatus.java", "content": "package run.halo.app.infra;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic enum ConditionStatus {\n TRUE,\n FALSE,\n UNKNOWN\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/ExternalLinkProcessor.java", "content": "package run.halo.app.infra;\n\nimport java.net.URI;\nimport org.springframework.http.HttpRequest;\nimport reactor.core.publisher.Mono;\n\n/**\n * {@link ExternalLinkProcessor} to process an in-site link to an external link.\n *\n * @author guqing\n * @see ExternalUrlSupplier\n * @since 2.9.0\n */\npublic interface ExternalLinkProcessor {\n\n /**\n * If the link is in-site link, then process it to an external link with\n * {@link ExternalUrlSupplier#getRaw()}, otherwise return the original link.\n *\n * @param link link to process\n * @return processed link or original link\n */\n String processLink(String link);\n\n /**\n * Process the URI to an external URL.\n *

\n * If the URI is an in-site link, then process it to an external link with\n * {@link ExternalUrlSupplier#getRaw()} or {@link ExternalUrlSupplier#getURL(HttpRequest)},\n * otherwise return the original URI.\n *

\n *\n * @param uri uri to process\n * @return processed URI or original URI\n */\n Mono processLink(URI uri);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/ExternalUrlSupplier.java", "content": "package run.halo.app.infra;\n\nimport java.net.URI;\nimport java.net.URL;\nimport java.util.function.Supplier;\nimport javax.annotation.Nullable;\nimport org.springframework.http.HttpRequest;\n\n/**\n * Represents a supplier of external url configuration.\n *\n * @author johnniang\n */\npublic interface ExternalUrlSupplier extends Supplier {\n\n /**\n * Gets URI according to external URL and use-absolute-permalink properties.\n *\n * @return URI \"/\" returned if use-absolute-permalink is false. Or external URL will be\n * returned.(never null)\n */\n @Override\n URI get();\n\n /**\n * Gets URL according to external URL and server request URL.\n *\n * @param request represents an HTTP request message, consisting of a method and a URI.\n * @return External URL will be return if it is provided, or request URI will be returned.\n * (never null)\n */\n URL getURL(HttpRequest request);\n\n /**\n * Gets user-configured external URL from HaloProperties#getExternalUrl().\n *\n * @return user-configured external URL or null if it is not provided.\n */\n @Nullable\n URL getRaw();\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/FileCategoryMatcher.java", "content": "package run.halo.app.infra;\n\nimport java.util.Set;\n\n/**\n *

Classifies files based on their MIME types.

\n *

It provides different categories such as IMAGE, SVG, AUDIO, VIDEO, ARCHIVE, and DOCUMENT.\n * Each category has a match method that checks if a given MIME type belongs to that\n * category.

\n *

The categories are defined as follows:

\n * 
\n * - IMAGE: Matches all image MIME types except for SVG.\n * - SVG: Specifically matches the SVG image MIME type.\n * - AUDIO: Matches all audio MIME types.\n * - VIDEO: Matches all video MIME types.\n * - ARCHIVE: Matches common archive MIME types like zip, rar, tar, etc.\n * - DOCUMENT: Matches common document MIME types like plain text, PDF, Word, Excel, etc.\n *
\n *\n * @author guqing\n * @since 2.18.0\n */\npublic enum FileCategoryMatcher {\n ALL {\n @Override\n public boolean match(String mimeType) {\n return true;\n }\n },\n IMAGE {\n @Override\n public boolean match(String mimeType) {\n return mimeType.startsWith(\"image/\") && !mimeType.equals(\"image/svg+xml\");\n }\n },\n SVG {\n @Override\n public boolean match(String mimeType) {\n return mimeType.equals(\"image/svg+xml\");\n }\n },\n AUDIO {\n @Override\n public boolean match(String mimeType) {\n return mimeType.startsWith(\"audio/\");\n }\n },\n VIDEO {\n @Override\n public boolean match(String mimeType) {\n return mimeType.startsWith(\"video/\");\n }\n },\n ARCHIVE {\n static final Set ARCHIVE_MIME_TYPES = Set.of(\n \"application/zip\",\n \"application/x-rar-compressed\",\n \"application/x-tar\",\n \"application/gzip\",\n \"application/x-bzip2\",\n \"application/x-xz\",\n \"application/x-7z-compressed\"\n );\n\n @Override\n public boolean match(String mimeType) {\n return ARCHIVE_MIME_TYPES.contains(mimeType);\n }\n },\n DOCUMENT {\n static final Set DOCUMENT_MIME_TYPES = Set.of(\n \"text/plain\",\n \"application/rtf\",\n \"text/csv\",\n \"text/xml\",\n \"application/pdf\",\n \"application/msword\",\n \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n \"application/vnd.ms-excel\",\n \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n \"application/vnd.ms-powerpoint\",\n \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n \"application/vnd.oasis.opendocument.text\",\n \"application/vnd.oasis.opendocument.spreadsheet\",\n \"application/vnd.oasis.opendocument.presentation\"\n );\n\n @Override\n public boolean match(String mimeType) {\n return DOCUMENT_MIME_TYPES.contains(mimeType);\n }\n };\n\n public abstract boolean match(String mimeType);\n\n /**\n * Get the file category matcher by name.\n */\n public static FileCategoryMatcher of(String name) {\n for (var matcher : values()) {\n if (matcher.name().equalsIgnoreCase(name)) {\n return matcher;\n }\n }\n throw new IllegalArgumentException(\"Unsupported file category matcher for name: \" + name);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/SystemInfo.java", "content": "package run.halo.app.infra;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.net.URL;\nimport java.util.Locale;\nimport java.util.TimeZone;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\n\n@Data\n@Accessors(chain = true)\npublic class SystemInfo {\n private String title;\n\n private String subtitle;\n\n private String logo;\n\n private String favicon;\n\n private URL url;\n\n private Version version;\n\n private SeoProp seo;\n\n private Locale locale;\n\n private TimeZone timeZone;\n\n private String activatedThemeName;\n\n @Data\n @Accessors(chain = true)\n public static class SeoProp {\n private boolean blockSpiders;\n private String keywords;\n private String description;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/SystemInfoGetter.java", "content": "package run.halo.app.infra;\n\nimport java.util.function.Supplier;\nimport reactor.core.publisher.Mono;\n\npublic interface SystemInfoGetter extends Supplier> {\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/SystemSetting.java", "content": "package run.halo.app.infra;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport jakarta.validation.constraints.NotBlank;\nimport java.util.LinkedHashMap;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport org.apache.commons.lang3.StringUtils;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.boot.convert.ApplicationConversionService;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * TODO Optimization value acquisition.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class SystemSetting {\n public static final String SYSTEM_CONFIG_DEFAULT = \"system-default\";\n public static final String SYSTEM_CONFIG = \"system\";\n\n @Builder\n public record Attachment(\n\n @Nullable\n UploadOptions console,\n\n @Nullable\n UploadOptions uc,\n\n @Nullable\n UploadOptions comment,\n\n @Nullable\n UploadOptions avatar\n\n ) {\n\n public static final String GROUP = \"attachment\";\n\n @Builder\n public record UploadOptions(\n\n @Nullable\n String groupName,\n\n @NotBlank\n String policyName\n\n ) {\n }\n\n }\n\n @Data\n public static class Theme {\n public static final String GROUP = \"theme\";\n\n private String active;\n }\n\n @Data\n public static class ThemeRouteRules {\n public static final String GROUP = \"routeRules\";\n\n private boolean disableThemePreview;\n private String categories;\n private String archives;\n private String post;\n private String tags;\n\n public static ThemeRouteRules empty() {\n ThemeRouteRules rules = new ThemeRouteRules();\n rules.setPost(\"/archives/{slug}\");\n rules.setArchives(\"/archives\");\n rules.setTags(\"/tags\");\n rules.setCategories(\"/categories\");\n return rules;\n }\n }\n\n @Data\n public static class CodeInjection {\n public static final String GROUP = \"codeInjection\";\n\n private String globalHead;\n\n private String contentHead;\n\n private String footer;\n }\n\n @Data\n public static class Basic {\n public static final String GROUP = \"basic\";\n String title;\n String subtitle;\n String logo;\n String favicon;\n String language;\n String externalUrl;\n\n @JsonIgnore\n public Optional useSystemLocale() {\n return Optional.ofNullable(language)\n .filter(StringUtils::isNotBlank)\n .map(Locale::forLanguageTag);\n }\n }\n\n @Data\n public static class User {\n public static final String GROUP = \"user\";\n boolean allowRegistration;\n boolean mustVerifyEmailOnRegistration;\n String defaultRole;\n\n /**\n * @deprecated since 2.22.0, use {@link Attachment} instead.\n */\n @Deprecated(since = \"2.22.0\")\n String avatarPolicy;\n\n /**\n * @deprecated since 2.22.0, use {@link Attachment} instead.\n */\n @Deprecated(since = \"2.22.0\")\n String ucAttachmentPolicy;\n\n String protectedUsernames;\n }\n\n @Data\n public static class Post {\n public static final String GROUP = \"post\";\n Integer postPageSize;\n Integer archivePageSize;\n Integer categoryPageSize;\n Integer tagPageSize;\n Integer authorPageSize;\n Boolean review;\n String slugGenerationStrategy;\n\n String attachmentPolicyName;\n String attachmentGroupName;\n }\n\n @Data\n public static class Seo {\n public static final String GROUP = \"seo\";\n Boolean blockSpiders;\n String keywords;\n String description;\n }\n\n @Data\n public static class Comment {\n public static final String GROUP = \"comment\";\n Boolean enable;\n Boolean requireReviewForNew;\n Boolean systemUserOnly;\n }\n\n @Data\n public static class Menu {\n public static final String GROUP = \"menu\";\n public String primary;\n }\n\n @Data\n public static class AuthProvider {\n public static final String GROUP = \"authProvider\";\n\n private List states;\n\n }\n\n @Data\n @Accessors(chain = true)\n public static class AuthProviderState {\n private String name;\n private boolean enabled;\n private int priority;\n }\n\n /**\n * ExtensionPointEnabled key is metadata name of extension point and value is a list of\n * extension definition names.\n */\n public static class ExtensionPointEnabled extends LinkedHashMap> {\n\n public static final String GROUP = \"extensionPointEnabled\";\n\n }\n\n @Nullable\n public static T get(Map data, String key, Class type) {\n var valueString = data.get(key);\n if (valueString == null) {\n return null;\n }\n var conversionService = ApplicationConversionService.getSharedInstance();\n if (conversionService.canConvert(String.class, type)) {\n return conversionService.convert(valueString, type);\n }\n return JsonUtils.jsonToObject(valueString, type);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/SystemVersionSupplier.java", "content": "package run.halo.app.infra;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.util.function.Supplier;\n\n/**\n * The supplier to gets the project version.\n * If it cannot be obtained, return 0.0.0.\n *\n * @author guqing\n * @see Semantic Versioning 2.0.0\n * @since 2.0.0\n */\npublic interface SystemVersionSupplier extends Supplier {\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/ValidationUtils.java", "content": "package run.halo.app.infra;\n\nimport java.util.regex.Pattern;\nimport lombok.experimental.UtilityClass;\nimport org.springframework.context.i18n.LocaleContextHolder;\nimport org.springframework.validation.BeanPropertyBindingResult;\nimport org.springframework.validation.BindingResult;\nimport org.springframework.validation.Validator;\nimport org.springframework.web.server.ServerWebExchange;\n\n@UtilityClass\npublic class ValidationUtils {\n public static final String NAME_REGEX =\n \"^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$\";\n public static final Pattern NAME_PATTERN = Pattern.compile(NAME_REGEX);\n\n /**\n * {@code A-Z, a-z, 0-9, !@#$%^&*.?} are allowed.\n */\n public static final String PASSWORD_REGEX = \"^[A-Za-z0-9!@#$%^&*.?]+$\";\n\n public static final Pattern PASSWORD_PATTERN = Pattern.compile(PASSWORD_REGEX);\n\n /**\n * Validate the target object with given locale context.\n */\n public static BindingResult validate(Object target, String objectName,\n Validator validator, ServerWebExchange exchange) {\n BindingResult bindingResult = new BeanPropertyBindingResult(target, objectName);\n try {\n LocaleContextHolder.setLocaleContext(exchange.getLocaleContext());\n validator.validate(target, bindingResult);\n return bindingResult;\n } finally {\n LocaleContextHolder.resetLocaleContext();\n }\n }\n\n public static BindingResult validate(Object target, Validator validator,\n ServerWebExchange exchange) {\n return validate(target, \"form\", validator, exchange);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/model/License.java", "content": "package run.halo.app.infra.model;\n\nimport lombok.Data;\n\n/**\n * Common data objects for license.\n */\n@Data\npublic class License {\n private String name;\n private String url;\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/utils/FileTypeDetectUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport java.io.BufferedInputStream;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.util.List;\nimport lombok.experimental.UtilityClass;\nimport org.apache.tika.detect.DefaultDetector;\nimport org.apache.tika.detect.Detector;\nimport org.apache.tika.metadata.Metadata;\nimport org.apache.tika.metadata.TikaCoreProperties;\nimport org.apache.tika.mime.MimeTypeException;\nimport org.apache.tika.mime.MimeTypes;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\n\n@UtilityClass\npublic class FileTypeDetectUtils {\n\n private static final Detector detector = new DefaultDetector();\n\n /**\n *

Detects the media type of the given document.

\n *

The type detection is based on the content of the given document stream and the name of\n * the document.

\n *\n * @param inputStream the document stream must not be null\n * @throws IOException if the stream can not be read\n */\n public static String detectMimeType(InputStream inputStream, String name) throws IOException {\n Assert.notNull(name, \"The name of the document must not be null\");\n var metadata = new Metadata();\n metadata.set(TikaCoreProperties.RESOURCE_NAME_KEY, name);\n return doDetectMimeType(inputStream, metadata);\n }\n\n /**\n * Detect mime type.\n *\n * @param inputStream input stream will be closed after detection, must not be null\n */\n public static String detectMimeType(InputStream inputStream) throws IOException {\n return doDetectMimeType(inputStream, new Metadata());\n }\n\n private static String doDetectMimeType(InputStream inputStream, Metadata metadata)\n throws IOException {\n Assert.notNull(inputStream, \"The inputStream must not be null\");\n try (var stream = (!inputStream.markSupported()\n ? new BufferedInputStream(inputStream) : inputStream)) {\n return detector.detect(stream, metadata).toString();\n }\n }\n\n public static String detectFileExtension(String mimeType) throws MimeTypeException {\n MimeTypes mimeTypes = MimeTypes.getDefaultMimeTypes();\n return mimeTypes.forName(mimeType).getExtension();\n }\n\n public static List detectFileExtensions(String mimeType) throws MimeTypeException {\n MimeTypes mimeTypes = MimeTypes.getDefaultMimeTypes();\n return mimeTypes.forName(mimeType).getExtensions();\n }\n\n /**\n *

Get file extension from file name.

\n *

The obtained file extension is in lowercase and includes the dot, such as \".jpg\".

\n */\n @NonNull\n public static String getFileExtension(String fileName) {\n Assert.notNull(fileName, \"The fileName must not be null\");\n int lastDot = fileName.lastIndexOf(\".\");\n if (lastDot > 0) {\n return fileName.substring(lastDot).toLowerCase();\n }\n return \"\";\n }\n\n /**\n *

Recommend to use this method to verify whether the file extension matches the file type\n * after matching the file type to avoid XSS attacks such as bypassing detection by polyglot\n * file.

\n *\n * @param mimeType file mime type,such as \"image/png\"\n * @param fileName file name,such as \"test.png\"\n * @see\n * CVE Stored XSS\n * @see gh-7149\n */\n public boolean isValidExtensionForMime(String mimeType, String fileName) {\n Assert.notNull(mimeType, \"The mimeType must not be null\");\n Assert.notNull(fileName, \"The fileName must not be null\");\n String fileExtension = getFileExtension(fileName);\n try {\n List detectedExtByMime = detectFileExtensions(mimeType);\n return detectedExtByMime.stream().anyMatch(ext -> ext.equalsIgnoreCase(fileExtension));\n } catch (MimeTypeException e) {\n return false;\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/utils/GenericClassUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport java.util.function.Supplier;\nimport net.bytebuddy.ByteBuddy;\nimport net.bytebuddy.description.type.TypeDescription;\n\npublic enum GenericClassUtils {\n ;\n\n /**\n * Generate concrete class of generic class. e.g.: {@code List}\n *\n * @param rawClass is generic class, like {@code List.class}\n * @param parameterType is parameter type of generic class\n * @param parameter type\n * @return generated class\n */\n public static Class generateConcreteClass(Class rawClass, Class parameterType) {\n return generateConcreteClass(rawClass, parameterType, () ->\n parameterType.getName() + rawClass.getSimpleName());\n }\n\n /**\n * Generate concrete class of generic class. e.g.: {@code List}\n *\n * @param rawClass is generic class, like {@code List.class}\n * @param parameterType is parameter type of generic class\n * @param nameGenerator is generated class name\n * @param parameter type\n * @return generated class\n */\n public static Class generateConcreteClass(Class rawClass, Class parameterType,\n Supplier nameGenerator) {\n var concreteType =\n TypeDescription.Generic.Builder.parameterizedType(rawClass, parameterType).build();\n try (var unloaded = new ByteBuddy()\n .subclass(concreteType)\n .name(nameGenerator.get())\n .make()) {\n return unloaded.load(parameterType.getClassLoader()).getLoaded();\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/utils/JsonParseException.java", "content": "package run.halo.app.infra.utils;\n\n/**\n * {@link JsonParseException} thrown when source JSON is invalid.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class JsonParseException extends RuntimeException {\n public JsonParseException() {\n super();\n }\n\n public JsonParseException(String message) {\n super(message);\n }\n\n public JsonParseException(String message, Throwable cause) {\n super(message, cause);\n }\n\n public JsonParseException(Throwable cause) {\n super(cause);\n }\n\n protected JsonParseException(String message, Throwable cause, boolean enableSuppression,\n boolean writableStackTrace) {\n super(message, cause, enableSuppression, writableStackTrace);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/utils/JsonUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;\nimport io.swagger.v3.core.util.Json;\nimport java.util.Map;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\n\n/**\n * Json utilities.\n *\n * @author guqing\n * @see JavaTimeModule\n * @since 2.0.0\n * @deprecated Use {@link tools.jackson.databind.json.JsonMapper} directly instead.\n */\n@Deprecated(forRemoval = true, since = \"2.23.0\")\npublic class JsonUtils {\n public static final ObjectMapper DEFAULT_JSON_MAPPER = Json.mapper();\n\n private JsonUtils() {\n }\n\n public static ObjectMapper mapper() {\n return DEFAULT_JSON_MAPPER;\n }\n\n /**\n * Converts a map to the object specified type.\n *\n * @param sourceMap source map must not be empty\n * @param type object type must not be null\n * @param target object type\n * @return the object specified type\n */\n @NonNull\n public static T mapToObject(@NonNull Map sourceMap, @NonNull Class type) {\n return DEFAULT_JSON_MAPPER.convertValue(sourceMap, type);\n }\n\n /**\n * Converts object to json format.\n *\n * @param source source object must not be null\n * @return json format of the source object\n */\n @NonNull\n public static String objectToJson(@NonNull Object source) {\n Assert.notNull(source, \"Source object must not be null\");\n try {\n return DEFAULT_JSON_MAPPER.writeValueAsString(source);\n } catch (JsonProcessingException e) {\n throw new JsonParseException(e);\n }\n }\n\n /**\n * Method to deserialize JSON content from given JSON content String.\n *\n * @param json json content\n * @param toValueType object type to convert\n * @param real type to convert\n * @return converted object\n */\n public static T jsonToObject(String json, Class toValueType) {\n try {\n return DEFAULT_JSON_MAPPER.readValue(json, toValueType);\n } catch (Exception e) {\n throw new JsonParseException(e);\n }\n }\n\n /**\n * Method to deserialize JSON content from given JSON content String.\n *\n * @param json json content\n * @param typeReference type reference to convert\n * @param real type to convert\n * @return converted object\n */\n public static T jsonToObject(String json, TypeReference typeReference) {\n try {\n return DEFAULT_JSON_MAPPER.readValue(json, typeReference);\n } catch (Exception e) {\n throw new JsonParseException(e);\n }\n }\n\n /**\n * Method to deserialize JSON content and serialize back from given Object.\n *\n * @param source source object to copy\n * @param real type to deep copy\n * @return deep copy of the source object\n */\n @SuppressWarnings(\"unchecked\")\n public static T deepCopy(T source) {\n try {\n return (T) DEFAULT_JSON_MAPPER.readValue(objectToJson(source), source.getClass());\n } catch (JsonProcessingException e) {\n throw new JsonParseException(e);\n }\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/infra/utils/PathUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport lombok.experimental.UtilityClass;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\n\n/**\n * Http path manipulation tool class.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@UtilityClass\npublic class PathUtils {\n\n /**\n * Every HTTP URL conforms to the syntax of a generic URI. The URI generic syntax consists of\n * components organized hierarchically in order of decreasing significance from left to\n * right:\n * 
\n     * URI = scheme \":\" [\"//\" authority] path [\"?\" query] [\"#\" fragment]\n     *
\n * The authority component consists of subcomponents:\n * 
\n     * authority = [userinfo \"@\"] host [\":\" port]\n     *
\n * Examples of popular schemes include http, https, ftp, mailto, file, data and irc. URI\n * schemes should be registered with the\n * Internet Assigned Numbers Authority (IANA), although\n * non-registered schemes are used in practice.\n *\n * @param uriString url or path\n * @return true if the linkBase is absolute, otherwise false\n * @see URL\n */\n public static boolean isAbsoluteUri(final String uriString) {\n if (StringUtils.isBlank(uriString)) {\n return false;\n }\n try {\n URI uri = new URI(uriString);\n return uri.isAbsolute();\n } catch (URISyntaxException e) {\n log.debug(\"Failed to parse uri: \" + uriString, e);\n // ignore this exception\n return false;\n }\n }\n\n /**\n * Combine paths based on the passed in path segments parameters.\n *

\n * This method doesn't work for Windows system currently.\n *\n * @param pathSegments Path segments to be combined\n * @return the combined path\n */\n public static String combinePath(String... pathSegments) {\n StringBuilder sb = new StringBuilder();\n for (String path : pathSegments) {\n if (path == null) {\n continue;\n }\n String s = path.startsWith(\"/\") ? path : \"/\" + path;\n String segment = s.endsWith(\"/\") ? s.substring(0, s.length() - 1) : s;\n sb.append(segment);\n }\n return sb.toString();\n }\n\n\n /**\n *

Append a {@code '/'} if the path does not end with a {@code '/'}.

\n * Examples are as follows:\n * 
\n     *     PathUtils.appendPathSeparatorIfMissing(\"hello\") -> hello/\n     *     PathUtils.appendPathSeparatorIfMissing(\"some-path/\") -> some-path/\n     *     PathUtils.appendPathSeparatorIfMissing(null) -> null\n     *
\n *\n * @param path a path\n * @return A new String if suffix was appended, the same string otherwise.\n */\n public static String appendPathSeparatorIfMissing(String path) {\n return StringUtils.appendIfMissing(path, \"/\", \"/\");\n }\n\n /**\n *

Remove the regex in the path pattern placeholder.

\n *

For example:

\n *
    \n *
  • '{@code /{year:\\d{4}}/{month:\\d{2}}}' → '{@code /{year}/{month}}'
    • \n *
  • '{@code /archives/{year:\\d{4}}/{month:\\d{2}}}' → '{@code /archives/{year}/{month}\n * }'
    • \n *
  • '{@code /archives/{year:\\d{4}}/{slug}}' → '{@code /archives/{year}/{slug}}'
    • \n *
\n *\n * @param pattern path pattern\n * @return Simplified path pattern\n */\n public static String simplifyPathPattern(String pattern) {\n if (StringUtils.isBlank(pattern)) {\n return StringUtils.EMPTY;\n }\n String[] parts = StringUtils.split(pattern, '/');\n for (int i = 0; i < parts.length; i++) {\n String part = parts[i];\n if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n int colonIdx = part.indexOf(':');\n if (colonIdx != -1) {\n parts[i] = part.substring(0, colonIdx) + part.charAt(part.length() - 1);\n }\n\n }\n }\n return combinePath(parts);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/migration/Backup.java", "content": "package run.halo.app.migration;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"migration.halo.run\", version = \"v1alpha1\", kind = \"Backup\",\n plural = \"backups\", singular = \"backup\")\npublic class Backup extends AbstractExtension {\n\n private Spec spec = new Spec();\n\n private Status status = new Status();\n\n @Data\n @Schema(name = \"BackupSpec\")\n public static class Spec {\n\n @Schema(description = \"Backup file format. Currently, only zip format is supported.\")\n private String format;\n\n private Instant expiresAt;\n\n }\n\n @Data\n @Schema(name = \"BackupStatus\")\n public static class Status {\n\n private Phase phase = Phase.PENDING;\n\n private Instant startTimestamp;\n\n private Instant completionTimestamp;\n\n private String failureReason;\n\n private String failureMessage;\n\n /**\n * Size of backup file. Data unit: byte\n */\n private Long size;\n\n /**\n * Name of backup file.\n */\n private String filename;\n }\n\n public enum Phase {\n PENDING,\n RUNNING,\n SUCCEEDED,\n FAILED,\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/migration/Constant.java", "content": "package run.halo.app.migration;\n\npublic enum Constant {\n ;\n\n public static final String GROUP = \"migration.halo.run\";\n\n public static final String VERSION = \"v1alpha1\";\n\n public static final String HOUSE_KEEPER_FINALIZER = \"housekeeper\";\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/notification/NotificationCenter.java", "content": "package run.halo.app.notification;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\n\n/**\n * Notification center to notify and manage notifications.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface NotificationCenter {\n\n /**\n * Notifies the subscriber with the given reason.\n *\n * @param reason reason to notify\n */\n Mono notify(Reason reason);\n\n /**\n * Subscribes to the given subject with the given reason.\n *\n * @param subscriber subscriber to subscribe to\n * @param reason interest reason to subscribe\n * @return a subscription\n */\n Mono subscribe(Subscription.Subscriber subscriber,\n Subscription.InterestReason reason);\n\n /**\n * Unsubscribes by the given subject.\n *\n * @param subscriber subscriber to unsubscribe\n */\n Mono unsubscribe(Subscription.Subscriber subscriber);\n\n /**\n * Unsubscribes by the given subject and reason.\n *\n * @param subscriber subscriber to unsubscribe\n * @param reason reason to unsubscribe\n */\n Mono unsubscribe(Subscription.Subscriber subscriber, Subscription.InterestReason reason);\n}\n" }, { "path": "api/src/main/java/run/halo/app/notification/NotificationContext.java", "content": "package run.halo.app.notification;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.time.Instant;\nimport lombok.Builder;\nimport lombok.Data;\n\n@Data\npublic class NotificationContext {\n\n private Message message;\n\n private ObjectNode receiverConfig;\n\n private ObjectNode senderConfig;\n\n @Data\n public static class Message {\n private MessagePayload payload;\n\n private Subject subject;\n\n private String recipient;\n\n private Instant timestamp;\n }\n\n @Data\n @Builder\n public static class Subject {\n private String apiVersion;\n private String kind;\n private String name;\n private String title;\n private String url;\n }\n\n @Data\n public static class MessagePayload {\n private String title;\n\n private String rawBody;\n\n private String htmlBody;\n\n private ReasonAttributes attributes;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/notification/NotificationReasonEmitter.java", "content": "package run.halo.app.notification;\n\nimport java.util.function.Consumer;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Reason;\n\n/**\n * {@link NotificationReasonEmitter} to emit notification reason.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface NotificationReasonEmitter {\n\n /**\n * Emit a {@link Reason} with {@link ReasonPayload}.\n *\n * @param reasonType reason type to emitter must not be blank\n * @param reasonData reason data must not be null\n */\n Mono emit(String reasonType, Consumer reasonData);\n}\n" }, { "path": "api/src/main/java/run/halo/app/notification/ReactiveNotifier.java", "content": "package run.halo.app.notification;\n\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Mono;\n\n/**\n * Notifier to notify user.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface ReactiveNotifier extends ExtensionPoint {\n\n /**\n * Notify user.\n *\n * @param context notification context must not be null\n */\n Mono notify(NotificationContext context);\n}\n" }, { "path": "api/src/main/java/run/halo/app/notification/ReasonAttributes.java", "content": "package run.halo.app.notification;\n\nimport java.util.HashMap;\n\n/**\n *

{@link ReasonAttributes} is a map that stores the attributes of the reason.

\n *\n * @author guqing\n * @since 2.10.0\n */\npublic class ReasonAttributes extends HashMap {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/notification/ReasonPayload.java", "content": "package run.halo.app.notification;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport run.halo.app.core.extension.notification.Reason;\n\n/**\n * A value object to hold reason payload.\n *\n * @author guqing\n * @see Reason\n * @since 2.10.0\n */\n@Data\n@AllArgsConstructor\npublic class ReasonPayload {\n private Reason.Subject subject;\n private final UserIdentity author;\n private Map attributes;\n\n public static ReasonPayloadBuilder builder() {\n return new ReasonPayloadBuilder();\n }\n\n public static class ReasonPayloadBuilder {\n private Reason.Subject subject;\n private UserIdentity author;\n private final Map attributes;\n\n ReasonPayloadBuilder() {\n this.attributes = new HashMap<>();\n }\n\n public ReasonPayloadBuilder subject(Reason.Subject subject) {\n this.subject = subject;\n return this;\n }\n\n public ReasonPayloadBuilder attribute(String key, Object value) {\n this.attributes.put(key, value);\n return this;\n }\n\n public ReasonPayloadBuilder attributes(Map attributes) {\n this.attributes.putAll(attributes);\n return this;\n }\n\n public ReasonPayloadBuilder author(UserIdentity author) {\n this.author = author;\n return this;\n }\n\n public ReasonPayload build() {\n return new ReasonPayload(subject, author, attributes);\n }\n }\n}" }, { "path": "api/src/main/java/run/halo/app/notification/UserIdentity.java", "content": "package run.halo.app.notification;\n\nimport java.util.Optional;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.util.Assert;\nimport run.halo.app.infra.AnonymousUserConst;\n\n/**\n * Identity for user.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic record UserIdentity(String name) {\n public static final String SEPARATOR = \"#\";\n\n /**\n * Create identity with username to identify a user.\n *\n * @param username username\n * @return identity\n */\n public static UserIdentity of(String username) {\n return new UserIdentity(username);\n }\n\n /**\n *

Create identity with email to identify a user,\n * the name will be {@code anonymousUser#email}.

\n *

An anonymous user can not be identified by username so we use email to identify it.

\n *\n * @param email email\n * @return identity\n */\n public static UserIdentity anonymousWithEmail(String email) {\n Assert.notNull(email, \"Email must not be null\");\n String name = AnonymousUserConst.PRINCIPAL + SEPARATOR + email;\n return of(name);\n }\n\n public boolean isAnonymous() {\n return name().startsWith(AnonymousUserConst.PRINCIPAL + SEPARATOR);\n }\n\n /**\n * Gets email if the identity is an anonymous user.\n *\n * @return email if the identity is an anonymous user, otherwise empty\n */\n public Optional getEmail() {\n if (isAnonymous()) {\n return Optional.of(name().substring(name().indexOf(SEPARATOR) + 1))\n .filter(StringUtils::isNotBlank);\n }\n return Optional.empty();\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/ApiVersion.java", "content": "package run.halo.app.plugin;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n/**\n * Api version.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Target({ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Documented\npublic @interface ApiVersion {\n\n /**\n * Api version value.\n *\n * @return api version string\n */\n String value();\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/BasePlugin.java", "content": "package run.halo.app.plugin;\n\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.Plugin;\n\n/**\n * This class will be extended by all plugins and serve as the common class between a plugin and\n * the application.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Getter\n@Slf4j\npublic class BasePlugin extends Plugin {\n\n protected PluginContext context;\n\n /**\n * Constructor a plugin with the given plugin context.\n *\n * @param pluginContext plugin context must not be null.\n */\n public BasePlugin(PluginContext pluginContext) {\n this.context = pluginContext;\n }\n\n public BasePlugin() {\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/PluginConfigUpdatedEvent.java", "content": "package run.halo.app.plugin;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport java.util.Map;\nimport lombok.Builder;\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ConfigMap;\n\n/**\n *

Event that is triggered when the {@link ConfigMap } represented by\n * {@link Plugin.PluginSpec#getConfigMapName()} in the {@link Plugin} is updated.

\n *

has two properties, oldConfig and newConfig, which represent the {@link ConfigMap#getData()}\n * property value of the {@link ConfigMap}.

\n *\n * @author guqing\n * @since 2.17.0\n */\n@Getter\npublic class PluginConfigUpdatedEvent extends ApplicationEvent {\n\n /**\n * Old configuration data.\n *\n * @deprecated Use {@link #oldSettingValues} and {@link #newSettingValues} instead.\n */\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n private final Map oldConfig;\n\n /**\n * New configuration data.\n *\n * @deprecated Use {@link #oldSettingValues} and {@link #newSettingValues} instead.\n */\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n private final Map newConfig;\n\n /**\n * Old setting values.\n */\n private final Map oldSettingValues;\n\n /**\n * New setting values.\n */\n private final Map newSettingValues;\n\n @Builder\n public PluginConfigUpdatedEvent(\n Object source,\n Map oldConfig,\n Map newConfig,\n Map oldSettingValues,\n Map newSettingValues\n ) {\n super(source);\n this.oldConfig = oldConfig;\n this.newConfig = newConfig;\n this.oldSettingValues = oldSettingValues;\n this.newSettingValues = newSettingValues;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/PluginContext.java", "content": "package run.halo.app.plugin;\n\nimport lombok.Builder;\nimport lombok.Getter;\nimport lombok.RequiredArgsConstructor;\nimport org.pf4j.RuntimeMode;\n\n/**\n *

This class will provide a context for the plugin, which will be used to store some\n * information about the plugin.

\n *

An instance of this class is provided to plugins in their constructor.

\n *

It's safe for plugins to keep a reference to the instance for later use.

\n *

This class facilitates communication with application and plugin manager.

\n *

Pf4j recommends that you use a custom PluginContext instead of PluginWrapper.

\n * Use application custom PluginContext instead of PluginWrapper\n *\n * @author guqing\n * @since 2.10.0\n */\n@Getter\n@Builder\n@RequiredArgsConstructor\npublic class PluginContext {\n private final String name;\n\n private final String configMapName;\n\n private final String version;\n\n private final RuntimeMode runtimeMode;\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/PluginsRootGetter.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport java.util.function.Supplier;\n\n/**\n * An interface to get the root path of plugins.\n *\n * @author johnniang\n * @since 2.18.0\n */\npublic interface PluginsRootGetter extends Supplier {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/ReactiveSettingFetcher.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Map;\nimport reactor.core.publisher.Mono;\nimport tools.jackson.databind.JsonNode;\n\n/**\n * The {@link ReactiveSettingFetcher} to help plugin fetch own setting configuration.\n *\n * @author guqing\n * @since 2.4.0\n */\npublic interface ReactiveSettingFetcher {\n\n Mono fetch(String group, Class clazz);\n\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n Mono get(String group);\n\n /**\n * Get setting value by group.\n *\n * @param group the setting group\n * @return the setting value or empty if not found\n */\n Mono getSettingValue(String group);\n\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n Mono> getValues();\n\n /**\n * Get all setting values.\n *\n * @return all setting values, never empty\n */\n Mono> getSettingValues();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/SettingFetcher.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Map;\nimport java.util.Optional;\nimport run.halo.app.extension.ConfigMap;\nimport tools.jackson.databind.JsonNode;\n\n/**\n * SettingFetcher must be a class instead of an interface due to backward compatibility.\n *\n * @author johnniang\n */\npublic interface SettingFetcher {\n\n Optional fetch(String group, Class clazz);\n\n /**\n * Get values from {@link ConfigMap} by group.\n *\n * @param group the setting group\n * @return the setting value(non-null)\n * @deprecated use {@link #getSettingValue(String)} instead\n */\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n com.fasterxml.jackson.databind.JsonNode get(String group);\n\n /**\n * Get setting value by group.\n *\n * @param group the setting group\n * @return the setting value(non-null)\n */\n JsonNode getSettingValue(String group);\n\n /**\n * Get values from {@link ConfigMap}.\n *\n * @return a unmodifiable map of values(non-null)\n * @deprecated use {@link #getSettingValues()} instead\n */\n @Deprecated(forRemoval = true, since = \"2.23.0\")\n Map getValues();\n\n /**\n * Get all setting values.\n *\n * @return all setting values, never null\n */\n Map getSettingValues();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/SharedEvent.java", "content": "package run.halo.app.plugin;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n/**\n *

It is a symbolic annotation.

\n *

When the event marked with {@link SharedEvent} annotation is published, it will be\n * broadcast to the application context of the plugin.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Target(ElementType.TYPE)\n@Retention(RetentionPolicy.RUNTIME)\n@Documented\npublic @interface SharedEvent {\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/event/PluginStartedEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * The event that is published when a plugin is really started, and is only for plugin internal use.\n *\n * @author johnniang\n * @since 2.17.0\n */\npublic class PluginStartedEvent extends ApplicationEvent {\n\n public PluginStartedEvent(Object source) {\n super(source);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionGetter.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport java.util.List;\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\npublic interface ExtensionGetter {\n\n /**\n * Get only one enabled extension from system configuration.\n *\n * @param extensionPoint is extension point class.\n * @return implementation of the corresponding extension point. If no configuration is found,\n * we will use the default implementation from application context instead.\n */\n Mono getEnabledExtension(Class extensionPoint);\n\n /**\n * Get the extension(s) according to the {@code ExtensionPointDefinition} queried\n * by incoming extension point class.\n *\n * @param extensionPoint extension point class\n * @return implementations of the corresponding extension point.\n * @throws IllegalArgumentException if the incoming extension point class does not have\n * the {@code ExtensionPointDefinition}.\n */\n Flux getEnabledExtensions(Class extensionPoint);\n\n /**\n * Get all extensions according to extension point class.\n *\n * @param extensionPointClass extension point class\n * @param type of extension point\n * @return a bunch of extension points.\n */\n Flux getExtensions(Class extensionPointClass);\n\n /**\n * Get all extensions according to extension point class.\n *\n * @param extensionPointClass extension point class\n * @param type of extension point\n * @return a bunch of extension points.\n */\n List getExtensionList(Class extensionPointClass);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/HaloDocument.java", "content": "package run.halo.app.search;\n\nimport jakarta.validation.constraints.NotBlank;\nimport jakarta.validation.constraints.PastOrPresent;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.Data;\n\n/**\n * Document for search.\n */\n@Data\npublic final class HaloDocument {\n\n /**\n * Document ID. It should be unique globally.\n */\n @NotBlank\n private String id;\n\n /**\n * Metadata name of the corresponding extension.\n */\n @NotBlank\n private String metadataName;\n\n /**\n * Custom metadata. Make sure the map is serializable.\n */\n private Map annotations;\n\n /**\n * Document title.\n */\n @NotBlank\n private String title;\n\n /**\n * Document description.\n */\n private String description;\n\n /**\n * Document content. Safety content, without HTML tag.\n */\n @NotBlank\n private String content;\n\n /**\n * Document categories. The item in the list is the category metadata name.\n */\n private List categories;\n\n /**\n * Document tags. The item in the list is the tag metadata name.\n */\n private List tags;\n\n /**\n * Whether the document is published.\n */\n private boolean published;\n\n /**\n * Whether the document is recycled.\n */\n private boolean recycled;\n\n /**\n * Whether the document is exposed to the public.\n */\n private boolean exposed;\n\n /**\n * Document owner metadata name.\n */\n @NotBlank\n private String ownerName;\n\n /**\n * Document creation timestamp.\n */\n @PastOrPresent\n private Instant creationTimestamp;\n\n /**\n * Document update timestamp.\n */\n @PastOrPresent\n private Instant updateTimestamp;\n\n /**\n * Document permalink.\n */\n @NotBlank\n private String permalink;\n\n /**\n * Document type. e.g.: post.content.halo.run, singlepage.content.halo.run, moment.moment\n * .halo.run, doc.doc.halo.run.\n */\n @NotBlank\n private String type;\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/HaloDocumentsProvider.java", "content": "package run.halo.app.search;\n\nimport org.pf4j.ExtensionPoint;\nimport reactor.core.publisher.Flux;\n\n/**\n * Halo documents provider. This interface is used to rebuild the search index.\n *\n * @author johnniang\n */\npublic interface HaloDocumentsProvider extends ExtensionPoint {\n\n /**\n * Fetch all halo documents.\n *\n * @return all halo documents\n */\n Flux fetchAll();\n\n /**\n * Get type of documents.\n *\n * @return type of documents\n */\n String getType();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/SearchEngine.java", "content": "package run.halo.app.search;\n\nimport org.pf4j.ExtensionPoint;\n\n/**\n * Search engine is used to index and search halo documents. Meanwhile, it is also an extension\n * point for adding different search engine implementations.\n *\n * @author johnniang\n */\npublic interface SearchEngine extends ExtensionPoint {\n\n /**\n * Whether the search engine is available.\n *\n * @return true if available, false otherwise\n */\n boolean available();\n\n /**\n * Add or update halo documents.\n *\n * @param haloDocuments halo documents\n */\n void addOrUpdate(Iterable haloDocuments);\n\n /**\n * Delete halo documents by ids.\n *\n * @param haloDocIds halo document ids\n */\n void deleteDocument(Iterable haloDocIds);\n\n /**\n * Delete all halo documents.\n */\n void deleteAll();\n\n /**\n * Search halo documents.\n *\n * @param option search option\n * @return search result of halo documents\n */\n SearchResult search(SearchOption option);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/SearchOption.java", "content": "package run.halo.app.search;\n\nimport jakarta.validation.constraints.Max;\nimport jakarta.validation.constraints.Min;\nimport jakarta.validation.constraints.NotBlank;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.Data;\n\n/**\n * Search option. It is used to control search behavior.\n *\n * @author johnniang\n */\n@Data\npublic class SearchOption {\n /**\n * Search keyword.\n */\n @NotBlank\n private String keyword;\n\n /**\n * Limit of result.\n */\n @Min(1)\n @Max(1000)\n private int limit = 10;\n\n /**\n * Pre HTML tag of highlighted fragment.\n */\n private String highlightPreTag = \"\";\n\n /**\n * Post HTML tag of highlighted fragment.\n */\n private String highlightPostTag = \"\";\n\n /**\n * Whether to filter exposed content. If null, it will not filter.\n */\n private Boolean filterExposed;\n\n /**\n * Whether to filter recycled content. If null, it will not filter.\n */\n private Boolean filterRecycled;\n\n /**\n * Whether to filter published content. If null, it will not filter.\n */\n private Boolean filterPublished;\n\n /**\n * Types to include(or). If null, it will include all types.\n */\n private List includeTypes;\n\n /**\n * Owner names to include(or). If null, it will include all owners.\n */\n private List includeOwnerNames;\n\n /**\n * Category names to include(and). If null, it will include all categories.\n */\n private List includeCategoryNames;\n\n /**\n * Tag names to include(and). If null, it will include all tags.\n */\n private List includeTagNames;\n\n /**\n * Additional annotations for extending search option by other search engines.\n */\n private Map annotations;\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/SearchResult.java", "content": "package run.halo.app.search;\n\nimport java.util.List;\nimport lombok.Data;\n\n@Data\npublic class SearchResult {\n private List hits;\n private String keyword;\n private Long total;\n private int limit;\n private long processingTimeMillis;\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/SearchService.java", "content": "package run.halo.app.search;\n\nimport reactor.core.publisher.Mono;\n\n/**\n * Search service is used to search content.\n *\n * @author johnniang\n * @since 2.17.0\n */\npublic interface SearchService {\n\n /**\n * Perform search.\n *\n * @param option search option must not be null\n * @return search result\n */\n Mono search(SearchOption option);\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/event/HaloDocumentAddRequestEvent.java", "content": "package run.halo.app.search.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.plugin.SharedEvent;\nimport run.halo.app.search.HaloDocument;\n\n@SharedEvent\npublic class HaloDocumentAddRequestEvent extends ApplicationEvent {\n\n private final Iterable documents;\n\n public HaloDocumentAddRequestEvent(Object source, Iterable documents) {\n super(source);\n this.documents = documents;\n }\n\n public Iterable getDocuments() {\n return documents;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/event/HaloDocumentDeleteRequestEvent.java", "content": "package run.halo.app.search.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.lang.Nullable;\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class HaloDocumentDeleteRequestEvent extends ApplicationEvent {\n\n private final Iterable docIds;\n\n /**\n * Construct a new {@code HaloDocumentDeleteRequestEvent} instance.\n *\n * @param source The source of the event.\n * @param docIds If the document IDs are not provided, all documents will be deleted.\n */\n public HaloDocumentDeleteRequestEvent(Object source, @Nullable Iterable docIds) {\n super(source);\n this.docIds = docIds;\n }\n\n public Iterable getDocIds() {\n return docIds;\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/search/event/HaloDocumentRebuildRequestEvent.java", "content": "package run.halo.app.search.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.plugin.SharedEvent;\n\n@SharedEvent\npublic class HaloDocumentRebuildRequestEvent extends ApplicationEvent {\n\n public HaloDocumentRebuildRequestEvent(Object source) {\n super(source);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/AdditionalWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.core.Ordered;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Contract for interception-style, chained processing of Web requests that may be used to\n * implement cross-cutting, application-agnostic requirements such as security, timeouts, and\n * others.\n *\n * @author guqing\n * @since 2.4.0\n */\npublic interface AdditionalWebFilter extends WebFilter, ExtensionPoint, Ordered {\n\n /**\n * Gets the order value of the object.\n *\n * @return the order value\n */\n default int getOrder() {\n return Ordered.LOWEST_PRECEDENCE;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/AfterSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for after security.\n *\n * @author johnniang\n * @since 2.18\n */\npublic interface AfterSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/AnonymousAuthenticationSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for anonymous authentication.\n *\n * @author johnniang\n */\npublic interface AnonymousAuthenticationSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/AuthenticationSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for normal authentication.\n *\n * @author johnniang\n */\npublic interface AuthenticationSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/BeforeSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for before security.\n *\n * @author johnniang\n * @since 2.18\n */\npublic interface BeforeSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/FormLoginSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for form login.\n *\n * @author johnniang\n */\npublic interface FormLoginSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/HttpBasicSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for HTTP basic.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface HttpBasicSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/LoginHandlerEnhancer.java", "content": "package run.halo.app.security;\n\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.AuthenticationException;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n *

Halo uses this interface to enhance the processing of login success, such as device management\n * and remember me, etc. The login method of the plugin extension needs to call this interface in\n * the processing method of login success to ensure the normal operation of some enhanced\n * functions.

\n *\n * @author guqing\n * @since 2.17.0\n */\npublic interface LoginHandlerEnhancer {\n\n /**\n * Invoked when login success.\n *\n * @param exchange The exchange.\n * @param successfulAuthentication The successful authentication.\n */\n Mono onLoginSuccess(ServerWebExchange exchange, Authentication successfulAuthentication);\n\n /**\n * Invoked when login fails.\n *\n * @param exchange The exchange.\n * @param exception the reason authentication failed\n */\n Mono onLoginFailure(ServerWebExchange exchange, AuthenticationException exception);\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/OAuth2AuthorizationCodeSecurityWebFilter.java", "content": "package run.halo.app.security;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.web.server.WebFilter;\n\n/**\n * Security web filter for OAuth2 authorization code.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface OAuth2AuthorizationCodeSecurityWebFilter extends WebFilter, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/PersonalAccessToken.java", "content": "package run.halo.app.security;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"security.halo.run\", version = \"v1alpha1\", kind = PersonalAccessToken.KIND,\n plural = \"personalaccesstokens\", singular = \"personalaccesstoken\")\npublic class PersonalAccessToken extends AbstractExtension {\n\n public static final String KIND = \"PersonalAccessToken\";\n\n public static final String PAT_TOKEN_PREFIX = \"pat_\";\n\n private Spec spec = new Spec();\n\n @Data\n @Schema(name = \"PatSpec\")\n public static class Spec {\n\n @Schema(requiredMode = REQUIRED)\n private String name;\n\n private String description;\n\n private Instant expiresAt;\n\n private List roles;\n\n private List scopes;\n\n @Schema(requiredMode = REQUIRED)\n private String username;\n\n private boolean revoked;\n\n private Instant revokesAt;\n\n private Instant lastUsed;\n\n @Schema(requiredMode = REQUIRED)\n private String tokenId;\n\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/authentication/CryptoService.java", "content": "package run.halo.app.security.authentication;\n\nimport com.nimbusds.jose.jwk.JWK;\nimport reactor.core.publisher.Mono;\n\npublic interface CryptoService {\n\n /**\n * Decrypts message with Base64 format.\n *\n * @param encryptedMessage is a byte array containing encrypted message.\n * @return decrypted message.\n */\n Mono decrypt(byte[] encryptedMessage);\n\n /**\n * Reads public key.\n *\n * @return byte array of public key\n */\n Mono readPublicKey();\n\n /**\n * Gets key ID of private key.\n *\n * @return key ID of private key.\n */\n String getKeyId();\n\n /**\n * Gets JSON Web Keys.\n *\n * @return JSON Web Keys\n */\n JWK getJwk();\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/authentication/login/UsernamePasswordAuthenticationManager.java", "content": "package run.halo.app.security.authentication.login;\n\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.security.authentication.ReactiveAuthenticationManager;\n\n/**\n * An extension point for username password authentication.\n * Any non-authentication exception occurs, the default authentication will be used.\n * If you want to skip authentication, please return Mono.empty() directly, the default\n * authentication will be used.\n *\n * @author johnniang\n * @since 2.8\n */\npublic interface UsernamePasswordAuthenticationManager\n extends ReactiveAuthenticationManager, ExtensionPoint {\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/authentication/oauth2/HaloOAuth2AuthenticationToken.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.Collections;\nimport lombok.Getter;\nimport org.springframework.security.authentication.AbstractAuthenticationToken;\nimport org.springframework.security.core.GrantedAuthority;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport org.springframework.security.oauth2.client.authentication.OAuth2AuthenticationToken;\nimport org.springframework.security.oauth2.core.user.OAuth2User;\n\n/**\n * Halo OAuth2 authentication token which combines {@link UserDetails} and original\n * {@link OAuth2AuthenticationToken}.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class HaloOAuth2AuthenticationToken extends AbstractAuthenticationToken {\n\n @Getter\n private final UserDetails userDetails;\n\n @Getter\n private final OAuth2AuthenticationToken original;\n\n /**\n * Constructs an {@code HaloOAuth2AuthenticationToken} using {@link UserDetails} and original\n * {@link OAuth2AuthenticationToken}.\n *\n * @param userDetails the {@link UserDetails}\n * @param original the original {@link OAuth2AuthenticationToken}\n */\n public HaloOAuth2AuthenticationToken(UserDetails userDetails,\n OAuth2AuthenticationToken original) {\n super(combineAuthorities(userDetails, original));\n this.userDetails = userDetails;\n this.original = original;\n setAuthenticated(true);\n }\n\n @Override\n public String getName() {\n return userDetails.getUsername();\n }\n\n @Override\n public Collection getAuthorities() {\n var originalAuthorities = super.getAuthorities();\n var userDetailsAuthorities = getUserDetails().getAuthorities();\n var authorities = new ArrayList(\n originalAuthorities.size() + userDetailsAuthorities.size()\n );\n authorities.addAll(originalAuthorities);\n authorities.addAll(userDetailsAuthorities);\n return Collections.unmodifiableList(authorities);\n }\n\n @Override\n public Object getCredentials() {\n return \"\";\n }\n\n @Override\n public OAuth2User getPrincipal() {\n return original.getPrincipal();\n }\n\n /**\n * Creates an authenticated {@link HaloOAuth2AuthenticationToken} using {@link UserDetails} and\n * original {@link OAuth2AuthenticationToken}.\n *\n * @param userDetails the {@link UserDetails}\n * @param original the original {@link OAuth2AuthenticationToken}\n * @return an authenticated {@link HaloOAuth2AuthenticationToken}\n */\n public static HaloOAuth2AuthenticationToken authenticated(\n UserDetails userDetails, OAuth2AuthenticationToken original\n ) {\n return new HaloOAuth2AuthenticationToken(userDetails, original);\n }\n\n private static Collection combineAuthorities(\n UserDetails userDetails, OAuth2AuthenticationToken original) {\n var userDetailsAuthorities = userDetails.getAuthorities();\n var originalAuthorities = original.getAuthorities();\n var authorities = new ArrayList(\n originalAuthorities.size() + userDetailsAuthorities.size()\n );\n authorities.addAll(originalAuthorities);\n authorities.addAll(userDetailsAuthorities);\n return Collections.unmodifiableList(authorities);\n }\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/security/device/DeviceService.java", "content": "package run.halo.app.security.device;\n\nimport org.springframework.security.core.Authentication;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\npublic interface DeviceService {\n\n Mono loginSuccess(ServerWebExchange exchange, Authentication successfullAuthentication);\n\n Mono changeSessionId(ServerWebExchange exchange);\n\n Mono revoke(String principalName, String deviceId);\n\n Mono revoke(String username);\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/Constant.java", "content": "package run.halo.app.theme;\n\n/**\n * This class holds constants related to the theme.\n *\n * @author johnniang\n */\npublic enum Constant {\n ;\n\n /**\n * The name of the variable that holds the SEO meta description.\n */\n public static final String META_DESCRIPTION_VARIABLE_NAME = \"seoMetaDescription\";\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/ReactivePostContentHandler.java", "content": "package run.halo.app.theme;\n\nimport lombok.Builder;\nimport lombok.Data;\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\n\n/**\n *

{@link ReactivePostContentHandler} provides a way to extend the content to be displayed in\n * the theme.

\n * Plugins can implement this interface to extend the content to be displayed in the theme,\n * including but not limited to adding specific styles, JS libraries, inserting specific content,\n * and intercepting content.\n *\n * @author guqing\n * @since 2.7.0\n */\npublic interface ReactivePostContentHandler extends ExtensionPoint {\n\n /**\n *

Methods for handling {@link run.halo.app.core.extension.content.Post} content.

\n *

For example, you can use this method to change the content for a better display in\n * theme-side.

\n *\n * @param postContent content to be handled\n * @return handled content\n */\n Mono handle(@NonNull PostContentContext postContent);\n\n @Data\n @Builder\n class PostContentContext {\n private Post post;\n private String content;\n private String raw;\n private String rawType;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/ReactiveSinglePageContentHandler.java", "content": "package run.halo.app.theme;\n\nimport lombok.Builder;\nimport lombok.Data;\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\n\n/**\n *

{@link ReactiveSinglePageContentHandler} provides a way to extend the content to be\n * displayed in the theme.

\n *\n * @author guqing\n * @see ReactivePostContentHandler\n * @since 2.7.0\n */\npublic interface ReactiveSinglePageContentHandler extends ExtensionPoint {\n\n /**\n *

Methods for handling {@link run.halo.app.core.extension.content.SinglePage} content.

\n *

For example, you can use this method to change the content for a better display in\n * theme-side.

\n *\n * @param singlePageContent content to be handled\n * @return handled content\n */\n Mono handle(@NonNull SinglePageContentContext singlePageContent);\n\n @Data\n @Builder\n class SinglePageContentContext {\n private SinglePage singlePage;\n private String content;\n private String raw;\n private String rawType;\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/TemplateNameResolver.java", "content": "package run.halo.app.theme;\n\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n *

The {@link TemplateNameResolver} is used to resolve template name.

\n * Halo has a theme mechanism, template files are provided by different themes, so\n * we need a method to determine whether the template file exists in the activated theme and if\n * it does not exist, provide a default template name.\n *\n * @author guqing\n * @since 2.11.0\n */\npublic interface TemplateNameResolver {\n\n /**\n * Resolve template name if exists or default template name in classpath.\n *\n * @param exchange exchange to resolve theme to use\n * @param name template\n * @return template name if exists or default template name in classpath\n */\n Mono resolveTemplateNameOrDefault(ServerWebExchange exchange, String name);\n\n /**\n * Resolve template name if exists or default template given.\n *\n * @param exchange exchange to resolve theme to use\n * @param name template name\n * @param defaultName default template name to use if given template name not exists\n * @return template name if exists or default template name given\n */\n Mono resolveTemplateNameOrDefault(ServerWebExchange exchange, String name,\n String defaultName);\n\n /**\n * Determine whether the template file exists in the current theme.\n *\n * @param exchange exchange to resolve theme to use\n * @param name template name\n * @return true if the template file exists in the current theme, false otherwise\n */\n Mono isTemplateAvailableInTheme(ServerWebExchange exchange, String name);\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/dialect/CommentWidget.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.pf4j.ExtensionPoint;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.element.IElementTagStructureHandler;\n\n/**\n * Comment widget extension point to extend the <halo:comment /> tag of the theme-side.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface CommentWidget extends ExtensionPoint {\n\n String ENABLE_COMMENT_ATTRIBUTE = CommentWidget.class.getName() + \".ENABLE\";\n\n void render(ITemplateContext context, IProcessableElementTag tag,\n IElementTagStructureHandler structureHandler);\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/dialect/ElementTagPostProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.pf4j.ExtensionPoint;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport reactor.core.publisher.Mono;\n\n/**\n * An extension point for post-processing element tag.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface ElementTagPostProcessor extends ExtensionPoint {\n\n /**\n *

\n * Execute the processor.\n *

\n *

\n * The {@link IProcessableElementTag} object argument is immutable, so all modifications to\n * this object or any\n * instructions to be given to the engine should be done through the specified\n * {@link org.thymeleaf.model.IModelFactory} model factory in context.\n *

\n *

\n * Don't forget to return the new tag after processing or\n * {@link reactor.core.publisher.Mono#empty()} if not processable.\n *

\n *\n * @param context the template context.\n * @param tag the event this processor is executing on.\n * @return a {@link reactor.core.publisher.Mono} that will complete when processing finishes\n * or empty mono if not support.\n */\n Mono process(\n ITemplateContext context,\n final IProcessableElementTag tag\n );\n\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/dialect/TemplateFooterProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.pf4j.ExtensionPoint;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.element.IElementTagStructureHandler;\nimport reactor.core.publisher.Mono;\n\n/**\n * Theme template footer tag snippet injection processor.\n *\n * @author guqing\n * @since 2.17.0\n */\npublic interface TemplateFooterProcessor extends ExtensionPoint {\n\n Mono process(ITemplateContext context, IProcessableElementTag tag,\n IElementTagStructureHandler structureHandler, IModel model);\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/dialect/TemplateHeadProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.pf4j.ExtensionPoint;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\n\n/**\n * Theme template head tag snippet injection processor.\n *

Head processor is processed order by {@link org.springframework.core.annotation.Order}\n * annotation, Higher order will be processed first and so that low-priority processor can be\n * overwritten head tag written by high-priority processor.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@FunctionalInterface\npublic interface TemplateHeadProcessor extends ExtensionPoint {\n\n Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler);\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/finders/Finder.java", "content": "package run.halo.app.theme.finders;\n\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\nimport org.springframework.core.annotation.AliasFor;\nimport org.springframework.stereotype.Service;\n\n/**\n * Template model data finder for theme.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Service\n@Retention(RetentionPolicy.RUNTIME)\n@Target(ElementType.TYPE)\npublic @interface Finder {\n\n /**\n * The name of the theme model variable.\n *\n * @return variable name, class simple name if not specified\n */\n @AliasFor(annotation = Service.class)\n String value() default \"\";\n}" }, { "path": "api/src/main/java/run/halo/app/theme/finders/vo/ExtensionVoOperator.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * An operator for extension value object.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface ExtensionVoOperator {\n\n @NonNull\n MetadataOperator getMetadata();\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/router/ModelConst.java", "content": "package run.halo.app.theme.router;\n\n/**\n * Static variable keys for view model.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic enum ModelConst {\n ;\n public static final String TEMPLATE_ID = \"_templateId\";\n public static final String POWERED_BY_HALO_TEMPLATE_ENGINE = \"poweredByHaloTemplateEngine\";\n\n /**\n * This key is used to prevent caching from cache plugins.\n */\n public static final String NO_CACHE = \"HALO_TEMPLATE_ENGINE.NO_CACHE\";\n\n public static final Integer DEFAULT_PAGE_SIZE = 10;\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/router/PageUrlUtils.java", "content": "package run.halo.app.theme.router;\n\nimport java.util.Objects;\nimport org.apache.commons.lang3.ArrayUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.apache.commons.lang3.math.NumberUtils;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.infra.utils.PathUtils;\n\n/**\n * A utility class for template page url.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PageUrlUtils {\n public static final String PAGE_PART = \"page\";\n\n public static int pageNum(ServerRequest request) {\n if (isPageUrl(request.path())) {\n String pageNum = StringUtils.substringAfterLast(request.path(), \"/page/\");\n return NumberUtils.toInt(pageNum, 1);\n }\n return 1;\n }\n\n public static boolean isPageUrl(String path) {\n String[] split = StringUtils.split(path, \"/\");\n if (split.length > 1) {\n return PAGE_PART.equals(split[split.length - 2])\n && NumberUtils.isDigits(split[split.length - 1]);\n }\n return false;\n }\n\n public static long totalPage(ListResult list) {\n return (list.getTotal() - 1) / list.getSize() + 1;\n }\n\n /**\n * Gets next page url with path.\n *\n * @param path request path\n * @return request path with next page part\n */\n public static String nextPageUrl(String path, long total) {\n String[] segments = StringUtils.split(path, \"/\");\n long defaultPage = Math.min(2, Math.max(total, 1));\n if (segments.length > 1) {\n String pagePart = segments[segments.length - 2];\n if (PAGE_PART.equals(pagePart)) {\n int pageNumIndex = segments.length - 1;\n String pageNum = segments[pageNumIndex];\n segments[pageNumIndex] = toNextPage(pageNum, total);\n return PathUtils.combinePath(segments);\n }\n return appendPagePart(PathUtils.combinePath(segments), defaultPage);\n }\n return appendPagePart(PathUtils.combinePath(segments), defaultPage);\n }\n\n /**\n * Gets previous page url with path.\n *\n * @param path request path\n * @return request path with previous page part\n */\n public static String prevPageUrl(String path) {\n String[] segments = StringUtils.split(path, \"/\");\n if (segments.length > 1) {\n String pagePart = segments[segments.length - 2];\n if (PAGE_PART.equals(pagePart)) {\n int pageNumIndex = segments.length - 1;\n String pageNum = segments[pageNumIndex];\n int prevPage = toPrevPage(pageNum);\n segments[pageNumIndex] = String.valueOf(prevPage);\n if (prevPage == 1) {\n segments = ArrayUtils.subarray(segments, 0, pageNumIndex - 1);\n }\n if (segments.length == 0) {\n return \"/\";\n }\n return PathUtils.combinePath(segments);\n }\n }\n return Objects.toString(path, \"/\");\n }\n\n private static String appendPagePart(String path, long page) {\n return PathUtils.combinePath(path, PAGE_PART, String.valueOf(page));\n }\n\n private static String toNextPage(String pageStr, long total) {\n long page = Math.min(parseInt(pageStr) + 1, Math.max(total, 1));\n return String.valueOf(page);\n }\n\n private static int toPrevPage(String pageStr) {\n return Math.max(parseInt(pageStr) - 1, 1);\n }\n\n private static int parseInt(String pageStr) {\n if (!NumberUtils.isParsable(pageStr)) {\n throw new IllegalArgumentException(\"Page number must be a number\");\n }\n return NumberUtils.toInt(pageStr, 1);\n }\n}\n" }, { "path": "api/src/main/java/run/halo/app/theme/router/UrlContextListResult.java", "content": "package run.halo.app.theme.router;\n\nimport java.util.List;\nimport lombok.Getter;\nimport lombok.ToString;\nimport run.halo.app.extension.ListResult;\n\n/**\n * Page wrapper with next and previous url.\n *\n * @param the type of the list item.\n * @author guqing\n * @since 2.0.0\n */\n@Getter\n@ToString(callSuper = true)\npublic class UrlContextListResult extends ListResult {\n private final String nextUrl;\n private final String prevUrl;\n\n public UrlContextListResult(int page, int size, long total, List items, String nextUrl,\n String prevUrl) {\n super(page, size, total, items);\n this.nextUrl = nextUrl;\n this.prevUrl = prevUrl;\n }\n\n public static class Builder {\n private int page;\n private int size;\n private long total;\n private List items;\n private String nextUrl;\n private String prevUrl;\n\n public Builder page(int page) {\n this.page = page;\n return this;\n }\n\n public Builder size(int size) {\n this.size = size;\n return this;\n }\n\n public Builder total(long total) {\n this.total = total;\n return this;\n }\n\n public Builder items(List items) {\n this.items = items;\n return this;\n }\n\n public Builder nextUrl(String nextUrl) {\n this.nextUrl = nextUrl;\n return this;\n }\n\n public Builder prevUrl(String prevUrl) {\n this.prevUrl = prevUrl;\n return this;\n }\n\n /**\n * Assign value with list result.\n *\n * @param listResult list result\n * @return builder\n */\n public Builder listResult(ListResult listResult) {\n this.page = listResult.getPage();\n this.size = listResult.getSize();\n this.total = listResult.getTotal();\n this.items = listResult.getItems();\n return this;\n }\n\n public UrlContextListResult build() {\n return new UrlContextListResult<>(page, size, total, items, nextUrl, prevUrl);\n }\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/core/extension/content/PostTest.java", "content": "package run.halo.app.core.extension.content;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.util.Map;\nimport java.util.function.Consumer;\nimport java.util.function.Function;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport run.halo.app.extension.Metadata;\n\nclass PostTest {\n\n @ParameterizedTest\n @MethodSource(\"isRecycledProvider\")\n void isRecycledTest(Metadata metadata, boolean expected) {\n assertEquals(expected, Post.isRecycled(metadata));\n }\n\n static Stream isRecycledProvider() {\n Function, Metadata> metadataCreator =\n metadataConsumer -> {\n var metadata = new Metadata();\n metadataConsumer.accept(metadata);\n return metadata;\n };\n return Stream.of(\n Arguments.of(metadataCreator.apply(metadata -> {\n }), false),\n Arguments.of(metadataCreator.apply(metadata ->\n metadata.setLabels(Map.of(Post.DELETED_LABEL, \"false\"))),\n false),\n Arguments.of(metadataCreator.apply(metadata ->\n metadata.setLabels(Map.of(Post.DELETED_LABEL, \"invalid\"))),\n false),\n Arguments.of(metadataCreator.apply(metadata -> {\n metadata.setLabels(Map.of(Post.DELETED_LABEL, \"true\"));\n }), true)\n );\n\n }\n\n}\n" }, { "path": "api/src/test/java/run/halo/app/core/extension/notification/SubscriptionTest.java", "content": "package run.halo.app.core.extension.notification;\n\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link Subscription}.\n *\n * @author guqing\n * @since 2.13.0\n */\nclass SubscriptionTest {\n\n @Test\n void reasonSubjectToStringTest() {\n Subscription.ReasonSubject subject = new Subscription.ReasonSubject();\n subject.setApiVersion(\"v1\");\n subject.setKind(\"Kind\");\n subject.setName(\"Name\");\n\n String expected = \"Kind#v1/Name\";\n String actual = subject.toString();\n\n assertThat(actual).isEqualTo(expected);\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/ExtensionUtilTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.HashSet;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\n\nclass ExtensionUtilTest {\n\n @Test\n void testIsNotDeleted() {\n var ext = mock(ExtensionOperator.class);\n\n when(ext.getMetadata()).thenReturn(null);\n assertFalse(ExtensionUtil.isDeleted(ext));\n\n var metadata = mock(Metadata.class);\n when(ext.getMetadata()).thenReturn(metadata);\n when(metadata.getDeletionTimestamp()).thenReturn(null);\n assertFalse(ExtensionUtil.isDeleted(ext));\n\n when(metadata.getDeletionTimestamp()).thenReturn(Instant.now());\n assertTrue(ExtensionUtil.isDeleted(ext));\n }\n\n @Test\n void addFinalizers() {\n var metadata = new Metadata();\n assertNull(metadata.getFinalizers());\n assertTrue(ExtensionUtil.addFinalizers(metadata, Set.of(\"fake\")));\n\n assertEquals(Set.of(\"fake\"), metadata.getFinalizers());\n\n assertFalse(ExtensionUtil.addFinalizers(metadata, Set.of(\"fake\")));\n assertEquals(Set.of(\"fake\"), metadata.getFinalizers());\n\n assertTrue(ExtensionUtil.addFinalizers(metadata, Set.of(\"another-fake\")));\n assertEquals(Set.of(\"fake\", \"another-fake\"), metadata.getFinalizers());\n }\n\n @Test\n void removeFinalizers() {\n var metadata = new Metadata();\n assertFalse(ExtensionUtil.removeFinalizers(metadata, Set.of(\"fake\")));\n assertNull(metadata.getFinalizers());\n\n metadata.setFinalizers(new HashSet<>(Set.of(\"fake\")));\n assertTrue(ExtensionUtil.removeFinalizers(metadata, Set.of(\"fake\")));\n assertEquals(Set.of(), metadata.getFinalizers());\n }\n\n @Test\n void hasDoNotOverwriteLabelTests() {\n var extension = mock(ExtensionOperator.class);\n when(extension.getMetadata()).thenReturn(null);\n assertFalse(ExtensionUtil.hasDoNotOverwriteLabel(extension));\n\n var metadata = mock(Metadata.class);\n when(extension.getMetadata()).thenReturn(metadata);\n when(metadata.getLabels()).thenReturn(null);\n assertFalse(ExtensionUtil.hasDoNotOverwriteLabel(extension));\n\n when(metadata.getLabels()).thenReturn(\n Map.of(ExtensionUtil.DO_NOT_OVERWRITE_LABEL, \"false\")\n );\n assertFalse(ExtensionUtil.hasDoNotOverwriteLabel(extension));\n\n when(metadata.getLabels()).thenReturn(\n Map.of(ExtensionUtil.DO_NOT_OVERWRITE_LABEL, \"true\")\n );\n assertTrue(ExtensionUtil.hasDoNotOverwriteLabel(extension));\n\n when(metadata.getLabels()).thenReturn(\n Map.of(ExtensionUtil.DO_NOT_OVERWRITE_LABEL, \"TrUe\")\n );\n assertTrue(ExtensionUtil.hasDoNotOverwriteLabel(extension));\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/FakeExtension.java", "content": "package run.halo.app.extension;\n\n@GVK(group = \"fake.halo.run\",\n version = \"v1alpha1\",\n kind = \"Fake\",\n plural = \"fakes\",\n singular = \"fake\")\npublic class FakeExtension extends AbstractExtension {\n\n public static FakeExtension createFake(String name) {\n var metadata = new Metadata();\n metadata.setName(name);\n var fake = new FakeExtension();\n fake.setMetadata(metadata);\n return fake;\n }\n\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/ListOptionsTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Test for {@link ListOptions}.\n *\n * @author guqing\n * @since 2.17.0\n */\nclass ListOptionsTest {\n\n @Nested\n class ListOptionsBuilderTest {\n\n @Test\n void shouldBuildWithFieldAndLabelSelectors() {\n var listOptions = ListOptions.builder()\n .labelSelector()\n .eq(\"key-1\", \"value-1\")\n .notEq(\"key-2\", \"value-1\")\n .exists(\"key-3\")\n .end()\n .andQuery(equal(\"spec.slug\", \"fake-slug\"))\n .orQuery(equal(\"spec.slug\", \"test\"))\n .build();\n assertEquals(\"\"\"\n ((spec.slug = fake-slug OR spec.slug = test) \\\n AND ((metadata.labels['key-1'] = 'value-1' \\\n AND metadata.labels['key-2'] <> 'value-1') \\\n AND EXISTS metadata.labels['key-3']))\\\n \"\"\", listOptions.toCondition().toString());\n }\n\n @Test\n void shouldBuildLabelSelectorOnly() {\n var listOptions = ListOptions.builder()\n .labelSelector()\n .notEq(\"key-2\", \"value-1\")\n .end()\n .build();\n assertEquals(\"\"\"\n metadata.labels['key-2'] <> 'value-1'\\\n \"\"\", listOptions.toCondition().toString());\n }\n\n @Test\n void shouldBuildFieldSelectorOnly() {\n var listOptions = ListOptions.builder()\n .andQuery(equal(\"spec.slug\", \"fake-slug\"))\n .orQuery(equal(\"spec.slug\", \"test\"))\n .build();\n assertEquals(\"\"\"\n (spec.slug = fake-slug OR spec.slug = test)\\\n \"\"\", listOptions.toCondition().toString());\n }\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/PageRequestImplTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.ValueSource;\nimport org.springframework.data.domain.Sort;\n\nclass PageRequestImplTest {\n\n @ParameterizedTest\n @ValueSource(\n ints = {0, -1, -10, -100, -1000, -10000}\n )\n void shouldBeCompatibleZeroAndNegativePageNumber(int pageNumber) {\n var page = new PageRequestImpl(pageNumber, 10, Sort.unsorted());\n assertEquals(1, page.getPageNumber());\n assertEquals(10, page.getPageSize());\n }\n\n @ParameterizedTest\n @ValueSource(\n ints = {0, -1, -10, -100, -1000, -10000}\n )\n void shouldBeCompatibleNegativePageSize(int size) {\n var page = new PageRequestImpl(10, size, Sort.unsorted());\n assertEquals(10, page.getPageNumber());\n assertEquals(PageRequestImpl.MAX_SIZE, page.getPageSize());\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/SecretTest.java", "content": "package run.halo.app.extension;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.dataformat.yaml.YAMLMapper;\nimport java.util.Map;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link Secret}.\n *\n * @author guqing\n * @since 2.4.0\n */\nclass SecretTest {\n\n @Test\n void serialize() throws JSONException {\n Secret secret = new Secret();\n secret.setMetadata(new Metadata());\n secret.getMetadata().setName(\"test-secret\");\n secret.setType(Secret.SECRET_TYPE_OPAQUE);\n secret.setData(Map.of(\"password\", \"admin\".getBytes()));\n String s = JsonUtils.objectToJson(secret);\n JSONAssert.assertEquals(testJsonString(), s, true);\n }\n\n @Test\n void deserialize() {\n String s = testJsonString();\n Secret secret = JsonUtils.jsonToObject(s, Secret.class);\n assertThat(secret).isNotNull();\n assertThat(secret.getMetadata().getName()).isEqualTo(\"test-secret\");\n assertThat(secret.getType()).isEqualTo(Secret.SECRET_TYPE_OPAQUE);\n assertThat(secret.getData()).containsEntry(\"password\", \"admin\".getBytes());\n }\n\n @Test\n void deserializeWithUnstructured() throws JsonProcessingException {\n Secret secret = Unstructured.OBJECT_MAPPER.readValue(testJsonString(), Secret.class);\n assertThat(secret.getMetadata().getName()).isEqualTo(\"test-secret\");\n assertThat(secret.getType()).isEqualTo(Secret.SECRET_TYPE_OPAQUE);\n assertThat(secret.getData()).containsEntry(\"password\", \"admin\".getBytes());\n }\n\n @Test\n void deserializeYamlWithStringData() throws JsonProcessingException {\n String s = \"\"\"\n apiVersion: v1alpha1\n kind: Secret\n metadata:\n name: secret-basic-auth\n type: halo.run/basic-auth\n stringData:\n username: admin\n password: t0p-Secret\n \"\"\";\n Secret secret = new YAMLMapper().readValue(s, Secret.class);\n assertThat(secret.getMetadata().getName()).isEqualTo(\"secret-basic-auth\");\n assertThat(secret.getType()).isEqualTo(\"halo.run/basic-auth\");\n assertThat(secret.getStringData()).containsEntry(\"username\", \"admin\");\n assertThat(secret.getStringData()).containsEntry(\"password\", \"t0p-Secret\");\n }\n\n private String testJsonString() {\n return \"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Secret\",\n \"metadata\": {\n \"name\": \"test-secret\"\n },\n \"type\": \"Opaque\",\n \"data\": {\n \"password\": \"YWRtaW4=\"\n }\n }\n \"\"\";\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/controller/ControllerBuilderTest.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.FakeExtension;\n\n@ExtendWith(MockitoExtension.class)\nclass ControllerBuilderTest {\n\n @Mock\n ExtensionClient client;\n\n @Test\n void buildWithNullReconciler() {\n assertThrows(IllegalArgumentException.class,\n () -> new ControllerBuilder(null, client).build(), \"Reconciler must not be null\");\n }\n\n @Test\n void buildWithNullClient() {\n assertThrows(IllegalArgumentException.class,\n () -> new ControllerBuilder(new FakeReconciler(), null).build());\n }\n\n @Test\n void buildTest() {\n assertThrows(IllegalArgumentException.class,\n () -> new ControllerBuilder(new FakeReconciler(), client)\n .build(),\n \"Extension must not be null\");\n\n assertNotNull(fakeBuilder().build());\n\n assertNotNull(fakeBuilder()\n .syncAllOnStart(true)\n .nowSupplier(Instant::now)\n .minDelay(Duration.ofMillis(5))\n .maxDelay(Duration.ofSeconds(1000))\n .build());\n\n assertNotNull(fakeBuilder()\n .syncAllOnStart(true)\n .minDelay(Duration.ofMillis(5))\n .maxDelay(Duration.ofSeconds(1000))\n .onAddMatcher(null)\n .onUpdateMatcher(null)\n .onDeleteMatcher(null)\n .build()\n );\n }\n\n @Test\n void invalidMinDelayAndMaxDelay() {\n assertThrows(IllegalArgumentException.class,\n () -> fakeBuilder()\n .minDelay(Duration.ofSeconds(2))\n .maxDelay(Duration.ofSeconds(1))\n .build(),\n \"Min delay must be less than or equal to max delay\");\n\n assertNotNull(fakeBuilder()\n .minDelay(null)\n .maxDelay(Duration.ofSeconds(1))\n .build());\n\n assertNotNull(fakeBuilder()\n .minDelay(Duration.ofSeconds(1))\n .maxDelay(null)\n .build());\n\n assertNotNull(fakeBuilder()\n .minDelay(Duration.ofSeconds(-1))\n .build());\n\n assertNotNull(fakeBuilder()\n .maxDelay(Duration.ofSeconds(-1))\n .build());\n }\n\n ControllerBuilder fakeBuilder() {\n return new ControllerBuilder(new FakeReconciler(), client)\n .extension(new FakeExtension());\n }\n\n static class FakeReconciler implements Reconciler {\n\n @Override\n public Result reconcile(Request request) {\n return new Reconciler.Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return null;\n }\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/controller/DefaultControllerTest.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyLong;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doAnswer;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.TimeUnit;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.controller.Reconciler.Result;\nimport run.halo.app.extension.controller.RequestQueue.DelayedEntry;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultControllerTest {\n\n @Mock\n RequestQueue queue;\n\n @Mock\n Reconciler reconciler;\n\n @Mock\n RequestSynchronizer synchronizer;\n\n @Mock\n ExecutorService executor;\n\n Instant now = Instant.now();\n\n Duration minRetryAfter = Duration.ofMillis(100);\n\n Duration maxRetryAfter = Duration.ofSeconds(10);\n\n DefaultController controller;\n\n @BeforeEach\n void setUp() {\n controller = createController(1);\n\n assertFalse(controller.isDisposed());\n assertFalse(controller.isStarted());\n }\n\n DefaultController createController(int workerCount) {\n return new DefaultController<>(\"fake-controller\", reconciler, queue, synchronizer,\n () -> now, minRetryAfter, maxRetryAfter, executor, workerCount);\n }\n\n @Test\n void shouldReturnRightName() {\n assertEquals(\"fake-controller\", controller.getName());\n }\n\n @Nested\n class WorkerTest {\n\n @Test\n void shouldCreateCorrectName() {\n var worker = controller.new Worker();\n assertEquals(\"fake-controller-worker-1\", worker.getName());\n worker = controller.new Worker();\n assertEquals(\"fake-controller-worker-2\", worker.getName());\n worker = controller.new Worker();\n assertEquals(\"fake-controller-worker-3\", worker.getName());\n }\n\n @Test\n void shouldRunCorrectlyIfReconcilerReturnsNoReEnqueue() throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), Duration.ofSeconds(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n when(reconciler.reconcile(any(Request.class))).thenReturn(new Result(false, null));\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue, times(0)).add(any());\n verify(queue, times(1)).done(any());\n verify(reconciler, times(1)).reconcile(eq(new Request(\"fake-request\")));\n }\n\n @Test\n void shouldRunCorrectlyIfReconcilerReturnsReEnqueue() throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), Duration.ofSeconds(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n when(queue.add(any())).thenReturn(true);\n when(reconciler.reconcile(any(Request.class))).thenReturn(new Result(true, null));\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue, times(1)).done(any());\n verify(queue, times(1)).add(argThat(de ->\n de.getEntry().name().equals(\"fake-request\")\n && de.getRetryAfter().equals(Duration.ofSeconds(2))));\n verify(reconciler, times(1)).reconcile(any(Request.class));\n }\n\n @Test\n void shouldReRunIfReconcilerThrowException() throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), Duration.ofSeconds(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n when(queue.add(any())).thenReturn(true);\n when(reconciler.reconcile(any(Request.class))).thenThrow(RuntimeException.class);\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue, times(1)).done(any());\n verify(queue, times(1)).add(argThat(de ->\n de.getEntry().name().equals(\"fake-request\")\n && de.getRetryAfter().equals(Duration.ofSeconds(2))));\n verify(reconciler, times(1)).reconcile(any(Request.class));\n }\n\n @Test\n void canReRunIfReconcilerThrowRequeueException() throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), Duration.ofSeconds(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n when(queue.add(any())).thenReturn(true);\n var expectException = new RequeueException(Result.requeue(Duration.ofSeconds(2)));\n when(reconciler.reconcile(any(Request.class))).thenThrow(expectException);\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue).done(any());\n verify(queue).add(argThat(de ->\n de.getEntry().name().equals(\"fake-request\")\n && de.getRetryAfter().equals(Duration.ofSeconds(2))));\n verify(reconciler).reconcile(any(Request.class));\n }\n\n @Test\n void doNotReRunIfReconcilerThrowsRequeueExceptionWithoutRequeue()\n throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), Duration.ofSeconds(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n var expectException = new RequeueException(Result.doNotRetry());\n when(reconciler.reconcile(any(Request.class))).thenThrow(expectException);\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue).done(any());\n\n verify(queue, never()).add(any());\n verify(reconciler).reconcile(any(Request.class));\n }\n\n @Test\n void shouldSetMinRetryAfterWhenTakeZeroDelayedEntry() throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), minRetryAfter.minusMillis(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n when(queue.add(any())).thenReturn(true);\n when(reconciler.reconcile(any(Request.class))).thenReturn(new Result(true, null));\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue, times(1)).done(any());\n verify(queue, times(1)).add(argThat(de ->\n de.getEntry().name().equals(\"fake-request\")\n && de.getRetryAfter().equals(minRetryAfter)));\n verify(reconciler, times(1)).reconcile(any(Request.class));\n }\n\n @Test\n void shouldSetMaxRetryAfterWhenTakeGreaterThanMaxRetryAfterDelayedEntry()\n throws InterruptedException {\n when(queue.take()).thenReturn(new DelayedEntry<>(\n new Request(\"fake-request\"), maxRetryAfter.plusMillis(1), () -> now\n ))\n .thenThrow(InterruptedException.class);\n when(queue.add(any())).thenReturn(true);\n when(reconciler.reconcile(any(Request.class))).thenReturn(new Result(true, null));\n\n controller.new Worker().run();\n\n verify(synchronizer, never()).start();\n verify(queue, times(2)).take();\n verify(queue, times(1)).done(any());\n verify(queue, times(1)).add(argThat(de ->\n de.getEntry().name().equals(\"fake-request\")\n && de.getRetryAfter().equals(maxRetryAfter)));\n verify(reconciler, times(1)).reconcile(any(Request.class));\n }\n\n }\n\n @Test\n void shouldDisposeCorrectlyIfShutdownInTime() throws InterruptedException {\n when(executor.awaitTermination(anyLong(), any())).thenReturn(true);\n\n controller.dispose();\n\n assertTrue(controller.isDisposed());\n assertFalse(controller.isStarted());\n\n verify(synchronizer, times(1)).dispose();\n verify(queue, times(1)).dispose();\n verify(executor).shutdownNow();\n verify(executor, never()).shutdown();\n verify(executor, times(1)).awaitTermination(anyLong(), any());\n }\n\n @Test\n void shouldDisposeCorrectlyIfNotShutdownInTime() throws InterruptedException {\n when(executor.awaitTermination(anyLong(), any()))\n .thenReturn(false)\n .thenReturn(true);\n\n controller.dispose();\n\n assertTrue(controller.isDisposed());\n assertFalse(controller.isStarted());\n\n verify(synchronizer).dispose();\n verify(queue).dispose();\n verify(executor).shutdown();\n verify(executor).shutdownNow();\n verify(executor, times(2)).awaitTermination(anyLong(), any());\n }\n\n @Test\n void shouldDisposeCorrectlyEvenIfTimeoutAwaitTermination() throws InterruptedException {\n when(executor.awaitTermination(anyLong(), any()))\n .thenThrow(InterruptedException.class)\n .thenReturn(true);\n\n controller.dispose();\n\n assertTrue(controller.isDisposed());\n assertFalse(controller.isStarted());\n\n verify(synchronizer, times(1)).dispose();\n verify(queue, times(1)).dispose();\n verify(executor).shutdown();\n verify(executor, times(1)).shutdownNow();\n verify(executor, times(2)).awaitTermination(anyLong(), any());\n }\n\n @Test\n void shouldStartCorrectly() throws InterruptedException {\n doAnswer(invocation -> {\n // simulate starting synchronizer\n invocation.getArgument(0, Runnable.class).run();\n return null;\n }).doAnswer(invocation -> {\n // simulate starting worker\n return null;\n }).when(executor).execute(any(Runnable.class));\n\n controller.start();\n assertTrue(controller.isStarted());\n assertFalse(controller.isDisposed());\n\n verify(synchronizer).start();\n verify(executor, times(2)).execute(any(Runnable.class));\n }\n\n @Test\n void shouldNotStartWhenDisposed() throws InterruptedException {\n when(executor.awaitTermination(1, TimeUnit.MINUTES)).thenReturn(true);\n controller.dispose();\n controller.start();\n assertFalse(controller.isStarted());\n assertTrue(controller.isDisposed());\n\n verify(executor, times(0)).execute(any(Runnable.class));\n }\n\n @Test\n void shouldCreateMultiWorkers() {\n controller = createController(5);\n controller.start();\n verify(executor, times(5)).execute(any(DefaultController.Worker.class));\n }\n\n @Test\n void shouldFailToCreateControllerDueToInvalidWorkerCount() {\n assertThrows(IllegalArgumentException.class, () -> createController(0));\n assertThrows(IllegalArgumentException.class, () -> createController(-1));\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/controller/DefaultDelayQueueTest.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.concurrent.TimeUnit;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.controller.RequestQueue.DelayedEntry;\n\nclass DefaultDelayQueueTest {\n\n Instant now = Instant.now();\n\n DefaultQueue queue;\n\n final Duration minDelay = Duration.ofMillis(1);\n\n @BeforeEach\n void setUp() {\n queue = new DefaultQueue<>(() -> now, minDelay);\n }\n\n @Test\n void addImmediatelyTest() {\n var request = newRequest(\"fake-name\");\n var added = queue.addImmediately(request);\n assertTrue(added);\n assertEquals(1, queue.size());\n var delayedEntry = queue.peek();\n assertNotNull(delayedEntry);\n assertEquals(newRequest(\"fake-name\"), delayedEntry.getEntry());\n assertEquals(minDelay, delayedEntry.getRetryAfter());\n assertEquals(minDelay.toMillis(), delayedEntry.getDelay(TimeUnit.MILLISECONDS));\n }\n\n @Test\n void addWithDelaySmallerThanMinDelay() {\n var request = newRequest(\"fake-name\");\n var added = queue.add(new DelayedEntry<>(request, Duration.ofNanos(1), () -> now));\n assertTrue(added);\n assertEquals(1, queue.size());\n var delayedEntry = queue.peek();\n assertNotNull(delayedEntry);\n assertEquals(newRequest(\"fake-name\"), delayedEntry.getEntry());\n assertEquals(minDelay, delayedEntry.getRetryAfter());\n assertEquals(minDelay.toMillis(), delayedEntry.getDelay(TimeUnit.MILLISECONDS));\n }\n\n @Test\n void addWithDelayGreaterThanMinDelay() {\n var request = newRequest(\"fake-name\");\n var added = queue.add(new DelayedEntry<>(request, minDelay.plusMillis(1), () -> now));\n assertTrue(added);\n assertEquals(1, queue.size());\n var delayedEntry = queue.peek();\n assertNotNull(delayedEntry);\n assertEquals(newRequest(\"fake-name\"), delayedEntry.getEntry());\n assertEquals(minDelay.plusMillis(1), delayedEntry.getRetryAfter());\n assertEquals(minDelay.plusMillis(1).toMillis(),\n delayedEntry.getDelay(TimeUnit.MILLISECONDS));\n }\n\n @Test\n void shouldNotAddAfterDisposing() {\n assertFalse(queue.isDisposed());\n queue.dispose();\n assertTrue(queue.isDisposed());\n var request = newRequest(\"fake-name\");\n var added = queue.add(new DelayedEntry<>(request, minDelay, () -> now));\n assertFalse(added);\n assertEquals(0, queue.size());\n }\n\n @Test\n void shouldNotAddRepeatedlyIfNotDone() throws InterruptedException {\n queue = new DefaultQueue<>(() -> now, Duration.ZERO);\n var fakeEntry = new DelayedEntry<>(newRequest(\"fake-name\"), Duration.ZERO,\n () -> this.now);\n\n queue.add(fakeEntry);\n assertEquals(1, queue.size());\n assertEquals(fakeEntry, queue.peek());\n queue.take();\n assertEquals(0, queue.size());\n\n queue.add(fakeEntry);\n assertEquals(0, queue.size());\n\n queue.done(newRequest(\"fake-name\"));\n queue.add(fakeEntry);\n assertEquals(1, queue.size());\n assertEquals(fakeEntry, queue.peek());\n }\n\n @Test\n void shouldNotAddIfHavingEarlierEntryInQueue() {\n queue = new DefaultQueue<>(() -> now, Duration.ZERO);\n var fakeEntry = new DelayedEntry<>(newRequest(\"fake-name\"), Duration.ZERO,\n () -> this.now);\n\n assertTrue(queue.add(fakeEntry));\n assertEquals(1, queue.size());\n assertEquals(fakeEntry, queue.peek());\n\n assertFalse(queue.add(fakeEntry));\n var laterEntry = new DelayedEntry<>(newRequest(\"fake-name\"), Duration.ofMillis(100),\n () -> this.now);\n assertFalse(queue.add(laterEntry));\n }\n\n @Test\n void shouldAddIfHavingLaterEntryInQueue() {\n queue = new DefaultQueue<>(() -> now, Duration.ZERO);\n var fakeEntry = new DelayedEntry<>(newRequest(\"fake-name\"), Duration.ofMillis(100),\n () -> this.now);\n\n assertTrue(queue.add(fakeEntry));\n assertEquals(1, queue.size());\n assertEquals(fakeEntry, queue.peek());\n\n assertFalse(queue.add(fakeEntry));\n var laterEntry = new DelayedEntry<>(newRequest(\"fake-name\"), Duration.ofMillis(99),\n () -> this.now);\n assertTrue(queue.add(laterEntry));\n }\n\n Request newRequest(String name) {\n return new Request(name);\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/controller/DelayedEntryTest.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.concurrent.TimeUnit;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.controller.RequestQueue.DelayedEntry;\n\nclass DelayedEntryTest {\n\n Instant now = Instant.now();\n\n @Test\n void createDelayedEntry() {\n var delayedEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(100), () -> now);\n assertEquals(100, delayedEntry.getDelay(TimeUnit.MILLISECONDS));\n assertEquals(Duration.ofMillis(100), delayedEntry.getRetryAfter());\n assertEquals(now.plusMillis(100), delayedEntry.getReadyAt());\n assertEquals(\"fake\", delayedEntry.getEntry());\n\n delayedEntry = new DelayedEntry<>(\"fake\", now.plus(Duration.ofSeconds(1)), () -> now);\n assertEquals(1000, delayedEntry.getDelay(TimeUnit.MILLISECONDS));\n assertEquals(Duration.ofMillis(1000), delayedEntry.getRetryAfter());\n }\n\n @Test\n void compareWithGreaterDelay() {\n var firstDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(100), () -> now);\n var secondDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(200), () -> now);\n\n assertTrue(firstDelayEntry.compareTo(secondDelayEntry) < 0);\n }\n\n @Test\n void compareWithSameDelay() {\n var firstDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(100), () -> now);\n var secondDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(100), () -> now);\n\n assertEquals(0, firstDelayEntry.compareTo(secondDelayEntry));\n }\n\n @Test\n void compareWithLessDelay() {\n var firstDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(200), () -> now);\n var secondDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(100), () -> now);\n\n assertTrue(firstDelayEntry.compareTo(secondDelayEntry) > 0);\n }\n\n @Test\n void shouldBeEqualWithNameOnly() {\n var firstDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(200), () -> now);\n var secondDelayEntry = new DelayedEntry<>(\"fake\", Duration.ofMillis(100), Instant::now);\n\n assertEquals(firstDelayEntry, secondDelayEntry);\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/controller/ExtensionWatcherTest.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.extension.FakeExtension.createFake;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.DefaultExtensionMatcher;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.WatcherExtensionMatchers;\nimport run.halo.app.extension.controller.Reconciler.Request;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionWatcherTest {\n\n @Mock\n RequestQueue queue;\n\n @Mock\n ExtensionClient client;\n\n @Mock\n WatcherExtensionMatchers matchers;\n\n @InjectMocks\n ExtensionWatcher watcher;\n\n private DefaultExtensionMatcher getEmptyMatcher() {\n return DefaultExtensionMatcher.builder(client,\n GroupVersionKind.fromExtension(FakeExtension.class))\n .build();\n }\n\n @Test\n void shouldAddExtensionWhenAddPredicateAlwaysTrue() {\n when(matchers.onAddMatcher()).thenReturn(getEmptyMatcher());\n watcher.onAdd(createFake(\"fake-name\"));\n\n verify(matchers, times(1)).onAddMatcher();\n verify(queue, times(1)).addImmediately(\n argThat(request -> request.name().equals(\"fake-name\")));\n verify(queue, times(0)).add(any());\n }\n\n @Test\n void shouldNotAddExtensionWhenAddPredicateAlwaysFalse() {\n var type = GroupVersionKind.fromAPIVersionAndKind(\"v1alpha1\", \"User\");\n when(matchers.onAddMatcher()).thenReturn(\n DefaultExtensionMatcher.builder(client, type).build());\n watcher.onAdd(createFake(\"fake-name\"));\n\n verify(matchers, times(1)).onAddMatcher();\n verify(queue, times(0)).add(any());\n verify(queue, times(0)).addImmediately(any());\n }\n\n @Test\n void shouldNotAddExtensionWhenWatcherIsDisposed() {\n watcher.dispose();\n watcher.onAdd(createFake(\"fake-name\"));\n\n verify(matchers, times(0)).onAddMatcher();\n verify(queue, times(0)).addImmediately(any());\n verify(queue, times(0)).add(any());\n }\n\n @Test\n void shouldUpdateExtensionWhenUpdatePredicateAlwaysTrue() {\n when(matchers.onUpdateMatcher()).thenReturn(getEmptyMatcher());\n watcher.onUpdate(createFake(\"old-fake-name\"), createFake(\"new-fake-name\"));\n\n verify(matchers, times(1)).onUpdateMatcher();\n verify(queue, times(1)).addImmediately(\n argThat(request -> request.name().equals(\"new-fake-name\")));\n verify(queue, times(0)).add(any());\n }\n\n @Test\n void shouldUpdateExtensionWhenUpdatePredicateAlwaysFalse() {\n var type = GroupVersionKind.fromAPIVersionAndKind(\"v1alpha1\", \"User\");\n when(matchers.onUpdateMatcher()).thenReturn(\n DefaultExtensionMatcher.builder(client, type).build());\n watcher.onUpdate(createFake(\"old-fake-name\"), createFake(\"new-fake-name\"));\n\n verify(matchers, times(1)).onUpdateMatcher();\n verify(queue, times(0)).add(any());\n verify(queue, times(0)).addImmediately(any());\n }\n\n @Test\n void shouldNotUpdateExtensionWhenWatcherIsDisposed() {\n watcher.dispose();\n watcher.onUpdate(createFake(\"old-fake-name\"), createFake(\"new-fake-name\"));\n\n verify(matchers, times(0)).onUpdateMatcher();\n verify(queue, times(0)).add(any());\n verify(queue, times(0)).addImmediately(any());\n }\n\n @Test\n void shouldDeleteExtensionWhenDeletePredicateAlwaysTrue() {\n when(matchers.onDeleteMatcher()).thenReturn(getEmptyMatcher());\n watcher.onDelete(createFake(\"fake-name\"));\n\n verify(matchers, times(1)).onDeleteMatcher();\n verify(queue, times(1)).addImmediately(\n argThat(request -> request.name().equals(\"fake-name\")));\n verify(queue, times(0)).add(any());\n }\n\n @Test\n void shouldDeleteExtensionWhenDeletePredicateAlwaysFalse() {\n var type = GroupVersionKind.fromAPIVersionAndKind(\"v1alpha1\", \"User\");\n when(matchers.onDeleteMatcher()).thenReturn(\n DefaultExtensionMatcher.builder(client, type).build());\n watcher.onDelete(createFake(\"fake-name\"));\n\n verify(matchers, times(1)).onDeleteMatcher();\n verify(queue, times(0)).add(any());\n verify(queue, times(0)).addImmediately(any());\n }\n\n @Test\n void shouldNotDeleteExtensionWhenWatcherIsDisposed() {\n watcher.dispose();\n watcher.onDelete(createFake(\"fake-name\"));\n\n verify(matchers, times(0)).onDeleteMatcher();\n verify(queue, times(0)).add(any());\n verify(queue, times(0)).addImmediately(any());\n }\n\n @Test\n void shouldInvokeDisposeHookIfRegistered() {\n var mockHook = mock(Runnable.class);\n watcher.registerDisposeHook(mockHook);\n verify(mockHook, times(0)).run();\n\n watcher.dispose();\n verify(mockHook, times(1)).run();\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/controller/RequestSynchronizerTest.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Watcher;\n\n@ExtendWith(MockitoExtension.class)\nclass RequestSynchronizerTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n Watcher watcher;\n\n RequestSynchronizer synchronizer;\n\n @BeforeEach\n void setUp() {\n synchronizer =\n new RequestSynchronizer(true, client, new FakeExtension(), watcher, new ListOptions());\n assertFalse(synchronizer.isDisposed());\n assertFalse(synchronizer.isStarted());\n }\n\n @Test\n void shouldStartCorrectlyWhenSyncingAllOnStart() {\n when(client.listTopNames(\n eq(FakeExtension.class), isA(ListOptions.class), isA(Sort.class), any(Integer.class))\n ).thenReturn(List.of(\"fake-01\", \"fake-02\"));\n\n synchronizer.start();\n\n assertTrue(synchronizer.isStarted());\n assertFalse(synchronizer.isDisposed());\n verify(watcher, times(2)).onAdd(isA(Reconciler.Request.class));\n verify(client, times(1)).watch(same(watcher));\n }\n\n @Test\n void shouldStartCorrectlyWhenNotSyncingAllOnStart() {\n synchronizer =\n new RequestSynchronizer(false, client, new FakeExtension(), watcher, new ListOptions());\n assertFalse(synchronizer.isDisposed());\n assertFalse(synchronizer.isStarted());\n\n synchronizer.start();\n\n assertTrue(synchronizer.isStarted());\n assertFalse(synchronizer.isDisposed());\n\n verify(client, times(0)).list(any(), any(), any());\n verify(watcher, times(0)).onAdd(isA(Reconciler.Request.class));\n verify(client, times(1)).watch(any(Watcher.class));\n }\n\n @Test\n void shouldDisposeCorrectly() {\n synchronizer.start();\n assertFalse(synchronizer.isDisposed());\n assertTrue(synchronizer.isStarted());\n\n synchronizer.dispose();\n\n assertTrue(synchronizer.isDisposed());\n assertTrue(synchronizer.isStarted());\n verify(watcher, times(1)).dispose();\n }\n\n @Test\n void shouldNotStartAfterDisposing() {\n synchronizer.dispose();\n synchronizer.start();\n\n verify(client, times(0)).list(any(), any(), any());\n verify(watcher, times(0)).onAdd(isA(Reconciler.Request.class));\n verify(client, times(0)).watch(any());\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/index/IndexAttributeFactoryTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Metadata;\n\n/**\n * Tests for {@link IndexAttributeFactory}.\n *\n * @author guqing\n * @since 2.12.0\n */\nclass IndexAttributeFactoryTest {\n\n @Test\n void shouldCreateMultiValueAttribute() {\n var attribute = IndexAttributeFactory.multiValueAttribute(FakeExtension.class,\n FakeExtension::getTags);\n assertThat(attribute).isNotNull();\n assertThat(attribute.getObjectType()).isEqualTo(FakeExtension.class);\n var extension = new FakeExtension();\n extension.setMetadata(new Metadata());\n extension.getMetadata().setName(\"fake-name-1\");\n extension.setTags(Set.of(\"tag1\", \"tag2\"));\n Assertions.assertEquals(\n Set.of(new UnknownKey(\"tag1\"), new UnknownKey(\"tag2\")),\n attribute.getValues(extension)\n );\n }\n\n @Test\n void shouldCreateSingleValueAttribute() {\n var attribute = IndexAttributeFactory.simpleAttribute(FakeExtension.class,\n FakeExtension::getName);\n assertThat(attribute).isNotNull();\n assertThat(attribute.getObjectType()).isEqualTo(FakeExtension.class);\n var extension = new FakeExtension();\n extension.setMetadata(new Metadata());\n extension.getMetadata().setName(\"fake-name-2\");\n extension.setName(\"Fake Extension Name\");\n Assertions.assertEquals(\n Set.of(new UnknownKey(\"Fake Extension Name\")),\n attribute.getValues(extension)\n );\n }\n\n @Data\n @EqualsAndHashCode(callSuper = true)\n @GVK(group = \"test\", version = \"v1\", kind = \"FakeExtension\", plural = \"fakes\",\n singular = \"fake\")\n static class FakeExtension extends AbstractExtension {\n\n private Set tags;\n\n private String name;\n\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/index/IndexSpecTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * Tests for {@link IndexSpec}.\n *\n * @author guqing\n * @since 2.12.0\n */\nclass IndexSpecTest {\n\n @Test\n void equalsVerifier() {\n var spec1 = new IndexSpec()\n .setName(\"metadata.name\")\n .setOrder(IndexSpec.OrderType.ASC)\n .setIndexFunc(IndexAttributeFactory.simpleAttribute(FakeExtension.class,\n e -> e.getMetadata().getName())\n )\n .setUnique(true);\n\n var spec2 = new IndexSpec()\n .setName(\"metadata.name\")\n .setOrder(IndexSpec.OrderType.ASC)\n .setIndexFunc(IndexAttributeFactory.simpleAttribute(FakeExtension.class,\n e -> e.getMetadata().getName())\n )\n .setUnique(true);\n\n assertThat(spec1).isEqualTo(spec2);\n assertThat(spec1.equals(spec2)).isTrue();\n assertThat(spec1.hashCode()).isEqualTo(spec2.hashCode());\n\n var spec3 = new IndexSpec()\n .setName(\"metadata.name\")\n .setOrder(IndexSpec.OrderType.DESC)\n .setIndexFunc(IndexAttributeFactory.simpleAttribute(FakeExtension.class,\n e -> e.getMetadata().getName())\n )\n .setUnique(false);\n assertThat(spec1).isEqualTo(spec3);\n assertThat(spec1.equals(spec3)).isTrue();\n assertThat(spec1.hashCode()).isEqualTo(spec3.hashCode());\n\n var spec4 = new IndexSpec()\n .setName(\"slug\")\n .setOrder(IndexSpec.OrderType.ASC)\n .setIndexFunc(IndexAttributeFactory.simpleAttribute(FakeExtension.class,\n e -> e.getMetadata().getName())\n )\n .setUnique(true);\n assertThat(spec1.equals(spec4)).isFalse();\n assertThat(spec1).isNotEqualTo(spec4);\n }\n\n @Test\n void equalAnotherObject() {\n var spec3 = new IndexSpec()\n .setName(\"metadata.name\");\n assertThat(spec3.equals(new Object())).isFalse();\n }\n\n @Test\n void shouldNormalizeToSingleValueIndexSpec() {\n var spec = new IndexSpec()\n .setName(\"metadata.name\")\n .setOrder(IndexSpec.OrderType.ASC)\n .setIndexFunc(IndexAttributeFactory.simpleAttribute(FakeExtension.class,\n e -> e.getMetadata().getName())\n )\n .setUnique(true);\n\n var normalized = spec.normalize();\n\n assertEquals(\"metadata.name\", normalized.getName());\n assertTrue(normalized.isUnique());\n assertTrue(normalized.isNullable());\n assertInstanceOf(SingleValueIndexSpec.class, normalized);\n }\n\n @Test\n void shouldNormalizeToMultiValueIndexSpec() {\n var spec = new IndexSpec()\n .setName(\"slug\")\n .setOrder(IndexSpec.OrderType.ASC)\n .setIndexFunc(IndexAttributeFactory.multiValueAttribute(FakeExtension.class,\n e -> Set.of(e.getSlug())))\n .setUnique(false);\n\n var normalized = spec.normalize();\n\n assertEquals(\"slug\", normalized.getName());\n assertFalse(normalized.isUnique());\n assertTrue(normalized.isNullable());\n assertInstanceOf(MultiValueIndexSpec.class, normalized);\n }\n\n @Data\n @EqualsAndHashCode(callSuper = true)\n @GVK(group = \"test\", version = \"v1\", kind = \"Fake\", plural = \"fakes\", singular = \"fake\")\n static class FakeExtension extends AbstractExtension {\n private String slug;\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/index/KeyComparatorTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.Arrays;\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.TreeMap;\nimport java.util.TreeSet;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.RepeatedTest;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link KeyComparator}.\n *\n * @author guqing\n * @since 2.12.0\n */\nclass KeyComparatorTest {\n private final KeyComparator comparator = KeyComparator.INSTANCE;\n\n @Test\n void keyComparator() {\n String[] strings = {\"103\", \"101\", \"102\", \"1011\", \"1013\", \"1021\", \"1022\", \"1012\", \"1023\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(\n new String[] {\"101\", \"102\", \"103\", \"1011\", \"1012\", \"1013\", \"1021\", \"1022\", \"1023\"});\n\n Arrays.sort(strings, comparator.reversed());\n assertThat(strings).isEqualTo(\n new String[] {\"1023\", \"1022\", \"1021\", \"1013\", \"1012\", \"1011\", \"103\", \"102\", \"101\"});\n\n // but if we use natural order, the result is:\n Arrays.sort(strings, Comparator.naturalOrder());\n assertThat(strings).isEqualTo(\n new String[] {\"101\", \"1011\", \"1012\", \"1013\", \"102\", \"1021\", \"1022\", \"1023\", \"103\"});\n }\n\n @Test\n void keyComparator2() {\n String[] strings =\n {\"moment-101\", \"moment-102\", \"moment-103\", \"moment-1011\", \"moment-1013\", \"moment-1021\",\n \"moment-1022\", \"moment-1012\", \"moment-1023\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(new String[] {\"moment-101\", \"moment-102\", \"moment-103\",\n \"moment-1011\", \"moment-1012\", \"moment-1013\", \"moment-1021\", \"moment-1022\",\n \"moment-1023\"});\n\n // date sort\n strings =\n new String[] {\"2022-01-15\", \"2022-02-01\", \"2021-12-25\", \"2022-01-01\", \"2022-01-02\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(\n new String[] {\"2021-12-25\", \"2022-01-01\", \"2022-01-02\", \"2022-01-15\", \"2022-02-01\"});\n\n // alphabet and number sort\n strings = new String[] {\"abc123\", \"abc45\", \"abc9\", \"abc100\", \"abc20\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(\n new String[] {\"abc9\", \"abc20\", \"abc45\", \"abc100\", \"abc123\"});\n\n // test for pure alphabet sort\n strings = new String[] {\"xyz\", \"abc\", \"def\", \"abcde\", \"xyzabc\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(new String[] {\"abc\", \"abcde\", \"def\", \"xyz\", \"xyzabc\"});\n\n // test for empty string\n strings = new String[] {\"\", \"abc\", \"123\", \"xyz\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(new String[] {\"\", \"123\", \"abc\", \"xyz\"});\n\n // test for the same string\n strings = new String[] {\"abc\", \"abc\", \"abc\", \"abc\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(new String[] {\"abc\", \"abc\", \"abc\", \"abc\"});\n\n // test for null element\n strings = new String[] {null, \"abc\", \"123\", \"xyz\"};\n Arrays.sort(strings, comparator);\n assertThat(strings).isEqualTo(new String[] {\"123\", \"abc\", \"xyz\", null});\n }\n\n @Test\n void complexStringTest() {\n var strings = new String[] {\n \"1719560085223\",\n \"1719564195757\",\n \"AJHQ9JKT\",\n \"1719565849173\",\n \"5InykKCe\",\n \"123123123\",\n \"adJhTqEo\",\n \"123123\",\n \"Ahvcq7Wn\",\n \"asda\",\n \"b5jHcxfe\"\n };\n Arrays.sort(strings, comparator);\n assertThat(strings).containsExactly(\n \"5InykKCe\",\n \"123123\",\n \"123123123\",\n \"1719560085223\",\n \"1719564195757\",\n \"1719565849173\",\n \"AJHQ9JKT\",\n \"Ahvcq7Wn\",\n \"adJhTqEo\",\n \"asda\",\n \"b5jHcxfe\"\n );\n }\n\n @Test\n void complexButSkewedStringTest() {\n var strings = new String[] {\n \"chu-shi-hua-gong-neng-you-hua-halo-2.9.0-fa-bu\",\n \"cxcc\",\n \"d\",\n \"dddd\",\n \"ddddd\",\n \"de-dao\",\n \"dENMr6tX\",\n \"dian-shang-ke-fu\",\n \"dong-tai-she-ji-shi-xi-25jie\",\n \"eeeeeeee\",\n \"ejqRrTp4\",\n \"Fh8Jd09T\",\n \"g5gZaGvS\",\n };\n Arrays.sort(strings, comparator);\n assertThat(strings).containsExactly(\n \"Fh8Jd09T\",\n \"chu-shi-hua-gong-neng-you-hua-halo-2.9.0-fa-bu\",\n \"cxcc\",\n \"d\",\n \"dENMr6tX\",\n \"dddd\",\n \"ddddd\",\n \"de-dao\",\n \"dian-shang-ke-fu\",\n \"dong-tai-she-ji-shi-xi-25jie\",\n \"eeeeeeee\",\n \"ejqRrTp4\",\n \"g5gZaGvS\"\n );\n }\n\n @Test\n void mixLetterCaseStringTest() {\n var strings = new String[] {\n \"VpLBxBJ7\", \"AJHQ9JKT\", \"asda\", \"Tq5EgH2V\", \"Fh8Jd09T\", \"J7KMLQeK\", \"adJhTqEo\",\n \"Ahvcq7Wn\",\n };\n Arrays.sort(strings, comparator);\n assertThat(strings).containsExactly(\n \"AJHQ9JKT\", \"Ahvcq7Wn\", \"Fh8Jd09T\", \"J7KMLQeK\", \"Tq5EgH2V\", \"VpLBxBJ7\", \"adJhTqEo\",\n \"asda\"\n );\n }\n\n @Test\n void mixLetterCaseAndNumberTest() {\n var strings = new String[] {\n \"1719565849173\", \"1719564195757\", \"1703040584263\",\n \"AJHQ9JKT\", \"Ahvcq7Wn\", \"Fh8Jd09T\", \"adJhTqEo\",\n \"asda\", \"1703053590063\", \"1702955288482\",\n \"zhi-chi-bei-fen-hui-fu-halo-2.8.0-fa-bu\",\n \"zhi-chi-ge-ren-zhong-xin-halo-2.11.0-fa-bu\",\n \"J7KMLQeK\", \"Tq5EgH2V\", \"VpLBxBJ7\",\n \"b5jHcxfe\", \"cao-ni-ma-a-huang-jian-ming\", \"chu-ji-ying-jian-kai-fa\",\n \"ddddd\", \"de-dao\", \"dian-shang-ke-fu\", \"eeeeeeee\", \"ejqRrTp4\",\n \"halo-maintainer-2023-nian-du-bang-dan\", \"hello-halo\", \"hello-world\",\n \"dong-tai-she-ji-shi-xi-25jie\", \"halo-nuan-dong-li-yu-quan-chang-qi-zhe-qi\", \"hello\",\n \"kai-fang-gong-gong-api-halo-2.5.0-fa-bu\",\n \"xing-neng-you-hua-yu-gong-neng-gai-jin-halo-2.13-fa-bu\", \"ye-wu-tuo-zhan-jing-li\",\n \"ying-qu-jing-mei-zhou-bian-halo-ying-yong-shi-chang-zhu-ti-you-jiang-zheng-ji\",\n \"zhi-chi-bao-chi-deng-lu-hui-hua-halo-2.16.0-fa-bu\",\n };\n Arrays.sort(strings, comparator);\n assertThat(strings).containsExactly(\n \"1702955288482\",\n \"1703040584263\",\n \"1703053590063\",\n \"1719564195757\",\n \"1719565849173\",\n \"AJHQ9JKT\",\n \"Ahvcq7Wn\",\n \"Fh8Jd09T\",\n \"J7KMLQeK\",\n \"Tq5EgH2V\",\n \"VpLBxBJ7\",\n \"adJhTqEo\",\n \"asda\",\n \"b5jHcxfe\",\n \"cao-ni-ma-a-huang-jian-ming\",\n \"chu-ji-ying-jian-kai-fa\",\n \"ddddd\",\n \"de-dao\",\n \"dian-shang-ke-fu\",\n \"dong-tai-she-ji-shi-xi-25jie\",\n \"eeeeeeee\",\n \"ejqRrTp4\",\n \"halo-maintainer-2023-nian-du-bang-dan\",\n \"halo-nuan-dong-li-yu-quan-chang-qi-zhe-qi\",\n \"hello\",\n \"hello-halo\",\n \"hello-world\",\n \"kai-fang-gong-gong-api-halo-2.5.0-fa-bu\",\n \"xing-neng-you-hua-yu-gong-neng-gai-jin-halo-2.13-fa-bu\",\n \"ye-wu-tuo-zhan-jing-li\",\n \"ying-qu-jing-mei-zhou-bian-halo-ying-yong-shi-chang-zhu-ti-you-jiang-zheng-ji\",\n \"zhi-chi-bao-chi-deng-lu-hui-hua-halo-2.16.0-fa-bu\",\n \"zhi-chi-bei-fen-hui-fu-halo-2.8.0-fa-bu\",\n \"zhi-chi-ge-ren-zhong-xin-halo-2.11.0-fa-bu\");\n }\n\n @Test\n public void sortingWithComplexStringsTest() {\n List strings = Arrays.asList(\"abc10\", \"abc2\", \"abc1\", \"abc20\", \"abc100\");\n strings.sort(comparator);\n assertThat(strings).containsExactly(\"abc1\", \"abc2\", \"abc10\", \"abc20\", \"abc100\");\n }\n\n @Test\n public void sortingWithDecimalStringsTest() {\n List strings =\n Arrays.asList(\"1.2\", \"1.10\", \"1.1\", \"1.20\", \"1.02\", \"1.22\", \"1.001\", \"1.002\");\n strings.sort(comparator);\n assertThat(strings).containsExactly(\"1.001\", \"1.002\", \"1.02\", \"1.1\", \"1.10\", \"1.2\", \"1.20\",\n \"1.22\");\n }\n\n @Test\n public void treeSetWithComparatorTest() {\n TreeSet set = new TreeSet<>(comparator);\n set.add(\"abc123\");\n set.add(\"abc1\");\n set.add(\"abc12\");\n set.add(\"abc2\");\n\n assertThat(set).containsExactly(\"abc1\", \"abc2\", \"abc12\", \"abc123\");\n }\n\n @Test\n public void testTreeMap_WithComparator() {\n TreeMap map = new TreeMap<>(comparator);\n map.put(\"2024-08-29\", \"date1\");\n map.put(\"2024-08-28\", \"date2\");\n map.put(\"2024-08-30\", \"date3\");\n\n assertThat(map.keySet()).containsExactly(\"2024-08-28\", \"2024-08-29\", \"2024-08-30\");\n assertThat(map.get(\"2024-08-29\")).isEqualTo(\"date1\");\n }\n\n @Test\n public void integerPartDifferentTest() {\n // Create strings with different integer parts to cover the compareIntegerPart code\n // block\n String[] strings = {\"abc10\", \"abc2\", \"abc1\", \"abc20\", \"abc10022229\"};\n Arrays.sort(strings, comparator);\n\n String[] expectedOrder = {\"abc1\", \"abc2\", \"abc10\", \"abc20\", \"abc10022229\"};\n assertThat(strings).containsExactly(expectedOrder);\n }\n\n @Test\n public void integerPartDifferentWithDecimalTest() {\n // To specifically test integer part comparison\n String str1 = \"abc12.5\";\n String str2 = \"abc11.5\";\n\n // Compare should return a positive number since \"12\" > \"11\"\n assertThat(comparator.compare(str1, str2)).isPositive();\n\n String str3 = \"abc11.5\";\n String str4 = \"abc12.5\";\n\n // Compare should return a negative number since \"11\" < \"12\"\n assertThat(comparator.compare(str3, str4)).isNegative();\n\n // Test for multiple decimal points\n assertThat(comparator.compare(\"1.23.4\", \"1.23\")).isGreaterThan(0);\n assertThat(comparator.compare(\"1.23\", \"1.23.4\")).isLessThan(0);\n\n assertThat(comparator.compare(\"1..23\", \"1.23\")).isLessThan(0);\n assertThat(comparator.compare(\"1.23..\", \"1.23\")).isGreaterThan(0);\n\n assertThat(comparator.compare(\"\", \"1.23\")).isLessThan(0);\n assertThat(comparator.compare(\"1.23\", \"\")).isGreaterThan(0);\n\n assertThat(comparator.compare(\"1.23\", \"1.23\")).isZero();\n }\n\n @Nested\n class ComparatorCharacteristicTest {\n @Test\n public void reflexiveTest() {\n // Reflexive: a == a should always return 0\n assertThat(comparator.compare(\"test\", \"test\")).isZero();\n assertThat(comparator.compare(\"\", \"\")).isZero();\n assertThat(comparator.compare(\"123\", \"123\")).isZero();\n assertThat(comparator.compare(null, null)).isZero();\n }\n\n @Test\n public void symmetricTest() {\n // Symmetric: a > b implies b < a\n assertThat(comparator.compare(\"123\", \"test\")).isNegative();\n assertThat(comparator.compare(\"test\", \"123\")).isPositive();\n\n assertThat(comparator.compare(\"1.023\", \"1.23\")).isNegative();\n assertThat(comparator.compare(\"1.23\", \"1.023\")).isPositive();\n }\n\n @Test\n public void transitiveTest() {\n // Transitive: a > b and b > c implies a > c\n assertThat(comparator.compare(\"test2\", \"test1\")).isPositive();\n assertThat(comparator.compare(\"test1\", \"test0\")).isPositive();\n assertThat(comparator.compare(\"test2\", \"test0\")).isPositive();\n }\n\n @RepeatedTest(50)\n public void consistencyTest() {\n // Consistency: a == b should always return 0 if not changed\n assertThat(comparator.compare(\"123abc\", \"123abc\")).isZero();\n assertThat(comparator.compare(\"test\", \"test\")).isZero();\n assertThat(comparator.compare(\"123abc\", \"123abc\"))\n .isEqualTo(comparator.compare(\"123abc\", \"123abc\"));\n }\n\n @Test\n public void withNumbersTest() {\n // Numbers should be compared numerically\n assertThat(comparator.compare(\"item2\", \"item10\")).isNegative();\n assertThat(comparator.compare(\"item10\", \"item2\")).isPositive();\n assertThat(comparator.compare(\"item10\", \"item10\")).isZero();\n }\n\n @Test\n public void mixedContentTest() {\n // Mixed content comparison\n assertThat(comparator.compare(\"abc123\", \"abc124\")).isNegative();\n assertThat(comparator.compare(\"abc124\", \"abc123\")).isPositive();\n assertThat(comparator.compare(\"abc123\", \"abc123\")).isZero();\n }\n\n @Test\n public void nullHandlingTest() {\n // Null handling\n assertThat(comparator.compare(null, \"test\")).isPositive();\n assertThat(comparator.compare(\"test\", null)).isNegative();\n assertThat(comparator.compare(null, null)).isZero();\n }\n\n @Test\n public void lengthDifferenceTest() {\n // Length difference should affect comparison\n assertThat(comparator.compare(\"test\", \"testa\")).isNegative();\n assertThat(comparator.compare(\"testa\", \"test\")).isPositive();\n }\n\n @Test\n public void specialCharactersTest() {\n // Special character comparison\n assertThat(comparator.compare(\"a#1\", \"a#2\")).isNegative();\n assertThat(comparator.compare(\"a#2\", \"a#1\")).isPositive();\n assertThat(comparator.compare(\"a#1\", \"a#1\")).isZero();\n }\n\n @Test\n public void emptyStringsTest() {\n // Empty string comparison\n assertThat(comparator.compare(\"\", \"test\")).isNegative();\n assertThat(comparator.compare(\"test\", \"\")).isPositive();\n assertThat(comparator.compare(\"\", \"\")).isZero();\n }\n }\n\n @Nested\n class ComparatorEdgeTest {\n @Test\n public void pureNumbersTest() {\n assertThat(comparator.compare(\"123\", \"123\")).isEqualTo(0);\n assertThat(comparator.compare(\"123\", \"124\")).isLessThan(0);\n assertThat(comparator.compare(\"124\", \"123\")).isGreaterThan(0);\n // Leading zeros\n assertThat(comparator.compare(\"00123\", \"123\") > 0).isTrue();\n assertThat(comparator.compare(\"0\", \"0\")).isEqualTo(0);\n assertThat(comparator.compare(\"0\", \"0000\")).isLessThan(0);\n assertThat(comparator.compare(\"0x\", \"0\")).isGreaterThan(0);\n assertThat(comparator.compare(\"0\", \"1\")).isLessThan(0);\n assertThat(comparator.compare(\"1\", \"0\")).isGreaterThan(0);\n assertThat(comparator.compare(\"001\", \"0\")).isGreaterThan(0);\n assertThat(comparator.compare(\"0x5e\", \"0000\")).isLessThan(0);\n }\n\n @Test\n public void mumbersWithOverflowTest() {\n // Max long value\n String largeNumber1 = \"9223372036854775807\";\n // One more than max long value\n String largeNumber2 = \"9223372036854775808\";\n assertThat(comparator.compare(largeNumber1, largeNumber2)).isLessThan(0);\n assertThat(comparator.compare(largeNumber2, largeNumber1)).isGreaterThan(0);\n\n // large number str comparison\n assertThat(comparator.compare(\"123456789012345678901234567890\",\n \"123456789012345678901234567891\")).isLessThan(0);\n assertThat(comparator.compare(\"123456789012345678901234567890\",\n \"123456789012345678901234567891\")).isNotPositive();\n assertThat(comparator.compare(\"999999999999999999999999999999\",\n \"999999999999999999999999999998\")).isGreaterThan(0);\n assertThat(comparator.compare(\"999999999999999999999999999999\",\n \"999999999999999999999999999998\")).isNotNegative();\n assertThat(comparator.compare(\"9999999999999999999999999999999999999999999999\",\n \"9999999999999999999999999999999999999999999998\")).isGreaterThan(0);\n assertThat(comparator.compare(\"100000000000000000000000000000\",\n \"100000000000000000000000000000\")).isEqualTo(0);\n\n // This specific case is to test the overflow for a real-world scenario\n assertThat(comparator.compare(\"5InykKCe\", \"1710683457874\") < 0).isTrue();\n assertThat(comparator.compare(\"5InykKce\", \"1717477435943\") > 0).isFalse();\n\n assertThat(comparator.compare(\"0\",\n \"9999999999999999999999999999999999999999999998\")).isLessThan(0);\n assertThat(comparator.compare(\"9999999999999999999999999999999999999999999998\",\n \"0\")).isGreaterThan(0);\n }\n\n @Test\n public void decimalStringsTest() {\n assertThat(comparator.compare(\"123.45\", \"123.45\")).isEqualTo(0);\n assertThat(comparator.compare(\"123.45\", \"123.46\")).isLessThan(0);\n assertThat(comparator.compare(\"123.46\", \"123.45\")).isGreaterThan(0);\n // Decimal equivalence\n assertThat(comparator.compare(\"123.5\", \"123.50\")).isLessThan(0);\n assertThat(comparator.compare(\"123.0005\", \"123.00050\")).isLessThan(0);\n }\n\n @Test\n public void lettersAndNumbersTest() {\n assertThat(comparator.compare(\"abc123\", \"abc123\")).isEqualTo(0);\n assertThat(comparator.compare(\"abc123\", \"abc124\")).isLessThan(0);\n assertThat(comparator.compare(\"abc124\", \"abc123\")).isGreaterThan(0);\n assertThat(comparator.compare(\"abc123\", \"abcd123\")).isLessThan(0);\n }\n\n @Test\n public void pureLettersTest() {\n assertThat(comparator.compare(\"abc\", \"abc\")).isEqualTo(0);\n assertThat(comparator.compare(\"abc\", \"abcd\")).isLessThan(0);\n assertThat(comparator.compare(\"abcd\", \"abc\")).isGreaterThan(0);\n // Case sensitivity\n assertThat(comparator.compare(\"ABC\", \"abc\")).isLessThan(0);\n }\n\n @Test\n public void dateStringsTest() {\n assertThat(comparator.compare(\"2024-08-29\", \"2024-08-29\")).isEqualTo(0);\n assertThat(comparator.compare(\"2024-08-29\", \"2024-08-30\")).isLessThan(0);\n assertThat(comparator.compare(\"2024-08-30\", \"2024-08-29\")).isGreaterThan(0);\n\n // Time comparison\n assertThat(comparator.compare(\"2024-08-29T12:00:00.000Z\", \"2024-08-29T12:00:00.001Z\"))\n .isLessThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:00:00.001Z\", \"2024-08-29T12:00:00.000Z\"))\n .isGreaterThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:00:00.000Z\", \"2024-08-29T12:00:01.000Z\"))\n .isLessThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:00:01.000Z\", \"2024-08-29T12:00:00.000Z\"))\n .isGreaterThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:00:00.000Z\", \"2024-08-29T12:01:00.000Z\"))\n .isLessThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:01:00.000Z\", \"2024-08-29T12:00:00.000Z\"))\n .isGreaterThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:00:00.000Z\", \"2024-08-29T13:00:00.000Z\"))\n .isLessThan(0);\n assertThat(comparator.compare(\"2024-08-29T13:00:00.000Z\", \"2024-08-29T12:00:00.000Z\"))\n .isGreaterThan(0);\n assertThat(comparator.compare(\"2024-08-29T12:00:00.000Z\", \"2024-08-30T12:00:00.000Z\"))\n .isLessThan(0);\n assertThat(comparator.compare(\"2024-08-30T12:00:00.000Z\", \"2024-08-29T12:00:00.000Z\"))\n .isGreaterThan(0);\n }\n\n @Test\n public void booleanStringsTest() {\n assertThat(comparator.compare(\"true\", \"false\")).isGreaterThan(0);\n assertThat(comparator.compare(\"false\", \"true\")).isLessThan(0);\n assertThat(comparator.compare(\"true\", \"true\")).isEqualTo(0);\n assertThat(comparator.compare(\"false\", \"false\")).isEqualTo(0);\n }\n\n @Test\n public void complexMixedStringsTest() {\n assertThat(comparator.compare(\"abc123xyz456\", \"abc123xyz456\")).isEqualTo(0);\n assertThat(comparator.compare(\"abc123xyz456\", \"abc124xyz456\")).isLessThan(0);\n assertThat(comparator.compare(\"abc124xyz456\", \"abc123xyz456\")).isGreaterThan(0);\n assertThat(comparator.compare(\"abc123xyz456\", \"abc123xyz457\")).isLessThan(0);\n }\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/index/MultiValueBuilderTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.Collections;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.FakeExtension;\n\nclass MultiValueBuilderTest {\n\n @Test\n void throwIfNoNameProvided() {\n assertThrows(IllegalArgumentException.class,\n () -> new MultiValueBuilder(null, String.class)\n );\n }\n\n @Test\n void throwIfNoKeyTypeProvided() {\n assertThrows(IllegalArgumentException.class,\n () -> new MultiValueBuilder(\"metadata.name\", null)\n );\n }\n\n @Test\n void throwIfNoIndexFuncProvided() {\n var builder = new MultiValueBuilder(\"metadata.name\", String.class);\n assertThrows(IllegalArgumentException.class, builder::build);\n }\n\n @Test\n void shouldBuildCorrectly() {\n var builder = new MultiValueBuilder(\"metadata.name\", String.class)\n .indexFunc(e -> Collections.singleton(e.getMetadata().getName()));\n var indexSpec = builder.build();\n assertNotNull(indexSpec);\n assertInstanceOf(MultiValueIndexSpec.class, indexSpec);\n assertEquals(String.class, indexSpec.getKeyType());\n assertEquals(\"metadata.name\", indexSpec.getName());\n assertFalse(indexSpec.isUnique());\n assertTrue(indexSpec.isNullable());\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/index/SingleValueBuilderTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.FakeExtension;\n\nclass SingleValueBuilderTest {\n\n @Test\n void throwIfNoNameProvided() {\n assertThrows(IllegalArgumentException.class,\n () -> new SingleValueBuilder(null, String.class)\n );\n }\n\n @Test\n void throwIfNoKeyTypeProvided() {\n assertThrows(IllegalArgumentException.class, () ->\n new SingleValueBuilder(\"metadata.name\", null)\n );\n }\n\n @Test\n void throwIfNoIndexFuncProvided() {\n var builder = new SingleValueBuilder(\"metadata.name\", String.class);\n assertThrows(IllegalArgumentException.class, builder::build);\n }\n\n @Test\n void shouldBuildCorrectly() {\n var builder = new SingleValueBuilder(\"metadata.name\", String.class)\n .indexFunc(e -> e.getMetadata().getName());\n var indexSpec = builder.build();\n assertNotNull(indexSpec);\n assertInstanceOf(SingleValueIndexSpec.class, indexSpec);\n assertEquals(String.class, indexSpec.getKeyType());\n assertEquals(\"metadata.name\", indexSpec.getName());\n assertFalse(indexSpec.isUnique());\n assertTrue(indexSpec.isNullable());\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/index/UnknownKeyTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.Objects;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.CsvSource;\n\nclass UnknownKeyTest {\n\n @ParameterizedTest\n @CsvSource({\n \"a, a\",\n \"b, b\",\n \",\",\n \"abc, abc\",\n \"2025, 2025\",\n \"true, true\",\n \"2025-10-20, 2025-10-20\",\n \"特殊字符, 特殊字符\"\n })\n void shouldEqualsWorkCorrectly(String key1, String key2) {\n assertEquals(new UnknownKey(key1), new UnknownKey(key2));\n assertEquals(new UnknownKey(null), new UnknownKey(null));\n }\n\n @ParameterizedTest\n @CsvSource(\n {\n \"a, a, 0\",\n \"a, b, -1\",\n \"b, a, 1\",\n \"abc, abd, -1\",\n \"abd, abc, 1\",\n \"0.1, 0.1, 0\",\n \"0.1, 0.2, -1\",\n \"0.2, 0.1, 1\",\n \"true, true, 0\",\n \"false, true, -1\",\n \"true, false, 1\",\n \"-0.1, -0.1, 0\",\n \"-1, -1, 0\",\n \"2025, 2025, 0\",\n \"2025, 2026, -1\",\n \"2026, 2025, 1\",\n \"2025-10-20, 2025-10-20, 0\",\n \"2025-10-20, 2025-10-21, -1\",\n \"2025-10-21, 2025-10-20, 1\",\n \"特殊字符A, 特殊字符B, -1\",\n \"特殊字符B, 特殊字符A, 1\"\n }\n )\n void shouldCompareCorrectly(String key1, String key2, int expected) {\n var compare = new UnknownKey(key1).compareTo(new UnknownKey(key2));\n assertTrue(Objects.equals(expected, compare) || expected * compare > 0);\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/index/query/QueriesTest.java", "content": "package run.halo.app.extension.index.query;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\n\nclass QueriesTest {\n\n @Test\n void shouldBuildAndConditionStaticMethod() {\n var condition = Queries.and(\n Queries.equal(\"status\", \"active\"),\n Queries.greaterThan(\"age\", 18)\n );\n assertEquals(\"(status = active AND age > 18)\", condition.toString());\n }\n\n @Test\n void shouldBuildOrConditionStaticMethod() {\n var condition = Queries.or(\n Queries.lessThan(\"price\", 50, false),\n Queries.equal(\"category\", \"Books\")\n );\n assertEquals(\"(price < 50 OR category = Books)\", condition.toString());\n }\n\n @Test\n void shouldBuildNotConditionStaticMethod() {\n var condition = Queries.not(Queries.equal(\"role\", \"Admin\"));\n assertEquals(\"role != Admin\", condition.toString());\n }\n\n @Test\n void shouldBuildBetweenCondition() {\n var condition = Queries.between(\"age\", 18, true, 30, false);\n assertEquals(\"age BETWEEN [18, 30)\", condition.toString());\n }\n\n @Test\n void shouldBuildEqualCondition() {\n var condition = Queries.equal(\"name\", \"John\");\n assertEquals(\"name = John\", condition.toString());\n }\n\n @Test\n void shouldBuildInCondition() {\n var condition = Queries.in(\"status\", \"active\", \"pending\");\n assertEquals(\"status IN (active, pending)\", condition.toString());\n\n condition = Queries.in(\"status\", List.of(\"active\", \"pending\"));\n assertEquals(\"status IN (active, pending)\", condition.toString());\n }\n\n @Test\n void shouldRefineInConditionWithSingleValueToEqualCondition() {\n var condition = Queries.in(\"status\", \"active\");\n assertEquals(\"status = active\", condition.toString());\n }\n\n @Test\n void shouldBuildGreaterThanCondition() {\n var condition = Queries.greaterThan(\"score\", 85);\n assertEquals(\"score > 85\", condition.toString());\n }\n\n @Test\n void shouldBuildLessThanCondition() {\n var condition = Queries.lessThan(\"price\", 100, true);\n assertEquals(\"price <= 100\", condition.toString());\n }\n\n @Test\n void shouldBuildLessThanConditionExclusive() {\n var condition = Queries.lessThan(\"price\", 100);\n assertEquals(\"price < 100\", condition.toString());\n }\n\n @Test\n void shouldBuildEmptyCondition() {\n var condition = Queries.empty();\n assertEquals(\"EMPTY\", condition.toString());\n }\n\n @Test\n void shouldBuildAllCondition() {\n var condition = Queries.all(\"tags\");\n assertEquals(\"ALL tags\", condition.toString());\n }\n\n @Test\n void shouldBuildNotEqualCondition() {\n var condition = Queries.notEqual(\"name\", \"Alice\");\n assertEquals(\"name != Alice\", condition.toString());\n }\n\n @Test\n void shouldBuildNotBetweenCondition() {\n var condition = Queries.between(\"age\", 20, false, 40, true).not();\n assertEquals(\"age NOT BETWEEN [20, 40)\", condition.toString());\n }\n\n @Test\n void shouldBuildNotInCondition() {\n var condition = Queries.in(\"status\", \"inactive\", \"banned\").not();\n assertEquals(\"status NOT IN (inactive, banned)\", condition.toString());\n }\n\n @Test\n void shouldBuildNotAllCondition() {\n var condition = Queries.all(\"categories\").not();\n assertEquals(\"NONE categories\", condition.toString());\n }\n\n @Test\n void shouldBuildStartsWithCondition() {\n var condition = Queries.startsWith(\"username\", \"admin\");\n assertEquals(\"username STARTS WITH admin\", condition.toString());\n }\n\n @Test\n void shouldBuildNotStartsWithCondition() {\n var condition = Queries.startsWith(\"username\", \"guest\").not();\n assertEquals(\"username NOT STARTS WITH guest\", condition.toString());\n }\n\n @Test\n void shouldBuildEndsWithCondition() {\n var condition = Queries.endsWith(\"email\", \"@example.com\");\n assertEquals(\"email ENDS WITH @example.com\", condition.toString());\n }\n\n @Test\n void shouldBuildNotEndsWithCondition() {\n var condition = Queries.endsWith(\"email\", \"@spam.com\").not();\n assertEquals(\"email NOT ENDS WITH @spam.com\", condition.toString());\n }\n\n @Test\n void shouldBuildContainsCondition() {\n var condition = Queries.contains(\"description\", \"important\");\n assertEquals(\"description CONTAINS important\", condition.toString());\n }\n\n @Test\n void shouldBuildNotContainsCondition() {\n var condition = Queries.contains(\"notes\", \"confidential\").not();\n assertEquals(\"notes NOT CONTAINS confidential\", condition.toString());\n }\n\n @Test\n void shouldBuildAndCondition() {\n var condition = Queries.equal(\"status\", \"active\")\n .and(Queries.greaterThan(\"age\", 18));\n assertEquals(\"(status = active AND age > 18)\", condition.toString());\n }\n\n @Test\n void shouldBuildOrCondition() {\n var condition = Queries.lessThan(\"price\", 50, false)\n .or(Queries.equal(\"category\", \"Books\"));\n assertEquals(\"(price < 50 OR category = Books)\", condition.toString());\n }\n\n\n @Test\n void shouldBuildNotCondition() {\n var condition = Queries.equal(\"role\", \"Admin\").not();\n assertEquals(\"role != Admin\", condition.toString());\n }\n\n @Test\n void shouldBuildLabelExistsCondition() {\n var condition = Queries.labelExists(\"premiumUser\");\n assertEquals(\"EXISTS metadata.labels['premiumUser']\", condition.toString());\n }\n\n @Test\n void shouldBuildLabelNotExistsCondition() {\n var condition = Queries.labelExists(\"betaTester\").not();\n assertEquals(\"NOT EXISTS metadata.labels['betaTester']\", condition.toString());\n }\n\n @Test\n void shouldBuildLabelEqualCondition() {\n var condition = Queries.labelEqual(\"region\", \"CN\");\n assertEquals(\"metadata.labels['region'] = 'CN'\", condition.toString());\n }\n\n @Test\n void shouldBuildLabelNotEqualCondition() {\n var condition = Queries.labelEqual(\"tier\", \"gold\").not();\n assertEquals(\"metadata.labels['tier'] <> 'gold'\", condition.toString());\n }\n\n @Test\n void shouldBuildLabelInCondition() {\n var condition = Queries.labelIn(\"env\", List.of(\"prod\", \"staging\"));\n assertEquals(\"metadata.labels['env'] IN ('prod', 'staging')\", condition.toString());\n }\n\n @Test\n void shouldBuildLabelNotInCondition() {\n var condition = Queries.labelIn(\"version\", List.of(\"v1\", \"v2\")).not();\n assertEquals(\"metadata.labels['version'] NOT IN ('v1', 'v2')\", condition.toString());\n }\n\n @Test\n void shouldBuildChainedConditions() {\n var condition = Queries.equal(\"name\", \"Bob\")\n .and(Queries.greaterThan(\"age\", 25))\n .or(Queries.in(\"status\", \"active\", \"pending\"));\n assertEquals(\n \"((name = Bob AND age > 25) OR status IN (active, pending))\", condition.toString()\n );\n }\n\n @Test\n void shouldBuildComplexCondition() {\n var condition = Queries.between(\"salary\", 50000, true, 100000, false)\n .and(Queries.equal(\"department\", \"Engineering\").not())\n .or(Queries.in(\"role\", \"Manager\", \"Director\"));\n assertEquals(\"\"\"\n ((salary BETWEEN [50000, 100000) AND department != Engineering) OR role IN (Manager,\\\n Director))\\\n \"\"\", condition.toString()\n );\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/indexer/DefaultIndexEngineTest.java", "content": "package run.halo.app.extension.indexer;\n\nimport java.util.ArrayList;\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.PriorityQueue;\nimport org.junit.jupiter.api.Test;\n\nclass DefaultIndexEngineTest {\n\n @Test\n void priorityQueueTest() {\n int n = 3;\n var pq = new PriorityQueue<>(n, Comparator.naturalOrder().reversed());\n List.of(5, 4, 3, 2, 1).forEach(i -> {\n pq.offer(i);\n if (pq.size() > n) {\n pq.poll();\n }\n });\n var result = new ArrayList<>();\n while (!pq.isEmpty()) {\n result.addFirst(pq.poll());\n }\n result.forEach(System.out::println);\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/extension/indexer/LabelIndexImplTest.java", "content": "package run.halo.app.extension.indexer;\n\nimport java.util.concurrent.ConcurrentSkipListMap;\nimport org.junit.jupiter.api.Test;\n\nclass LabelIndexImplTest {\n\n @Test\n void stringPrefixTest() {\n var map = new ConcurrentSkipListMap();\n map.put(\"a@b\", \"1\");\n map.put(\"a@c\", \"2\");\n map.put(\"a@cdefg\", \"2\");\n map.put(\"a@d\", \"3\");\n map.put(\"b@d\", \"4\");\n\n var subMap = map.subMap(\"a@\", \"a@\" + Character.MAX_VALUE);\n subMap.sequencedKeySet().forEach(System.out::println);\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/router/selector/LabelSelectorTest.java", "content": "package run.halo.app.extension.router.selector;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link LabelSelector}.\n *\n * @author guqing\n * @since 2.17.0\n */\nclass LabelSelectorTest {\n\n @Test\n void builderTest() {\n var labelSelector = LabelSelector.builder()\n .eq(\"a\", \"v1\")\n .in(\"b\", \"v2\", \"v3\")\n .build();\n assertThat(labelSelector.toString())\n .isEqualTo(\"\"\"\n (metadata.labels['a'] = 'v1' AND metadata.labels['b'] IN ('v2', 'v3'))\\\n \"\"\");\n }\n}" }, { "path": "api/src/test/java/run/halo/app/extension/router/selector/OperatorTest.java", "content": "package run.halo.app.extension.router.selector;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static run.halo.app.extension.router.selector.Operator.Equals;\nimport static run.halo.app.extension.router.selector.Operator.Exist;\nimport static run.halo.app.extension.router.selector.Operator.IN;\nimport static run.halo.app.extension.router.selector.Operator.NotEquals;\nimport static run.halo.app.extension.router.selector.Operator.NotExist;\n\nimport java.util.List;\nimport java.util.Set;\nimport lombok.extern.slf4j.Slf4j;\nimport org.junit.jupiter.api.Test;\n\n@Slf4j\nclass OperatorTest {\n\n @Test\n void shouldConvertCorrectly() {\n record TestCase(String source, Operator converter, SelectorCriteria expected) {\n }\n\n List.of(\n new TestCase(\"\", Equals, null),\n new TestCase(\"=\", Equals, null),\n new TestCase(\"=value\", Equals, null),\n new TestCase(\"name=\", Equals, null),\n new TestCase(\"name=value\", Equals,\n new SelectorCriteria(\"name\", Equals, Set.of(\"value\"))),\n new TestCase(\"name=v\", Equals,\n new SelectorCriteria(\"name\", Equals, Set.of(\"v\"))),\n\n new TestCase(\"\", NotEquals, null),\n new TestCase(\"=\", NotEquals, null),\n new TestCase(\"!\", NotEquals, null),\n new TestCase(\"!=\", NotEquals, null),\n new TestCase(\"!=value\", NotEquals, null),\n new TestCase(\"name!=\", NotEquals, null),\n new TestCase(\"name!=value\", NotEquals,\n new SelectorCriteria(\"name\", NotEquals, Set.of(\"value\"))),\n\n new TestCase(\"\", NotExist, null),\n new TestCase(\"!\", NotExist, null),\n new TestCase(\"!name\", NotExist, new SelectorCriteria(\"name\", NotExist, Set.of())),\n new TestCase(\"name\", NotExist, null),\n new TestCase(\"na!me\", NotExist, null),\n new TestCase(\"name!\", NotExist, null),\n new TestCase(\"name!=1\", NotEquals,\n new SelectorCriteria(\"name\", NotEquals, Set.of(\"1\"))),\n new TestCase(\"name!=12\", NotEquals,\n new SelectorCriteria(\"name\", NotEquals, Set.of(\"12\"))),\n\n new TestCase(\"name\", Exist, new SelectorCriteria(\"name\", Exist, Set.of())),\n new TestCase(\"\", Exist, null),\n new TestCase(\"!\", Exist, new SelectorCriteria(\"!\", Exist, Set.of())),\n new TestCase(\"a\", Exist, new SelectorCriteria(\"a\", Exist, Set.of())),\n\n new TestCase(\"name\", IN, null),\n new TestCase(\"name=(fake-name)\", IN,\n new SelectorCriteria(\"name\", IN, Set.of(\"fake-name\"))),\n new TestCase(\"name=(first-name,second-name)\", IN,\n new SelectorCriteria(\"name\", IN, Set.of(\"first-name\", \"second-name\")))\n ).forEach(testCase -> {\n log.debug(\"Testing: {}\", testCase);\n assertEquals(testCase.expected(), testCase.converter().convert(testCase.source()));\n });\n }\n\n}\n" }, { "path": "api/src/test/java/run/halo/app/extension/router/selector/SelectorConverterTest.java", "content": "package run.halo.app.extension.router.selector;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static run.halo.app.extension.router.selector.Operator.Equals;\n\nimport java.util.List;\nimport java.util.Set;\nimport lombok.extern.slf4j.Slf4j;\nimport org.junit.jupiter.api.Test;\n\n@Slf4j\nclass SelectorConverterTest {\n\n SelectorConverter converter = new SelectorConverter();\n\n @Test\n void shouldConvertCorrectly() {\n record TestCase(String selector, SelectorCriteria expected) {\n }\n\n List.of(\n new TestCase(\"\", null),\n new TestCase(\"name=value\",\n new SelectorCriteria(\"name\", Equals, Set.of(\"value\"))),\n new TestCase(\"name!=value\",\n new SelectorCriteria(\"name\", Operator.NotEquals, Set.of(\"value\"))),\n new TestCase(\"name\",\n new SelectorCriteria(\"name\", Operator.Exist, Set.of())),\n new TestCase(\"!name\",\n new SelectorCriteria(\"name\", Operator.NotExist, Set.of())),\n new TestCase(\"name\",\n new SelectorCriteria(\"name\", Operator.Exist, Set.of())),\n new TestCase(\"name!=\",\n new SelectorCriteria(\"name!=\", Operator.Exist, Set.of())),\n new TestCase(\"==\",\n new SelectorCriteria(\"==\", Operator.Exist, Set.of()))\n ).forEach(testCase -> {\n log.debug(\"Testing: {}\", testCase);\n assertEquals(testCase.expected, converter.convert(testCase.selector));\n });\n }\n}" }, { "path": "api/src/test/java/run/halo/app/infra/utils/GenericClassUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListResult;\n\nclass GenericClassUtilsTest {\n\n @Test\n void generateConcreteClass() {\n var clazz = GenericClassUtils.generateConcreteClass(ListResult.class, Post.class,\n () -> Post.class.getName() + \"List\");\n assertEquals(\"run.halo.app.core.extension.content.PostList\", clazz.getName());\n assertEquals(\"run.halo.app.core.extension.content\", clazz.getPackageName());\n }\n\n}" }, { "path": "api/src/test/java/run/halo/app/infra/utils/JsonUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.time.Instant;\nimport java.time.LocalDateTime;\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link JsonUtils}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class JsonUtilsTest {\n\n @Test\n public void serializerTime() {\n Instant now = Instant.now();\n String instantStr = JsonUtils.objectToJson(now);\n assertThat(instantStr).isNotNull();\n\n String localDateTimeStr = JsonUtils.objectToJson(LocalDateTime.now());\n assertThat(localDateTimeStr).isNotNull();\n }\n\n @Test\n @SuppressWarnings(\"rawtypes\")\n public void deserializerArrayString() {\n String s = \"[\\\"hello\\\", \\\"world\\\"]\";\n List list = JsonUtils.jsonToObject(s, List.class);\n assertThat(list).isEqualTo(List.of(\"hello\", \"world\"));\n }\n}\n" }, { "path": "api/src/test/java/run/halo/app/infra/utils/PathUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link PathUtils}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass PathUtilsTest {\n\n @Test\n void combinePath() {\n Map combinePathCases = getCombinePathCases();\n combinePathCases.forEach((segments, expected) -> {\n String s = PathUtils.combinePath(segments.split(\",\"));\n assertThat(s).isEqualTo(expected);\n });\n\n String s = PathUtils.combinePath(\"a\", \"\", \"c\");\n assertThat(s).isEqualTo(\"/a/c\");\n }\n\n private Map getCombinePathCases() {\n Map combinePathCases = new HashMap<>();\n combinePathCases.put(\"a,b,c\", \"/a/b/c\");\n combinePathCases.put(\"/a,b,c\", \"/a/b/c\");\n combinePathCases.put(\"/a,b/,c\", \"/a/b/c\");\n combinePathCases.put(\"/a,/b/,c\", \"/a/b/c\");\n return combinePathCases;\n }\n\n @Test\n void appendPathSeparatorIfMissing() {\n String s = PathUtils.appendPathSeparatorIfMissing(\"a\");\n assertThat(s).isEqualTo(\"a/\");\n\n s = PathUtils.appendPathSeparatorIfMissing(\"a/\");\n assertThat(s).isEqualTo(\"a/\");\n\n s = PathUtils.appendPathSeparatorIfMissing(null);\n assertThat(s).isEqualTo(null);\n }\n\n @Test\n void simplifyPathPattern() {\n assertThat(PathUtils.simplifyPathPattern(\"/a/b/c\")).isEqualTo(\"/a/b/c\");\n assertThat(PathUtils.simplifyPathPattern(\"/a/{b}/c\")).isEqualTo(\"/a/{b}/c\");\n assertThat(PathUtils.simplifyPathPattern(\"/a/{b}/*\")).isEqualTo(\"/a/{b}/*\");\n assertThat(PathUtils.simplifyPathPattern(\"/archives/{year:\\\\d{4}}/{month:\\\\d{2}}\"))\n .isEqualTo(\"/archives/{year}/{month}\");\n assertThat(PathUtils.simplifyPathPattern(\"/archives/{year:\\\\d{4}}/{slug}\"))\n .isEqualTo(\"/archives/{year}/{slug}\");\n assertThat(PathUtils.simplifyPathPattern(\"/archives/{year:\\\\d{4}}/page/{page:\\\\d+}\"))\n .isEqualTo(\"/archives/{year}/page/{page}\");\n }\n\n @Test\n void isAbsoluteUri() {\n String[] absoluteUris = new String[] {\n \"ftp://ftp.is.co.za/rfc/rfc1808.txt\",\n \"http://www.ietf.org/rfc/rfc2396.txt\",\n \"ldap://[2001:db8::7]/c=GB?objectClass?one\",\n \"mailto:John.Doe@example.com\",\n \"news:comp.infosystems.www.servers.unix\",\n \"tel:+1-816-555-1212\",\n \"telnet://192.0.2.16:80/\",\n \"urn:oasis:names:specification:docbook:dtd:xml:4.1.2\",\n \"data:text/vnd-example+xyz;foo=bar;base64,R0lGODdh\",\n \"irc://irc.example.com:6667/#some-channel\",\n \"ircs://irc.example.com:6667/#some-channel\",\n \"irc6://irc.example.com:6667/#some-channel\"\n };\n for (String uri : absoluteUris) {\n assertThat(PathUtils.isAbsoluteUri(uri)).isTrue();\n }\n\n String[] paths = new String[] {\n \"//example.com/path/resource.txt\",\n \"/path/resource.txt\",\n \"path/resource.txt\",\n \"../resource.txt\",\n \"./resource.txt\",\n \"resource.txt\",\n \"#fragment\",\n \"\",\n null\n };\n for (String path : paths) {\n assertThat(PathUtils.isAbsoluteUri(path)).isFalse();\n }\n }\n}" }, { "path": "api-docs/openapi/v3_0/aggregated.json", "content": "{\n \"openapi\": \"3.0.1\",\n \"info\": {\n \"title\": \"Halo\",\n \"version\": \"2.23.0-SNAPSHOT\"\n },\n \"servers\": [\n {\n \"url\": \"http://localhost:8091\",\n \"description\": \"Generated server url\"\n }\n ],\n \"security\": [\n {\n \"basicAuth\": [],\n \"bearerAuth\": []\n }\n ],\n \"paths\": {\n \"/api/v1alpha1/annotationsettings\": {\n \"get\": {\n \"description\": \"List AnnotationSetting\",\n \"operationId\": \"listAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSettingList\"\n }\n }\n },\n \"description\": \"Response annotationsettings\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create AnnotationSetting\",\n \"operationId\": \"createAnnotationSetting\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Fresh annotationsetting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response annotationsettings created just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/annotationsettings/{name}\": {\n \"delete\": {\n \"description\": \"Delete AnnotationSetting\",\n \"operationId\": \"deleteAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response annotationsetting deleted just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get AnnotationSetting\",\n \"operationId\": \"getAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response single annotationsetting\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch AnnotationSetting\",\n \"operationId\": \"patchAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response annotationsetting patched just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update AnnotationSetting\",\n \"operationId\": \"updateAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Updated annotationsetting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response annotationsettings updated just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/configmaps\": {\n \"get\": {\n \"description\": \"List ConfigMap\",\n \"operationId\": \"listConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMapList\"\n }\n }\n },\n \"description\": \"Response configmaps\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ConfigMap\",\n \"operationId\": \"createConfigMap\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Fresh configmap\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response configmaps created just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/configmaps/{name}\": {\n \"delete\": {\n \"description\": \"Delete ConfigMap\",\n \"operationId\": \"deleteConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response configmap deleted just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ConfigMap\",\n \"operationId\": \"getConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response single configmap\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ConfigMap\",\n \"operationId\": \"patchConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response configmap patched just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ConfigMap\",\n \"operationId\": \"updateConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Updated configmap\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response configmaps updated just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menuitems\": {\n \"get\": {\n \"description\": \"List MenuItem\",\n \"operationId\": \"listMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItemList\"\n }\n }\n },\n \"description\": \"Response menuitems\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create MenuItem\",\n \"operationId\": \"createMenuItem\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Fresh menuitem\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response menuitems created just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menuitems/{name}\": {\n \"delete\": {\n \"description\": \"Delete MenuItem\",\n \"operationId\": \"deleteMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response menuitem deleted just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get MenuItem\",\n \"operationId\": \"getMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response single menuitem\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch MenuItem\",\n \"operationId\": \"patchMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response menuitem patched just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update MenuItem\",\n \"operationId\": \"updateMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Updated menuitem\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response menuitems updated just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menus\": {\n \"get\": {\n \"description\": \"List Menu\",\n \"operationId\": \"listMenu\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuList\"\n }\n }\n },\n \"description\": \"Response menus\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Menu\",\n \"operationId\": \"createMenu\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Fresh menu\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response menus created just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menus/{name}\": {\n \"delete\": {\n \"description\": \"Delete Menu\",\n \"operationId\": \"deleteMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response menu deleted just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Menu\",\n \"operationId\": \"getMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response single menu\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Menu\",\n \"operationId\": \"patchMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response menu patched just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Menu\",\n \"operationId\": \"updateMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Updated menu\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response menus updated just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/rolebindings\": {\n \"get\": {\n \"description\": \"List RoleBinding\",\n \"operationId\": \"listRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBindingList\"\n }\n }\n },\n \"description\": \"Response rolebindings\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create RoleBinding\",\n \"operationId\": \"createRoleBinding\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Fresh rolebinding\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response rolebindings created just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/rolebindings/{name}\": {\n \"delete\": {\n \"description\": \"Delete RoleBinding\",\n \"operationId\": \"deleteRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response rolebinding deleted just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get RoleBinding\",\n \"operationId\": \"getRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response single rolebinding\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch RoleBinding\",\n \"operationId\": \"patchRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response rolebinding patched just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update RoleBinding\",\n \"operationId\": \"updateRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Updated rolebinding\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response rolebindings updated just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/roles\": {\n \"get\": {\n \"description\": \"List Role\",\n \"operationId\": \"listRole\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleList\"\n }\n }\n },\n \"description\": \"Response roles\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Role\",\n \"operationId\": \"createRole\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Fresh role\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response roles created just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/roles/{name}\": {\n \"delete\": {\n \"description\": \"Delete Role\",\n \"operationId\": \"deleteRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response role deleted just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Role\",\n \"operationId\": \"getRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response single role\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Role\",\n \"operationId\": \"patchRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response role patched just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Role\",\n \"operationId\": \"updateRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Updated role\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response roles updated just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/secrets\": {\n \"get\": {\n \"description\": \"List Secret\",\n \"operationId\": \"listSecret\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SecretList\"\n }\n }\n },\n \"description\": \"Response secrets\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Secret\",\n \"operationId\": \"createSecret\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Fresh secret\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response secrets created just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/secrets/{name}\": {\n \"delete\": {\n \"description\": \"Delete Secret\",\n \"operationId\": \"deleteSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response secret deleted just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Secret\",\n \"operationId\": \"getSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response single secret\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Secret\",\n \"operationId\": \"patchSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response secret patched just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Secret\",\n \"operationId\": \"updateSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Updated secret\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response secrets updated just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/settings\": {\n \"get\": {\n \"description\": \"List Setting\",\n \"operationId\": \"listSetting\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SettingList\"\n }\n }\n },\n \"description\": \"Response settings\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Setting\",\n \"operationId\": \"createSetting\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Fresh setting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response settings created just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/settings/{name}\": {\n \"delete\": {\n \"description\": \"Delete Setting\",\n \"operationId\": \"deleteSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response setting deleted just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Setting\",\n \"operationId\": \"getSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response single setting\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Setting\",\n \"operationId\": \"patchSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response setting patched just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Setting\",\n \"operationId\": \"updateSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Updated setting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response settings updated just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/users\": {\n \"get\": {\n \"description\": \"List User\",\n \"operationId\": \"listUser\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserList\"\n }\n }\n },\n \"description\": \"Response users\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create User\",\n \"operationId\": \"createUser\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Fresh user\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response users created just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/users/{name}\": {\n \"delete\": {\n \"description\": \"Delete User\",\n \"operationId\": \"deleteUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response user deleted just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get User\",\n \"operationId\": \"getUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response single user\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch User\",\n \"operationId\": \"patchUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response user patched just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update User\",\n \"operationId\": \"updateUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Updated user\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response users updated just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/attachments\": {\n \"get\": {\n \"operationId\": \"SearchAttachments\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Filter attachments without group. This parameter will ignore group parameter.\",\n \"in\": \"query\",\n \"name\": \"ungrouped\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n },\n {\n \"description\": \"Keyword for searching.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Acceptable media types.\",\n \"in\": \"query\",\n \"name\": \"accepts\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AttachmentList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/attachments/-/upload-from-url\": {\n \"post\": {\n \"operationId\": \"ExternalTransferAttachment\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UploadFromUrlRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/attachments/upload\": {\n \"post\": {\n \"operationId\": \"UploadAttachment\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/IUploadRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/auth-providers\": {\n \"get\": {\n \"description\": \"Lists all auth providers\",\n \"operationId\": \"listAuthProviders\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedAuthProvider\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/auth-providers/{name}/disable\": {\n \"put\": {\n \"description\": \"Disables an auth provider\",\n \"operationId\": \"disableAuthProvider\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/auth-providers/{name}/enable\": {\n \"put\": {\n \"description\": \"Enables an auth provider\",\n \"operationId\": \"enableAuthProvider\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/comments\": {\n \"get\": {\n \"description\": \"List comments.\",\n \"operationId\": \"ListComments\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Comments filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Commenter kind.\",\n \"in\": \"query\",\n \"name\": \"ownerKind\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Commenter name.\",\n \"in\": \"query\",\n \"name\": \"ownerName\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedCommentList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Create a comment.\",\n \"operationId\": \"CreateComment\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/comments/{name}/reply\": {\n \"post\": {\n \"description\": \"Create a reply.\",\n \"operationId\": \"CreateReply\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/indices/-/rebuild\": {\n \"post\": {\n \"description\": \"Rebuild all indices\",\n \"operationId\": \"RebuildAllIndices\",\n \"responses\": {},\n \"tags\": [\n \"IndicesV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/notifiers/{name}/sender-config\": {\n \"get\": {\n \"description\": \"Fetch sender config of notifier\",\n \"operationId\": \"FetchSenderConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Save sender config of notifier\",\n \"operationId\": \"SaveSenderConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins\": {\n \"get\": {\n \"description\": \"List plugins using query criteria and sort params\",\n \"operationId\": \"ListPlugins\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Keyword of plugin name or description\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Whether the plugin is enabled\",\n \"in\": \"query\",\n \"name\": \"enabled\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.css\": {\n \"get\": {\n \"description\": \"Merge all CSS bundles of enabled plugins into one.\",\n \"operationId\": \"fetchCssBundle\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.js\": {\n \"get\": {\n \"description\": \"Merge all JS bundles of enabled plugins into one.\",\n \"operationId\": \"fetchJsBundle\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/install-from-uri\": {\n \"post\": {\n \"description\": \"Install a plugin from uri.\",\n \"operationId\": \"InstallPluginFromUri\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/InstallFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/install\": {\n \"post\": {\n \"description\": \"Install a plugin by uploading a Jar file.\",\n \"operationId\": \"InstallPlugin\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginInstallRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/json-config\": {\n \"get\": {\n \"description\": \"Fetch converted json config of plugin by configured configMapName.\",\n \"operationId\": \"fetchPluginJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update the config of plugin setting.\",\n \"operationId\": \"updatePluginJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"content\": {},\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/plugin-state\": {\n \"put\": {\n \"description\": \"Change the running state of a plugin by name.\",\n \"operationId\": \"ChangePluginRunningState\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginRunningStateRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/reload\": {\n \"put\": {\n \"description\": \"Reload a plugin by name.\",\n \"operationId\": \"reloadPlugin\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/reset-config\": {\n \"put\": {\n \"description\": \"Reset the configMap of plugin setting.\",\n \"operationId\": \"ResetPluginConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/setting\": {\n \"get\": {\n \"description\": \"Fetch setting of plugin.\",\n \"operationId\": \"fetchPluginSetting\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/upgrade\": {\n \"post\": {\n \"description\": \"Upgrade a plugin by uploading a Jar file\",\n \"operationId\": \"UpgradePlugin\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginInstallRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {},\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/upgrade-from-uri\": {\n \"post\": {\n \"description\": \"Upgrade a plugin from uri.\",\n \"operationId\": \"UpgradePluginFromUri\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UpgradeFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"List posts.\",\n \"operationId\": \"ListPosts\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Posts filtered by publish phase.\",\n \"in\": \"query\",\n \"name\": \"publishPhase\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"DRAFT\",\n \"PENDING_APPROVAL\",\n \"PUBLISHED\",\n \"FAILED\"\n ]\n }\n },\n {\n \"description\": \"Posts filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Posts filtered by category including sub-categories.\",\n \"in\": \"query\",\n \"name\": \"categoryWithChildren\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Draft a post.\",\n \"operationId\": \"DraftPost\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}\": {\n \"put\": {\n \"description\": \"Update a post.\",\n \"operationId\": \"UpdateDraftPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/content\": {\n \"delete\": {\n \"description\": \"Delete a content for post.\",\n \"operationId\": \"deletePostContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n },\n \"get\": {\n \"description\": \"Fetch content of post.\",\n \"operationId\": \"fetchPostContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update a post\\u0027s content.\",\n \"operationId\": \"UpdatePostContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Content\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/head-content\": {\n \"get\": {\n \"description\": \"Fetch head content of post.\",\n \"operationId\": \"fetchPostHeadContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/publish\": {\n \"put\": {\n \"description\": \"Publish a post.\",\n \"operationId\": \"PublishPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Head snapshot name of content.\",\n \"in\": \"query\",\n \"name\": \"headSnapshot\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"async\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/recycle\": {\n \"put\": {\n \"description\": \"Recycle a post.\",\n \"operationId\": \"RecyclePost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/release-content\": {\n \"get\": {\n \"description\": \"Fetch release content of post.\",\n \"operationId\": \"fetchPostReleaseContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/revert-content\": {\n \"put\": {\n \"description\": \"Revert to specified snapshot for post content.\",\n \"operationId\": \"revertToSpecifiedSnapshotForPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RevertSnapshotForPostParam\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/snapshot\": {\n \"get\": {\n \"description\": \"List all snapshots for post content.\",\n \"operationId\": \"listPostSnapshots\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSnapshotDto\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/unpublish\": {\n \"put\": {\n \"description\": \"UnPublish a post.\",\n \"operationId\": \"UnpublishPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/replies\": {\n \"get\": {\n \"description\": \"List replies.\",\n \"operationId\": \"ListReplies\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Replies filtered by commentName.\",\n \"in\": \"query\",\n \"name\": \"commentName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedReplyList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages\": {\n \"get\": {\n \"description\": \"List single pages.\",\n \"operationId\": \"ListSinglePages\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"SinglePages filtered by contributor.\",\n \"in\": \"query\",\n \"name\": \"contributor\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"SinglePages filtered by publish phase.\",\n \"in\": \"query\",\n \"name\": \"publishPhase\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"DRAFT\",\n \"PENDING_APPROVAL\",\n \"PUBLISHED\",\n \"FAILED\"\n ]\n }\n },\n {\n \"description\": \"SinglePages filtered by visibility.\",\n \"in\": \"query\",\n \"name\": \"visible\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ]\n }\n },\n {\n \"description\": \"SinglePages filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedSinglePageList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Draft a single page.\",\n \"operationId\": \"DraftSinglePage\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}\": {\n \"put\": {\n \"description\": \"Update a single page.\",\n \"operationId\": \"UpdateDraftSinglePage\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/content\": {\n \"delete\": {\n \"description\": \"Delete a content for post.\",\n \"operationId\": \"deleteSinglePageContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n },\n \"get\": {\n \"description\": \"Fetch content of single page.\",\n \"operationId\": \"fetchSinglePageContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update a single page\\u0027s content.\",\n \"operationId\": \"UpdateSinglePageContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Content\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/head-content\": {\n \"get\": {\n \"description\": \"Fetch head content of single page.\",\n \"operationId\": \"fetchSinglePageHeadContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/publish\": {\n \"put\": {\n \"description\": \"Publish a single page.\",\n \"operationId\": \"PublishSinglePage\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/release-content\": {\n \"get\": {\n \"description\": \"Fetch release content of single page.\",\n \"operationId\": \"fetchSinglePageReleaseContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/revert-content\": {\n \"put\": {\n \"description\": \"Revert to specified snapshot for single page content.\",\n \"operationId\": \"revertToSpecifiedSnapshotForSinglePage\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RevertSnapshotForSingleParam\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/snapshot\": {\n \"get\": {\n \"description\": \"List all snapshots for single page content.\",\n \"operationId\": \"listSinglePageSnapshots\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSnapshotDto\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/stats\": {\n \"get\": {\n \"description\": \"Get stats.\",\n \"operationId\": \"getStats\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DashboardStats\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/tags\": {\n \"get\": {\n \"description\": \"List Post Tags.\",\n \"operationId\": \"ListPostTags\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Post tags filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes\": {\n \"get\": {\n \"description\": \"List themes.\",\n \"operationId\": \"ListThemes\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Whether to list uninstalled themes.\",\n \"in\": \"query\",\n \"name\": \"uninstalled\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThemeList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/-/activation\": {\n \"get\": {\n \"description\": \"Fetch the activated theme.\",\n \"operationId\": \"fetchActivatedTheme\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/-/install-from-uri\": {\n \"post\": {\n \"description\": \"Install a theme from uri.\",\n \"operationId\": \"InstallThemeFromUri\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/InstallFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/install\": {\n \"post\": {\n \"description\": \"Install a theme by uploading a zip file.\",\n \"operationId\": \"InstallTheme\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThemeInstallRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/activation\": {\n \"put\": {\n \"description\": \"Activate a theme by name.\",\n \"operationId\": \"activateTheme\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/invalidate-cache\": {\n \"put\": {\n \"description\": \"Invalidate theme template cache.\",\n \"operationId\": \"InvalidateCache\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"204\": {\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/json-config\": {\n \"get\": {\n \"description\": \"Fetch converted json config of theme by configured configMapName.\",\n \"operationId\": \"fetchThemeJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update the configMap of theme setting.\",\n \"operationId\": \"updateThemeJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"content\": {},\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/reload\": {\n \"put\": {\n \"description\": \"Reload theme setting.\",\n \"operationId\": \"Reload\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/reset-config\": {\n \"put\": {\n \"description\": \"Reset the configMap of theme setting.\",\n \"operationId\": \"ResetThemeConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/setting\": {\n \"get\": {\n \"description\": \"Fetch setting of theme.\",\n \"operationId\": \"fetchThemeSetting\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/upgrade\": {\n \"post\": {\n \"description\": \"Upgrade theme\",\n \"operationId\": \"UpgradeTheme\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UpgradeRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {},\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/upgrade-from-uri\": {\n \"post\": {\n \"description\": \"Upgrade a theme from uri.\",\n \"operationId\": \"UpgradeThemeFromUri\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UpgradeFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users\": {\n \"get\": {\n \"description\": \"List users\",\n \"operationId\": \"ListUsers\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Keyword to search\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Role name\",\n \"in\": \"query\",\n \"name\": \"role\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserEndpoint.ListedUserList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Creates a new user.\",\n \"operationId\": \"CreateUser\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CreateUserRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-\": {\n \"get\": {\n \"description\": \"Get current user detail\",\n \"operationId\": \"GetCurrentUserDetail\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DetailedUser\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update current user profile, but password.\",\n \"operationId\": \"UpdateCurrentUser\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-/password\": {\n \"put\": {\n \"description\": \"Change own password of user.\",\n \"operationId\": \"ChangeOwnPassword\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ChangeOwnPasswordRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-/send-email-verification-code\": {\n \"post\": {\n \"description\": \"Send email verification code for user\",\n \"operationId\": \"SendEmailVerificationCode\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/EmailVerifyRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-/verify-email\": {\n \"post\": {\n \"description\": \"Verify email for user by code.\",\n \"operationId\": \"VerifyEmail\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/VerifyCodeRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}\": {\n \"get\": {\n \"description\": \"Get user detail by name\",\n \"operationId\": \"GetUserDetail\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DetailedUser\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}/avatar\": {\n \"delete\": {\n \"description\": \"delete user avatar\",\n \"operationId\": \"DeleteUserAvatar\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"upload user avatar\",\n \"operationId\": \"UploadUserAvatar\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/IAvatarUploadRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}/password\": {\n \"put\": {\n \"description\": \"Change anyone password of user for admin.\",\n \"operationId\": \"ChangeAnyonePassword\",\n \"parameters\": [\n {\n \"description\": \"Name of user. If the name is equal to \\u0027-\\u0027, it will change the password of current user.\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ChangePasswordRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}/permissions\": {\n \"get\": {\n \"description\": \"Get permissions of user\",\n \"operationId\": \"GetPermissions\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserPermission\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Grant permissions to user\",\n \"operationId\": \"GrantPermission\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/GrantRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/categories\": {\n \"get\": {\n \"description\": \"Lists categories.\",\n \"operationId\": \"queryCategories\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CategoryVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/categories/{name}\": {\n \"get\": {\n \"description\": \"Gets category by name.\",\n \"operationId\": \"queryCategoryByName\",\n \"parameters\": [\n {\n \"description\": \"Category name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/categories/{name}/posts\": {\n \"get\": {\n \"description\": \"Lists posts by category name.\",\n \"operationId\": \"queryPostsByCategoryName\",\n \"parameters\": [\n {\n \"description\": \"Category name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"Lists posts.\",\n \"operationId\": \"queryPosts\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/posts/{name}\": {\n \"get\": {\n \"description\": \"Gets a post by name.\",\n \"operationId\": \"queryPostByName\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/posts/{name}/navigation\": {\n \"get\": {\n \"description\": \"Gets a post navigation by name.\",\n \"operationId\": \"queryPostNavigationByName\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NavigationPostVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/singlepages\": {\n \"get\": {\n \"description\": \"Lists single pages\",\n \"operationId\": \"querySinglePages\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedSinglePageVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/singlepages/{name}\": {\n \"get\": {\n \"description\": \"Gets single page by name\",\n \"operationId\": \"querySinglePageByName\",\n \"parameters\": [\n {\n \"description\": \"SinglePage name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/tags\": {\n \"get\": {\n \"description\": \"Lists tags\",\n \"operationId\": \"queryTags\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/tags/{name}\": {\n \"get\": {\n \"description\": \"Gets tag by name\",\n \"operationId\": \"queryTagByName\",\n \"parameters\": [\n {\n \"description\": \"Tag name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/tags/{name}/posts\": {\n \"get\": {\n \"description\": \"Lists posts by tag name\",\n \"operationId\": \"queryPostsByTagName\",\n \"parameters\": [\n {\n \"description\": \"Tag name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/comments\": {\n \"get\": {\n \"description\": \"List comments.\",\n \"operationId\": \"ListComments_1\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"The comment subject group.\",\n \"in\": \"query\",\n \"name\": \"group\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The comment subject version.\",\n \"in\": \"query\",\n \"name\": \"version\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The comment subject kind.\",\n \"in\": \"query\",\n \"name\": \"kind\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The comment subject name.\",\n \"in\": \"query\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Whether to include replies. Default is false.\",\n \"in\": \"query\",\n \"name\": \"withReplies\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n },\n {\n \"description\": \"Reply size of the comment, default is 10, only works when withReplies is true.\",\n \"in\": \"query\",\n \"name\": \"replySize\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentWithReplyVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n },\n \"post\": {\n \"description\": \"Create a comment.\",\n \"operationId\": \"CreateComment_1\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/comments/{name}\": {\n \"get\": {\n \"description\": \"Get a comment.\",\n \"operationId\": \"GetComment\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/comments/{name}/reply\": {\n \"get\": {\n \"description\": \"List comment replies.\",\n \"operationId\": \"ListCommentReplies\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n },\n \"post\": {\n \"description\": \"Create a reply.\",\n \"operationId\": \"CreateReply_1\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/indices/-/search\": {\n \"post\": {\n \"description\": \"Search indices.\",\n \"operationId\": \"IndicesSearch\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SearchOption\"\n }\n }\n },\n \"description\": \"Please note that the \\\"filterPublished\\\", \\\"filterExposed\\\" and \\\"filterRecycled\\\" fields are ignored in this endpoint.\"\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SearchResult\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"IndexV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/menus/-\": {\n \"get\": {\n \"description\": \"Gets primary menu.\",\n \"operationId\": \"queryPrimaryMenu\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/menus/{name}\": {\n \"get\": {\n \"description\": \"Gets menu by name.\",\n \"operationId\": \"queryMenuByName\",\n \"parameters\": [\n {\n \"description\": \"Menu name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/stats/-\": {\n \"get\": {\n \"description\": \"Gets site stats\",\n \"operationId\": \"queryStats\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SiteStatsVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/trackers/counter\": {\n \"post\": {\n \"description\": \"Count an extension resource visits.\",\n \"operationId\": \"count\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CounterRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MetricsV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/trackers/downvote\": {\n \"post\": {\n \"description\": \"Downvote an extension resource.\",\n \"operationId\": \"downvote\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/VoteRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MetricsV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/trackers/upvote\": {\n \"post\": {\n \"description\": \"Upvote an extension resource.\",\n \"operationId\": \"upvote\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/VoteRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MetricsV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/notifiers/{name}/receiver-config\": {\n \"get\": {\n \"description\": \"Fetch receiver config of notifier\",\n \"operationId\": \"FetchReceiverConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Save receiver config of notifier\",\n \"operationId\": \"SaveReceiverConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/subscriptions/{name}/unsubscribe\": {\n \"get\": {\n \"description\": \"Unsubscribe a subscription\",\n \"operationId\": \"Unsubscribe\",\n \"parameters\": [\n {\n \"description\": \"Subscription name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Unsubscribe token\",\n \"in\": \"query\",\n \"name\": \"token\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notification-preferences\": {\n \"get\": {\n \"description\": \"List notification preferences for the authenticated user.\",\n \"operationId\": \"ListUserNotificationPreferences\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierMatrix\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Save notification preferences for the authenticated user.\",\n \"operationId\": \"SaveUserNotificationPreferences\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierCollectionRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierMatrix\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications\": {\n \"get\": {\n \"description\": \"List notifications for the authenticated user.\",\n \"operationId\": \"ListUserNotifications\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/-/mark-specified-as-read\": {\n \"put\": {\n \"description\": \"Mark the specified notifications as read.\",\n \"operationId\": \"MarkNotificationsAsRead\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MarkSpecifiedRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/{name}\": {\n \"delete\": {\n \"description\": \"Delete the specified notification.\",\n \"operationId\": \"DeleteSpecifiedNotification\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Notification name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/{name}/mark-as-read\": {\n \"put\": {\n \"description\": \"Mark the specified notification as read.\",\n \"operationId\": \"MarkNotificationAsRead\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Notification name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.plugin.halo.run/v1alpha1/plugins/{name}/available\": {\n \"get\": {\n \"description\": \"Gets plugin available by name.\",\n \"operationId\": \"queryPluginAvailableByName\",\n \"parameters\": [\n {\n \"description\": \"Plugin name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.storage.halo.run/v1alpha1/thumbnails/-/via-uri\": {\n \"get\": {\n \"description\": \"Get thumbnail by URI\",\n \"operationId\": \"GetThumbnailByUri\",\n \"parameters\": [\n {\n \"description\": \"The URI of the image\",\n \"in\": \"query\",\n \"name\": \"uri\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The size of the thumbnail\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"S\",\n \"M\",\n \"L\",\n \"XL\"\n ]\n }\n },\n {\n \"description\": \"The width of the thumbnail, if \\u0027size\\u0027 is not provided, this parameter will be used to determine the size\",\n \"in\": \"query\",\n \"name\": \"width\",\n \"schema\": {\n \"type\": \"integer\",\n \"enum\": [\n \"400\",\n \"800\",\n \"1200\",\n \"1600\"\n ]\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1Public\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/authproviders\": {\n \"get\": {\n \"description\": \"List AuthProvider\",\n \"operationId\": \"listAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProviderList\"\n }\n }\n },\n \"description\": \"Response authproviders\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create AuthProvider\",\n \"operationId\": \"createAuthProvider\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Fresh authprovider\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response authproviders created just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/authproviders/{name}\": {\n \"delete\": {\n \"description\": \"Delete AuthProvider\",\n \"operationId\": \"deleteAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response authprovider deleted just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get AuthProvider\",\n \"operationId\": \"getAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response single authprovider\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch AuthProvider\",\n \"operationId\": \"patchAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response authprovider patched just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update AuthProvider\",\n \"operationId\": \"updateAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Updated authprovider\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response authproviders updated just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/userconnections\": {\n \"get\": {\n \"description\": \"List UserConnection\",\n \"operationId\": \"listUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnectionList\"\n }\n }\n },\n \"description\": \"Response userconnections\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create UserConnection\",\n \"operationId\": \"createUserConnection\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Fresh userconnection\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response userconnections created just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/userconnections/{name}\": {\n \"delete\": {\n \"description\": \"Delete UserConnection\",\n \"operationId\": \"deleteUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response userconnection deleted just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get UserConnection\",\n \"operationId\": \"getUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response single userconnection\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch UserConnection\",\n \"operationId\": \"patchUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response userconnection patched just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update UserConnection\",\n \"operationId\": \"updateUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Updated userconnection\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response userconnections updated just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n }\n },\n \"/apis/console.api.halo.run/v1alpha1/systemconfigs/{group}\": {\n \"get\": {\n \"description\": \"Get system config by group\",\n \"operationId\": \"getSystemConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Group of the system config\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n },\n \"application/json\": {}\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemConfigV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update system config by group\",\n \"operationId\": \"updateSystemConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Group of the system config\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n }\n },\n \"responses\": {\n \"204 NO_CONTENT\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemConfigV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.migration.halo.run/v1alpha1/backup-files\": {\n \"get\": {\n \"description\": \"Get backup files from backup root.\",\n \"operationId\": \"getBackupFiles\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/BackupFile\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MigrationV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.migration.halo.run/v1alpha1/backups/{name}/files/{filename}\": {\n \"get\": {\n \"operationId\": \"DownloadBackups\",\n \"parameters\": [\n {\n \"description\": \"Backup name.\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Backup filename.\",\n \"in\": \"path\",\n \"name\": \"filename\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"MigrationV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.migration.halo.run/v1alpha1/restorations\": {\n \"post\": {\n \"description\": \"Restore backup by uploading file or providing download link or backup name.\",\n \"operationId\": \"RestoreBackup\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RestoreRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {},\n \"tags\": [\n \"MigrationV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.notification.halo.run/v1alpha1/notifiers/default-email-notifier/verify-connection\": {\n \"post\": {\n \"description\": \"Verify email sender config.\",\n \"operationId\": \"VerifyEmailSenderConfig\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/EmailConfigValidationRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.security.halo.run/v1alpha1/users/{username}/disable\": {\n \"post\": {\n \"description\": \"Disable user by username\",\n \"operationId\": \"DisableUser\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"The user has been disabled.\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.security.halo.run/v1alpha1/users/{username}/enable\": {\n \"post\": {\n \"description\": \"Enable user by username\",\n \"operationId\": \"EnableUser\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"The user has been enabled.\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.storage.halo.run/v1alpha1/attachments/-/upload\": {\n \"post\": {\n \"description\": \"Upload attachment endpoint for console.\",\n \"operationId\": \"uploadAttachmentForConsole\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UploadForm\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.storage.halo.run/v1alpha1/policies/{name}/configs/{group}\": {\n \"get\": {\n \"description\": \"Get policy config by group\",\n \"operationId\": \"getPolicyConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of the policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Name of the group\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PolicyAlpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update policy config by group\",\n \"operationId\": \"updatePolicyConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of the policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Name of the group\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"PolicyAlpha1Console\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/categories\": {\n \"get\": {\n \"description\": \"List Category\",\n \"operationId\": \"listCategory\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CategoryList\"\n }\n }\n },\n \"description\": \"Response categories\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Category\",\n \"operationId\": \"createCategory\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Fresh category\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response categories created just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/categories/{name}\": {\n \"delete\": {\n \"description\": \"Delete Category\",\n \"operationId\": \"deleteCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response category deleted just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Category\",\n \"operationId\": \"getCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response single category\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Category\",\n \"operationId\": \"patchCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response category patched just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Category\",\n \"operationId\": \"updateCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Updated category\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response categories updated just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/comments\": {\n \"get\": {\n \"description\": \"List Comment\",\n \"operationId\": \"listComment\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentList\"\n }\n }\n },\n \"description\": \"Response comments\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Comment\",\n \"operationId\": \"createComment\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Fresh comment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response comments created just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/comments/{name}\": {\n \"delete\": {\n \"description\": \"Delete Comment\",\n \"operationId\": \"deleteComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response comment deleted just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Comment\",\n \"operationId\": \"getComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response single comment\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Comment\",\n \"operationId\": \"patchComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response comment patched just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Comment\",\n \"operationId\": \"updateComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Updated comment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response comments updated just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"List Post\",\n \"operationId\": \"listPost\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostList\"\n }\n }\n },\n \"description\": \"Response posts\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Post\",\n \"operationId\": \"createPost\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Fresh post\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response posts created just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/posts/{name}\": {\n \"delete\": {\n \"description\": \"Delete Post\",\n \"operationId\": \"deletePost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response post deleted just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Post\",\n \"operationId\": \"getPost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response single post\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Post\",\n \"operationId\": \"patchPost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response post patched just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Post\",\n \"operationId\": \"updatePost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Updated post\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response posts updated just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/replies\": {\n \"get\": {\n \"description\": \"List Reply\",\n \"operationId\": \"listReply\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyList\"\n }\n }\n },\n \"description\": \"Response replies\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Reply\",\n \"operationId\": \"createReply\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Fresh reply\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response replies created just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/replies/{name}\": {\n \"delete\": {\n \"description\": \"Delete Reply\",\n \"operationId\": \"deleteReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reply deleted just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Reply\",\n \"operationId\": \"getReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response single reply\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Reply\",\n \"operationId\": \"patchReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response reply patched just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Reply\",\n \"operationId\": \"updateReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Updated reply\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response replies updated just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/singlepages\": {\n \"get\": {\n \"description\": \"List SinglePage\",\n \"operationId\": \"listSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageList\"\n }\n }\n },\n \"description\": \"Response singlepages\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create SinglePage\",\n \"operationId\": \"createSinglePage\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Fresh singlepage\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response singlepages created just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/singlepages/{name}\": {\n \"delete\": {\n \"description\": \"Delete SinglePage\",\n \"operationId\": \"deleteSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response singlepage deleted just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get SinglePage\",\n \"operationId\": \"getSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response single singlepage\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch SinglePage\",\n \"operationId\": \"patchSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response singlepage patched just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update SinglePage\",\n \"operationId\": \"updateSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Updated singlepage\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response singlepages updated just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/snapshots\": {\n \"get\": {\n \"description\": \"List Snapshot\",\n \"operationId\": \"listSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SnapshotList\"\n }\n }\n },\n \"description\": \"Response snapshots\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Snapshot\",\n \"operationId\": \"createSnapshot\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Fresh snapshot\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response snapshots created just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/snapshots/{name}\": {\n \"delete\": {\n \"description\": \"Delete Snapshot\",\n \"operationId\": \"deleteSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response snapshot deleted just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Snapshot\",\n \"operationId\": \"getSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response single snapshot\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Snapshot\",\n \"operationId\": \"patchSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response snapshot patched just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Snapshot\",\n \"operationId\": \"updateSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Updated snapshot\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response snapshots updated just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/tags\": {\n \"get\": {\n \"description\": \"List Tag\",\n \"operationId\": \"listTag\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagList\"\n }\n }\n },\n \"description\": \"Response tags\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Tag\",\n \"operationId\": \"createTag\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Fresh tag\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response tags created just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/tags/{name}\": {\n \"delete\": {\n \"description\": \"Delete Tag\",\n \"operationId\": \"deleteTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response tag deleted just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Tag\",\n \"operationId\": \"getTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response single tag\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Tag\",\n \"operationId\": \"patchTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response tag patched just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Tag\",\n \"operationId\": \"updateTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Updated tag\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response tags updated just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n }\n },\n \"/apis/metrics.halo.run/v1alpha1/counters\": {\n \"get\": {\n \"description\": \"List Counter\",\n \"operationId\": \"listCounter\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CounterList\"\n }\n }\n },\n \"description\": \"Response counters\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Counter\",\n \"operationId\": \"createCounter\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Fresh counter\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response counters created just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n }\n },\n \"/apis/metrics.halo.run/v1alpha1/counters/{name}\": {\n \"delete\": {\n \"description\": \"Delete Counter\",\n \"operationId\": \"deleteCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response counter deleted just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Counter\",\n \"operationId\": \"getCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response single counter\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Counter\",\n \"operationId\": \"patchCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response counter patched just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Counter\",\n \"operationId\": \"updateCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Updated counter\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response counters updated just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n }\n },\n \"/apis/migration.halo.run/v1alpha1/backups\": {\n \"get\": {\n \"description\": \"List Backup\",\n \"operationId\": \"listBackup\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/BackupList\"\n }\n }\n },\n \"description\": \"Response backups\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Backup\",\n \"operationId\": \"createBackup\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Fresh backup\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response backups created just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n }\n },\n \"/apis/migration.halo.run/v1alpha1/backups/{name}\": {\n \"delete\": {\n \"description\": \"Delete Backup\",\n \"operationId\": \"deleteBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response backup deleted just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Backup\",\n \"operationId\": \"getBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response single backup\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Backup\",\n \"operationId\": \"patchBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response backup patched just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Backup\",\n \"operationId\": \"updateBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Updated backup\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response backups updated just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifications\": {\n \"get\": {\n \"description\": \"List Notification\",\n \"operationId\": \"listNotification\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationList\"\n }\n }\n },\n \"description\": \"Response notifications\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Notification\",\n \"operationId\": \"createNotification\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Fresh notification\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response notifications created just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifications/{name}\": {\n \"delete\": {\n \"description\": \"Delete Notification\",\n \"operationId\": \"deleteNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response notification deleted just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Notification\",\n \"operationId\": \"getNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response single notification\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Notification\",\n \"operationId\": \"patchNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response notification patched just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Notification\",\n \"operationId\": \"updateNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Updated notification\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response notifications updated just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notificationtemplates\": {\n \"get\": {\n \"description\": \"List NotificationTemplate\",\n \"operationId\": \"listNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplateList\"\n }\n }\n },\n \"description\": \"Response notificationtemplates\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create NotificationTemplate\",\n \"operationId\": \"createNotificationTemplate\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Fresh notificationtemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response notificationtemplates created just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notificationtemplates/{name}\": {\n \"delete\": {\n \"description\": \"Delete NotificationTemplate\",\n \"operationId\": \"deleteNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response notificationtemplate deleted just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get NotificationTemplate\",\n \"operationId\": \"getNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response single notificationtemplate\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch NotificationTemplate\",\n \"operationId\": \"patchNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response notificationtemplate patched just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update NotificationTemplate\",\n \"operationId\": \"updateNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Updated notificationtemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response notificationtemplates updated just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifierDescriptors\": {\n \"get\": {\n \"description\": \"List NotifierDescriptor\",\n \"operationId\": \"listNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptorList\"\n }\n }\n },\n \"description\": \"Response notifierDescriptors\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create NotifierDescriptor\",\n \"operationId\": \"createNotifierDescriptor\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Fresh notifierDescriptor\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response notifierDescriptors created just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifierDescriptors/{name}\": {\n \"delete\": {\n \"description\": \"Delete NotifierDescriptor\",\n \"operationId\": \"deleteNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response notifierDescriptor deleted just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get NotifierDescriptor\",\n \"operationId\": \"getNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response single notifierDescriptor\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch NotifierDescriptor\",\n \"operationId\": \"patchNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response notifierDescriptor patched just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update NotifierDescriptor\",\n \"operationId\": \"updateNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Updated notifierDescriptor\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response notifierDescriptors updated just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasons\": {\n \"get\": {\n \"description\": \"List Reason\",\n \"operationId\": \"listReason\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonList\"\n }\n }\n },\n \"description\": \"Response reasons\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Reason\",\n \"operationId\": \"createReason\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Fresh reason\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response reasons created just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasons/{name}\": {\n \"delete\": {\n \"description\": \"Delete Reason\",\n \"operationId\": \"deleteReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reason deleted just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Reason\",\n \"operationId\": \"getReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response single reason\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Reason\",\n \"operationId\": \"patchReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response reason patched just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Reason\",\n \"operationId\": \"updateReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Updated reason\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response reasons updated just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasontypes\": {\n \"get\": {\n \"description\": \"List ReasonType\",\n \"operationId\": \"listReasonType\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeList\"\n }\n }\n },\n \"description\": \"Response reasontypes\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ReasonType\",\n \"operationId\": \"createReasonType\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Fresh reasontype\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response reasontypes created just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasontypes/{name}\": {\n \"delete\": {\n \"description\": \"Delete ReasonType\",\n \"operationId\": \"deleteReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reasontype deleted just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ReasonType\",\n \"operationId\": \"getReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response single reasontype\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ReasonType\",\n \"operationId\": \"patchReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response reasontype patched just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ReasonType\",\n \"operationId\": \"updateReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Updated reasontype\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response reasontypes updated just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/subscriptions\": {\n \"get\": {\n \"description\": \"List Subscription\",\n \"operationId\": \"listSubscription\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SubscriptionList\"\n }\n }\n },\n \"description\": \"Response subscriptions\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Subscription\",\n \"operationId\": \"createSubscription\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Fresh subscription\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response subscriptions created just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/subscriptions/{name}\": {\n \"delete\": {\n \"description\": \"Delete Subscription\",\n \"operationId\": \"deleteSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response subscription deleted just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Subscription\",\n \"operationId\": \"getSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response single subscription\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Subscription\",\n \"operationId\": \"patchSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response subscription patched just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Subscription\",\n \"operationId\": \"updateSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Updated subscription\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response subscriptions updated just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensiondefinitions\": {\n \"get\": {\n \"description\": \"List ExtensionDefinition\",\n \"operationId\": \"listExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinitionList\"\n }\n }\n },\n \"description\": \"Response extensiondefinitions\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ExtensionDefinition\",\n \"operationId\": \"createExtensionDefinition\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Fresh extensiondefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response extensiondefinitions created just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensiondefinitions/{name}\": {\n \"delete\": {\n \"description\": \"Delete ExtensionDefinition\",\n \"operationId\": \"deleteExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response extensiondefinition deleted just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ExtensionDefinition\",\n \"operationId\": \"getExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response single extensiondefinition\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ExtensionDefinition\",\n \"operationId\": \"patchExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response extensiondefinition patched just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ExtensionDefinition\",\n \"operationId\": \"updateExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Updated extensiondefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response extensiondefinitions updated just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensionpointdefinitions\": {\n \"get\": {\n \"description\": \"List ExtensionPointDefinition\",\n \"operationId\": \"listExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinitionList\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinitions\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ExtensionPointDefinition\",\n \"operationId\": \"createExtensionPointDefinition\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Fresh extensionpointdefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinitions created just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensionpointdefinitions/{name}\": {\n \"delete\": {\n \"description\": \"Delete ExtensionPointDefinition\",\n \"operationId\": \"deleteExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response extensionpointdefinition deleted just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ExtensionPointDefinition\",\n \"operationId\": \"getExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response single extensionpointdefinition\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ExtensionPointDefinition\",\n \"operationId\": \"patchExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinition patched just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ExtensionPointDefinition\",\n \"operationId\": \"updateExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Updated extensionpointdefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinitions updated just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/plugins\": {\n \"get\": {\n \"description\": \"List Plugin\",\n \"operationId\": \"listPlugin\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginList\"\n }\n }\n },\n \"description\": \"Response plugins\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Plugin\",\n \"operationId\": \"createPlugin\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Fresh plugin\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response plugins created just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/plugins/{name}\": {\n \"delete\": {\n \"description\": \"Delete Plugin\",\n \"operationId\": \"deletePlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response plugin deleted just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Plugin\",\n \"operationId\": \"getPlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response single plugin\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Plugin\",\n \"operationId\": \"patchPlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response plugin patched just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Plugin\",\n \"operationId\": \"updatePlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Updated plugin\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response plugins updated just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/reverseproxies\": {\n \"get\": {\n \"description\": \"List ReverseProxy\",\n \"operationId\": \"listReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxyList\"\n }\n }\n },\n \"description\": \"Response reverseproxies\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ReverseProxy\",\n \"operationId\": \"createReverseProxy\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Fresh reverseproxy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response reverseproxies created just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/reverseproxies/{name}\": {\n \"delete\": {\n \"description\": \"Delete ReverseProxy\",\n \"operationId\": \"deleteReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reverseproxy deleted just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ReverseProxy\",\n \"operationId\": \"getReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response single reverseproxy\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ReverseProxy\",\n \"operationId\": \"patchReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response reverseproxy patched just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ReverseProxy\",\n \"operationId\": \"updateReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Updated reverseproxy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response reverseproxies updated just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/devices\": {\n \"get\": {\n \"description\": \"List Device\",\n \"operationId\": \"listDevice\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DeviceList\"\n }\n }\n },\n \"description\": \"Response devices\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Device\",\n \"operationId\": \"createDevice\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Fresh device\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response devices created just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/devices/{name}\": {\n \"delete\": {\n \"description\": \"Delete Device\",\n \"operationId\": \"deleteDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response device deleted just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Device\",\n \"operationId\": \"getDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response single device\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Device\",\n \"operationId\": \"patchDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response device patched just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Device\",\n \"operationId\": \"updateDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Updated device\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response devices updated just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/personalaccesstokens\": {\n \"get\": {\n \"description\": \"List PersonalAccessToken\",\n \"operationId\": \"listPersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessTokenList\"\n }\n }\n },\n \"description\": \"Response personalaccesstokens\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create PersonalAccessToken\",\n \"operationId\": \"createPersonalAccessToken\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Fresh personalaccesstoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response personalaccesstokens created just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/personalaccesstokens/{name}\": {\n \"delete\": {\n \"description\": \"Delete PersonalAccessToken\",\n \"operationId\": \"deletePersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response personalaccesstoken deleted just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get PersonalAccessToken\",\n \"operationId\": \"getPersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response single personalaccesstoken\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch PersonalAccessToken\",\n \"operationId\": \"patchPersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response personalaccesstoken patched just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update PersonalAccessToken\",\n \"operationId\": \"updatePersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Updated personalaccesstoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response personalaccesstokens updated just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/remembermetokens\": {\n \"get\": {\n \"description\": \"List RememberMeToken\",\n \"operationId\": \"listRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeTokenList\"\n }\n }\n },\n \"description\": \"Response remembermetokens\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create RememberMeToken\",\n \"operationId\": \"createRememberMeToken\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Fresh remembermetoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response remembermetokens created just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/remembermetokens/{name}\": {\n \"delete\": {\n \"description\": \"Delete RememberMeToken\",\n \"operationId\": \"deleteRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response remembermetoken deleted just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get RememberMeToken\",\n \"operationId\": \"getRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response single remembermetoken\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch RememberMeToken\",\n \"operationId\": \"patchRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response remembermetoken patched just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update RememberMeToken\",\n \"operationId\": \"updateRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Updated remembermetoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response remembermetokens updated just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/attachments\": {\n \"get\": {\n \"description\": \"List Attachment\",\n \"operationId\": \"listAttachment\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AttachmentList\"\n }\n }\n },\n \"description\": \"Response attachments\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Attachment\",\n \"operationId\": \"createAttachment\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Fresh attachment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response attachments created just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/attachments/{name}\": {\n \"delete\": {\n \"description\": \"Delete Attachment\",\n \"operationId\": \"deleteAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response attachment deleted just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Attachment\",\n \"operationId\": \"getAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response single attachment\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Attachment\",\n \"operationId\": \"patchAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response attachment patched just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Attachment\",\n \"operationId\": \"updateAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Updated attachment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response attachments updated just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/groups\": {\n \"get\": {\n \"description\": \"List Group\",\n \"operationId\": \"listGroup\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/GroupList\"\n }\n }\n },\n \"description\": \"Response groups\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Group\",\n \"operationId\": \"createGroup\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Fresh group\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response groups created just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/groups/{name}\": {\n \"delete\": {\n \"description\": \"Delete Group\",\n \"operationId\": \"deleteGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response group deleted just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Group\",\n \"operationId\": \"getGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response single group\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Group\",\n \"operationId\": \"patchGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response group patched just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Group\",\n \"operationId\": \"updateGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Updated group\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response groups updated just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/localthumbnails\": {\n \"get\": {\n \"description\": \"List LocalThumbnail\",\n \"operationId\": \"listLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnailList\"\n }\n }\n },\n \"description\": \"Response localthumbnails\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create LocalThumbnail\",\n \"operationId\": \"createLocalThumbnail\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Fresh localthumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response localthumbnails created just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/localthumbnails/{name}\": {\n \"delete\": {\n \"description\": \"Delete LocalThumbnail\",\n \"operationId\": \"deleteLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response localthumbnail deleted just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get LocalThumbnail\",\n \"operationId\": \"getLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response single localthumbnail\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch LocalThumbnail\",\n \"operationId\": \"patchLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response localthumbnail patched just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update LocalThumbnail\",\n \"operationId\": \"updateLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Updated localthumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response localthumbnails updated just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policies\": {\n \"get\": {\n \"description\": \"List Policy\",\n \"operationId\": \"listPolicy\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyList\"\n }\n }\n },\n \"description\": \"Response policies\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Policy\",\n \"operationId\": \"createPolicy\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Fresh policy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response policies created just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policies/{name}\": {\n \"delete\": {\n \"description\": \"Delete Policy\",\n \"operationId\": \"deletePolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response policy deleted just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Policy\",\n \"operationId\": \"getPolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response single policy\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Policy\",\n \"operationId\": \"patchPolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response policy patched just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Policy\",\n \"operationId\": \"updatePolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Updated policy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response policies updated just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policytemplates\": {\n \"get\": {\n \"description\": \"List PolicyTemplate\",\n \"operationId\": \"listPolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplateList\"\n }\n }\n },\n \"description\": \"Response policytemplates\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create PolicyTemplate\",\n \"operationId\": \"createPolicyTemplate\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Fresh policytemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response policytemplates created just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policytemplates/{name}\": {\n \"delete\": {\n \"description\": \"Delete PolicyTemplate\",\n \"operationId\": \"deletePolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response policytemplate deleted just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get PolicyTemplate\",\n \"operationId\": \"getPolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response single policytemplate\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch PolicyTemplate\",\n \"operationId\": \"patchPolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response policytemplate patched just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update PolicyTemplate\",\n \"operationId\": \"updatePolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Updated policytemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response policytemplates updated just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/thumbnails\": {\n \"get\": {\n \"description\": \"List Thumbnail\",\n \"operationId\": \"listThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThumbnailList\"\n }\n }\n },\n \"description\": \"Response thumbnails\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Thumbnail\",\n \"operationId\": \"createThumbnail\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Fresh thumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response thumbnails created just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/thumbnails/{name}\": {\n \"delete\": {\n \"description\": \"Delete Thumbnail\",\n \"operationId\": \"deleteThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response thumbnail deleted just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Thumbnail\",\n \"operationId\": \"getThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response single thumbnail\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Thumbnail\",\n \"operationId\": \"patchThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response thumbnail patched just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Thumbnail\",\n \"operationId\": \"updateThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Updated thumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response thumbnails updated just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/theme.halo.run/v1alpha1/themes\": {\n \"get\": {\n \"description\": \"List Theme\",\n \"operationId\": \"listTheme\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThemeList\"\n }\n }\n },\n \"description\": \"Response themes\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Theme\",\n \"operationId\": \"createTheme\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Fresh theme\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response themes created just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n }\n },\n \"/apis/theme.halo.run/v1alpha1/themes/{name}\": {\n \"delete\": {\n \"description\": \"Delete Theme\",\n \"operationId\": \"deleteTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response theme deleted just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Theme\",\n \"operationId\": \"getTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response single theme\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Theme\",\n \"operationId\": \"patchTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response theme patched just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Theme\",\n \"operationId\": \"updateTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Updated theme\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response themes updated just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n }\n },\n \"/apis/uc.api.auth.halo.run/v1alpha1/user-connections/{registerId}/disconnect\": {\n \"put\": {\n \"description\": \"Disconnect my connection from a third-party platform.\",\n \"operationId\": \"DisconnectMyConnection\",\n \"parameters\": [\n {\n \"description\": \"The registration ID of the third-party platform.\",\n \"in\": \"path\",\n \"name\": \"registerId\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"List posts owned by the current user.\",\n \"operationId\": \"ListMyPosts\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Posts filtered by publish phase.\",\n \"in\": \"query\",\n \"name\": \"publishPhase\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"DRAFT\",\n \"PENDING_APPROVAL\",\n \"PUBLISHED\",\n \"FAILED\"\n ]\n }\n },\n {\n \"description\": \"Posts filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Posts filtered by category including sub-categories.\",\n \"in\": \"query\",\n \"name\": \"categoryWithChildren\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Create my post. If you want to create a post with content, please set\\n annotation: \\\"content.halo.run/content-json\\\" into annotations and refer\\n to Content for corresponding data type.\\n\",\n \"operationId\": \"CreateMyPost\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}\": {\n \"get\": {\n \"description\": \"Get post that belongs to the current user.\",\n \"operationId\": \"GetMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n },\n \"put\": {\n \"description\": \"Update my post.\",\n \"operationId\": \"UpdateMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/draft\": {\n \"get\": {\n \"description\": \"Get my post draft.\",\n \"operationId\": \"GetMyPostDraft\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Should include patched content and raw or not.\",\n \"in\": \"query\",\n \"name\": \"patched\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n },\n \"put\": {\n \"description\": \"Update draft of my post. Please make sure set annotation:\\n\\\"content.halo.run/content-json\\\" into annotations and refer to\\nContent for corresponding data type.\\n\",\n \"operationId\": \"UpdateMyPostDraft\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/publish\": {\n \"put\": {\n \"description\": \"Publish my post.\",\n \"operationId\": \"PublishMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/recycle\": {\n \"delete\": {\n \"description\": \"Move my post to recycle bin.\",\n \"operationId\": \"RecycleMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/unpublish\": {\n \"put\": {\n \"description\": \"Unpublish my post.\",\n \"operationId\": \"UnpublishMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/snapshots/{name}\": {\n \"get\": {\n \"description\": \"Get snapshot for one post.\",\n \"operationId\": \"GetSnapshotForPost\",\n \"parameters\": [\n {\n \"description\": \"Snapshot name.\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Post name.\",\n \"in\": \"query\",\n \"name\": \"postName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Should include patched content and raw or not.\",\n \"in\": \"query\",\n \"name\": \"patched\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.halo.run/v1alpha1/annotationsettings\": {\n \"get\": {\n \"description\": \"List available AnnotationSettings for the given targetRef. The available AnnotationSettings are determined by the currently activated theme and started plugins.\",\n \"operationId\": \"listAvailableAnnotationSettings\",\n \"parameters\": [\n {\n \"description\": \"The targetRef of the AnnotationSetting. e.g.: \\u0027content.halo.run/Post\",\n \"in\": \"query\",\n \"name\": \"targetRef\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1AlphaUc\"\n ]\n }\n },\n \"/apis/uc.api.halo.run/v1alpha1/user-preferences/{group}\": {\n \"get\": {\n \"description\": \"Get my preference by group.\",\n \"operationId\": \"getMyPreference\",\n \"parameters\": [\n {\n \"description\": \"Group of user preference, e.g. `notification`.\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserPreferenceV1alpha1Uc\"\n ]\n },\n \"put\": {\n \"description\": \"Create or update my preference by group.\",\n \"operationId\": \"updateMyPreference\",\n \"parameters\": [\n {\n \"description\": \"Group of user preference, e.g. `notification`.\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"description\": \"No content, preference updated successfully.\"\n }\n },\n \"tags\": [\n \"UserPreferenceV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/settings\": {\n \"get\": {\n \"description\": \"Get Two-factor authentication settings.\",\n \"operationId\": \"GetTwoFactorAuthenticationSettings\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/settings/disabled\": {\n \"put\": {\n \"description\": \"Disable Two-factor authentication\",\n \"operationId\": \"DisableTwoFactor\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PasswordRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/settings/enabled\": {\n \"put\": {\n \"description\": \"Enable Two-factor authentication\",\n \"operationId\": \"EnableTwoFactor\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PasswordRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/totp\": {\n \"post\": {\n \"description\": \"Configure a TOTP\",\n \"operationId\": \"ConfigurerTotp\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TotpRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/totp/-\": {\n \"delete\": {\n \"operationId\": \"DeleteTotp\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PasswordRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/totp/auth-link\": {\n \"get\": {\n \"description\": \"Get TOTP auth link, including secret\",\n \"operationId\": \"GetTotpAuthLink\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TotpAuthLinkResponse\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/devices\": {\n \"get\": {\n \"description\": \"List all user devices\",\n \"operationId\": \"ListDevices\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/UserDevice\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/devices/{deviceId}\": {\n \"delete\": {\n \"description\": \"Revoke a own device\",\n \"operationId\": \"RevokeDevice\",\n \"parameters\": [\n {\n \"description\": \"Device ID\",\n \"in\": \"path\",\n \"name\": \"deviceId\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"204 NO_CONTENT\": {\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens\": {\n \"get\": {\n \"description\": \"Obtain PAT list.\",\n \"operationId\": \"ObtainPats\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Generate a PAT.\",\n \"operationId\": \"GeneratePat\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens/{name}\": {\n \"delete\": {\n \"description\": \"Delete a PAT\",\n \"operationId\": \"DeletePat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n },\n \"get\": {\n \"description\": \"Obtain a PAT.\",\n \"operationId\": \"ObtainPat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens/{name}/actions/restoration\": {\n \"put\": {\n \"description\": \"Restore a PAT.\",\n \"operationId\": \"RestorePat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens/{name}/actions/revocation\": {\n \"put\": {\n \"description\": \"Revoke a PAT\",\n \"operationId\": \"RevokePat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.storage.halo.run/v1alpha1/attachments\": {\n \"get\": {\n \"description\": \"List attachments of the current user uploaded.\",\n \"operationId\": \"ListMyAttachments\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Filter attachments without group. This parameter will ignore group parameter.\",\n \"in\": \"query\",\n \"name\": \"ungrouped\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n },\n {\n \"description\": \"Keyword for searching.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Acceptable media types.\",\n \"in\": \"query\",\n \"name\": \"accepts\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AttachmentList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"deprecated\": true,\n \"description\": \"Create attachment for the given post. Deprecated in favor of /attachments/-/upload.\",\n \"operationId\": \"CreateAttachmentForPost\",\n \"parameters\": [\n {\n \"description\": \"Wait for permalink.\",\n \"in\": \"query\",\n \"name\": \"waitForPermalink\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostAttachmentRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.storage.halo.run/v1alpha1/attachments/-/upload\": {\n \"post\": {\n \"description\": \"Upload attachment to user center storage.\",\n \"operationId\": \"UploadAttachmentForUc\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UploadForm\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.storage.halo.run/v1alpha1/attachments/-/upload-from-url\": {\n \"post\": {\n \"deprecated\": true,\n \"description\": \"Upload attachment from the given URL.\\nDeprecated in favor of /attachments/-/upload.\",\n \"operationId\": \"ExternalTransferAttachment_1\",\n \"parameters\": [\n {\n \"description\": \"Wait for permalink.\",\n \"in\": \"query\",\n \"name\": \"waitForPermalink\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UcUploadFromUrlRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n }\n },\n \"/system/setup\": {\n \"get\": {\n \"description\": \"Jump to setup page\",\n \"operationId\": \"JumpToSetupPage\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"text/html\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemV1alpha1Public\"\n ]\n },\n \"post\": {\n \"description\": \"Setup system\",\n \"operationId\": \"SetupSystem\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SetupRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"content\": {},\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"SystemV1alpha1Public\"\n ]\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"AddOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"add\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"AnnotationSetting\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AnnotationSettingSpec\"\n }\n }\n },\n \"AnnotationSettingList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AnnotationSettingSpec\": {\n \"required\": [\n \"formSchema\",\n \"targetRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"formSchema\": {\n \"minLength\": 1,\n \"type\": \"array\",\n \"items\": {\n \"minLength\": 1,\n \"type\": \"object\"\n }\n },\n \"targetRef\": {\n \"$ref\": \"#/components/schemas/GroupKind\"\n }\n }\n },\n \"Attachment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AttachmentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/AttachmentStatus\"\n }\n }\n },\n \"AttachmentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AttachmentSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of attachment\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"Group name\"\n },\n \"mediaType\": {\n \"type\": \"string\",\n \"description\": \"Media type of attachment\"\n },\n \"ownerName\": {\n \"type\": \"string\",\n \"description\": \"Name of User who uploads the attachment\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Policy name\"\n },\n \"size\": {\n \"minimum\": 0,\n \"type\": \"integer\",\n \"description\": \"Size of attachment. Unit is Byte\",\n \"format\": \"int64\"\n },\n \"tags\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Tags of attachment\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Tag name\"\n }\n }\n }\n },\n \"AttachmentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\",\n \"description\": \"Permalink of attachment.\\nIf it is in local storage, the public URL will be set.\\nIf it is in s3 storage, the Object URL will be set.\\n\"\n },\n \"thumbnails\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"AuthProvider\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AuthProviderSpec\"\n }\n },\n \"description\": \"Auth provider extension.\"\n },\n \"AuthProviderList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AuthProviderSpec\": {\n \"required\": [\n \"authType\",\n \"authenticationUrl\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"authType\": {\n \"type\": \"string\",\n \"description\": \"Auth type: form or oauth2.\",\n \"enum\": [\n \"FORM\",\n \"OAUTH2\"\n ]\n },\n \"authenticationUrl\": {\n \"type\": \"string\",\n \"description\": \"Authentication url of the auth provider\"\n },\n \"bindingUrl\": {\n \"type\": \"string\"\n },\n \"configMapRef\": {\n \"$ref\": \"#/components/schemas/ConfigMapRef\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of the auth provider\"\n },\n \"helpPage\": {\n \"type\": \"string\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"method\": {\n \"type\": \"string\"\n },\n \"rememberMeSupport\": {\n \"type\": \"boolean\"\n },\n \"settingRef\": {\n \"$ref\": \"#/components/schemas/SettingRef\"\n },\n \"unbindUrl\": {\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"Author\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"Backup\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/BackupSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/BackupStatus\"\n }\n }\n },\n \"BackupFile\": {\n \"type\": \"object\",\n \"properties\": {\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Filename of backup file.\"\n },\n \"lastModifiedTime\": {\n \"type\": \"string\",\n \"description\": \"Last modified time of backup file.\",\n \"format\": \"date-time\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of backup file.\",\n \"format\": \"int64\"\n }\n },\n \"description\": \"Backup file.\"\n },\n \"BackupList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"BackupSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"expiresAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"format\": {\n \"type\": \"string\",\n \"description\": \"Backup file format. Currently, only zip format is supported.\"\n }\n }\n },\n \"BackupStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"completionTimestamp\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"failureMessage\": {\n \"type\": \"string\"\n },\n \"failureReason\": {\n \"type\": \"string\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Name of backup file.\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"RUNNING\",\n \"SUCCEEDED\",\n \"FAILED\"\n ]\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of backup file. Data unit: byte\",\n \"format\": \"int64\"\n },\n \"startTimestamp\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n }\n }\n },\n \"Category\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CategorySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CategoryStatus\"\n }\n }\n },\n \"CategoryList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CategorySpec\": {\n \"required\": [\n \"displayName\",\n \"priority\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eWhether to hide the category from the category list.\\u003c/p\\u003e\\n \\u003cp\\u003eWhen set to true, the category including its subcategories and related posts will\\n not be displayed in the category list, but it can still be accessed by permalink.\\u003c/p\\u003e\\n \\u003cp\\u003eLimitation: It only takes effect on the theme-side categorized list and it only\\n allows to be set to true on the first level(root node) of categories.\\u003c/p\\u003e\"\n },\n \"postTemplate\": {\n \"maxLength\": 255,\n \"type\": \"string\",\n \"description\": \"\\u003cp\\u003eUsed to specify the template for the posts associated with the category.\\u003c/p\\u003e\\n \\u003cp\\u003eThe priority is not as high as that of the post.\\u003c/p\\u003e\\n \\u003cp\\u003eIf the post also specifies a template, the post\\u0027s template will prevail.\\u003c/p\\u003e\"\n },\n \"preventParentPostCascadeQuery\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eif a category is queried for related posts, the default behavior is to\\n query all posts under the category including its subcategories, but if this field is\\n set to true, cascade query behavior will be terminated here.\\u003c/p\\u003e\\n \\u003cp\\u003eFor example, if a category has subcategories A and B, and A has subcategories C and\\n D and C marked this field as true, when querying posts under A category,all posts under A\\n and B will be queried, but C and D will not be queried.\\u003c/p\\u003e\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"maxLength\": 255,\n \"type\": \"string\"\n }\n }\n },\n \"CategoryStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的已发布且公开的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n }\n }\n },\n \"CategoryVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CategorySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CategoryStatus\"\n }\n },\n \"description\": \"A value object for {@link Category Category}.\"\n },\n \"CategoryVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ChangeOwnPasswordRequest\": {\n \"required\": [\n \"oldPassword\",\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"oldPassword\": {\n \"type\": \"string\",\n \"description\": \"Old password.\"\n },\n \"password\": {\n \"minLength\": 5,\n \"type\": \"string\",\n \"description\": \"New password.\"\n }\n }\n },\n \"ChangePasswordRequest\": {\n \"required\": [\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"password\": {\n \"minLength\": 5,\n \"type\": \"string\",\n \"description\": \"New password.\"\n }\n }\n },\n \"Comment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n }\n },\n \"CommentEmailOwner\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\",\n \"description\": \"avatar for comment owner\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"display name for comment owner\"\n },\n \"email\": {\n \"type\": \"string\",\n \"description\": \"email for comment owner\"\n },\n \"website\": {\n \"type\": \"string\",\n \"description\": \"website for comment owner\"\n }\n },\n \"description\": \"\\u003cp\\u003eThe creator info of the comment.\\u003c/p\\u003e\\n This {@link CommentEmailOwner CommentEmailOwner} is only applicable to the user who is allowed to comment\\n without logging in.\"\n },\n \"CommentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CommentOwner\": {\n \"required\": [\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"maxLength\": 64,\n \"type\": \"string\"\n }\n }\n },\n \"CommentRequest\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"subjectRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentEmailOwner\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n },\n \"description\": \"Request parameter object for {@link Comment Comment}.\"\n },\n \"CommentSpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"subjectRef\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"lastReadTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"CommentStats\": {\n \"type\": \"object\",\n \"properties\": {\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"comment stats value object.\"\n },\n \"CommentStatsVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"comment stats value object.\"\n },\n \"CommentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"hasNewReply\": {\n \"type\": \"boolean\"\n },\n \"lastReplyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"replyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"unreadReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visibleReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"CommentVo\": {\n \"required\": [\n \"metadata\",\n \"owner\",\n \"spec\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"CommentVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CommentVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CommentWithReplyVo\": {\n \"required\": [\n \"metadata\",\n \"owner\",\n \"spec\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"replies\": {\n \"$ref\": \"#/components/schemas/ListResultReplyVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"CommentWithReplyVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CommentWithReplyVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Condition\": {\n \"required\": [\n \"lastTransitionTime\",\n \"status\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastTransitionTime\": {\n \"type\": \"string\",\n \"description\": \"Last time the condition transitioned from one status to another.\",\n \"format\": \"date-time\"\n },\n \"message\": {\n \"maxLength\": 32768,\n \"type\": \"string\",\n \"description\": \"Human-readable message indicating details about last transition.\\n This may be an empty string.\"\n },\n \"reason\": {\n \"maxLength\": 1024,\n \"pattern\": \"^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$\",\n \"type\": \"string\",\n \"description\": \"Unique, one-word, CamelCase reason for the condition\\u0027s last transition.\"\n },\n \"status\": {\n \"type\": \"string\",\n \"description\": \"Status is the status of the condition. Can be True, False, Unknown.\",\n \"enum\": [\n \"TRUE\",\n \"FALSE\",\n \"UNKNOWN\"\n ]\n },\n \"type\": {\n \"maxLength\": 316,\n \"pattern\": \"^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$\",\n \"type\": \"string\",\n \"description\": \"type of condition in CamelCase or in foo.example.com/CamelCase.\\n example: Ready, Initialized.\\n maxLength: 316.\"\n }\n },\n \"description\": \"EqualsAndHashCode 排除了lastTransitionTime否则失败时，lastTransitionTime 会被更新\\n 导致 equals 为 false，一直被加入队列.\"\n },\n \"ConfigMap\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n }\n },\n \"description\": \"\\u003cp\\u003eConfigMap holds configuration data to consume.\\u003c/p\\u003e\"\n },\n \"ConfigMapList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ConfigMapRef\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"Content\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"rawType\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"type\": \"string\"\n }\n }\n },\n \"ContentUpdateParam\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"rawType\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"ContentVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"A value object for Content from {@link Snapshot Snapshot}.\"\n },\n \"ContentWrapper\": {\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"type\": \"string\"\n },\n \"snapshotName\": {\n \"type\": \"string\"\n }\n }\n },\n \"Contributor\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Contributor from user.\"\n },\n \"ContributorVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"permalink\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"A value object for {@link run.halo.app.core.extension.User run.halo.app.core.extension.User}.\"\n },\n \"CopyOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"copy\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"Counter\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"approvedComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"downvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"totalComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"A counter for number of requests by extension resource name.\"\n },\n \"CounterList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CounterRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\"\n },\n \"hostname\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"plural\": {\n \"type\": \"string\"\n },\n \"referrer\": {\n \"type\": \"string\"\n },\n \"screen\": {\n \"type\": \"string\"\n }\n }\n },\n \"CreateUserRequest\": {\n \"required\": [\n \"email\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"phone\": {\n \"type\": \"string\"\n },\n \"roles\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"CustomTemplates\": {\n \"type\": \"object\",\n \"properties\": {\n \"category\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n },\n \"page\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n },\n \"post\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n }\n }\n },\n \"DashboardStats\": {\n \"type\": \"object\",\n \"properties\": {\n \"approvedComments\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"comments\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"posts\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"upvotes\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"users\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"visits\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"DetailedUser\": {\n \"required\": [\n \"roles\",\n \"user\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"user\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"Device\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/DeviceSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/DeviceStatus\"\n }\n }\n },\n \"DeviceList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"DeviceSpec\": {\n \"required\": [\n \"ipAddress\",\n \"principalName\",\n \"sessionId\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"ipAddress\": {\n \"maxLength\": 129,\n \"type\": \"string\"\n },\n \"lastAccessedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"lastAuthenticatedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"principalName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"rememberMeSeriesId\": {\n \"type\": \"string\"\n },\n \"sessionId\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"userAgent\": {\n \"maxLength\": 500,\n \"type\": \"string\"\n }\n }\n },\n \"DeviceStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"browser\": {\n \"type\": \"string\"\n },\n \"os\": {\n \"type\": \"string\"\n }\n }\n },\n \"EmailConfigValidationRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Gets email display name.\"\n },\n \"enable\": {\n \"type\": \"boolean\"\n },\n \"encryption\": {\n \"type\": \"string\"\n },\n \"host\": {\n \"type\": \"string\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"port\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"sender\": {\n \"type\": \"string\",\n \"description\": \"Gets email sender address.\"\n },\n \"username\": {\n \"type\": \"string\"\n }\n }\n },\n \"EmailVerifyRequest\": {\n \"required\": [\n \"email\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"email\": {\n \"type\": \"string\",\n \"format\": \"email\"\n }\n }\n },\n \"Excerpt\": {\n \"required\": [\n \"autoGenerate\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"autoGenerate\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"raw\": {\n \"type\": \"string\"\n }\n }\n },\n \"Extension\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n }\n },\n \"description\": \"Extension is an interface which represents an Extension. It contains setters and getters of\\n GroupVersionKind and Metadata.\"\n },\n \"ExtensionDefinition\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ExtensionSpec\"\n }\n },\n \"description\": \"Extension definition.\\n An {@link ExtensionDefinition ExtensionDefinition} is a type of metadata that provides additional information about\\n an extension. An extension is a way to add new functionality to an existing class, structure,\\n enumeration, or protocol type without needing to subclass it.\"\n },\n \"ExtensionDefinitionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ExtensionPointDefinition\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ExtensionPointSpec\"\n }\n },\n \"description\": \"Extension point definition.\\n An {@link ExtensionPointDefinition ExtensionPointDefinition} is a concept used in \\u003ccode\\u003eHalo\\u003c/code\\u003e to allow for the\\n dynamic extension of system. It defines a location within \\u003ccode\\u003eHalo\\u003c/code\\u003e where\\n additional functionality can be added through the use of plugins or extensions.\"\n },\n \"ExtensionPointDefinitionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ExtensionPointSpec\": {\n \"required\": [\n \"className\",\n \"displayName\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"className\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"SINGLETON\",\n \"MULTI_INSTANCE\"\n ]\n }\n }\n },\n \"ExtensionSpec\": {\n \"required\": [\n \"className\",\n \"displayName\",\n \"extensionPointName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"className\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"extensionPointName\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n }\n }\n },\n \"FileReverseProxyProvider\": {\n \"type\": \"object\",\n \"properties\": {\n \"directory\": {\n \"type\": \"string\"\n },\n \"filename\": {\n \"type\": \"string\"\n }\n }\n },\n \"GrantRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"roles\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"Group\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/GroupSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/GroupStatus\"\n }\n }\n },\n \"GroupKind\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"is group name of Extension.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"is kind name of Extension.\"\n }\n },\n \"description\": \"GroupKind contains group and kind data only.\"\n },\n \"GroupList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"GroupSpec\": {\n \"required\": [\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of group\"\n }\n }\n },\n \"GroupStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"totalAttachments\": {\n \"minimum\": 0,\n \"type\": \"integer\",\n \"description\": \"Total of attachments under the current group\",\n \"format\": \"int64\"\n },\n \"updateTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Update timestamp of the group\",\n \"format\": \"date-time\"\n }\n }\n },\n \"HaloDocument\": {\n \"required\": [\n \"content\",\n \"id\",\n \"metadataName\",\n \"ownerName\",\n \"permalink\",\n \"title\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Custom metadata. Make sure the map is serializable.\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"description\": \"Document categories. The item in the list is the category metadata name.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document content. Safety content, without HTML tag.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Document creation timestamp.\",\n \"format\": \"date-time\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Document description.\"\n },\n \"exposed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the document is exposed to the public.\"\n },\n \"id\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document ID. It should be unique globally.\"\n },\n \"metadataName\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Metadata name of the corresponding extension.\"\n },\n \"ownerName\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document owner metadata name.\"\n },\n \"permalink\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document permalink.\"\n },\n \"published\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the document is published.\"\n },\n \"recycled\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the document is recycled.\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"description\": \"Document tags. The item in the list is the tag metadata name.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document title.\"\n },\n \"type\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document type. e.g.: post.content.halo.run, singlepage.content.halo.run, moment.moment\\n .halo.run, doc.doc.halo.run.\"\n },\n \"updateTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Document update timestamp.\",\n \"format\": \"date-time\"\n }\n },\n \"description\": \"Document for search.\"\n },\n \"IAvatarUploadRequest\": {\n \"required\": [\n \"file\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n }\n }\n },\n \"IUploadRequest\": {\n \"required\": [\n \"file\",\n \"policyName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"The name of the group to which the attachment belongs\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Storage policy name\"\n }\n }\n },\n \"InstallFromUriRequest\": {\n \"required\": [\n \"uri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"uri\": {\n \"type\": \"string\",\n \"format\": \"uri\"\n }\n }\n },\n \"InterestReason\": {\n \"required\": [\n \"reasonType\",\n \"subject\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"expression\": {\n \"type\": \"string\",\n \"description\": \"The expression to be interested in\"\n },\n \"reasonType\": {\n \"type\": \"string\",\n \"description\": \"The name of the reason definition to be interested in\"\n },\n \"subject\": {\n \"$ref\": \"#/components/schemas/InterestReasonSubject\"\n }\n },\n \"description\": \"The reason to be interested in\"\n },\n \"InterestReasonSubject\": {\n \"required\": [\n \"apiVersion\",\n \"kind\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"kind\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"if name is not specified, it presents all subjects of the specified reason type and custom resources\"\n }\n },\n \"description\": \"The subject name of reason type to be interested in\"\n },\n \"JsonPatch\": {\n \"minItems\": 1,\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"JSON schema for JSONPatch operations\",\n \"items\": {\n \"oneOf\": [\n {\n \"$ref\": \"#/components/schemas/AddOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/ReplaceOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/TestOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/RemoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/MoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/CopyOperation\"\n }\n ]\n }\n },\n \"License\": {\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Common data objects for license.\"\n },\n \"ListResultReplyVo\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReplyVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedAuthProvider\": {\n \"required\": [\n \"displayName\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"authType\": {\n \"type\": \"string\",\n \"enum\": [\n \"FORM\",\n \"OAUTH2\"\n ]\n },\n \"authenticationUrl\": {\n \"type\": \"string\"\n },\n \"bindingUrl\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"helpPage\": {\n \"type\": \"string\"\n },\n \"isBound\": {\n \"type\": \"boolean\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"privileged\": {\n \"type\": \"boolean\"\n },\n \"supportsBinding\": {\n \"type\": \"boolean\"\n },\n \"unbindingUrl\": {\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"A listed value object for {@link run.halo.app.core.extension.AuthProvider run.halo.app.core.extension.AuthProvider}.\"\n },\n \"ListedComment\": {\n \"required\": [\n \"comment\",\n \"owner\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"comment\": {\n \"$ref\": \"#/components/schemas/Comment\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStats\"\n },\n \"subject\": {\n \"$ref\": \"#/components/schemas/Extension\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedCommentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedComment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedPost\": {\n \"required\": [\n \"categories\",\n \"contributors\",\n \"owner\",\n \"post\",\n \"stats\",\n \"tags\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n }\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n },\n \"post\": {\n \"$ref\": \"#/components/schemas/Post\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/Stats\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedPostList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedPost\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedPostVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n }\n },\n \"description\": \"A value object for {@link Post Post}.\"\n },\n \"ListedPostVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedReply\": {\n \"required\": [\n \"owner\",\n \"reply\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"reply\": {\n \"$ref\": \"#/components/schemas/Reply\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStats\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedReplyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedReply\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedSinglePage\": {\n \"required\": [\n \"contributors\",\n \"owner\",\n \"page\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n }\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n },\n \"page\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/Stats\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedSinglePageList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSinglePage\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedSinglePageVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedSinglePageVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSinglePageVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedSnapshotDto\": {\n \"required\": [\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ListedSnapshotSpec\"\n }\n }\n },\n \"ListedSnapshotSpec\": {\n \"required\": [\n \"owner\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"modifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"type\": \"string\"\n }\n }\n },\n \"ListedUser\": {\n \"required\": [\n \"roles\",\n \"user\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"user\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"LocalThumbnail\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/LocalThumbnailSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/LocalThumbnailStatus\"\n }\n }\n },\n \"LocalThumbnailList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"LocalThumbnailSpec\": {\n \"required\": [\n \"filePath\",\n \"imageSignature\",\n \"imageUri\",\n \"size\",\n \"thumbSignature\",\n \"thumbnailUri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"filePath\": {\n \"type\": \"string\",\n \"description\": \"Consider the compatibility of the system and migration, use unix-style relative paths\\n here.\"\n },\n \"imageSignature\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"A hash signature for the image uri.\"\n },\n \"imageUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"string\",\n \"enum\": [\n \"S\",\n \"M\",\n \"L\",\n \"XL\"\n ]\n },\n \"thumbSignature\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"A hash signature for the thumbnail uri.\"\n },\n \"thumbnailUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"LocalThumbnailStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"SUCCEEDED\",\n \"FAILED\"\n ]\n }\n }\n },\n \"MarkSpecifiedRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"names\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"Menu\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuSpec\"\n }\n }\n },\n \"MenuItem\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuItemSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/MenuItemStatus\"\n }\n }\n },\n \"MenuItemList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"MenuItemSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Children of this menu item\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"The name of menu item child\"\n }\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"The display name of menu item.\"\n },\n \"href\": {\n \"type\": \"string\",\n \"description\": \"The href of this menu item.\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"description\": \"The priority is for ordering.\",\n \"format\": \"int32\"\n },\n \"target\": {\n \"type\": \"string\",\n \"description\": \"The \\u003ca\\u003e target attribute of this menu item.\",\n \"enum\": [\n \"_blank\",\n \"_self\",\n \"_parent\",\n \"_top\"\n ]\n },\n \"targetRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n }\n },\n \"MenuItemStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Calculated Display name of menu item.\"\n },\n \"href\": {\n \"type\": \"string\",\n \"description\": \"Calculated href of manu item.\"\n }\n }\n },\n \"MenuItemVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/MenuItemVo\"\n }\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Gets menu item\\u0027s display name.\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"parentName\": {\n \"type\": \"string\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuItemSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/MenuItemStatus\"\n }\n },\n \"description\": \"A value object for {@link MenuItem MenuItem}.\"\n },\n \"MenuList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"MenuSpec\": {\n \"required\": [\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"The display name of the menu.\"\n },\n \"menuItems\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Menu items of this menu.\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Name of menu item.\"\n }\n }\n }\n },\n \"MenuVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"menuItems\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/MenuItemVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuSpec\"\n }\n },\n \"description\": \"A value object for {@link Menu Menu}.\"\n },\n \"Metadata\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Annotations are like key-value format.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Creation timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"deletionTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Deletion timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"finalizers\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"nullable\": true,\n \"items\": {\n \"type\": \"string\",\n \"nullable\": true\n }\n },\n \"generateName\": {\n \"type\": \"string\",\n \"description\": \"The name field will be generated automatically according to the given generateName field\"\n },\n \"labels\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Labels are like key-value format.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Metadata name\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Current version of the Extension. It will be bumped up every update.\",\n \"format\": \"int64\",\n \"nullable\": true\n }\n },\n \"description\": \"Metadata of Extension.\"\n },\n \"MoveOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"move\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"NavigationPostVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"next\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n },\n \"previous\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n }\n },\n \"description\": \"Post navigation vo to hold previous and next item.\"\n },\n \"Notification\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotificationSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Notification Notification} is a custom extension that used to store notification information for\\n inner use, it\\u0027s on-site notification.\\u003c/p\\u003e\\n\\n \\u003cp\\u003eSupports the following operations:\\u003c/p\\u003e\\n \\u003cul\\u003e\\n \\u003cli\\u003eMarked as read: {@link NotificationSpec#setUnread(boolean) NotificationSpec#setUnread(boolean)}\\u003c/li\\u003e\\n \\u003cli\\u003eGet the last read time: {@link NotificationSpec#getLastReadAt NotificationSpec#getLastReadAt()}\\u003c/li\\u003e\\n \\u003cli\\u003eFilter by recipient: {@link NotificationSpec#getRecipient NotificationSpec#getRecipient()}\\u003c/li\\u003e\\n \\u003c/ul\\u003e\"\n },\n \"NotificationList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotificationSpec\": {\n \"required\": [\n \"htmlContent\",\n \"rawContent\",\n \"reason\",\n \"recipient\",\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"htmlContent\": {\n \"type\": \"string\"\n },\n \"lastReadAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"rawContent\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"The name of reason\"\n },\n \"recipient\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"The name of user\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"unread\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"NotificationTemplate\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotificationTemplateSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link NotificationTemplate NotificationTemplate} is a custom extension that defines a notification template.\\u003c/p\\u003e\\n \\u003cp\\u003eIt describes the notification template\\u0027s name, description, and the template content.\\u003c/p\\u003e\\n \\u003cp\\u003e{@link Spec#getReasonSelector Spec#getReasonSelector()} is used to select the template by reasonType and language,\\n if multiple templates are matched, the best match will be selected. This is useful when you\\n want to override the default template.\\u003c/p\\u003e\"\n },\n \"NotificationTemplateList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotificationTemplateSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"reasonSelector\": {\n \"$ref\": \"#/components/schemas/ReasonSelector\"\n },\n \"template\": {\n \"$ref\": \"#/components/schemas/TemplateContent\"\n }\n }\n },\n \"NotifierDescriptor\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptorSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link NotifierDescriptor NotifierDescriptor} is a custom extension that defines a notifier.\\u003c/p\\u003e\\n \\u003cp\\u003eIt describes the notifier\\u0027s name, description, and the extension name of the notifier to\\n let the user know what the notifier is and what it can do in the UI and also let the\\n \\u003ccode\\u003eNotificationCenter\\u003c/code\\u003e know how to load the notifier and prepare the notifier\\u0027s settings.\\u003c/p\\u003e\"\n },\n \"NotifierDescriptorList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotifierDescriptorSpec\": {\n \"required\": [\n \"displayName\",\n \"notifierExtName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"notifierExtName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"receiverSettingRef\": {\n \"$ref\": \"#/components/schemas/NotifierSettingRef\"\n },\n \"senderSettingRef\": {\n \"$ref\": \"#/components/schemas/NotifierSettingRef\"\n }\n }\n },\n \"NotifierInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n }\n },\n \"NotifierSettingRef\": {\n \"required\": [\n \"group\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n }\n },\n \"OwnerInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Comment owner info.\"\n },\n \"PasswordRequest\": {\n \"required\": [\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"password\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"PatSpec\": {\n \"required\": [\n \"name\",\n \"tokenId\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"expiresAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"lastUsed\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"revoked\": {\n \"type\": \"boolean\"\n },\n \"revokesAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"scopes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"tokenId\": {\n \"type\": \"string\"\n },\n \"username\": {\n \"type\": \"string\"\n }\n }\n },\n \"PersonalAccessToken\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PatSpec\"\n }\n }\n },\n \"PersonalAccessTokenList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Plugin\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PluginSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PluginStatus\"\n }\n },\n \"description\": \"A custom resource for Plugin.\"\n },\n \"PluginAuthor\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"PluginInstallRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"presetName\": {\n \"type\": \"string\",\n \"description\": \"Plugin preset name. We will find the plugin from plugin presets\"\n },\n \"source\": {\n \"type\": \"string\",\n \"description\": \"Install source. Default is file.\",\n \"enum\": [\n \"FILE\",\n \"PRESET\",\n \"URL\"\n ]\n }\n }\n },\n \"PluginList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PluginRunningStateRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"async\": {\n \"type\": \"boolean\"\n },\n \"enable\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"PluginSpec\": {\n \"required\": [\n \"version\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"author\": {\n \"$ref\": \"#/components/schemas/PluginAuthor\"\n },\n \"configMapName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"issues\": {\n \"type\": \"string\"\n },\n \"license\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/License\"\n }\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"pluginDependencies\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"repo\": {\n \"type\": \"string\"\n },\n \"requires\": {\n \"type\": \"string\",\n \"description\": \"SemVer format.\"\n },\n \"settingName\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"pattern\": \"^(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)(?:-((?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\\\.(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\\\+([0-9a-zA-Z-]+(?:\\\\.[0-9a-zA-Z-]+)*))?$\",\n \"type\": \"string\",\n \"description\": \"plugin version.\"\n }\n }\n },\n \"PluginStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"entry\": {\n \"type\": \"string\"\n },\n \"lastProbeState\": {\n \"type\": \"string\",\n \"enum\": [\n \"CREATED\",\n \"DISABLED\",\n \"RESOLVED\",\n \"STARTED\",\n \"STOPPED\",\n \"FAILED\",\n \"UNLOADED\"\n ]\n },\n \"lastStartTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"loadLocation\": {\n \"type\": \"string\",\n \"description\": \"Load location of the plugin, often a path.\",\n \"format\": \"uri\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"STARTING\",\n \"CREATED\",\n \"DISABLING\",\n \"DISABLED\",\n \"RESOLVED\",\n \"STARTED\",\n \"STOPPED\",\n \"FAILED\",\n \"UNKNOWN\"\n ]\n },\n \"stylesheet\": {\n \"type\": \"string\"\n }\n }\n },\n \"Policy\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PolicySpec\"\n }\n }\n },\n \"PolicyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PolicyRule\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroups\": {\n \"type\": \"array\",\n \"description\": \"APIGroups is the name of the APIGroup that contains the resources.\\n If multiple API groups are specified, any action requested against one of the enumerated\\n resources in any API group will be allowed.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"nonResourceURLs\": {\n \"type\": \"array\",\n \"description\": \"NonResourceURLs is a set of partial urls that a user should have access to.\\n *s are allowed, but only as the full, final step in the path\\n If an action is not a resource API request, then the URL is split on \\u0027/\\u0027 and is checked\\n against the NonResourceURLs to look for a match.\\n Since non-resource URLs are not namespaced, this field is only applicable for\\n ClusterRoles referenced from a ClusterRoleBinding.\\n Rules can either apply to API resources (such as \\\"pods\\\" or \\\"secrets\\\") or non-resource\\n URL paths (such as \\\"/api\\\"), but not both.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"resourceNames\": {\n \"type\": \"array\",\n \"description\": \"ResourceNames is an optional white list of names that the rule applies to. An empty set\\n means that everything is allowed.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"resources\": {\n \"type\": \"array\",\n \"description\": \"Resources is a list of resources this rule applies to. \\u0027*\\u0027 represents all resources in\\n the specified apiGroups.\\n \\u0027*\\u0026#47;foo\\u0027 represents the subresource \\u0027foo\\u0027 for all resources in the specified\\n apiGroups.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"verbs\": {\n \"type\": \"array\",\n \"description\": \"about who the rule applies to or which namespace the rule applies to.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"PolicyRule holds information that describes a policy rule, but does not contain information\\n about whom the rule applies to or which namespace the rule applies to.\"\n },\n \"PolicySpec\": {\n \"required\": [\n \"displayName\",\n \"templateName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"configMapName\": {\n \"type\": \"string\",\n \"description\": \"Reference name of ConfigMap extension\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of policy\"\n },\n \"templateName\": {\n \"type\": \"string\",\n \"description\": \"Reference name of PolicyTemplate\"\n }\n }\n },\n \"PolicyTemplate\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PolicyTemplateSpec\"\n }\n }\n },\n \"PolicyTemplateList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PolicyTemplateSpec\": {\n \"required\": [\n \"settingName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\"\n },\n \"settingName\": {\n \"type\": \"string\"\n }\n }\n },\n \"Post\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003ePost extension.\\u003c/p\\u003e\"\n },\n \"PostAttachmentRequest\": {\n \"required\": [\n \"file\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"postName\": {\n \"type\": \"string\",\n \"description\": \"Post name.\"\n },\n \"singlePageName\": {\n \"type\": \"string\",\n \"description\": \"Single page name.\"\n }\n }\n },\n \"PostList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PostRequest\": {\n \"required\": [\n \"content\",\n \"post\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentUpdateParam\"\n },\n \"post\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n },\n \"description\": \"Post and content data for creating and updating post.\"\n },\n \"PostSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"文章引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"PostStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"PostVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n },\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentVo\"\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n }\n },\n \"description\": \"A value object for {@link Post Post}.\"\n },\n \"Reason\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReasonSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Reason Reason} is a custom extension that defines a reason for a notification, It represents\\n an instance of a {@link ReasonType ReasonType}.\\u003c/p\\u003e\\n \\u003cp\\u003eIt can be understood as an event that triggers a notification.\\u003c/p\\u003e\"\n },\n \"ReasonAttributes\": {\n \"type\": \"object\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"description\": \"Attributes used to transfer data\"\n },\n \"ReasonList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReasonProperty\": {\n \"required\": [\n \"name\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"optional\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"type\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"ReasonSelector\": {\n \"required\": [\n \"language\",\n \"reasonType\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"language\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"default\": \"default\"\n },\n \"reasonType\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"ReasonSpec\": {\n \"required\": [\n \"author\",\n \"reasonType\",\n \"subject\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"attributes\": {\n \"$ref\": \"#/components/schemas/ReasonAttributes\"\n },\n \"author\": {\n \"type\": \"string\"\n },\n \"reasonType\": {\n \"type\": \"string\"\n },\n \"subject\": {\n \"$ref\": \"#/components/schemas/ReasonSubject\"\n }\n }\n },\n \"ReasonSubject\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"name\",\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReasonType\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReasonTypeSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link ReasonType ReasonType} is a custom extension that defines a type of reason.\\u003c/p\\u003e\\n \\u003cp\\u003eOne {@link ReasonType ReasonType} can have multiple {@link Reason Reason}s to notify.\\u003c/p\\u003e\"\n },\n \"ReasonTypeInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"uiPermissions\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"ReasonTypeList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReasonTypeNotifierCollectionRequest\": {\n \"required\": [\n \"reasonTypeNotifiers\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"reasonTypeNotifiers\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierRequest\"\n }\n }\n }\n },\n \"ReasonTypeNotifierMatrix\": {\n \"type\": \"object\",\n \"properties\": {\n \"notifiers\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/NotifierInfo\"\n }\n },\n \"reasonTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonTypeInfo\"\n }\n },\n \"stateMatrix\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"boolean\"\n }\n }\n }\n }\n },\n \"ReasonTypeNotifierRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"notifiers\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"reasonType\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReasonTypeSpec\": {\n \"required\": [\n \"description\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"properties\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonProperty\"\n }\n }\n }\n },\n \"Ref\": {\n \"required\": [\n \"group\",\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"Extension group\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Extension kind\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Extension name. This field is mandatory\"\n },\n \"version\": {\n \"type\": \"string\",\n \"description\": \"Extension version\"\n }\n },\n \"description\": \"Extension reference object. The name is mandatory\"\n },\n \"RememberMeToken\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/RememberMeTokenSpec\"\n }\n }\n },\n \"RememberMeTokenList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RememberMeTokenSpec\": {\n \"required\": [\n \"series\",\n \"tokenValue\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastUsed\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"series\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tokenValue\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"username\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"RemoveOperation\": {\n \"required\": [\n \"op\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"remove\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"ReplaceOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"replace\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Reply\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReplySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ReplyStatus\"\n }\n }\n },\n \"ReplyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReplyRequest\": {\n \"required\": [\n \"content\",\n \"raw\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentEmailOwner\"\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n },\n \"description\": \"A request parameter object for {@link Reply Reply}.\"\n },\n \"ReplySpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"commentName\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"commentName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReplyStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReplyVo\": {\n \"required\": [\n \"metadata\",\n \"owner\",\n \"spec\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReplySpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStatsVo\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ReplyVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReplyVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RestoreRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"backupName\": {\n \"type\": \"string\",\n \"description\": \"Backup metadata name.\"\n },\n \"downloadUrl\": {\n \"type\": \"string\",\n \"description\": \"Remote backup HTTP URL.\"\n },\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Filename of backup file in backups root.\"\n }\n }\n },\n \"ReverseProxy\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"rules\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReverseProxyRule\"\n }\n }\n },\n \"description\": \"\\u003cp\\u003eThe reverse proxy custom resource is used to configure a path to proxy it to a directory or\\n file.\\u003c/p\\u003e\\n \\u003cp\\u003eHTTP proxy may be added in the future.\\u003c/p\\u003e\"\n },\n \"ReverseProxyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReverseProxyRule\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"$ref\": \"#/components/schemas/FileReverseProxyProvider\"\n },\n \"path\": {\n \"type\": \"string\"\n }\n }\n },\n \"RevertSnapshotForPostParam\": {\n \"required\": [\n \"snapshotName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"snapshotName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"RevertSnapshotForSingleParam\": {\n \"required\": [\n \"snapshotName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"snapshotName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"Role\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"rules\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"rules\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PolicyRule\"\n }\n }\n }\n },\n \"RoleBinding\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"roleRef\": {\n \"$ref\": \"#/components/schemas/RoleRef\"\n },\n \"subjects\": {\n \"type\": \"array\",\n \"description\": \"Subjects holds references to the objects the role applies to.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Subject\"\n }\n }\n },\n \"description\": \"RoleBinding references a role, but does not contain it.\\n It can reference a Role in the global.\\n It adds who information via Subjects.\"\n },\n \"RoleBindingList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RoleList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RoleRef\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroup\": {\n \"type\": \"string\",\n \"description\": \"APIGroup is the group for the resource being referenced.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Kind is the type of resource being referenced.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Name is the name of resource being referenced.\"\n }\n },\n \"description\": \"RoleRef contains information that points to the role being used.\"\n },\n \"SearchOption\": {\n \"required\": [\n \"keyword\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Additional annotations for extending search option by other search engines.\"\n },\n \"filterExposed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether to filter exposed content. If null, it will not filter.\"\n },\n \"filterPublished\": {\n \"type\": \"boolean\",\n \"description\": \"Whether to filter published content. If null, it will not filter.\"\n },\n \"filterRecycled\": {\n \"type\": \"boolean\",\n \"description\": \"Whether to filter recycled content. If null, it will not filter.\"\n },\n \"highlightPostTag\": {\n \"type\": \"string\",\n \"description\": \"Post HTML tag of highlighted fragment.\"\n },\n \"highlightPreTag\": {\n \"type\": \"string\",\n \"description\": \"Pre HTML tag of highlighted fragment.\"\n },\n \"includeCategoryNames\": {\n \"type\": \"array\",\n \"description\": \"Category names to include(and). If null, it will include all categories.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"includeOwnerNames\": {\n \"type\": \"array\",\n \"description\": \"Owner names to include(or). If null, it will include all owners.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"includeTagNames\": {\n \"type\": \"array\",\n \"description\": \"Tag names to include(and). If null, it will include all tags.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"includeTypes\": {\n \"type\": \"array\",\n \"description\": \"Types to include(or). If null, it will include all types.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"keyword\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Search keyword.\"\n },\n \"limit\": {\n \"maximum\": 1000,\n \"minimum\": 1,\n \"type\": \"integer\",\n \"description\": \"Limit of result.\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Search option. It is used to control search behavior.\"\n },\n \"SearchResult\": {\n \"type\": \"object\",\n \"properties\": {\n \"hits\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/HaloDocument\"\n }\n },\n \"keyword\": {\n \"type\": \"string\"\n },\n \"limit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"processingTimeMillis\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"Secret\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\",\n \"format\": \"byte\"\n },\n \"description\": \"\\u003cp\\u003eThe total bytes of the values in\\n the Data field must be less than {@link run.halo.app.extension.Secret#MAX_SECRET_SIZE #MAX_SECRET_SIZE} bytes.\\u003c/p\\u003e\\n \\u003cp\\u003e\\u003ccode\\u003edata\\u003c/code\\u003e contains the secret data. Each key must consist of alphanumeric\\n characters, \\u0027-\\u0027, \\u0027_\\u0027 or \\u0027.\\u0027. The serialized form of the secret data is a\\n base64 encoded string, representing the arbitrary (possibly non-string)\\n data value here. Described in\\n \\u003ca href\\u003d\\\"https://tools.ietf.org/html/rfc4648#section-4\\\"\\u003erfc4648#section-4\\u003c/a\\u003e\\n \\u003c/p\\u003e\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"stringData\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"\\u003ccode\\u003estringData\\u003c/code\\u003e allows specifying non-binary secret data in string form.\\n It is provided as a write-only input field for convenience.\\n All keys and values are merged into the data field on write, overwriting any existing\\n values.\\n The stringData field is never output when reading from the API.\"\n },\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Used to facilitate programmatic handling of secret data.\\n More info:\\n \\u003ca href\\u003d\\\"https://kubernetes.io/docs/concepts/configuration/secret/#secret-types\\\"\\u003esecret-types\\u003c/a\\u003e\"\n }\n },\n \"description\": \"Secret is a small piece of sensitive data which should be kept secret, such as a password,\\n a token, or a key.\"\n },\n \"SecretList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Setting\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SettingSpec\"\n }\n },\n \"description\": \"{@link Setting Setting} is a custom extension to generate forms based on configuration.\"\n },\n \"SettingForm\": {\n \"minLength\": 1,\n \"required\": [\n \"formSchema\",\n \"group\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"formSchema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"group\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"type\": \"string\"\n }\n }\n },\n \"SettingList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SettingRef\": {\n \"required\": [\n \"group\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"SettingSpec\": {\n \"required\": [\n \"forms\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"forms\": {\n \"minLength\": 1,\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/SettingForm\"\n }\n }\n }\n },\n \"SetupRequest\": {\n \"required\": [\n \"externalUrl\",\n \"password\",\n \"siteTitle\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"email\": {\n \"type\": \"string\",\n \"format\": \"email\"\n },\n \"externalUrl\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"pattern\": \"^(zh-CN|zh-TW|en|es)$\",\n \"type\": \"string\"\n },\n \"password\": {\n \"maxLength\": 257,\n \"minLength\": 5,\n \"pattern\": \"^[A-Za-z0-9!@#$%^\\u0026*.?]+$\",\n \"type\": \"string\"\n },\n \"siteTitle\": {\n \"maxLength\": 80,\n \"minLength\": 0,\n \"type\": \"string\"\n },\n \"username\": {\n \"maxLength\": 63,\n \"minLength\": 4,\n \"pattern\": \"^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$\",\n \"type\": \"string\"\n }\n }\n },\n \"SinglePage\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003eSingle page extension.\\u003c/p\\u003e\"\n },\n \"SinglePageList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SinglePageRequest\": {\n \"required\": [\n \"content\",\n \"page\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentUpdateParam\"\n },\n \"page\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n },\n \"description\": \"A request parameter for {@link SinglePage SinglePage}.\"\n },\n \"SinglePageSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"SinglePageStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"SinglePageVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentVo\"\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"A value object for {@link SinglePage SinglePage}.\"\n },\n \"SiteStatsVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"category\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"comment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"post\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"A value object for site stats.\"\n },\n \"SnapShotSpec\": {\n \"required\": [\n \"owner\",\n \"rawType\",\n \"subjectRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contentPatch\": {\n \"type\": \"string\"\n },\n \"contributors\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"parentSnapshotName\": {\n \"type\": \"string\"\n },\n \"rawPatch\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"maxLength\": 50,\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"such as: markdown | html | json | asciidoc | latex.\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n }\n },\n \"Snapshot\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SnapShotSpec\"\n }\n }\n },\n \"SnapshotList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Stats\": {\n \"type\": \"object\",\n \"properties\": {\n \"approvedComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"totalComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Stats value object.\"\n },\n \"StatsVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"comment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Stats value object.\"\n },\n \"Subject\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroup\": {\n \"type\": \"string\",\n \"description\": \"APIGroup holds the API group of the referenced subject.\\n Defaults to \\\"\\\" for ServiceAccount subjects.\\n Defaults to \\\"rbac.authorization.halo.run\\\" for User and Group subjects.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Kind of object being referenced. Values defined by this API group are \\\"User\\\", \\\"Group\\\",\\n and \\\"ServiceAccount\\\".\\n If the Authorizer does not recognize the kind value, the Authorizer should report\\n an error.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Name of the object being referenced.\"\n }\n }\n },\n \"Subscription\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SubscriptionSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Subscription Subscription} is a custom extension that defines a subscriber to be notified when a\\n certain {@link Reason Reason} is triggered.\\u003c/p\\u003e\\n \\u003cp\\u003eIt holds a {@link Subscriber Subscriber} to the user to be notified, a {@link InterestReason InterestReason} to\\n subscribe to.\\u003c/p\\u003e\"\n },\n \"SubscriptionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SubscriptionSpec\": {\n \"required\": [\n \"reason\",\n \"subscriber\",\n \"unsubscribeToken\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"disabled\": {\n \"type\": \"boolean\",\n \"description\": \"Perhaps users need to unsubscribe and interact without receiving notifications again\"\n },\n \"reason\": {\n \"$ref\": \"#/components/schemas/InterestReason\"\n },\n \"subscriber\": {\n \"$ref\": \"#/components/schemas/SubscriptionSubscriber\"\n },\n \"unsubscribeToken\": {\n \"type\": \"string\",\n \"description\": \"The token to unsubscribe\"\n }\n }\n },\n \"SubscriptionSubscriber\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n },\n \"description\": \"The subscriber to be notified\"\n },\n \"Tag\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/TagSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/TagStatus\"\n }\n }\n },\n \"TagList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"TagSpec\": {\n \"required\": [\n \"displayName\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"color\": {\n \"pattern\": \"^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$\",\n \"type\": \"string\",\n \"description\": \"Color regex explanation.\\n \\u003cpre\\u003e\\n ^ # start of the line\\n # # start with a number sign `#`\\n ( # start of (group 1)\\n [a-fA-F0-9]{6} # support z-f, A-F and 0-9, with a length of 6\\n | # or\\n [a-fA-F0-9]{3} # support z-f, A-F and 0-9, with a length of 3\\n ) # end of (group 1)\\n $ # end of the line\\n \\u003c/pre\\u003e\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TagStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"TagVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/TagSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/TagStatus\"\n }\n },\n \"description\": \"A value object for {@link Tag Tag}.\"\n },\n \"TagVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"TemplateContent\": {\n \"required\": [\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"htmlBody\": {\n \"type\": \"string\"\n },\n \"rawBody\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TemplateDescriptor\": {\n \"required\": [\n \"file\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"file\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"screenshot\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Type used to describe custom template page.\"\n },\n \"TestOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"test\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Theme\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ThemeSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ThemeStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003eTheme extension.\\u003c/p\\u003e\"\n },\n \"ThemeInstallRequest\": {\n \"type\": \"object\"\n },\n \"ThemeList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ThemeSpec\": {\n \"required\": [\n \"author\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"author\": {\n \"$ref\": \"#/components/schemas/Author\"\n },\n \"configMapName\": {\n \"type\": \"string\"\n },\n \"customTemplates\": {\n \"$ref\": \"#/components/schemas/CustomTemplates\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"issues\": {\n \"type\": \"string\"\n },\n \"license\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/License\"\n }\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"repo\": {\n \"type\": \"string\"\n },\n \"requires\": {\n \"type\": \"string\"\n },\n \"settingName\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"string\"\n }\n }\n },\n \"ThemeStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"READY\",\n \"FAILED\",\n \"UNKNOWN\"\n ]\n }\n }\n },\n \"Thumbnail\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ThumbnailSpec\"\n }\n }\n },\n \"ThumbnailList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ThumbnailSpec\": {\n \"required\": [\n \"imageSignature\",\n \"imageUri\",\n \"size\",\n \"thumbnailUri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"imageSignature\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"imageUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"string\",\n \"enum\": [\n \"S\",\n \"M\",\n \"L\",\n \"XL\"\n ]\n },\n \"thumbnailUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TotpAuthLinkResponse\": {\n \"type\": \"object\",\n \"properties\": {\n \"authLink\": {\n \"type\": \"string\",\n \"description\": \"QR Code with base64 encoded.\",\n \"format\": \"uri\"\n },\n \"rawSecret\": {\n \"type\": \"string\"\n }\n }\n },\n \"TotpRequest\": {\n \"required\": [\n \"code\",\n \"password\",\n \"secret\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"code\": {\n \"type\": \"string\"\n },\n \"password\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"secret\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TwoFactorAuthSettings\": {\n \"type\": \"object\",\n \"properties\": {\n \"available\": {\n \"type\": \"boolean\",\n \"description\": \"Check if 2FA is available.\"\n },\n \"emailVerified\": {\n \"type\": \"boolean\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"totpConfigured\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"UcUploadFromUrlRequest\": {\n \"required\": [\n \"url\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Custom file name\"\n },\n \"url\": {\n \"type\": \"string\",\n \"format\": \"url\"\n }\n }\n },\n \"UpgradeFromUriRequest\": {\n \"required\": [\n \"uri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"uri\": {\n \"type\": \"string\",\n \"format\": \"uri\"\n }\n }\n },\n \"UpgradeRequest\": {\n \"required\": [\n \"file\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n }\n }\n },\n \"UploadForm\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"description\": \"The file to upload. If not provided, the url will be used.\",\n \"format\": \"binary\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"The filename to use when uploading from url. If not provided, the filename will be\\n extracted from the url.\"\n },\n \"url\": {\n \"type\": \"string\",\n \"description\": \"The url to upload from. If not provided, the file will be used.\"\n }\n },\n \"description\": \"Upload form from console. The file and url are mutually exclusive. If both are provided,\\n the file will be used.\"\n },\n \"UploadFromUrlRequest\": {\n \"required\": [\n \"policyName\",\n \"url\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Custom file name\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"The name of the group to which the attachment belongs\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Storage policy name\"\n },\n \"url\": {\n \"type\": \"string\",\n \"format\": \"url\"\n }\n }\n },\n \"User\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/UserSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/UserStatus\"\n }\n },\n \"description\": \"The extension represents user details of Halo.\"\n },\n \"UserConnection\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/UserConnectionSpec\"\n }\n },\n \"description\": \"User connection extension.\"\n },\n \"UserConnectionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"UserConnectionSpec\": {\n \"required\": [\n \"providerUserId\",\n \"registrationId\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"providerUserId\": {\n \"type\": \"string\",\n \"description\": \"The unique identifier for the user\\u0027s connection to the OAuth provider.\\n for example, the user\\u0027s GitHub id.\"\n },\n \"registrationId\": {\n \"type\": \"string\",\n \"description\": \"The name of the OAuth provider (e.g. Google, Facebook, Twitter).\"\n },\n \"updatedAt\": {\n \"type\": \"string\",\n \"description\": \"The time when the user connection was last updated.\",\n \"format\": \"date-time\"\n },\n \"username\": {\n \"type\": \"string\",\n \"description\": \"The {@link Metadata#getName Metadata#getName()} of the user associated with the OAuth connection.\"\n }\n }\n },\n \"UserDevice\": {\n \"required\": [\n \"active\",\n \"currentDevice\",\n \"device\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"active\": {\n \"type\": \"boolean\"\n },\n \"currentDevice\": {\n \"type\": \"boolean\"\n },\n \"device\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"UserEndpoint.ListedUserList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedUser\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"UserList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"UserPermission\": {\n \"required\": [\n \"permissions\",\n \"roles\",\n \"uiPermissions\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"permissions\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"uiPermissions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"UserSpec\": {\n \"required\": [\n \"displayName\",\n \"email\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"disabled\": {\n \"type\": \"boolean\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"emailVerified\": {\n \"type\": \"boolean\"\n },\n \"loginHistoryLimit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"phone\": {\n \"type\": \"string\"\n },\n \"registeredAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"totpEncryptedSecret\": {\n \"type\": \"string\"\n },\n \"twoFactorAuthEnabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"UserStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n }\n }\n },\n \"VerifyCodeRequest\": {\n \"required\": [\n \"code\",\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"code\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"password\": {\n \"type\": \"string\"\n }\n }\n },\n \"VoteRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"plural\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"securitySchemes\": {\n \"basicAuth\": {\n \"scheme\": \"basic\",\n \"type\": \"http\"\n },\n \"bearerAuth\": {\n \"bearerFormat\": \"JWT\",\n \"scheme\": \"bearer\",\n \"type\": \"http\"\n }\n }\n }\n}" }, { "path": "api-docs/openapi/v3_0/apis_console.api_v1alpha1.json", "content": "{\n \"openapi\": \"3.0.1\",\n \"info\": {\n \"title\": \"Halo\",\n \"version\": \"2.23.0-SNAPSHOT\"\n },\n \"servers\": [\n {\n \"url\": \"http://localhost:8091\",\n \"description\": \"Generated server url\"\n }\n ],\n \"security\": [\n {\n \"basicAuth\": [],\n \"bearerAuth\": []\n }\n ],\n \"paths\": {\n \"/apis/api.console.halo.run/v1alpha1/attachments\": {\n \"get\": {\n \"operationId\": \"SearchAttachments\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Filter attachments without group. This parameter will ignore group parameter.\",\n \"in\": \"query\",\n \"name\": \"ungrouped\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n },\n {\n \"description\": \"Keyword for searching.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Acceptable media types.\",\n \"in\": \"query\",\n \"name\": \"accepts\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AttachmentList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/attachments/-/upload-from-url\": {\n \"post\": {\n \"operationId\": \"ExternalTransferAttachment\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UploadFromUrlRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/attachments/upload\": {\n \"post\": {\n \"operationId\": \"UploadAttachment\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/IUploadRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/auth-providers\": {\n \"get\": {\n \"description\": \"Lists all auth providers\",\n \"operationId\": \"listAuthProviders\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedAuthProvider\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/auth-providers/{name}/disable\": {\n \"put\": {\n \"description\": \"Disables an auth provider\",\n \"operationId\": \"disableAuthProvider\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/auth-providers/{name}/enable\": {\n \"put\": {\n \"description\": \"Enables an auth provider\",\n \"operationId\": \"enableAuthProvider\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/comments\": {\n \"get\": {\n \"description\": \"List comments.\",\n \"operationId\": \"ListComments\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Comments filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Commenter kind.\",\n \"in\": \"query\",\n \"name\": \"ownerKind\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Commenter name.\",\n \"in\": \"query\",\n \"name\": \"ownerName\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedCommentList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Create a comment.\",\n \"operationId\": \"CreateComment\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/comments/{name}/reply\": {\n \"post\": {\n \"description\": \"Create a reply.\",\n \"operationId\": \"CreateReply\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/indices/-/rebuild\": {\n \"post\": {\n \"description\": \"Rebuild all indices\",\n \"operationId\": \"RebuildAllIndices\",\n \"responses\": {},\n \"tags\": [\n \"IndicesV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/notifiers/{name}/sender-config\": {\n \"get\": {\n \"description\": \"Fetch sender config of notifier\",\n \"operationId\": \"FetchSenderConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Save sender config of notifier\",\n \"operationId\": \"SaveSenderConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins\": {\n \"get\": {\n \"description\": \"List plugins using query criteria and sort params\",\n \"operationId\": \"ListPlugins\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Keyword of plugin name or description\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Whether the plugin is enabled\",\n \"in\": \"query\",\n \"name\": \"enabled\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.css\": {\n \"get\": {\n \"description\": \"Merge all CSS bundles of enabled plugins into one.\",\n \"operationId\": \"fetchCssBundle\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.js\": {\n \"get\": {\n \"description\": \"Merge all JS bundles of enabled plugins into one.\",\n \"operationId\": \"fetchJsBundle\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/install-from-uri\": {\n \"post\": {\n \"description\": \"Install a plugin from uri.\",\n \"operationId\": \"InstallPluginFromUri\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/InstallFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/install\": {\n \"post\": {\n \"description\": \"Install a plugin by uploading a Jar file.\",\n \"operationId\": \"InstallPlugin\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginInstallRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/json-config\": {\n \"get\": {\n \"description\": \"Fetch converted json config of plugin by configured configMapName.\",\n \"operationId\": \"fetchPluginJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update the config of plugin setting.\",\n \"operationId\": \"updatePluginJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"content\": {},\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/plugin-state\": {\n \"put\": {\n \"description\": \"Change the running state of a plugin by name.\",\n \"operationId\": \"ChangePluginRunningState\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginRunningStateRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/reload\": {\n \"put\": {\n \"description\": \"Reload a plugin by name.\",\n \"operationId\": \"reloadPlugin\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/reset-config\": {\n \"put\": {\n \"description\": \"Reset the configMap of plugin setting.\",\n \"operationId\": \"ResetPluginConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/setting\": {\n \"get\": {\n \"description\": \"Fetch setting of plugin.\",\n \"operationId\": \"fetchPluginSetting\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/upgrade\": {\n \"post\": {\n \"description\": \"Upgrade a plugin by uploading a Jar file\",\n \"operationId\": \"UpgradePlugin\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginInstallRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {},\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/plugins/{name}/upgrade-from-uri\": {\n \"post\": {\n \"description\": \"Upgrade a plugin from uri.\",\n \"operationId\": \"UpgradePluginFromUri\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UpgradeFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"List posts.\",\n \"operationId\": \"ListPosts\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Posts filtered by publish phase.\",\n \"in\": \"query\",\n \"name\": \"publishPhase\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"DRAFT\",\n \"PENDING_APPROVAL\",\n \"PUBLISHED\",\n \"FAILED\"\n ]\n }\n },\n {\n \"description\": \"Posts filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Posts filtered by category including sub-categories.\",\n \"in\": \"query\",\n \"name\": \"categoryWithChildren\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Draft a post.\",\n \"operationId\": \"DraftPost\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}\": {\n \"put\": {\n \"description\": \"Update a post.\",\n \"operationId\": \"UpdateDraftPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/content\": {\n \"delete\": {\n \"description\": \"Delete a content for post.\",\n \"operationId\": \"deletePostContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n },\n \"get\": {\n \"description\": \"Fetch content of post.\",\n \"operationId\": \"fetchPostContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update a post\\u0027s content.\",\n \"operationId\": \"UpdatePostContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Content\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/head-content\": {\n \"get\": {\n \"description\": \"Fetch head content of post.\",\n \"operationId\": \"fetchPostHeadContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/publish\": {\n \"put\": {\n \"description\": \"Publish a post.\",\n \"operationId\": \"PublishPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Head snapshot name of content.\",\n \"in\": \"query\",\n \"name\": \"headSnapshot\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"async\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/recycle\": {\n \"put\": {\n \"description\": \"Recycle a post.\",\n \"operationId\": \"RecyclePost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/release-content\": {\n \"get\": {\n \"description\": \"Fetch release content of post.\",\n \"operationId\": \"fetchPostReleaseContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/revert-content\": {\n \"put\": {\n \"description\": \"Revert to specified snapshot for post content.\",\n \"operationId\": \"revertToSpecifiedSnapshotForPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RevertSnapshotForPostParam\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/snapshot\": {\n \"get\": {\n \"description\": \"List all snapshots for post content.\",\n \"operationId\": \"listPostSnapshots\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSnapshotDto\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/posts/{name}/unpublish\": {\n \"put\": {\n \"description\": \"UnPublish a post.\",\n \"operationId\": \"UnpublishPost\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/replies\": {\n \"get\": {\n \"description\": \"List replies.\",\n \"operationId\": \"ListReplies\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Replies filtered by commentName.\",\n \"in\": \"query\",\n \"name\": \"commentName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedReplyList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages\": {\n \"get\": {\n \"description\": \"List single pages.\",\n \"operationId\": \"ListSinglePages\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"SinglePages filtered by contributor.\",\n \"in\": \"query\",\n \"name\": \"contributor\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"SinglePages filtered by publish phase.\",\n \"in\": \"query\",\n \"name\": \"publishPhase\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"DRAFT\",\n \"PENDING_APPROVAL\",\n \"PUBLISHED\",\n \"FAILED\"\n ]\n }\n },\n {\n \"description\": \"SinglePages filtered by visibility.\",\n \"in\": \"query\",\n \"name\": \"visible\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ]\n }\n },\n {\n \"description\": \"SinglePages filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedSinglePageList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Draft a single page.\",\n \"operationId\": \"DraftSinglePage\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}\": {\n \"put\": {\n \"description\": \"Update a single page.\",\n \"operationId\": \"UpdateDraftSinglePage\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/content\": {\n \"delete\": {\n \"description\": \"Delete a content for post.\",\n \"operationId\": \"deleteSinglePageContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n },\n \"get\": {\n \"description\": \"Fetch content of single page.\",\n \"operationId\": \"fetchSinglePageContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"in\": \"query\",\n \"name\": \"snapshotName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update a single page\\u0027s content.\",\n \"operationId\": \"UpdateSinglePageContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Content\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/head-content\": {\n \"get\": {\n \"description\": \"Fetch head content of single page.\",\n \"operationId\": \"fetchSinglePageHeadContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/publish\": {\n \"put\": {\n \"description\": \"Publish a single page.\",\n \"operationId\": \"PublishSinglePage\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/release-content\": {\n \"get\": {\n \"description\": \"Fetch release content of single page.\",\n \"operationId\": \"fetchSinglePageReleaseContent\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ContentWrapper\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/revert-content\": {\n \"put\": {\n \"description\": \"Revert to specified snapshot for single page content.\",\n \"operationId\": \"revertToSpecifiedSnapshotForSinglePage\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RevertSnapshotForSingleParam\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/singlepages/{name}/snapshot\": {\n \"get\": {\n \"description\": \"List all snapshots for single page content.\",\n \"operationId\": \"listSinglePageSnapshots\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSnapshotDto\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/stats\": {\n \"get\": {\n \"description\": \"Get stats.\",\n \"operationId\": \"getStats\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DashboardStats\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/tags\": {\n \"get\": {\n \"description\": \"List Post Tags.\",\n \"operationId\": \"ListPostTags\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Post tags filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes\": {\n \"get\": {\n \"description\": \"List themes.\",\n \"operationId\": \"ListThemes\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Whether to list uninstalled themes.\",\n \"in\": \"query\",\n \"name\": \"uninstalled\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThemeList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/-/activation\": {\n \"get\": {\n \"description\": \"Fetch the activated theme.\",\n \"operationId\": \"fetchActivatedTheme\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/-/install-from-uri\": {\n \"post\": {\n \"description\": \"Install a theme from uri.\",\n \"operationId\": \"InstallThemeFromUri\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/InstallFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/install\": {\n \"post\": {\n \"description\": \"Install a theme by uploading a zip file.\",\n \"operationId\": \"InstallTheme\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThemeInstallRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/activation\": {\n \"put\": {\n \"description\": \"Activate a theme by name.\",\n \"operationId\": \"activateTheme\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/invalidate-cache\": {\n \"put\": {\n \"description\": \"Invalidate theme template cache.\",\n \"operationId\": \"InvalidateCache\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"204\": {\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/json-config\": {\n \"get\": {\n \"description\": \"Fetch converted json config of theme by configured configMapName.\",\n \"operationId\": \"fetchThemeJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update the configMap of theme setting.\",\n \"operationId\": \"updateThemeJsonConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"content\": {},\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/reload\": {\n \"put\": {\n \"description\": \"Reload theme setting.\",\n \"operationId\": \"Reload\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/reset-config\": {\n \"put\": {\n \"description\": \"Reset the configMap of theme setting.\",\n \"operationId\": \"ResetThemeConfig\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/setting\": {\n \"get\": {\n \"description\": \"Fetch setting of theme.\",\n \"operationId\": \"fetchThemeSetting\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/upgrade\": {\n \"post\": {\n \"description\": \"Upgrade theme\",\n \"operationId\": \"UpgradeTheme\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UpgradeRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {},\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/themes/{name}/upgrade-from-uri\": {\n \"post\": {\n \"description\": \"Upgrade a theme from uri.\",\n \"operationId\": \"UpgradeThemeFromUri\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UpgradeFromUriRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users\": {\n \"get\": {\n \"description\": \"List users\",\n \"operationId\": \"ListUsers\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Keyword to search\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Role name\",\n \"in\": \"query\",\n \"name\": \"role\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserEndpoint.ListedUserList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Creates a new user.\",\n \"operationId\": \"CreateUser\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CreateUserRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-\": {\n \"get\": {\n \"description\": \"Get current user detail\",\n \"operationId\": \"GetCurrentUserDetail\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DetailedUser\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update current user profile, but password.\",\n \"operationId\": \"UpdateCurrentUser\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-/password\": {\n \"put\": {\n \"description\": \"Change own password of user.\",\n \"operationId\": \"ChangeOwnPassword\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ChangeOwnPasswordRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-/send-email-verification-code\": {\n \"post\": {\n \"description\": \"Send email verification code for user\",\n \"operationId\": \"SendEmailVerificationCode\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/EmailVerifyRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/-/verify-email\": {\n \"post\": {\n \"description\": \"Verify email for user by code.\",\n \"operationId\": \"VerifyEmail\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/VerifyCodeRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}\": {\n \"get\": {\n \"description\": \"Get user detail by name\",\n \"operationId\": \"GetUserDetail\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DetailedUser\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}/avatar\": {\n \"delete\": {\n \"description\": \"delete user avatar\",\n \"operationId\": \"DeleteUserAvatar\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"upload user avatar\",\n \"operationId\": \"UploadUserAvatar\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/IAvatarUploadRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}/password\": {\n \"put\": {\n \"description\": \"Change anyone password of user for admin.\",\n \"operationId\": \"ChangeAnyonePassword\",\n \"parameters\": [\n {\n \"description\": \"Name of user. If the name is equal to \\u0027-\\u0027, it will change the password of current user.\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ChangePasswordRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/api.console.halo.run/v1alpha1/users/{name}/permissions\": {\n \"get\": {\n \"description\": \"Get permissions of user\",\n \"operationId\": \"GetPermissions\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserPermission\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n },\n \"post\": {\n \"description\": \"Grant permissions to user\",\n \"operationId\": \"GrantPermission\",\n \"parameters\": [\n {\n \"description\": \"User name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/GrantRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.halo.run/v1alpha1/systemconfigs/{group}\": {\n \"get\": {\n \"description\": \"Get system config by group\",\n \"operationId\": \"getSystemConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Group of the system config\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n },\n \"application/json\": {}\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemConfigV1alpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update system config by group\",\n \"operationId\": \"updateSystemConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Group of the system config\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n }\n },\n \"responses\": {\n \"204 NO_CONTENT\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemConfigV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.migration.halo.run/v1alpha1/backup-files\": {\n \"get\": {\n \"description\": \"Get backup files from backup root.\",\n \"operationId\": \"getBackupFiles\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/BackupFile\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MigrationV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.migration.halo.run/v1alpha1/backups/{name}/files/{filename}\": {\n \"get\": {\n \"operationId\": \"DownloadBackups\",\n \"parameters\": [\n {\n \"description\": \"Backup name.\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Backup filename.\",\n \"in\": \"path\",\n \"name\": \"filename\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"MigrationV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.migration.halo.run/v1alpha1/restorations\": {\n \"post\": {\n \"description\": \"Restore backup by uploading file or providing download link or backup name.\",\n \"operationId\": \"RestoreBackup\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RestoreRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {},\n \"tags\": [\n \"MigrationV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.notification.halo.run/v1alpha1/notifiers/default-email-notifier/verify-connection\": {\n \"post\": {\n \"description\": \"Verify email sender config.\",\n \"operationId\": \"VerifyEmailSenderConfig\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/EmailConfigValidationRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.security.halo.run/v1alpha1/users/{username}/disable\": {\n \"post\": {\n \"description\": \"Disable user by username\",\n \"operationId\": \"DisableUser\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"The user has been disabled.\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.security.halo.run/v1alpha1/users/{username}/enable\": {\n \"post\": {\n \"description\": \"Enable user by username\",\n \"operationId\": \"EnableUser\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"The user has been enabled.\"\n }\n },\n \"tags\": [\n \"UserV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.storage.halo.run/v1alpha1/attachments/-/upload\": {\n \"post\": {\n \"description\": \"Upload attachment endpoint for console.\",\n \"operationId\": \"uploadAttachmentForConsole\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UploadForm\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Console\"\n ]\n }\n },\n \"/apis/console.api.storage.halo.run/v1alpha1/policies/{name}/configs/{group}\": {\n \"get\": {\n \"description\": \"Get policy config by group\",\n \"operationId\": \"getPolicyConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of the policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Name of the group\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PolicyAlpha1Console\"\n ]\n },\n \"put\": {\n \"description\": \"Update policy config by group\",\n \"operationId\": \"updatePolicyConfigByGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of the policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Name of the group\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"description\": \"No Content\"\n }\n },\n \"tags\": [\n \"PolicyAlpha1Console\"\n ]\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"AddOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"add\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Attachment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AttachmentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/AttachmentStatus\"\n }\n }\n },\n \"AttachmentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AttachmentSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of attachment\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"Group name\"\n },\n \"mediaType\": {\n \"type\": \"string\",\n \"description\": \"Media type of attachment\"\n },\n \"ownerName\": {\n \"type\": \"string\",\n \"description\": \"Name of User who uploads the attachment\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Policy name\"\n },\n \"size\": {\n \"minimum\": 0,\n \"type\": \"integer\",\n \"description\": \"Size of attachment. Unit is Byte\",\n \"format\": \"int64\"\n },\n \"tags\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Tags of attachment\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Tag name\"\n }\n }\n }\n },\n \"AttachmentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\",\n \"description\": \"Permalink of attachment.\\nIf it is in local storage, the public URL will be set.\\nIf it is in s3 storage, the Object URL will be set.\\n\"\n },\n \"thumbnails\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"AuthProvider\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AuthProviderSpec\"\n }\n },\n \"description\": \"Auth provider extension.\"\n },\n \"AuthProviderSpec\": {\n \"required\": [\n \"authType\",\n \"authenticationUrl\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"authType\": {\n \"type\": \"string\",\n \"description\": \"Auth type: form or oauth2.\",\n \"enum\": [\n \"FORM\",\n \"OAUTH2\"\n ]\n },\n \"authenticationUrl\": {\n \"type\": \"string\",\n \"description\": \"Authentication url of the auth provider\"\n },\n \"bindingUrl\": {\n \"type\": \"string\"\n },\n \"configMapRef\": {\n \"$ref\": \"#/components/schemas/ConfigMapRef\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of the auth provider\"\n },\n \"helpPage\": {\n \"type\": \"string\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"method\": {\n \"type\": \"string\"\n },\n \"rememberMeSupport\": {\n \"type\": \"boolean\"\n },\n \"settingRef\": {\n \"$ref\": \"#/components/schemas/SettingRef\"\n },\n \"unbindUrl\": {\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"Author\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"BackupFile\": {\n \"type\": \"object\",\n \"properties\": {\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Filename of backup file.\"\n },\n \"lastModifiedTime\": {\n \"type\": \"string\",\n \"description\": \"Last modified time of backup file.\",\n \"format\": \"date-time\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of backup file.\",\n \"format\": \"int64\"\n }\n },\n \"description\": \"Backup file.\"\n },\n \"Category\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CategorySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CategoryStatus\"\n }\n }\n },\n \"CategorySpec\": {\n \"required\": [\n \"displayName\",\n \"priority\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eWhether to hide the category from the category list.\\u003c/p\\u003e\\n \\u003cp\\u003eWhen set to true, the category including its subcategories and related posts will\\n not be displayed in the category list, but it can still be accessed by permalink.\\u003c/p\\u003e\\n \\u003cp\\u003eLimitation: It only takes effect on the theme-side categorized list and it only\\n allows to be set to true on the first level(root node) of categories.\\u003c/p\\u003e\"\n },\n \"postTemplate\": {\n \"maxLength\": 255,\n \"type\": \"string\",\n \"description\": \"\\u003cp\\u003eUsed to specify the template for the posts associated with the category.\\u003c/p\\u003e\\n \\u003cp\\u003eThe priority is not as high as that of the post.\\u003c/p\\u003e\\n \\u003cp\\u003eIf the post also specifies a template, the post\\u0027s template will prevail.\\u003c/p\\u003e\"\n },\n \"preventParentPostCascadeQuery\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eif a category is queried for related posts, the default behavior is to\\n query all posts under the category including its subcategories, but if this field is\\n set to true, cascade query behavior will be terminated here.\\u003c/p\\u003e\\n \\u003cp\\u003eFor example, if a category has subcategories A and B, and A has subcategories C and\\n D and C marked this field as true, when querying posts under A category,all posts under A\\n and B will be queried, but C and D will not be queried.\\u003c/p\\u003e\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"maxLength\": 255,\n \"type\": \"string\"\n }\n }\n },\n \"CategoryStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的已发布且公开的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n }\n }\n },\n \"ChangeOwnPasswordRequest\": {\n \"required\": [\n \"oldPassword\",\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"oldPassword\": {\n \"type\": \"string\",\n \"description\": \"Old password.\"\n },\n \"password\": {\n \"minLength\": 5,\n \"type\": \"string\",\n \"description\": \"New password.\"\n }\n }\n },\n \"ChangePasswordRequest\": {\n \"required\": [\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"password\": {\n \"minLength\": 5,\n \"type\": \"string\",\n \"description\": \"New password.\"\n }\n }\n },\n \"Comment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n }\n },\n \"CommentEmailOwner\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\",\n \"description\": \"avatar for comment owner\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"display name for comment owner\"\n },\n \"email\": {\n \"type\": \"string\",\n \"description\": \"email for comment owner\"\n },\n \"website\": {\n \"type\": \"string\",\n \"description\": \"website for comment owner\"\n }\n },\n \"description\": \"\\u003cp\\u003eThe creator info of the comment.\\u003c/p\\u003e\\n This {@link CommentEmailOwner CommentEmailOwner} is only applicable to the user who is allowed to comment\\n without logging in.\"\n },\n \"CommentOwner\": {\n \"required\": [\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"maxLength\": 64,\n \"type\": \"string\"\n }\n }\n },\n \"CommentRequest\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"subjectRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentEmailOwner\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n },\n \"description\": \"Request parameter object for {@link Comment Comment}.\"\n },\n \"CommentSpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"subjectRef\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"lastReadTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"CommentStats\": {\n \"type\": \"object\",\n \"properties\": {\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"comment stats value object.\"\n },\n \"CommentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"hasNewReply\": {\n \"type\": \"boolean\"\n },\n \"lastReplyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"replyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"unreadReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visibleReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"Condition\": {\n \"required\": [\n \"lastTransitionTime\",\n \"status\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastTransitionTime\": {\n \"type\": \"string\",\n \"description\": \"Last time the condition transitioned from one status to another.\",\n \"format\": \"date-time\"\n },\n \"message\": {\n \"maxLength\": 32768,\n \"type\": \"string\",\n \"description\": \"Human-readable message indicating details about last transition.\\n This may be an empty string.\"\n },\n \"reason\": {\n \"maxLength\": 1024,\n \"pattern\": \"^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$\",\n \"type\": \"string\",\n \"description\": \"Unique, one-word, CamelCase reason for the condition\\u0027s last transition.\"\n },\n \"status\": {\n \"type\": \"string\",\n \"description\": \"Status is the status of the condition. Can be True, False, Unknown.\",\n \"enum\": [\n \"TRUE\",\n \"FALSE\",\n \"UNKNOWN\"\n ]\n },\n \"type\": {\n \"maxLength\": 316,\n \"pattern\": \"^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$\",\n \"type\": \"string\",\n \"description\": \"type of condition in CamelCase or in foo.example.com/CamelCase.\\n example: Ready, Initialized.\\n maxLength: 316.\"\n }\n },\n \"description\": \"EqualsAndHashCode 排除了lastTransitionTime否则失败时，lastTransitionTime 会被更新\\n 导致 equals 为 false，一直被加入队列.\"\n },\n \"ConfigMap\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n }\n },\n \"description\": \"\\u003cp\\u003eConfigMap holds configuration data to consume.\\u003c/p\\u003e\"\n },\n \"ConfigMapRef\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"Content\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"rawType\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"type\": \"string\"\n }\n }\n },\n \"ContentUpdateParam\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"rawType\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"ContentWrapper\": {\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"type\": \"string\"\n },\n \"snapshotName\": {\n \"type\": \"string\"\n }\n }\n },\n \"Contributor\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Contributor from user.\"\n },\n \"CopyOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"copy\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"CreateUserRequest\": {\n \"required\": [\n \"email\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"phone\": {\n \"type\": \"string\"\n },\n \"roles\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"CustomTemplates\": {\n \"type\": \"object\",\n \"properties\": {\n \"category\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n },\n \"page\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n },\n \"post\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n }\n }\n },\n \"DashboardStats\": {\n \"type\": \"object\",\n \"properties\": {\n \"approvedComments\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"comments\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"posts\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"upvotes\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"users\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"visits\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"DetailedUser\": {\n \"required\": [\n \"roles\",\n \"user\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"user\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"EmailConfigValidationRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Gets email display name.\"\n },\n \"enable\": {\n \"type\": \"boolean\"\n },\n \"encryption\": {\n \"type\": \"string\"\n },\n \"host\": {\n \"type\": \"string\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"port\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"sender\": {\n \"type\": \"string\",\n \"description\": \"Gets email sender address.\"\n },\n \"username\": {\n \"type\": \"string\"\n }\n }\n },\n \"EmailVerifyRequest\": {\n \"required\": [\n \"email\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"email\": {\n \"type\": \"string\",\n \"format\": \"email\"\n }\n }\n },\n \"Excerpt\": {\n \"required\": [\n \"autoGenerate\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"autoGenerate\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"raw\": {\n \"type\": \"string\"\n }\n }\n },\n \"Extension\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n }\n },\n \"description\": \"Extension is an interface which represents an Extension. It contains setters and getters of\\n GroupVersionKind and Metadata.\"\n },\n \"GrantRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"roles\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"IAvatarUploadRequest\": {\n \"required\": [\n \"file\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n }\n }\n },\n \"IUploadRequest\": {\n \"required\": [\n \"file\",\n \"policyName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"The name of the group to which the attachment belongs\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Storage policy name\"\n }\n }\n },\n \"InstallFromUriRequest\": {\n \"required\": [\n \"uri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"uri\": {\n \"type\": \"string\",\n \"format\": \"uri\"\n }\n }\n },\n \"JsonPatch\": {\n \"minItems\": 1,\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"JSON schema for JSONPatch operations\",\n \"items\": {\n \"oneOf\": [\n {\n \"$ref\": \"#/components/schemas/AddOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/ReplaceOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/TestOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/RemoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/MoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/CopyOperation\"\n }\n ]\n }\n },\n \"License\": {\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Common data objects for license.\"\n },\n \"ListedAuthProvider\": {\n \"required\": [\n \"displayName\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"authType\": {\n \"type\": \"string\",\n \"enum\": [\n \"FORM\",\n \"OAUTH2\"\n ]\n },\n \"authenticationUrl\": {\n \"type\": \"string\"\n },\n \"bindingUrl\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"helpPage\": {\n \"type\": \"string\"\n },\n \"isBound\": {\n \"type\": \"boolean\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"privileged\": {\n \"type\": \"boolean\"\n },\n \"supportsBinding\": {\n \"type\": \"boolean\"\n },\n \"unbindingUrl\": {\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"A listed value object for {@link run.halo.app.core.extension.AuthProvider run.halo.app.core.extension.AuthProvider}.\"\n },\n \"ListedComment\": {\n \"required\": [\n \"comment\",\n \"owner\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"comment\": {\n \"$ref\": \"#/components/schemas/Comment\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStats\"\n },\n \"subject\": {\n \"$ref\": \"#/components/schemas/Extension\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedCommentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedComment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedPost\": {\n \"required\": [\n \"categories\",\n \"contributors\",\n \"owner\",\n \"post\",\n \"stats\",\n \"tags\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n }\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n },\n \"post\": {\n \"$ref\": \"#/components/schemas/Post\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/Stats\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedPostList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedPost\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedReply\": {\n \"required\": [\n \"owner\",\n \"reply\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"reply\": {\n \"$ref\": \"#/components/schemas/Reply\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStats\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedReplyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedReply\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedSinglePage\": {\n \"required\": [\n \"contributors\",\n \"owner\",\n \"page\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n }\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n },\n \"page\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/Stats\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedSinglePageList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSinglePage\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedSnapshotDto\": {\n \"required\": [\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ListedSnapshotSpec\"\n }\n }\n },\n \"ListedSnapshotSpec\": {\n \"required\": [\n \"owner\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"modifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"type\": \"string\"\n }\n }\n },\n \"ListedUser\": {\n \"required\": [\n \"roles\",\n \"user\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"user\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"Metadata\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Annotations are like key-value format.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Creation timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"deletionTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Deletion timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"finalizers\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"nullable\": true,\n \"items\": {\n \"type\": \"string\",\n \"nullable\": true\n }\n },\n \"generateName\": {\n \"type\": \"string\",\n \"description\": \"The name field will be generated automatically according to the given generateName field\"\n },\n \"labels\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Labels are like key-value format.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Metadata name\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Current version of the Extension. It will be bumped up every update.\",\n \"format\": \"int64\",\n \"nullable\": true\n }\n },\n \"description\": \"Metadata of Extension.\"\n },\n \"MoveOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"move\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"OwnerInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Comment owner info.\"\n },\n \"Plugin\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PluginSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PluginStatus\"\n }\n },\n \"description\": \"A custom resource for Plugin.\"\n },\n \"PluginAuthor\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"PluginInstallRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"presetName\": {\n \"type\": \"string\",\n \"description\": \"Plugin preset name. We will find the plugin from plugin presets\"\n },\n \"source\": {\n \"type\": \"string\",\n \"description\": \"Install source. Default is file.\",\n \"enum\": [\n \"FILE\",\n \"PRESET\",\n \"URL\"\n ]\n }\n }\n },\n \"PluginList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PluginRunningStateRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"async\": {\n \"type\": \"boolean\"\n },\n \"enable\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"PluginSpec\": {\n \"required\": [\n \"version\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"author\": {\n \"$ref\": \"#/components/schemas/PluginAuthor\"\n },\n \"configMapName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"issues\": {\n \"type\": \"string\"\n },\n \"license\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/License\"\n }\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"pluginDependencies\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"repo\": {\n \"type\": \"string\"\n },\n \"requires\": {\n \"type\": \"string\",\n \"description\": \"SemVer format.\"\n },\n \"settingName\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"pattern\": \"^(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)(?:-((?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\\\.(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\\\+([0-9a-zA-Z-]+(?:\\\\.[0-9a-zA-Z-]+)*))?$\",\n \"type\": \"string\",\n \"description\": \"plugin version.\"\n }\n }\n },\n \"PluginStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"entry\": {\n \"type\": \"string\"\n },\n \"lastProbeState\": {\n \"type\": \"string\",\n \"enum\": [\n \"CREATED\",\n \"DISABLED\",\n \"RESOLVED\",\n \"STARTED\",\n \"STOPPED\",\n \"FAILED\",\n \"UNLOADED\"\n ]\n },\n \"lastStartTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"loadLocation\": {\n \"type\": \"string\",\n \"description\": \"Load location of the plugin, often a path.\",\n \"format\": \"uri\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"STARTING\",\n \"CREATED\",\n \"DISABLING\",\n \"DISABLED\",\n \"RESOLVED\",\n \"STARTED\",\n \"STOPPED\",\n \"FAILED\",\n \"UNKNOWN\"\n ]\n },\n \"stylesheet\": {\n \"type\": \"string\"\n }\n }\n },\n \"PolicyRule\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroups\": {\n \"type\": \"array\",\n \"description\": \"APIGroups is the name of the APIGroup that contains the resources.\\n If multiple API groups are specified, any action requested against one of the enumerated\\n resources in any API group will be allowed.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"nonResourceURLs\": {\n \"type\": \"array\",\n \"description\": \"NonResourceURLs is a set of partial urls that a user should have access to.\\n *s are allowed, but only as the full, final step in the path\\n If an action is not a resource API request, then the URL is split on \\u0027/\\u0027 and is checked\\n against the NonResourceURLs to look for a match.\\n Since non-resource URLs are not namespaced, this field is only applicable for\\n ClusterRoles referenced from a ClusterRoleBinding.\\n Rules can either apply to API resources (such as \\\"pods\\\" or \\\"secrets\\\") or non-resource\\n URL paths (such as \\\"/api\\\"), but not both.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"resourceNames\": {\n \"type\": \"array\",\n \"description\": \"ResourceNames is an optional white list of names that the rule applies to. An empty set\\n means that everything is allowed.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"resources\": {\n \"type\": \"array\",\n \"description\": \"Resources is a list of resources this rule applies to. \\u0027*\\u0027 represents all resources in\\n the specified apiGroups.\\n \\u0027*\\u0026#47;foo\\u0027 represents the subresource \\u0027foo\\u0027 for all resources in the specified\\n apiGroups.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"verbs\": {\n \"type\": \"array\",\n \"description\": \"about who the rule applies to or which namespace the rule applies to.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"PolicyRule holds information that describes a policy rule, but does not contain information\\n about whom the rule applies to or which namespace the rule applies to.\"\n },\n \"Post\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003ePost extension.\\u003c/p\\u003e\"\n },\n \"PostRequest\": {\n \"required\": [\n \"content\",\n \"post\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentUpdateParam\"\n },\n \"post\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n },\n \"description\": \"Post and content data for creating and updating post.\"\n },\n \"PostSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"文章引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"PostStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"Ref\": {\n \"required\": [\n \"group\",\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"Extension group\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Extension kind\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Extension name. This field is mandatory\"\n },\n \"version\": {\n \"type\": \"string\",\n \"description\": \"Extension version\"\n }\n },\n \"description\": \"Extension reference object. The name is mandatory\"\n },\n \"RemoveOperation\": {\n \"required\": [\n \"op\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"remove\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"ReplaceOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"replace\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Reply\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReplySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ReplyStatus\"\n }\n }\n },\n \"ReplyRequest\": {\n \"required\": [\n \"content\",\n \"raw\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentEmailOwner\"\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n },\n \"description\": \"A request parameter object for {@link Reply Reply}.\"\n },\n \"ReplySpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"commentName\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"commentName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReplyStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"RestoreRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"backupName\": {\n \"type\": \"string\",\n \"description\": \"Backup metadata name.\"\n },\n \"downloadUrl\": {\n \"type\": \"string\",\n \"description\": \"Remote backup HTTP URL.\"\n },\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Filename of backup file in backups root.\"\n }\n }\n },\n \"RevertSnapshotForPostParam\": {\n \"required\": [\n \"snapshotName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"snapshotName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"RevertSnapshotForSingleParam\": {\n \"required\": [\n \"snapshotName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"snapshotName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"Role\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"rules\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"rules\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PolicyRule\"\n }\n }\n }\n },\n \"Setting\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SettingSpec\"\n }\n },\n \"description\": \"{@link Setting Setting} is a custom extension to generate forms based on configuration.\"\n },\n \"SettingForm\": {\n \"minLength\": 1,\n \"required\": [\n \"formSchema\",\n \"group\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"formSchema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"group\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"type\": \"string\"\n }\n }\n },\n \"SettingRef\": {\n \"required\": [\n \"group\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"SettingSpec\": {\n \"required\": [\n \"forms\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"forms\": {\n \"minLength\": 1,\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/SettingForm\"\n }\n }\n }\n },\n \"SinglePage\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003eSingle page extension.\\u003c/p\\u003e\"\n },\n \"SinglePageRequest\": {\n \"required\": [\n \"content\",\n \"page\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentUpdateParam\"\n },\n \"page\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n },\n \"description\": \"A request parameter for {@link SinglePage SinglePage}.\"\n },\n \"SinglePageSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"SinglePageStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"Stats\": {\n \"type\": \"object\",\n \"properties\": {\n \"approvedComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"totalComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Stats value object.\"\n },\n \"Tag\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/TagSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/TagStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"TagList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"TagSpec\": {\n \"required\": [\n \"displayName\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"color\": {\n \"pattern\": \"^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$\",\n \"type\": \"string\",\n \"description\": \"Color regex explanation.\\n \\u003cpre\\u003e\\n ^ # start of the line\\n # # start with a number sign `#`\\n ( # start of (group 1)\\n [a-fA-F0-9]{6} # support z-f, A-F and 0-9, with a length of 6\\n | # or\\n [a-fA-F0-9]{3} # support z-f, A-F and 0-9, with a length of 3\\n ) # end of (group 1)\\n $ # end of the line\\n \\u003c/pre\\u003e\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TagStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"TemplateDescriptor\": {\n \"required\": [\n \"file\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"file\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"screenshot\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Type used to describe custom template page.\"\n },\n \"TestOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"test\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Theme\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ThemeSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ThemeStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003eTheme extension.\\u003c/p\\u003e\"\n },\n \"ThemeInstallRequest\": {\n \"type\": \"object\"\n },\n \"ThemeList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ThemeSpec\": {\n \"required\": [\n \"author\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"author\": {\n \"$ref\": \"#/components/schemas/Author\"\n },\n \"configMapName\": {\n \"type\": \"string\"\n },\n \"customTemplates\": {\n \"$ref\": \"#/components/schemas/CustomTemplates\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"issues\": {\n \"type\": \"string\"\n },\n \"license\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/License\"\n }\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"repo\": {\n \"type\": \"string\"\n },\n \"requires\": {\n \"type\": \"string\"\n },\n \"settingName\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"string\"\n }\n }\n },\n \"ThemeStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"READY\",\n \"FAILED\",\n \"UNKNOWN\"\n ]\n }\n }\n },\n \"UpgradeFromUriRequest\": {\n \"required\": [\n \"uri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"uri\": {\n \"type\": \"string\",\n \"format\": \"uri\"\n }\n }\n },\n \"UpgradeRequest\": {\n \"required\": [\n \"file\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n }\n }\n },\n \"UploadForm\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"description\": \"The file to upload. If not provided, the url will be used.\",\n \"format\": \"binary\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"The filename to use when uploading from url. If not provided, the filename will be\\n extracted from the url.\"\n },\n \"url\": {\n \"type\": \"string\",\n \"description\": \"The url to upload from. If not provided, the file will be used.\"\n }\n },\n \"description\": \"Upload form from console. The file and url are mutually exclusive. If both are provided,\\n the file will be used.\"\n },\n \"UploadFromUrlRequest\": {\n \"required\": [\n \"policyName\",\n \"url\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Custom file name\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"The name of the group to which the attachment belongs\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Storage policy name\"\n },\n \"url\": {\n \"type\": \"string\",\n \"format\": \"url\"\n }\n }\n },\n \"User\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/UserSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/UserStatus\"\n }\n },\n \"description\": \"The extension represents user details of Halo.\"\n },\n \"UserEndpoint.ListedUserList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedUser\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"UserPermission\": {\n \"required\": [\n \"permissions\",\n \"roles\",\n \"uiPermissions\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"permissions\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"uiPermissions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"UserSpec\": {\n \"required\": [\n \"displayName\",\n \"email\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"disabled\": {\n \"type\": \"boolean\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"emailVerified\": {\n \"type\": \"boolean\"\n },\n \"loginHistoryLimit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"phone\": {\n \"type\": \"string\"\n },\n \"registeredAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"totpEncryptedSecret\": {\n \"type\": \"string\"\n },\n \"twoFactorAuthEnabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"UserStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n }\n }\n },\n \"VerifyCodeRequest\": {\n \"required\": [\n \"code\",\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"code\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"password\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"securitySchemes\": {\n \"basicAuth\": {\n \"scheme\": \"basic\",\n \"type\": \"http\"\n },\n \"bearerAuth\": {\n \"bearerFormat\": \"JWT\",\n \"scheme\": \"bearer\",\n \"type\": \"http\"\n }\n }\n }\n}" }, { "path": "api-docs/openapi/v3_0/apis_extension.api_v1alpha1.json", "content": "{\n \"openapi\": \"3.0.1\",\n \"info\": {\n \"title\": \"Halo\",\n \"version\": \"2.23.0-SNAPSHOT\"\n },\n \"servers\": [\n {\n \"url\": \"http://localhost:8091\",\n \"description\": \"Generated server url\"\n }\n ],\n \"security\": [\n {\n \"basicAuth\": [],\n \"bearerAuth\": []\n }\n ],\n \"paths\": {\n \"/api/v1alpha1/annotationsettings\": {\n \"get\": {\n \"description\": \"List AnnotationSetting\",\n \"operationId\": \"listAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSettingList\"\n }\n }\n },\n \"description\": \"Response annotationsettings\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create AnnotationSetting\",\n \"operationId\": \"createAnnotationSetting\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Fresh annotationsetting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response annotationsettings created just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/annotationsettings/{name}\": {\n \"delete\": {\n \"description\": \"Delete AnnotationSetting\",\n \"operationId\": \"deleteAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response annotationsetting deleted just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get AnnotationSetting\",\n \"operationId\": \"getAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response single annotationsetting\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch AnnotationSetting\",\n \"operationId\": \"patchAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response annotationsetting patched just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update AnnotationSetting\",\n \"operationId\": \"updateAnnotationSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of annotationsetting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Updated annotationsetting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n },\n \"description\": \"Response annotationsettings updated just now\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/configmaps\": {\n \"get\": {\n \"description\": \"List ConfigMap\",\n \"operationId\": \"listConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMapList\"\n }\n }\n },\n \"description\": \"Response configmaps\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ConfigMap\",\n \"operationId\": \"createConfigMap\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Fresh configmap\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response configmaps created just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/configmaps/{name}\": {\n \"delete\": {\n \"description\": \"Delete ConfigMap\",\n \"operationId\": \"deleteConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response configmap deleted just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ConfigMap\",\n \"operationId\": \"getConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response single configmap\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ConfigMap\",\n \"operationId\": \"patchConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response configmap patched just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ConfigMap\",\n \"operationId\": \"updateConfigMap\",\n \"parameters\": [\n {\n \"description\": \"Name of configmap\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Updated configmap\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n }\n },\n \"description\": \"Response configmaps updated just now\"\n }\n },\n \"tags\": [\n \"ConfigMapV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menuitems\": {\n \"get\": {\n \"description\": \"List MenuItem\",\n \"operationId\": \"listMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItemList\"\n }\n }\n },\n \"description\": \"Response menuitems\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create MenuItem\",\n \"operationId\": \"createMenuItem\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Fresh menuitem\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response menuitems created just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menuitems/{name}\": {\n \"delete\": {\n \"description\": \"Delete MenuItem\",\n \"operationId\": \"deleteMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response menuitem deleted just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get MenuItem\",\n \"operationId\": \"getMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response single menuitem\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch MenuItem\",\n \"operationId\": \"patchMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response menuitem patched just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update MenuItem\",\n \"operationId\": \"updateMenuItem\",\n \"parameters\": [\n {\n \"description\": \"Name of menuitem\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Updated menuitem\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n }\n },\n \"description\": \"Response menuitems updated just now\"\n }\n },\n \"tags\": [\n \"MenuItemV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menus\": {\n \"get\": {\n \"description\": \"List Menu\",\n \"operationId\": \"listMenu\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuList\"\n }\n }\n },\n \"description\": \"Response menus\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Menu\",\n \"operationId\": \"createMenu\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Fresh menu\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response menus created just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/menus/{name}\": {\n \"delete\": {\n \"description\": \"Delete Menu\",\n \"operationId\": \"deleteMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response menu deleted just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Menu\",\n \"operationId\": \"getMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response single menu\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Menu\",\n \"operationId\": \"patchMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response menu patched just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Menu\",\n \"operationId\": \"updateMenu\",\n \"parameters\": [\n {\n \"description\": \"Name of menu\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Updated menu\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n }\n },\n \"description\": \"Response menus updated just now\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/rolebindings\": {\n \"get\": {\n \"description\": \"List RoleBinding\",\n \"operationId\": \"listRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBindingList\"\n }\n }\n },\n \"description\": \"Response rolebindings\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create RoleBinding\",\n \"operationId\": \"createRoleBinding\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Fresh rolebinding\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response rolebindings created just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/rolebindings/{name}\": {\n \"delete\": {\n \"description\": \"Delete RoleBinding\",\n \"operationId\": \"deleteRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response rolebinding deleted just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get RoleBinding\",\n \"operationId\": \"getRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response single rolebinding\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch RoleBinding\",\n \"operationId\": \"patchRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response rolebinding patched just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update RoleBinding\",\n \"operationId\": \"updateRoleBinding\",\n \"parameters\": [\n {\n \"description\": \"Name of rolebinding\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Updated rolebinding\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n }\n },\n \"description\": \"Response rolebindings updated just now\"\n }\n },\n \"tags\": [\n \"RoleBindingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/roles\": {\n \"get\": {\n \"description\": \"List Role\",\n \"operationId\": \"listRole\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RoleList\"\n }\n }\n },\n \"description\": \"Response roles\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Role\",\n \"operationId\": \"createRole\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Fresh role\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response roles created just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/roles/{name}\": {\n \"delete\": {\n \"description\": \"Delete Role\",\n \"operationId\": \"deleteRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response role deleted just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Role\",\n \"operationId\": \"getRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response single role\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Role\",\n \"operationId\": \"patchRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response role patched just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Role\",\n \"operationId\": \"updateRole\",\n \"parameters\": [\n {\n \"description\": \"Name of role\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Updated role\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n }\n },\n \"description\": \"Response roles updated just now\"\n }\n },\n \"tags\": [\n \"RoleV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/secrets\": {\n \"get\": {\n \"description\": \"List Secret\",\n \"operationId\": \"listSecret\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SecretList\"\n }\n }\n },\n \"description\": \"Response secrets\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Secret\",\n \"operationId\": \"createSecret\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Fresh secret\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response secrets created just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/secrets/{name}\": {\n \"delete\": {\n \"description\": \"Delete Secret\",\n \"operationId\": \"deleteSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response secret deleted just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Secret\",\n \"operationId\": \"getSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response single secret\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Secret\",\n \"operationId\": \"patchSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response secret patched just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Secret\",\n \"operationId\": \"updateSecret\",\n \"parameters\": [\n {\n \"description\": \"Name of secret\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Updated secret\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n }\n },\n \"description\": \"Response secrets updated just now\"\n }\n },\n \"tags\": [\n \"SecretV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/settings\": {\n \"get\": {\n \"description\": \"List Setting\",\n \"operationId\": \"listSetting\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SettingList\"\n }\n }\n },\n \"description\": \"Response settings\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Setting\",\n \"operationId\": \"createSetting\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Fresh setting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response settings created just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/settings/{name}\": {\n \"delete\": {\n \"description\": \"Delete Setting\",\n \"operationId\": \"deleteSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response setting deleted just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Setting\",\n \"operationId\": \"getSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response single setting\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Setting\",\n \"operationId\": \"patchSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response setting patched just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Setting\",\n \"operationId\": \"updateSetting\",\n \"parameters\": [\n {\n \"description\": \"Name of setting\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Updated setting\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n }\n },\n \"description\": \"Response settings updated just now\"\n }\n },\n \"tags\": [\n \"SettingV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/users\": {\n \"get\": {\n \"description\": \"List User\",\n \"operationId\": \"listUser\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserList\"\n }\n }\n },\n \"description\": \"Response users\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create User\",\n \"operationId\": \"createUser\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Fresh user\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response users created just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n }\n },\n \"/api/v1alpha1/users/{name}\": {\n \"delete\": {\n \"description\": \"Delete User\",\n \"operationId\": \"deleteUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response user deleted just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get User\",\n \"operationId\": \"getUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response single user\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch User\",\n \"operationId\": \"patchUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response user patched just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update User\",\n \"operationId\": \"updateUser\",\n \"parameters\": [\n {\n \"description\": \"Name of user\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Updated user\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n }\n },\n \"description\": \"Response users updated just now\"\n }\n },\n \"tags\": [\n \"UserV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/authproviders\": {\n \"get\": {\n \"description\": \"List AuthProvider\",\n \"operationId\": \"listAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProviderList\"\n }\n }\n },\n \"description\": \"Response authproviders\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create AuthProvider\",\n \"operationId\": \"createAuthProvider\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Fresh authprovider\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response authproviders created just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/authproviders/{name}\": {\n \"delete\": {\n \"description\": \"Delete AuthProvider\",\n \"operationId\": \"deleteAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response authprovider deleted just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get AuthProvider\",\n \"operationId\": \"getAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response single authprovider\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch AuthProvider\",\n \"operationId\": \"patchAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response authprovider patched just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update AuthProvider\",\n \"operationId\": \"updateAuthProvider\",\n \"parameters\": [\n {\n \"description\": \"Name of authprovider\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Updated authprovider\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n }\n },\n \"description\": \"Response authproviders updated just now\"\n }\n },\n \"tags\": [\n \"AuthProviderV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/userconnections\": {\n \"get\": {\n \"description\": \"List UserConnection\",\n \"operationId\": \"listUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnectionList\"\n }\n }\n },\n \"description\": \"Response userconnections\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create UserConnection\",\n \"operationId\": \"createUserConnection\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Fresh userconnection\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response userconnections created just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n }\n },\n \"/apis/auth.halo.run/v1alpha1/userconnections/{name}\": {\n \"delete\": {\n \"description\": \"Delete UserConnection\",\n \"operationId\": \"deleteUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response userconnection deleted just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get UserConnection\",\n \"operationId\": \"getUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response single userconnection\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch UserConnection\",\n \"operationId\": \"patchUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response userconnection patched just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update UserConnection\",\n \"operationId\": \"updateUserConnection\",\n \"parameters\": [\n {\n \"description\": \"Name of userconnection\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Updated userconnection\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n },\n \"description\": \"Response userconnections updated just now\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/categories\": {\n \"get\": {\n \"description\": \"List Category\",\n \"operationId\": \"listCategory\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CategoryList\"\n }\n }\n },\n \"description\": \"Response categories\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Category\",\n \"operationId\": \"createCategory\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Fresh category\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response categories created just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/categories/{name}\": {\n \"delete\": {\n \"description\": \"Delete Category\",\n \"operationId\": \"deleteCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response category deleted just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Category\",\n \"operationId\": \"getCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response single category\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Category\",\n \"operationId\": \"patchCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response category patched just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Category\",\n \"operationId\": \"updateCategory\",\n \"parameters\": [\n {\n \"description\": \"Name of category\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Updated category\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n }\n },\n \"description\": \"Response categories updated just now\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/comments\": {\n \"get\": {\n \"description\": \"List Comment\",\n \"operationId\": \"listComment\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentList\"\n }\n }\n },\n \"description\": \"Response comments\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Comment\",\n \"operationId\": \"createComment\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Fresh comment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response comments created just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/comments/{name}\": {\n \"delete\": {\n \"description\": \"Delete Comment\",\n \"operationId\": \"deleteComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response comment deleted just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Comment\",\n \"operationId\": \"getComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response single comment\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Comment\",\n \"operationId\": \"patchComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response comment patched just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Comment\",\n \"operationId\": \"updateComment\",\n \"parameters\": [\n {\n \"description\": \"Name of comment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Updated comment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"Response comments updated just now\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"List Post\",\n \"operationId\": \"listPost\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostList\"\n }\n }\n },\n \"description\": \"Response posts\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Post\",\n \"operationId\": \"createPost\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Fresh post\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response posts created just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/posts/{name}\": {\n \"delete\": {\n \"description\": \"Delete Post\",\n \"operationId\": \"deletePost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response post deleted just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Post\",\n \"operationId\": \"getPost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response single post\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Post\",\n \"operationId\": \"patchPost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response post patched just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Post\",\n \"operationId\": \"updatePost\",\n \"parameters\": [\n {\n \"description\": \"Name of post\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Updated post\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"Response posts updated just now\"\n }\n },\n \"tags\": [\n \"PostV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/replies\": {\n \"get\": {\n \"description\": \"List Reply\",\n \"operationId\": \"listReply\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyList\"\n }\n }\n },\n \"description\": \"Response replies\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Reply\",\n \"operationId\": \"createReply\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Fresh reply\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response replies created just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/replies/{name}\": {\n \"delete\": {\n \"description\": \"Delete Reply\",\n \"operationId\": \"deleteReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reply deleted just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Reply\",\n \"operationId\": \"getReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response single reply\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Reply\",\n \"operationId\": \"patchReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response reply patched just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Reply\",\n \"operationId\": \"updateReply\",\n \"parameters\": [\n {\n \"description\": \"Name of reply\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Updated reply\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"Response replies updated just now\"\n }\n },\n \"tags\": [\n \"ReplyV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/singlepages\": {\n \"get\": {\n \"description\": \"List SinglePage\",\n \"operationId\": \"listSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageList\"\n }\n }\n },\n \"description\": \"Response singlepages\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create SinglePage\",\n \"operationId\": \"createSinglePage\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Fresh singlepage\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response singlepages created just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/singlepages/{name}\": {\n \"delete\": {\n \"description\": \"Delete SinglePage\",\n \"operationId\": \"deleteSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response singlepage deleted just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get SinglePage\",\n \"operationId\": \"getSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response single singlepage\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch SinglePage\",\n \"operationId\": \"patchSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response singlepage patched just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update SinglePage\",\n \"operationId\": \"updateSinglePage\",\n \"parameters\": [\n {\n \"description\": \"Name of singlepage\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Updated singlepage\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n }\n },\n \"description\": \"Response singlepages updated just now\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/snapshots\": {\n \"get\": {\n \"description\": \"List Snapshot\",\n \"operationId\": \"listSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SnapshotList\"\n }\n }\n },\n \"description\": \"Response snapshots\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Snapshot\",\n \"operationId\": \"createSnapshot\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Fresh snapshot\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response snapshots created just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/snapshots/{name}\": {\n \"delete\": {\n \"description\": \"Delete Snapshot\",\n \"operationId\": \"deleteSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response snapshot deleted just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Snapshot\",\n \"operationId\": \"getSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response single snapshot\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Snapshot\",\n \"operationId\": \"patchSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response snapshot patched just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Snapshot\",\n \"operationId\": \"updateSnapshot\",\n \"parameters\": [\n {\n \"description\": \"Name of snapshot\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Updated snapshot\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"Response snapshots updated just now\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/tags\": {\n \"get\": {\n \"description\": \"List Tag\",\n \"operationId\": \"listTag\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagList\"\n }\n }\n },\n \"description\": \"Response tags\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Tag\",\n \"operationId\": \"createTag\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Fresh tag\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response tags created just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n }\n },\n \"/apis/content.halo.run/v1alpha1/tags/{name}\": {\n \"delete\": {\n \"description\": \"Delete Tag\",\n \"operationId\": \"deleteTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response tag deleted just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Tag\",\n \"operationId\": \"getTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response single tag\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Tag\",\n \"operationId\": \"patchTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response tag patched just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Tag\",\n \"operationId\": \"updateTag\",\n \"parameters\": [\n {\n \"description\": \"Name of tag\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Updated tag\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"Response tags updated just now\"\n }\n },\n \"tags\": [\n \"TagV1alpha1\"\n ]\n }\n },\n \"/apis/metrics.halo.run/v1alpha1/counters\": {\n \"get\": {\n \"description\": \"List Counter\",\n \"operationId\": \"listCounter\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CounterList\"\n }\n }\n },\n \"description\": \"Response counters\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Counter\",\n \"operationId\": \"createCounter\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Fresh counter\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response counters created just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n }\n },\n \"/apis/metrics.halo.run/v1alpha1/counters/{name}\": {\n \"delete\": {\n \"description\": \"Delete Counter\",\n \"operationId\": \"deleteCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response counter deleted just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Counter\",\n \"operationId\": \"getCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response single counter\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Counter\",\n \"operationId\": \"patchCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response counter patched just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Counter\",\n \"operationId\": \"updateCounter\",\n \"parameters\": [\n {\n \"description\": \"Name of counter\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Updated counter\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n }\n },\n \"description\": \"Response counters updated just now\"\n }\n },\n \"tags\": [\n \"CounterV1alpha1\"\n ]\n }\n },\n \"/apis/migration.halo.run/v1alpha1/backups\": {\n \"get\": {\n \"description\": \"List Backup\",\n \"operationId\": \"listBackup\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/BackupList\"\n }\n }\n },\n \"description\": \"Response backups\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Backup\",\n \"operationId\": \"createBackup\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Fresh backup\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response backups created just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n }\n },\n \"/apis/migration.halo.run/v1alpha1/backups/{name}\": {\n \"delete\": {\n \"description\": \"Delete Backup\",\n \"operationId\": \"deleteBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response backup deleted just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Backup\",\n \"operationId\": \"getBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response single backup\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Backup\",\n \"operationId\": \"patchBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response backup patched just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Backup\",\n \"operationId\": \"updateBackup\",\n \"parameters\": [\n {\n \"description\": \"Name of backup\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Updated backup\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n }\n },\n \"description\": \"Response backups updated just now\"\n }\n },\n \"tags\": [\n \"BackupV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifications\": {\n \"get\": {\n \"description\": \"List Notification\",\n \"operationId\": \"listNotification\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationList\"\n }\n }\n },\n \"description\": \"Response notifications\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Notification\",\n \"operationId\": \"createNotification\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Fresh notification\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response notifications created just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifications/{name}\": {\n \"delete\": {\n \"description\": \"Delete Notification\",\n \"operationId\": \"deleteNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response notification deleted just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Notification\",\n \"operationId\": \"getNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response single notification\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Notification\",\n \"operationId\": \"patchNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response notification patched just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Notification\",\n \"operationId\": \"updateNotification\",\n \"parameters\": [\n {\n \"description\": \"Name of notification\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Updated notification\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"Response notifications updated just now\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notificationtemplates\": {\n \"get\": {\n \"description\": \"List NotificationTemplate\",\n \"operationId\": \"listNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplateList\"\n }\n }\n },\n \"description\": \"Response notificationtemplates\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create NotificationTemplate\",\n \"operationId\": \"createNotificationTemplate\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Fresh notificationtemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response notificationtemplates created just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notificationtemplates/{name}\": {\n \"delete\": {\n \"description\": \"Delete NotificationTemplate\",\n \"operationId\": \"deleteNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response notificationtemplate deleted just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get NotificationTemplate\",\n \"operationId\": \"getNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response single notificationtemplate\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch NotificationTemplate\",\n \"operationId\": \"patchNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response notificationtemplate patched just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update NotificationTemplate\",\n \"operationId\": \"updateNotificationTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of notificationtemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Updated notificationtemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n }\n },\n \"description\": \"Response notificationtemplates updated just now\"\n }\n },\n \"tags\": [\n \"NotificationTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifierDescriptors\": {\n \"get\": {\n \"description\": \"List NotifierDescriptor\",\n \"operationId\": \"listNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptorList\"\n }\n }\n },\n \"description\": \"Response notifierDescriptors\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create NotifierDescriptor\",\n \"operationId\": \"createNotifierDescriptor\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Fresh notifierDescriptor\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response notifierDescriptors created just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/notifierDescriptors/{name}\": {\n \"delete\": {\n \"description\": \"Delete NotifierDescriptor\",\n \"operationId\": \"deleteNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response notifierDescriptor deleted just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get NotifierDescriptor\",\n \"operationId\": \"getNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response single notifierDescriptor\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch NotifierDescriptor\",\n \"operationId\": \"patchNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response notifierDescriptor patched just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update NotifierDescriptor\",\n \"operationId\": \"updateNotifierDescriptor\",\n \"parameters\": [\n {\n \"description\": \"Name of notifierDescriptor\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Updated notifierDescriptor\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n }\n },\n \"description\": \"Response notifierDescriptors updated just now\"\n }\n },\n \"tags\": [\n \"NotifierDescriptorV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasons\": {\n \"get\": {\n \"description\": \"List Reason\",\n \"operationId\": \"listReason\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonList\"\n }\n }\n },\n \"description\": \"Response reasons\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Reason\",\n \"operationId\": \"createReason\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Fresh reason\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response reasons created just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasons/{name}\": {\n \"delete\": {\n \"description\": \"Delete Reason\",\n \"operationId\": \"deleteReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reason deleted just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Reason\",\n \"operationId\": \"getReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response single reason\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Reason\",\n \"operationId\": \"patchReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response reason patched just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Reason\",\n \"operationId\": \"updateReason\",\n \"parameters\": [\n {\n \"description\": \"Name of reason\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Updated reason\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n }\n },\n \"description\": \"Response reasons updated just now\"\n }\n },\n \"tags\": [\n \"ReasonV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasontypes\": {\n \"get\": {\n \"description\": \"List ReasonType\",\n \"operationId\": \"listReasonType\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeList\"\n }\n }\n },\n \"description\": \"Response reasontypes\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ReasonType\",\n \"operationId\": \"createReasonType\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Fresh reasontype\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response reasontypes created just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/reasontypes/{name}\": {\n \"delete\": {\n \"description\": \"Delete ReasonType\",\n \"operationId\": \"deleteReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reasontype deleted just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ReasonType\",\n \"operationId\": \"getReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response single reasontype\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ReasonType\",\n \"operationId\": \"patchReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response reasontype patched just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ReasonType\",\n \"operationId\": \"updateReasonType\",\n \"parameters\": [\n {\n \"description\": \"Name of reasontype\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Updated reasontype\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n }\n },\n \"description\": \"Response reasontypes updated just now\"\n }\n },\n \"tags\": [\n \"ReasonTypeV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/subscriptions\": {\n \"get\": {\n \"description\": \"List Subscription\",\n \"operationId\": \"listSubscription\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SubscriptionList\"\n }\n }\n },\n \"description\": \"Response subscriptions\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Subscription\",\n \"operationId\": \"createSubscription\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Fresh subscription\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response subscriptions created just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n }\n },\n \"/apis/notification.halo.run/v1alpha1/subscriptions/{name}\": {\n \"delete\": {\n \"description\": \"Delete Subscription\",\n \"operationId\": \"deleteSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response subscription deleted just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Subscription\",\n \"operationId\": \"getSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response single subscription\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Subscription\",\n \"operationId\": \"patchSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response subscription patched just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Subscription\",\n \"operationId\": \"updateSubscription\",\n \"parameters\": [\n {\n \"description\": \"Name of subscription\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Updated subscription\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n }\n },\n \"description\": \"Response subscriptions updated just now\"\n }\n },\n \"tags\": [\n \"SubscriptionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensiondefinitions\": {\n \"get\": {\n \"description\": \"List ExtensionDefinition\",\n \"operationId\": \"listExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinitionList\"\n }\n }\n },\n \"description\": \"Response extensiondefinitions\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ExtensionDefinition\",\n \"operationId\": \"createExtensionDefinition\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Fresh extensiondefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response extensiondefinitions created just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensiondefinitions/{name}\": {\n \"delete\": {\n \"description\": \"Delete ExtensionDefinition\",\n \"operationId\": \"deleteExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response extensiondefinition deleted just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ExtensionDefinition\",\n \"operationId\": \"getExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response single extensiondefinition\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ExtensionDefinition\",\n \"operationId\": \"patchExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response extensiondefinition patched just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ExtensionDefinition\",\n \"operationId\": \"updateExtensionDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensiondefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Updated extensiondefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n }\n },\n \"description\": \"Response extensiondefinitions updated just now\"\n }\n },\n \"tags\": [\n \"ExtensionDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensionpointdefinitions\": {\n \"get\": {\n \"description\": \"List ExtensionPointDefinition\",\n \"operationId\": \"listExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinitionList\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinitions\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ExtensionPointDefinition\",\n \"operationId\": \"createExtensionPointDefinition\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Fresh extensionpointdefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinitions created just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/extensionpointdefinitions/{name}\": {\n \"delete\": {\n \"description\": \"Delete ExtensionPointDefinition\",\n \"operationId\": \"deleteExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response extensionpointdefinition deleted just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ExtensionPointDefinition\",\n \"operationId\": \"getExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response single extensionpointdefinition\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ExtensionPointDefinition\",\n \"operationId\": \"patchExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinition patched just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ExtensionPointDefinition\",\n \"operationId\": \"updateExtensionPointDefinition\",\n \"parameters\": [\n {\n \"description\": \"Name of extensionpointdefinition\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Updated extensionpointdefinition\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n }\n },\n \"description\": \"Response extensionpointdefinitions updated just now\"\n }\n },\n \"tags\": [\n \"ExtensionPointDefinitionV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/plugins\": {\n \"get\": {\n \"description\": \"List Plugin\",\n \"operationId\": \"listPlugin\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PluginList\"\n }\n }\n },\n \"description\": \"Response plugins\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Plugin\",\n \"operationId\": \"createPlugin\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Fresh plugin\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response plugins created just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/plugins/{name}\": {\n \"delete\": {\n \"description\": \"Delete Plugin\",\n \"operationId\": \"deletePlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response plugin deleted just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Plugin\",\n \"operationId\": \"getPlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response single plugin\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Plugin\",\n \"operationId\": \"patchPlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response plugin patched just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Plugin\",\n \"operationId\": \"updatePlugin\",\n \"parameters\": [\n {\n \"description\": \"Name of plugin\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Updated plugin\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n }\n },\n \"description\": \"Response plugins updated just now\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/reverseproxies\": {\n \"get\": {\n \"description\": \"List ReverseProxy\",\n \"operationId\": \"listReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxyList\"\n }\n }\n },\n \"description\": \"Response reverseproxies\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create ReverseProxy\",\n \"operationId\": \"createReverseProxy\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Fresh reverseproxy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response reverseproxies created just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n }\n },\n \"/apis/plugin.halo.run/v1alpha1/reverseproxies/{name}\": {\n \"delete\": {\n \"description\": \"Delete ReverseProxy\",\n \"operationId\": \"deleteReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response reverseproxy deleted just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get ReverseProxy\",\n \"operationId\": \"getReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response single reverseproxy\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch ReverseProxy\",\n \"operationId\": \"patchReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response reverseproxy patched just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update ReverseProxy\",\n \"operationId\": \"updateReverseProxy\",\n \"parameters\": [\n {\n \"description\": \"Name of reverseproxy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Updated reverseproxy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n }\n },\n \"description\": \"Response reverseproxies updated just now\"\n }\n },\n \"tags\": [\n \"ReverseProxyV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/devices\": {\n \"get\": {\n \"description\": \"List Device\",\n \"operationId\": \"listDevice\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/DeviceList\"\n }\n }\n },\n \"description\": \"Response devices\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Device\",\n \"operationId\": \"createDevice\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Fresh device\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response devices created just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/devices/{name}\": {\n \"delete\": {\n \"description\": \"Delete Device\",\n \"operationId\": \"deleteDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response device deleted just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Device\",\n \"operationId\": \"getDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response single device\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Device\",\n \"operationId\": \"patchDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response device patched just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Device\",\n \"operationId\": \"updateDevice\",\n \"parameters\": [\n {\n \"description\": \"Name of device\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Updated device\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n },\n \"description\": \"Response devices updated just now\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/personalaccesstokens\": {\n \"get\": {\n \"description\": \"List PersonalAccessToken\",\n \"operationId\": \"listPersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessTokenList\"\n }\n }\n },\n \"description\": \"Response personalaccesstokens\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create PersonalAccessToken\",\n \"operationId\": \"createPersonalAccessToken\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Fresh personalaccesstoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response personalaccesstokens created just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/personalaccesstokens/{name}\": {\n \"delete\": {\n \"description\": \"Delete PersonalAccessToken\",\n \"operationId\": \"deletePersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response personalaccesstoken deleted just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get PersonalAccessToken\",\n \"operationId\": \"getPersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response single personalaccesstoken\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch PersonalAccessToken\",\n \"operationId\": \"patchPersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response personalaccesstoken patched just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update PersonalAccessToken\",\n \"operationId\": \"updatePersonalAccessToken\",\n \"parameters\": [\n {\n \"description\": \"Name of personalaccesstoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Updated personalaccesstoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"Response personalaccesstokens updated just now\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/remembermetokens\": {\n \"get\": {\n \"description\": \"List RememberMeToken\",\n \"operationId\": \"listRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeTokenList\"\n }\n }\n },\n \"description\": \"Response remembermetokens\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create RememberMeToken\",\n \"operationId\": \"createRememberMeToken\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Fresh remembermetoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response remembermetokens created just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n }\n },\n \"/apis/security.halo.run/v1alpha1/remembermetokens/{name}\": {\n \"delete\": {\n \"description\": \"Delete RememberMeToken\",\n \"operationId\": \"deleteRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response remembermetoken deleted just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get RememberMeToken\",\n \"operationId\": \"getRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response single remembermetoken\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch RememberMeToken\",\n \"operationId\": \"patchRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response remembermetoken patched just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update RememberMeToken\",\n \"operationId\": \"updateRememberMeToken\",\n \"parameters\": [\n {\n \"description\": \"Name of remembermetoken\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Updated remembermetoken\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n }\n },\n \"description\": \"Response remembermetokens updated just now\"\n }\n },\n \"tags\": [\n \"RememberMeTokenV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/attachments\": {\n \"get\": {\n \"description\": \"List Attachment\",\n \"operationId\": \"listAttachment\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AttachmentList\"\n }\n }\n },\n \"description\": \"Response attachments\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Attachment\",\n \"operationId\": \"createAttachment\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Fresh attachment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response attachments created just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/attachments/{name}\": {\n \"delete\": {\n \"description\": \"Delete Attachment\",\n \"operationId\": \"deleteAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response attachment deleted just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Attachment\",\n \"operationId\": \"getAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response single attachment\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Attachment\",\n \"operationId\": \"patchAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response attachment patched just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Attachment\",\n \"operationId\": \"updateAttachment\",\n \"parameters\": [\n {\n \"description\": \"Name of attachment\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Updated attachment\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"Response attachments updated just now\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/groups\": {\n \"get\": {\n \"description\": \"List Group\",\n \"operationId\": \"listGroup\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/GroupList\"\n }\n }\n },\n \"description\": \"Response groups\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Group\",\n \"operationId\": \"createGroup\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Fresh group\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response groups created just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/groups/{name}\": {\n \"delete\": {\n \"description\": \"Delete Group\",\n \"operationId\": \"deleteGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response group deleted just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Group\",\n \"operationId\": \"getGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response single group\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Group\",\n \"operationId\": \"patchGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response group patched just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Group\",\n \"operationId\": \"updateGroup\",\n \"parameters\": [\n {\n \"description\": \"Name of group\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Updated group\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n }\n },\n \"description\": \"Response groups updated just now\"\n }\n },\n \"tags\": [\n \"GroupV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/localthumbnails\": {\n \"get\": {\n \"description\": \"List LocalThumbnail\",\n \"operationId\": \"listLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnailList\"\n }\n }\n },\n \"description\": \"Response localthumbnails\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create LocalThumbnail\",\n \"operationId\": \"createLocalThumbnail\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Fresh localthumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response localthumbnails created just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/localthumbnails/{name}\": {\n \"delete\": {\n \"description\": \"Delete LocalThumbnail\",\n \"operationId\": \"deleteLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response localthumbnail deleted just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get LocalThumbnail\",\n \"operationId\": \"getLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response single localthumbnail\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch LocalThumbnail\",\n \"operationId\": \"patchLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response localthumbnail patched just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update LocalThumbnail\",\n \"operationId\": \"updateLocalThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of localthumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Updated localthumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n }\n },\n \"description\": \"Response localthumbnails updated just now\"\n }\n },\n \"tags\": [\n \"LocalThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policies\": {\n \"get\": {\n \"description\": \"List Policy\",\n \"operationId\": \"listPolicy\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyList\"\n }\n }\n },\n \"description\": \"Response policies\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Policy\",\n \"operationId\": \"createPolicy\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Fresh policy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response policies created just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policies/{name}\": {\n \"delete\": {\n \"description\": \"Delete Policy\",\n \"operationId\": \"deletePolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response policy deleted just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Policy\",\n \"operationId\": \"getPolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response single policy\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Policy\",\n \"operationId\": \"patchPolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response policy patched just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Policy\",\n \"operationId\": \"updatePolicy\",\n \"parameters\": [\n {\n \"description\": \"Name of policy\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Updated policy\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n }\n },\n \"description\": \"Response policies updated just now\"\n }\n },\n \"tags\": [\n \"PolicyV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policytemplates\": {\n \"get\": {\n \"description\": \"List PolicyTemplate\",\n \"operationId\": \"listPolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplateList\"\n }\n }\n },\n \"description\": \"Response policytemplates\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create PolicyTemplate\",\n \"operationId\": \"createPolicyTemplate\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Fresh policytemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response policytemplates created just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/policytemplates/{name}\": {\n \"delete\": {\n \"description\": \"Delete PolicyTemplate\",\n \"operationId\": \"deletePolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response policytemplate deleted just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get PolicyTemplate\",\n \"operationId\": \"getPolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response single policytemplate\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch PolicyTemplate\",\n \"operationId\": \"patchPolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response policytemplate patched just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update PolicyTemplate\",\n \"operationId\": \"updatePolicyTemplate\",\n \"parameters\": [\n {\n \"description\": \"Name of policytemplate\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Updated policytemplate\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n }\n },\n \"description\": \"Response policytemplates updated just now\"\n }\n },\n \"tags\": [\n \"PolicyTemplateV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/thumbnails\": {\n \"get\": {\n \"description\": \"List Thumbnail\",\n \"operationId\": \"listThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThumbnailList\"\n }\n }\n },\n \"description\": \"Response thumbnails\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Thumbnail\",\n \"operationId\": \"createThumbnail\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Fresh thumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response thumbnails created just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/storage.halo.run/v1alpha1/thumbnails/{name}\": {\n \"delete\": {\n \"description\": \"Delete Thumbnail\",\n \"operationId\": \"deleteThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response thumbnail deleted just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Thumbnail\",\n \"operationId\": \"getThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response single thumbnail\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Thumbnail\",\n \"operationId\": \"patchThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response thumbnail patched just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Thumbnail\",\n \"operationId\": \"updateThumbnail\",\n \"parameters\": [\n {\n \"description\": \"Name of thumbnail\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Updated thumbnail\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n }\n },\n \"description\": \"Response thumbnails updated just now\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1\"\n ]\n }\n },\n \"/apis/theme.halo.run/v1alpha1/themes\": {\n \"get\": {\n \"description\": \"List Theme\",\n \"operationId\": \"listTheme\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ThemeList\"\n }\n }\n },\n \"description\": \"Response themes\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"post\": {\n \"description\": \"Create Theme\",\n \"operationId\": \"createTheme\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Fresh theme\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response themes created just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n }\n },\n \"/apis/theme.halo.run/v1alpha1/themes/{name}\": {\n \"delete\": {\n \"description\": \"Delete Theme\",\n \"operationId\": \"deleteTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Response theme deleted just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"get\": {\n \"description\": \"Get Theme\",\n \"operationId\": \"getTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response single theme\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"patch\": {\n \"description\": \"Patch Theme\",\n \"operationId\": \"patchTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json-patch+json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/JsonPatch\"\n }\n }\n }\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response theme patched just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n },\n \"put\": {\n \"description\": \"Update Theme\",\n \"operationId\": \"updateTheme\",\n \"parameters\": [\n {\n \"description\": \"Name of theme\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Updated theme\"\n },\n \"responses\": {\n \"200\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n }\n },\n \"description\": \"Response themes updated just now\"\n }\n },\n \"tags\": [\n \"ThemeV1alpha1\"\n ]\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"AddOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"add\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"AnnotationSetting\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AnnotationSettingSpec\"\n }\n }\n },\n \"AnnotationSettingList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AnnotationSettingSpec\": {\n \"required\": [\n \"formSchema\",\n \"targetRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"formSchema\": {\n \"minLength\": 1,\n \"type\": \"array\",\n \"items\": {\n \"minLength\": 1,\n \"type\": \"object\"\n }\n },\n \"targetRef\": {\n \"$ref\": \"#/components/schemas/GroupKind\"\n }\n }\n },\n \"Attachment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AttachmentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/AttachmentStatus\"\n }\n }\n },\n \"AttachmentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AttachmentSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of attachment\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"Group name\"\n },\n \"mediaType\": {\n \"type\": \"string\",\n \"description\": \"Media type of attachment\"\n },\n \"ownerName\": {\n \"type\": \"string\",\n \"description\": \"Name of User who uploads the attachment\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Policy name\"\n },\n \"size\": {\n \"minimum\": 0,\n \"type\": \"integer\",\n \"description\": \"Size of attachment. Unit is Byte\",\n \"format\": \"int64\"\n },\n \"tags\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Tags of attachment\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Tag name\"\n }\n }\n }\n },\n \"AttachmentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\",\n \"description\": \"Permalink of attachment.\\nIf it is in local storage, the public URL will be set.\\nIf it is in s3 storage, the Object URL will be set.\\n\"\n },\n \"thumbnails\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"AuthProvider\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AuthProviderSpec\"\n }\n },\n \"description\": \"Auth provider extension.\"\n },\n \"AuthProviderList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/AuthProvider\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AuthProviderSpec\": {\n \"required\": [\n \"authType\",\n \"authenticationUrl\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"authType\": {\n \"type\": \"string\",\n \"description\": \"Auth type: form or oauth2.\",\n \"enum\": [\n \"FORM\",\n \"OAUTH2\"\n ]\n },\n \"authenticationUrl\": {\n \"type\": \"string\",\n \"description\": \"Authentication url of the auth provider\"\n },\n \"bindingUrl\": {\n \"type\": \"string\"\n },\n \"configMapRef\": {\n \"$ref\": \"#/components/schemas/ConfigMapRef\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of the auth provider\"\n },\n \"helpPage\": {\n \"type\": \"string\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"method\": {\n \"type\": \"string\"\n },\n \"rememberMeSupport\": {\n \"type\": \"boolean\"\n },\n \"settingRef\": {\n \"$ref\": \"#/components/schemas/SettingRef\"\n },\n \"unbindUrl\": {\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"Author\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"Backup\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/BackupSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/BackupStatus\"\n }\n }\n },\n \"BackupList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Backup\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"BackupSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"expiresAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"format\": {\n \"type\": \"string\",\n \"description\": \"Backup file format. Currently, only zip format is supported.\"\n }\n }\n },\n \"BackupStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"completionTimestamp\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"failureMessage\": {\n \"type\": \"string\"\n },\n \"failureReason\": {\n \"type\": \"string\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Name of backup file.\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"RUNNING\",\n \"SUCCEEDED\",\n \"FAILED\"\n ]\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of backup file. Data unit: byte\",\n \"format\": \"int64\"\n },\n \"startTimestamp\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n }\n }\n },\n \"Category\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CategorySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CategoryStatus\"\n }\n }\n },\n \"CategoryList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CategorySpec\": {\n \"required\": [\n \"displayName\",\n \"priority\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eWhether to hide the category from the category list.\\u003c/p\\u003e\\n \\u003cp\\u003eWhen set to true, the category including its subcategories and related posts will\\n not be displayed in the category list, but it can still be accessed by permalink.\\u003c/p\\u003e\\n \\u003cp\\u003eLimitation: It only takes effect on the theme-side categorized list and it only\\n allows to be set to true on the first level(root node) of categories.\\u003c/p\\u003e\"\n },\n \"postTemplate\": {\n \"maxLength\": 255,\n \"type\": \"string\",\n \"description\": \"\\u003cp\\u003eUsed to specify the template for the posts associated with the category.\\u003c/p\\u003e\\n \\u003cp\\u003eThe priority is not as high as that of the post.\\u003c/p\\u003e\\n \\u003cp\\u003eIf the post also specifies a template, the post\\u0027s template will prevail.\\u003c/p\\u003e\"\n },\n \"preventParentPostCascadeQuery\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eif a category is queried for related posts, the default behavior is to\\n query all posts under the category including its subcategories, but if this field is\\n set to true, cascade query behavior will be terminated here.\\u003c/p\\u003e\\n \\u003cp\\u003eFor example, if a category has subcategories A and B, and A has subcategories C and\\n D and C marked this field as true, when querying posts under A category,all posts under A\\n and B will be queried, but C and D will not be queried.\\u003c/p\\u003e\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"maxLength\": 255,\n \"type\": \"string\"\n }\n }\n },\n \"CategoryStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的已发布且公开的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n }\n }\n },\n \"Comment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n }\n },\n \"CommentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CommentOwner\": {\n \"required\": [\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"maxLength\": 64,\n \"type\": \"string\"\n }\n }\n },\n \"CommentSpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"subjectRef\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"lastReadTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"CommentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"hasNewReply\": {\n \"type\": \"boolean\"\n },\n \"lastReplyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"replyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"unreadReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visibleReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"Condition\": {\n \"required\": [\n \"lastTransitionTime\",\n \"status\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastTransitionTime\": {\n \"type\": \"string\",\n \"description\": \"Last time the condition transitioned from one status to another.\",\n \"format\": \"date-time\"\n },\n \"message\": {\n \"maxLength\": 32768,\n \"type\": \"string\",\n \"description\": \"Human-readable message indicating details about last transition.\\n This may be an empty string.\"\n },\n \"reason\": {\n \"maxLength\": 1024,\n \"pattern\": \"^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$\",\n \"type\": \"string\",\n \"description\": \"Unique, one-word, CamelCase reason for the condition\\u0027s last transition.\"\n },\n \"status\": {\n \"type\": \"string\",\n \"description\": \"Status is the status of the condition. Can be True, False, Unknown.\",\n \"enum\": [\n \"TRUE\",\n \"FALSE\",\n \"UNKNOWN\"\n ]\n },\n \"type\": {\n \"maxLength\": 316,\n \"pattern\": \"^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$\",\n \"type\": \"string\",\n \"description\": \"type of condition in CamelCase or in foo.example.com/CamelCase.\\n example: Ready, Initialized.\\n maxLength: 316.\"\n }\n },\n \"description\": \"EqualsAndHashCode 排除了lastTransitionTime否则失败时，lastTransitionTime 会被更新\\n 导致 equals 为 false，一直被加入队列.\"\n },\n \"ConfigMap\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n }\n },\n \"description\": \"\\u003cp\\u003eConfigMap holds configuration data to consume.\\u003c/p\\u003e\"\n },\n \"ConfigMapList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ConfigMap\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ConfigMapRef\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"CopyOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"copy\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"Counter\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"approvedComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"downvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"totalComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"A counter for number of requests by extension resource name.\"\n },\n \"CounterList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Counter\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CustomTemplates\": {\n \"type\": \"object\",\n \"properties\": {\n \"category\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n },\n \"page\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n },\n \"post\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TemplateDescriptor\"\n }\n }\n }\n },\n \"Device\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/DeviceSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/DeviceStatus\"\n }\n }\n },\n \"DeviceList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"DeviceSpec\": {\n \"required\": [\n \"ipAddress\",\n \"principalName\",\n \"sessionId\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"ipAddress\": {\n \"maxLength\": 129,\n \"type\": \"string\"\n },\n \"lastAccessedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"lastAuthenticatedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"principalName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"rememberMeSeriesId\": {\n \"type\": \"string\"\n },\n \"sessionId\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"userAgent\": {\n \"maxLength\": 500,\n \"type\": \"string\"\n }\n }\n },\n \"DeviceStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"browser\": {\n \"type\": \"string\"\n },\n \"os\": {\n \"type\": \"string\"\n }\n }\n },\n \"Excerpt\": {\n \"required\": [\n \"autoGenerate\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"autoGenerate\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"raw\": {\n \"type\": \"string\"\n }\n }\n },\n \"ExtensionDefinition\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ExtensionSpec\"\n }\n },\n \"description\": \"Extension definition.\\n An {@link ExtensionDefinition ExtensionDefinition} is a type of metadata that provides additional information about\\n an extension. An extension is a way to add new functionality to an existing class, structure,\\n enumeration, or protocol type without needing to subclass it.\"\n },\n \"ExtensionDefinitionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ExtensionDefinition\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ExtensionPointDefinition\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ExtensionPointSpec\"\n }\n },\n \"description\": \"Extension point definition.\\n An {@link ExtensionPointDefinition ExtensionPointDefinition} is a concept used in \\u003ccode\\u003eHalo\\u003c/code\\u003e to allow for the\\n dynamic extension of system. It defines a location within \\u003ccode\\u003eHalo\\u003c/code\\u003e where\\n additional functionality can be added through the use of plugins or extensions.\"\n },\n \"ExtensionPointDefinitionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ExtensionPointDefinition\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ExtensionPointSpec\": {\n \"required\": [\n \"className\",\n \"displayName\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"className\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"SINGLETON\",\n \"MULTI_INSTANCE\"\n ]\n }\n }\n },\n \"ExtensionSpec\": {\n \"required\": [\n \"className\",\n \"displayName\",\n \"extensionPointName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"className\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"extensionPointName\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n }\n }\n },\n \"FileReverseProxyProvider\": {\n \"type\": \"object\",\n \"properties\": {\n \"directory\": {\n \"type\": \"string\"\n },\n \"filename\": {\n \"type\": \"string\"\n }\n }\n },\n \"Group\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/GroupSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/GroupStatus\"\n }\n }\n },\n \"GroupKind\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"is group name of Extension.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"is kind name of Extension.\"\n }\n },\n \"description\": \"GroupKind contains group and kind data only.\"\n },\n \"GroupList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Group\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"GroupSpec\": {\n \"required\": [\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of group\"\n }\n }\n },\n \"GroupStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"totalAttachments\": {\n \"minimum\": 0,\n \"type\": \"integer\",\n \"description\": \"Total of attachments under the current group\",\n \"format\": \"int64\"\n },\n \"updateTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Update timestamp of the group\",\n \"format\": \"date-time\"\n }\n }\n },\n \"InterestReason\": {\n \"required\": [\n \"reasonType\",\n \"subject\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"expression\": {\n \"type\": \"string\",\n \"description\": \"The expression to be interested in\"\n },\n \"reasonType\": {\n \"type\": \"string\",\n \"description\": \"The name of the reason definition to be interested in\"\n },\n \"subject\": {\n \"$ref\": \"#/components/schemas/InterestReasonSubject\"\n }\n },\n \"description\": \"The reason to be interested in\"\n },\n \"InterestReasonSubject\": {\n \"required\": [\n \"apiVersion\",\n \"kind\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"kind\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"if name is not specified, it presents all subjects of the specified reason type and custom resources\"\n }\n },\n \"description\": \"The subject name of reason type to be interested in\"\n },\n \"JsonPatch\": {\n \"minItems\": 1,\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"JSON schema for JSONPatch operations\",\n \"items\": {\n \"oneOf\": [\n {\n \"$ref\": \"#/components/schemas/AddOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/ReplaceOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/TestOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/RemoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/MoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/CopyOperation\"\n }\n ]\n }\n },\n \"License\": {\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Common data objects for license.\"\n },\n \"LocalThumbnail\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/LocalThumbnailSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/LocalThumbnailStatus\"\n }\n }\n },\n \"LocalThumbnailList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/LocalThumbnail\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"LocalThumbnailSpec\": {\n \"required\": [\n \"filePath\",\n \"imageSignature\",\n \"imageUri\",\n \"size\",\n \"thumbSignature\",\n \"thumbnailUri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"filePath\": {\n \"type\": \"string\",\n \"description\": \"Consider the compatibility of the system and migration, use unix-style relative paths\\n here.\"\n },\n \"imageSignature\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"A hash signature for the image uri.\"\n },\n \"imageUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"string\",\n \"enum\": [\n \"S\",\n \"M\",\n \"L\",\n \"XL\"\n ]\n },\n \"thumbSignature\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"A hash signature for the thumbnail uri.\"\n },\n \"thumbnailUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"LocalThumbnailStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"SUCCEEDED\",\n \"FAILED\"\n ]\n }\n }\n },\n \"Menu\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuSpec\"\n }\n }\n },\n \"MenuItem\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuItemSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/MenuItemStatus\"\n }\n }\n },\n \"MenuItemList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/MenuItem\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"MenuItemSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Children of this menu item\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"The name of menu item child\"\n }\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"The display name of menu item.\"\n },\n \"href\": {\n \"type\": \"string\",\n \"description\": \"The href of this menu item.\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"description\": \"The priority is for ordering.\",\n \"format\": \"int32\"\n },\n \"target\": {\n \"type\": \"string\",\n \"description\": \"The \\u003ca\\u003e target attribute of this menu item.\",\n \"enum\": [\n \"_blank\",\n \"_self\",\n \"_parent\",\n \"_top\"\n ]\n },\n \"targetRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n },\n \"description\": \"The spec of menu item.\"\n },\n \"MenuItemStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Calculated Display name of menu item.\"\n },\n \"href\": {\n \"type\": \"string\",\n \"description\": \"Calculated href of manu item.\"\n }\n },\n \"description\": \"The status of menu item.\"\n },\n \"MenuList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Menu\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"MenuSpec\": {\n \"required\": [\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"The display name of the menu.\"\n },\n \"menuItems\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Menu items of this menu.\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Name of menu item.\"\n }\n }\n },\n \"description\": \"The spec of menu.\"\n },\n \"Metadata\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Annotations are like key-value format.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Creation timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"deletionTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Deletion timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"finalizers\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"nullable\": true,\n \"items\": {\n \"type\": \"string\",\n \"nullable\": true\n }\n },\n \"generateName\": {\n \"type\": \"string\",\n \"description\": \"The name field will be generated automatically according to the given generateName field\"\n },\n \"labels\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Labels are like key-value format.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Metadata name\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Current version of the Extension. It will be bumped up every update.\",\n \"format\": \"int64\",\n \"nullable\": true\n }\n },\n \"description\": \"Metadata of Extension.\"\n },\n \"MoveOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"move\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"Notification\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotificationSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Notification Notification} is a custom extension that used to store notification information for\\n inner use, it\\u0027s on-site notification.\\u003c/p\\u003e\\n\\n \\u003cp\\u003eSupports the following operations:\\u003c/p\\u003e\\n \\u003cul\\u003e\\n \\u003cli\\u003eMarked as read: {@link NotificationSpec#setUnread(boolean) NotificationSpec#setUnread(boolean)}\\u003c/li\\u003e\\n \\u003cli\\u003eGet the last read time: {@link NotificationSpec#getLastReadAt NotificationSpec#getLastReadAt()}\\u003c/li\\u003e\\n \\u003cli\\u003eFilter by recipient: {@link NotificationSpec#getRecipient NotificationSpec#getRecipient()}\\u003c/li\\u003e\\n \\u003c/ul\\u003e\"\n },\n \"NotificationList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotificationSpec\": {\n \"required\": [\n \"htmlContent\",\n \"rawContent\",\n \"reason\",\n \"recipient\",\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"htmlContent\": {\n \"type\": \"string\"\n },\n \"lastReadAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"rawContent\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"The name of reason\"\n },\n \"recipient\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"The name of user\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"unread\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"NotificationTemplate\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotificationTemplateSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link NotificationTemplate NotificationTemplate} is a custom extension that defines a notification template.\\u003c/p\\u003e\\n \\u003cp\\u003eIt describes the notification template\\u0027s name, description, and the template content.\\u003c/p\\u003e\\n \\u003cp\\u003e{@link Spec#getReasonSelector Spec#getReasonSelector()} is used to select the template by reasonType and language,\\n if multiple templates are matched, the best match will be selected. This is useful when you\\n want to override the default template.\\u003c/p\\u003e\"\n },\n \"NotificationTemplateList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/NotificationTemplate\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotificationTemplateSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"reasonSelector\": {\n \"$ref\": \"#/components/schemas/ReasonSelector\"\n },\n \"template\": {\n \"$ref\": \"#/components/schemas/TemplateContent\"\n }\n }\n },\n \"NotifierDescriptor\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptorSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link NotifierDescriptor NotifierDescriptor} is a custom extension that defines a notifier.\\u003c/p\\u003e\\n \\u003cp\\u003eIt describes the notifier\\u0027s name, description, and the extension name of the notifier to\\n let the user know what the notifier is and what it can do in the UI and also let the\\n \\u003ccode\\u003eNotificationCenter\\u003c/code\\u003e know how to load the notifier and prepare the notifier\\u0027s settings.\\u003c/p\\u003e\"\n },\n \"NotifierDescriptorList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/NotifierDescriptor\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotifierDescriptorSpec\": {\n \"required\": [\n \"displayName\",\n \"notifierExtName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"notifierExtName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"receiverSettingRef\": {\n \"$ref\": \"#/components/schemas/NotifierSettingRef\"\n },\n \"senderSettingRef\": {\n \"$ref\": \"#/components/schemas/NotifierSettingRef\"\n }\n }\n },\n \"NotifierSettingRef\": {\n \"required\": [\n \"group\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n }\n },\n \"PatSpec\": {\n \"required\": [\n \"name\",\n \"tokenId\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"expiresAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"lastUsed\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"revoked\": {\n \"type\": \"boolean\"\n },\n \"revokesAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"scopes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"tokenId\": {\n \"type\": \"string\"\n },\n \"username\": {\n \"type\": \"string\"\n }\n }\n },\n \"PersonalAccessToken\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PatSpec\"\n }\n }\n },\n \"PersonalAccessTokenList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Plugin\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PluginSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PluginStatus\"\n }\n },\n \"description\": \"A custom resource for Plugin.\"\n },\n \"PluginAuthor\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"website\": {\n \"type\": \"string\"\n }\n }\n },\n \"PluginList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Plugin\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PluginSpec\": {\n \"required\": [\n \"version\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"author\": {\n \"$ref\": \"#/components/schemas/PluginAuthor\"\n },\n \"configMapName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"issues\": {\n \"type\": \"string\"\n },\n \"license\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/License\"\n }\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"pluginDependencies\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"repo\": {\n \"type\": \"string\"\n },\n \"requires\": {\n \"type\": \"string\",\n \"description\": \"SemVer format.\"\n },\n \"settingName\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"pattern\": \"^(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)(?:-((?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\\\.(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\\\+([0-9a-zA-Z-]+(?:\\\\.[0-9a-zA-Z-]+)*))?$\",\n \"type\": \"string\",\n \"description\": \"plugin version.\"\n }\n }\n },\n \"PluginStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"entry\": {\n \"type\": \"string\"\n },\n \"lastProbeState\": {\n \"type\": \"string\",\n \"enum\": [\n \"CREATED\",\n \"DISABLED\",\n \"RESOLVED\",\n \"STARTED\",\n \"STOPPED\",\n \"FAILED\",\n \"UNLOADED\"\n ]\n },\n \"lastStartTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"loadLocation\": {\n \"type\": \"string\",\n \"description\": \"Load location of the plugin, often a path.\",\n \"format\": \"uri\"\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"PENDING\",\n \"STARTING\",\n \"CREATED\",\n \"DISABLING\",\n \"DISABLED\",\n \"RESOLVED\",\n \"STARTED\",\n \"STOPPED\",\n \"FAILED\",\n \"UNKNOWN\"\n ]\n },\n \"stylesheet\": {\n \"type\": \"string\"\n }\n }\n },\n \"Policy\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PolicySpec\"\n }\n }\n },\n \"PolicyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Policy\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PolicyRule\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroups\": {\n \"type\": \"array\",\n \"description\": \"APIGroups is the name of the APIGroup that contains the resources.\\n If multiple API groups are specified, any action requested against one of the enumerated\\n resources in any API group will be allowed.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"nonResourceURLs\": {\n \"type\": \"array\",\n \"description\": \"NonResourceURLs is a set of partial urls that a user should have access to.\\n *s are allowed, but only as the full, final step in the path\\n If an action is not a resource API request, then the URL is split on \\u0027/\\u0027 and is checked\\n against the NonResourceURLs to look for a match.\\n Since non-resource URLs are not namespaced, this field is only applicable for\\n ClusterRoles referenced from a ClusterRoleBinding.\\n Rules can either apply to API resources (such as \\\"pods\\\" or \\\"secrets\\\") or non-resource\\n URL paths (such as \\\"/api\\\"), but not both.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"resourceNames\": {\n \"type\": \"array\",\n \"description\": \"ResourceNames is an optional white list of names that the rule applies to. An empty set\\n means that everything is allowed.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"resources\": {\n \"type\": \"array\",\n \"description\": \"Resources is a list of resources this rule applies to. \\u0027*\\u0027 represents all resources in\\n the specified apiGroups.\\n \\u0027*\\u0026#47;foo\\u0027 represents the subresource \\u0027foo\\u0027 for all resources in the specified\\n apiGroups.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"verbs\": {\n \"type\": \"array\",\n \"description\": \"about who the rule applies to or which namespace the rule applies to.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"PolicyRule holds information that describes a policy rule, but does not contain information\\n about whom the rule applies to or which namespace the rule applies to.\"\n },\n \"PolicySpec\": {\n \"required\": [\n \"displayName\",\n \"templateName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"configMapName\": {\n \"type\": \"string\",\n \"description\": \"Reference name of ConfigMap extension\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of policy\"\n },\n \"templateName\": {\n \"type\": \"string\",\n \"description\": \"Reference name of PolicyTemplate\"\n }\n }\n },\n \"PolicyTemplate\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PolicyTemplateSpec\"\n }\n }\n },\n \"PolicyTemplateList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PolicyTemplate\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PolicyTemplateSpec\": {\n \"required\": [\n \"settingName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\"\n },\n \"settingName\": {\n \"type\": \"string\"\n }\n }\n },\n \"Post\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003ePost extension.\\u003c/p\\u003e\"\n },\n \"PostList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"PostSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"文章引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"PostStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"Reason\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReasonSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Reason Reason} is a custom extension that defines a reason for a notification, It represents\\n an instance of a {@link ReasonType ReasonType}.\\u003c/p\\u003e\\n \\u003cp\\u003eIt can be understood as an event that triggers a notification.\\u003c/p\\u003e\"\n },\n \"ReasonAttributes\": {\n \"type\": \"object\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"description\": \"Attributes used to transfer data\"\n },\n \"ReasonList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Reason\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReasonProperty\": {\n \"required\": [\n \"name\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"optional\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"type\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"ReasonSelector\": {\n \"required\": [\n \"language\",\n \"reasonType\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"language\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"default\": \"default\"\n },\n \"reasonType\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"ReasonSpec\": {\n \"required\": [\n \"author\",\n \"reasonType\",\n \"subject\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"attributes\": {\n \"$ref\": \"#/components/schemas/ReasonAttributes\"\n },\n \"author\": {\n \"type\": \"string\"\n },\n \"reasonType\": {\n \"type\": \"string\"\n },\n \"subject\": {\n \"$ref\": \"#/components/schemas/ReasonSubject\"\n }\n }\n },\n \"ReasonSubject\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"name\",\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReasonType\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReasonTypeSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link ReasonType ReasonType} is a custom extension that defines a type of reason.\\u003c/p\\u003e\\n \\u003cp\\u003eOne {@link ReasonType ReasonType} can have multiple {@link Reason Reason}s to notify.\\u003c/p\\u003e\"\n },\n \"ReasonTypeList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonType\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReasonTypeSpec\": {\n \"required\": [\n \"description\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"properties\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonProperty\"\n }\n }\n }\n },\n \"Ref\": {\n \"required\": [\n \"group\",\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"Extension group\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Extension kind\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Extension name. This field is mandatory\"\n },\n \"version\": {\n \"type\": \"string\",\n \"description\": \"Extension version\"\n }\n },\n \"description\": \"Extension reference object. The name is mandatory\"\n },\n \"RememberMeToken\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/RememberMeTokenSpec\"\n }\n }\n },\n \"RememberMeTokenList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/RememberMeToken\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RememberMeTokenSpec\": {\n \"required\": [\n \"series\",\n \"tokenValue\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastUsed\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"series\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tokenValue\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"username\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"RemoveOperation\": {\n \"required\": [\n \"op\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"remove\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"ReplaceOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"replace\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Reply\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReplySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ReplyStatus\"\n }\n }\n },\n \"ReplyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReplySpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"commentName\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"commentName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReplyStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReverseProxy\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"rules\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReverseProxyRule\"\n }\n }\n },\n \"description\": \"\\u003cp\\u003eThe reverse proxy custom resource is used to configure a path to proxy it to a directory or\\n file.\\u003c/p\\u003e\\n \\u003cp\\u003eHTTP proxy may be added in the future.\\u003c/p\\u003e\"\n },\n \"ReverseProxyList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReverseProxy\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReverseProxyRule\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"$ref\": \"#/components/schemas/FileReverseProxyProvider\"\n },\n \"path\": {\n \"type\": \"string\"\n }\n }\n },\n \"Role\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"rules\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"rules\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PolicyRule\"\n }\n }\n }\n },\n \"RoleBinding\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"roleRef\": {\n \"$ref\": \"#/components/schemas/RoleRef\"\n },\n \"subjects\": {\n \"type\": \"array\",\n \"description\": \"Subjects holds references to the objects the role applies to.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Subject\"\n }\n }\n },\n \"description\": \"RoleBinding references a role, but does not contain it.\\n It can reference a Role in the global.\\n It adds who information via Subjects.\"\n },\n \"RoleBindingList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/RoleBinding\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RoleList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Role\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"RoleRef\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroup\": {\n \"type\": \"string\",\n \"description\": \"APIGroup is the group for the resource being referenced.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Kind is the type of resource being referenced.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Name is the name of resource being referenced.\"\n }\n },\n \"description\": \"RoleRef contains information that points to the role being used.\"\n },\n \"Secret\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\",\n \"format\": \"byte\"\n },\n \"description\": \"\\u003cp\\u003eThe total bytes of the values in\\n the Data field must be less than {@link run.halo.app.extension.Secret#MAX_SECRET_SIZE #MAX_SECRET_SIZE} bytes.\\u003c/p\\u003e\\n \\u003cp\\u003e\\u003ccode\\u003edata\\u003c/code\\u003e contains the secret data. Each key must consist of alphanumeric\\n characters, \\u0027-\\u0027, \\u0027_\\u0027 or \\u0027.\\u0027. The serialized form of the secret data is a\\n base64 encoded string, representing the arbitrary (possibly non-string)\\n data value here. Described in\\n \\u003ca href\\u003d\\\"https://tools.ietf.org/html/rfc4648#section-4\\\"\\u003erfc4648#section-4\\u003c/a\\u003e\\n \\u003c/p\\u003e\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"stringData\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"\\u003ccode\\u003estringData\\u003c/code\\u003e allows specifying non-binary secret data in string form.\\n It is provided as a write-only input field for convenience.\\n All keys and values are merged into the data field on write, overwriting any existing\\n values.\\n The stringData field is never output when reading from the API.\"\n },\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Used to facilitate programmatic handling of secret data.\\n More info:\\n \\u003ca href\\u003d\\\"https://kubernetes.io/docs/concepts/configuration/secret/#secret-types\\\"\\u003esecret-types\\u003c/a\\u003e\"\n }\n },\n \"description\": \"Secret is a small piece of sensitive data which should be kept secret, such as a password,\\n a token, or a key.\"\n },\n \"SecretList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Secret\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Setting\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SettingSpec\"\n }\n },\n \"description\": \"{@link Setting Setting} is a custom extension to generate forms based on configuration.\"\n },\n \"SettingForm\": {\n \"minLength\": 1,\n \"required\": [\n \"formSchema\",\n \"group\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"formSchema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"group\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"type\": \"string\"\n }\n }\n },\n \"SettingList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Setting\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SettingRef\": {\n \"required\": [\n \"group\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"SettingSpec\": {\n \"required\": [\n \"forms\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"forms\": {\n \"minLength\": 1,\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/SettingForm\"\n }\n }\n }\n },\n \"SinglePage\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003eSingle page extension.\\u003c/p\\u003e\"\n },\n \"SinglePageList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/SinglePage\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SinglePageSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"SinglePageStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"SnapShotSpec\": {\n \"required\": [\n \"owner\",\n \"rawType\",\n \"subjectRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contentPatch\": {\n \"type\": \"string\"\n },\n \"contributors\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"parentSnapshotName\": {\n \"type\": \"string\"\n },\n \"rawPatch\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"maxLength\": 50,\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"such as: markdown | html | json | asciidoc | latex.\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n }\n },\n \"Snapshot\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SnapShotSpec\"\n }\n }\n },\n \"SnapshotList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Subject\": {\n \"type\": \"object\",\n \"properties\": {\n \"apiGroup\": {\n \"type\": \"string\",\n \"description\": \"APIGroup holds the API group of the referenced subject.\\n Defaults to \\\"\\\" for ServiceAccount subjects.\\n Defaults to \\\"rbac.authorization.halo.run\\\" for User and Group subjects.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Kind of object being referenced. Values defined by this API group are \\\"User\\\", \\\"Group\\\",\\n and \\\"ServiceAccount\\\".\\n If the Authorizer does not recognize the kind value, the Authorizer should report\\n an error.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Name of the object being referenced.\"\n }\n }\n },\n \"Subscription\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SubscriptionSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Subscription Subscription} is a custom extension that defines a subscriber to be notified when a\\n certain {@link Reason Reason} is triggered.\\u003c/p\\u003e\\n \\u003cp\\u003eIt holds a {@link Subscriber Subscriber} to the user to be notified, a {@link InterestReason InterestReason} to\\n subscribe to.\\u003c/p\\u003e\"\n },\n \"SubscriptionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Subscription\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SubscriptionSpec\": {\n \"required\": [\n \"reason\",\n \"subscriber\",\n \"unsubscribeToken\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"disabled\": {\n \"type\": \"boolean\",\n \"description\": \"Perhaps users need to unsubscribe and interact without receiving notifications again\"\n },\n \"reason\": {\n \"$ref\": \"#/components/schemas/InterestReason\"\n },\n \"subscriber\": {\n \"$ref\": \"#/components/schemas/SubscriptionSubscriber\"\n },\n \"unsubscribeToken\": {\n \"type\": \"string\",\n \"description\": \"The token to unsubscribe\"\n }\n }\n },\n \"SubscriptionSubscriber\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n },\n \"description\": \"The subscriber to be notified\"\n },\n \"Tag\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/TagSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/TagStatus\"\n }\n }\n },\n \"TagList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"TagSpec\": {\n \"required\": [\n \"displayName\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"color\": {\n \"pattern\": \"^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$\",\n \"type\": \"string\",\n \"description\": \"Color regex explanation.\\n \\u003cpre\\u003e\\n ^ # start of the line\\n # # start with a number sign `#`\\n ( # start of (group 1)\\n [a-fA-F0-9]{6} # support z-f, A-F and 0-9, with a length of 6\\n | # or\\n [a-fA-F0-9]{3} # support z-f, A-F and 0-9, with a length of 3\\n ) # end of (group 1)\\n $ # end of the line\\n \\u003c/pre\\u003e\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TagStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"TemplateContent\": {\n \"required\": [\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"htmlBody\": {\n \"type\": \"string\"\n },\n \"rawBody\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TemplateDescriptor\": {\n \"required\": [\n \"file\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"file\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"screenshot\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Type used to describe custom template page.\"\n },\n \"TestOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"test\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Theme\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ThemeSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ThemeStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003eTheme extension.\\u003c/p\\u003e\"\n },\n \"ThemeList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Theme\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ThemeSpec\": {\n \"required\": [\n \"author\",\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"author\": {\n \"$ref\": \"#/components/schemas/Author\"\n },\n \"configMapName\": {\n \"type\": \"string\"\n },\n \"customTemplates\": {\n \"$ref\": \"#/components/schemas/CustomTemplates\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"issues\": {\n \"type\": \"string\"\n },\n \"license\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/License\"\n }\n },\n \"logo\": {\n \"type\": \"string\"\n },\n \"repo\": {\n \"type\": \"string\"\n },\n \"requires\": {\n \"type\": \"string\"\n },\n \"settingName\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"string\"\n }\n }\n },\n \"ThemeStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\",\n \"enum\": [\n \"READY\",\n \"FAILED\",\n \"UNKNOWN\"\n ]\n }\n }\n },\n \"Thumbnail\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ThumbnailSpec\"\n }\n }\n },\n \"ThumbnailList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Thumbnail\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ThumbnailSpec\": {\n \"required\": [\n \"imageSignature\",\n \"imageUri\",\n \"size\",\n \"thumbnailUri\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"imageSignature\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"imageUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"string\",\n \"enum\": [\n \"S\",\n \"M\",\n \"L\",\n \"XL\"\n ]\n },\n \"thumbnailUri\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"User\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/UserSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/UserStatus\"\n }\n },\n \"description\": \"The extension represents user details of Halo.\"\n },\n \"UserConnection\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/UserConnectionSpec\"\n }\n },\n \"description\": \"User connection extension.\"\n },\n \"UserConnectionList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"UserConnectionSpec\": {\n \"required\": [\n \"providerUserId\",\n \"registrationId\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"providerUserId\": {\n \"type\": \"string\",\n \"description\": \"The unique identifier for the user\\u0027s connection to the OAuth provider.\\n for example, the user\\u0027s GitHub id.\"\n },\n \"registrationId\": {\n \"type\": \"string\",\n \"description\": \"The name of the OAuth provider (e.g. Google, Facebook, Twitter).\"\n },\n \"updatedAt\": {\n \"type\": \"string\",\n \"description\": \"The time when the user connection was last updated.\",\n \"format\": \"date-time\"\n },\n \"username\": {\n \"type\": \"string\",\n \"description\": \"The {@link Metadata#getName Metadata#getName()} of the user associated with the OAuth connection.\"\n }\n }\n },\n \"UserList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/User\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"UserSpec\": {\n \"required\": [\n \"displayName\",\n \"email\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"disabled\": {\n \"type\": \"boolean\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"emailVerified\": {\n \"type\": \"boolean\"\n },\n \"loginHistoryLimit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"password\": {\n \"type\": \"string\"\n },\n \"phone\": {\n \"type\": \"string\"\n },\n \"registeredAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"totpEncryptedSecret\": {\n \"type\": \"string\"\n },\n \"twoFactorAuthEnabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"UserStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"securitySchemes\": {\n \"basicAuth\": {\n \"scheme\": \"basic\",\n \"type\": \"http\"\n },\n \"bearerAuth\": {\n \"bearerFormat\": \"JWT\",\n \"scheme\": \"bearer\",\n \"type\": \"http\"\n }\n }\n }\n}" }, { "path": "api-docs/openapi/v3_0/apis_public.api_v1alpha1.json", "content": "{\n \"openapi\": \"3.0.1\",\n \"info\": {\n \"title\": \"Halo\",\n \"version\": \"2.23.0-SNAPSHOT\"\n },\n \"servers\": [\n {\n \"url\": \"http://localhost:8091\",\n \"description\": \"Generated server url\"\n }\n ],\n \"security\": [\n {\n \"basicAuth\": [],\n \"bearerAuth\": []\n }\n ],\n \"paths\": {\n \"/apis/api.content.halo.run/v1alpha1/categories\": {\n \"get\": {\n \"description\": \"Lists categories.\",\n \"operationId\": \"queryCategories\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CategoryVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/categories/{name}\": {\n \"get\": {\n \"description\": \"Gets category by name.\",\n \"operationId\": \"queryCategoryByName\",\n \"parameters\": [\n {\n \"description\": \"Category name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/categories/{name}/posts\": {\n \"get\": {\n \"description\": \"Lists posts by category name.\",\n \"operationId\": \"queryPostsByCategoryName\",\n \"parameters\": [\n {\n \"description\": \"Category name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CategoryV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"Lists posts.\",\n \"operationId\": \"queryPosts\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/posts/{name}\": {\n \"get\": {\n \"description\": \"Gets a post by name.\",\n \"operationId\": \"queryPostByName\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/posts/{name}/navigation\": {\n \"get\": {\n \"description\": \"Gets a post navigation by name.\",\n \"operationId\": \"queryPostNavigationByName\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NavigationPostVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/singlepages\": {\n \"get\": {\n \"description\": \"Lists single pages\",\n \"operationId\": \"querySinglePages\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedSinglePageVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/singlepages/{name}\": {\n \"get\": {\n \"description\": \"Gets single page by name\",\n \"operationId\": \"querySinglePageByName\",\n \"parameters\": [\n {\n \"description\": \"SinglePage name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SinglePageVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SinglePageV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/tags\": {\n \"get\": {\n \"description\": \"Lists tags\",\n \"operationId\": \"queryTags\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/tags/{name}\": {\n \"get\": {\n \"description\": \"Gets tag by name\",\n \"operationId\": \"queryTagByName\",\n \"parameters\": [\n {\n \"description\": \"Tag name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.content.halo.run/v1alpha1/tags/{name}/posts\": {\n \"get\": {\n \"description\": \"Lists posts by tag name\",\n \"operationId\": \"queryPostsByTagName\",\n \"parameters\": [\n {\n \"description\": \"Tag name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TagV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/comments\": {\n \"get\": {\n \"description\": \"List comments.\",\n \"operationId\": \"ListComments_1\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"The comment subject group.\",\n \"in\": \"query\",\n \"name\": \"group\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The comment subject version.\",\n \"in\": \"query\",\n \"name\": \"version\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The comment subject kind.\",\n \"in\": \"query\",\n \"name\": \"kind\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The comment subject name.\",\n \"in\": \"query\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Whether to include replies. Default is false.\",\n \"in\": \"query\",\n \"name\": \"withReplies\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n },\n {\n \"description\": \"Reply size of the comment, default is 10, only works when withReplies is true.\",\n \"in\": \"query\",\n \"name\": \"replySize\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentWithReplyVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n },\n \"post\": {\n \"description\": \"Create a comment.\",\n \"operationId\": \"CreateComment_1\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Comment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/comments/{name}\": {\n \"get\": {\n \"description\": \"Get a comment.\",\n \"operationId\": \"GetComment\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CommentVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/comments/{name}/reply\": {\n \"get\": {\n \"description\": \"List comment replies.\",\n \"operationId\": \"ListCommentReplies\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyVoList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n },\n \"post\": {\n \"description\": \"Create a reply.\",\n \"operationId\": \"CreateReply_1\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReplyRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Reply\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"CommentV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/indices/-/search\": {\n \"post\": {\n \"description\": \"Search indices.\",\n \"operationId\": \"IndicesSearch\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SearchOption\"\n }\n }\n },\n \"description\": \"Please note that the \\\"filterPublished\\\", \\\"filterExposed\\\" and \\\"filterRecycled\\\" fields are ignored in this endpoint.\"\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SearchResult\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"IndexV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/menus/-\": {\n \"get\": {\n \"description\": \"Gets primary menu.\",\n \"operationId\": \"queryPrimaryMenu\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/menus/{name}\": {\n \"get\": {\n \"description\": \"Gets menu by name.\",\n \"operationId\": \"queryMenuByName\",\n \"parameters\": [\n {\n \"description\": \"Menu name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MenuVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MenuV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/stats/-\": {\n \"get\": {\n \"description\": \"Gets site stats\",\n \"operationId\": \"queryStats\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/SiteStatsVo\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SystemV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/trackers/counter\": {\n \"post\": {\n \"description\": \"Count an extension resource visits.\",\n \"operationId\": \"count\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/CounterRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MetricsV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/trackers/downvote\": {\n \"post\": {\n \"description\": \"Downvote an extension resource.\",\n \"operationId\": \"downvote\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/VoteRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MetricsV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.halo.run/v1alpha1/trackers/upvote\": {\n \"post\": {\n \"description\": \"Upvote an extension resource.\",\n \"operationId\": \"upvote\",\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/VoteRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"MetricsV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/subscriptions/{name}/unsubscribe\": {\n \"get\": {\n \"description\": \"Unsubscribe a subscription\",\n \"operationId\": \"Unsubscribe\",\n \"parameters\": [\n {\n \"description\": \"Subscription name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Unsubscribe token\",\n \"in\": \"query\",\n \"name\": \"token\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.plugin.halo.run/v1alpha1/plugins/{name}/available\": {\n \"get\": {\n \"description\": \"Gets plugin available by name.\",\n \"operationId\": \"queryPluginAvailableByName\",\n \"parameters\": [\n {\n \"description\": \"Plugin name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PluginV1alpha1Public\"\n ]\n }\n },\n \"/apis/api.storage.halo.run/v1alpha1/thumbnails/-/via-uri\": {\n \"get\": {\n \"description\": \"Get thumbnail by URI\",\n \"operationId\": \"GetThumbnailByUri\",\n \"parameters\": [\n {\n \"description\": \"The URI of the image\",\n \"in\": \"query\",\n \"name\": \"uri\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"The size of the thumbnail\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"S\",\n \"M\",\n \"L\",\n \"XL\"\n ]\n }\n },\n {\n \"description\": \"The width of the thumbnail, if \\u0027size\\u0027 is not provided, this parameter will be used to determine the size\",\n \"in\": \"query\",\n \"name\": \"width\",\n \"schema\": {\n \"type\": \"integer\",\n \"enum\": [\n \"400\",\n \"800\",\n \"1200\",\n \"1600\"\n ]\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"ThumbnailV1alpha1Public\"\n ]\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"AddOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"add\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"CategorySpec\": {\n \"required\": [\n \"displayName\",\n \"priority\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eWhether to hide the category from the category list.\\u003c/p\\u003e\\n \\u003cp\\u003eWhen set to true, the category including its subcategories and related posts will\\n not be displayed in the category list, but it can still be accessed by permalink.\\u003c/p\\u003e\\n \\u003cp\\u003eLimitation: It only takes effect on the theme-side categorized list and it only\\n allows to be set to true on the first level(root node) of categories.\\u003c/p\\u003e\"\n },\n \"postTemplate\": {\n \"maxLength\": 255,\n \"type\": \"string\",\n \"description\": \"\\u003cp\\u003eUsed to specify the template for the posts associated with the category.\\u003c/p\\u003e\\n \\u003cp\\u003eThe priority is not as high as that of the post.\\u003c/p\\u003e\\n \\u003cp\\u003eIf the post also specifies a template, the post\\u0027s template will prevail.\\u003c/p\\u003e\"\n },\n \"preventParentPostCascadeQuery\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eif a category is queried for related posts, the default behavior is to\\n query all posts under the category including its subcategories, but if this field is\\n set to true, cascade query behavior will be terminated here.\\u003c/p\\u003e\\n \\u003cp\\u003eFor example, if a category has subcategories A and B, and A has subcategories C and\\n D and C marked this field as true, when querying posts under A category,all posts under A\\n and B will be queried, but C and D will not be queried.\\u003c/p\\u003e\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"maxLength\": 255,\n \"type\": \"string\"\n }\n }\n },\n \"CategoryStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的已发布且公开的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n }\n }\n },\n \"CategoryVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CategorySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CategoryStatus\"\n }\n },\n \"description\": \"A value object for {@link Category Category}.\"\n },\n \"CategoryVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Comment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n }\n },\n \"CommentEmailOwner\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\",\n \"description\": \"avatar for comment owner\"\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"display name for comment owner\"\n },\n \"email\": {\n \"type\": \"string\",\n \"description\": \"email for comment owner\"\n },\n \"website\": {\n \"type\": \"string\",\n \"description\": \"website for comment owner\"\n }\n },\n \"description\": \"\\u003cp\\u003eThe creator info of the comment.\\u003c/p\\u003e\\n This {@link CommentEmailOwner CommentEmailOwner} is only applicable to the user who is allowed to comment\\n without logging in.\"\n },\n \"CommentOwner\": {\n \"required\": [\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"name\": {\n \"maxLength\": 64,\n \"type\": \"string\"\n }\n }\n },\n \"CommentRequest\": {\n \"required\": [\n \"content\",\n \"raw\",\n \"subjectRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentEmailOwner\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n },\n \"description\": \"Request parameter object for {@link Comment Comment}.\"\n },\n \"CommentSpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"subjectRef\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"lastReadTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"CommentStatsVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"comment stats value object.\"\n },\n \"CommentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"hasNewReply\": {\n \"type\": \"boolean\"\n },\n \"lastReplyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"replyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"unreadReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visibleReplyCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"CommentVo\": {\n \"required\": [\n \"metadata\",\n \"owner\",\n \"spec\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"CommentVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CommentVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"CommentWithReplyVo\": {\n \"required\": [\n \"metadata\",\n \"owner\",\n \"spec\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"replies\": {\n \"$ref\": \"#/components/schemas/ListResultReplyVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CommentSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CommentStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"CommentWithReplyVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CommentWithReplyVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"Condition\": {\n \"required\": [\n \"lastTransitionTime\",\n \"status\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastTransitionTime\": {\n \"type\": \"string\",\n \"description\": \"Last time the condition transitioned from one status to another.\",\n \"format\": \"date-time\"\n },\n \"message\": {\n \"maxLength\": 32768,\n \"type\": \"string\",\n \"description\": \"Human-readable message indicating details about last transition.\\n This may be an empty string.\"\n },\n \"reason\": {\n \"maxLength\": 1024,\n \"pattern\": \"^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$\",\n \"type\": \"string\",\n \"description\": \"Unique, one-word, CamelCase reason for the condition\\u0027s last transition.\"\n },\n \"status\": {\n \"type\": \"string\",\n \"description\": \"Status is the status of the condition. Can be True, False, Unknown.\",\n \"enum\": [\n \"TRUE\",\n \"FALSE\",\n \"UNKNOWN\"\n ]\n },\n \"type\": {\n \"maxLength\": 316,\n \"pattern\": \"^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$\",\n \"type\": \"string\",\n \"description\": \"type of condition in CamelCase or in foo.example.com/CamelCase.\\n example: Ready, Initialized.\\n maxLength: 316.\"\n }\n },\n \"description\": \"EqualsAndHashCode 排除了lastTransitionTime否则失败时，lastTransitionTime 会被更新\\n 导致 equals 为 false，一直被加入队列.\"\n },\n \"ContentVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"A value object for Content from {@link Snapshot Snapshot}.\"\n },\n \"ContributorVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"permalink\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"A value object for {@link run.halo.app.core.extension.User run.halo.app.core.extension.User}.\"\n },\n \"CopyOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"copy\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"CounterRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\"\n },\n \"hostname\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"plural\": {\n \"type\": \"string\"\n },\n \"referrer\": {\n \"type\": \"string\"\n },\n \"screen\": {\n \"type\": \"string\"\n }\n }\n },\n \"Excerpt\": {\n \"required\": [\n \"autoGenerate\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"autoGenerate\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"raw\": {\n \"type\": \"string\"\n }\n }\n },\n \"HaloDocument\": {\n \"required\": [\n \"content\",\n \"id\",\n \"metadataName\",\n \"ownerName\",\n \"permalink\",\n \"title\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Custom metadata. Make sure the map is serializable.\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"description\": \"Document categories. The item in the list is the category metadata name.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document content. Safety content, without HTML tag.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Document creation timestamp.\",\n \"format\": \"date-time\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Document description.\"\n },\n \"exposed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the document is exposed to the public.\"\n },\n \"id\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document ID. It should be unique globally.\"\n },\n \"metadataName\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Metadata name of the corresponding extension.\"\n },\n \"ownerName\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document owner metadata name.\"\n },\n \"permalink\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document permalink.\"\n },\n \"published\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the document is published.\"\n },\n \"recycled\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the document is recycled.\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"description\": \"Document tags. The item in the list is the tag metadata name.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document title.\"\n },\n \"type\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Document type. e.g.: post.content.halo.run, singlepage.content.halo.run, moment.moment\\n .halo.run, doc.doc.halo.run.\"\n },\n \"updateTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Document update timestamp.\",\n \"format\": \"date-time\"\n }\n },\n \"description\": \"Document for search.\"\n },\n \"JsonPatch\": {\n \"minItems\": 1,\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"JSON schema for JSONPatch operations\",\n \"items\": {\n \"oneOf\": [\n {\n \"$ref\": \"#/components/schemas/AddOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/ReplaceOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/TestOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/RemoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/MoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/CopyOperation\"\n }\n ]\n }\n },\n \"ListResultReplyVo\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReplyVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedPostVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n }\n },\n \"description\": \"A value object for {@link Post Post}.\"\n },\n \"ListedPostVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"ListedSinglePageVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedSinglePageVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedSinglePageVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"MenuItemSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Children of this menu item\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"The name of menu item child\"\n }\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"The display name of menu item.\"\n },\n \"href\": {\n \"type\": \"string\",\n \"description\": \"The href of this menu item.\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"description\": \"The priority is for ordering.\",\n \"format\": \"int32\"\n },\n \"target\": {\n \"type\": \"string\",\n \"description\": \"The \\u003ca\\u003e target attribute of this menu item.\",\n \"enum\": [\n \"_blank\",\n \"_self\",\n \"_parent\",\n \"_top\"\n ]\n },\n \"targetRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n }\n },\n \"MenuItemStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Calculated Display name of menu item.\"\n },\n \"href\": {\n \"type\": \"string\",\n \"description\": \"Calculated href of manu item.\"\n }\n }\n },\n \"MenuItemVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/MenuItemVo\"\n }\n },\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Gets menu item\\u0027s display name.\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"parentName\": {\n \"type\": \"string\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuItemSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/MenuItemStatus\"\n }\n },\n \"description\": \"A value object for {@link MenuItem MenuItem}.\"\n },\n \"MenuSpec\": {\n \"required\": [\n \"displayName\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"The display name of the menu.\"\n },\n \"menuItems\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Menu items of this menu.\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Name of menu item.\"\n }\n }\n }\n },\n \"MenuVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"menuItems\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/MenuItemVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/MenuSpec\"\n }\n },\n \"description\": \"A value object for {@link Menu Menu}.\"\n },\n \"Metadata\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Annotations are like key-value format.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Creation timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"deletionTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Deletion timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"finalizers\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"nullable\": true,\n \"items\": {\n \"type\": \"string\",\n \"nullable\": true\n }\n },\n \"generateName\": {\n \"type\": \"string\",\n \"description\": \"The name field will be generated automatically according to the given generateName field\"\n },\n \"labels\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Labels are like key-value format.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Metadata name\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Current version of the Extension. It will be bumped up every update.\",\n \"format\": \"int64\",\n \"nullable\": true\n }\n },\n \"description\": \"Metadata of Extension.\"\n },\n \"MoveOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"move\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"NavigationPostVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"next\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n },\n \"previous\": {\n \"$ref\": \"#/components/schemas/ListedPostVo\"\n }\n },\n \"description\": \"Post navigation vo to hold previous and next item.\"\n },\n \"OwnerInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Comment owner info.\"\n },\n \"PostSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"文章引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"PostStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"PostVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/CategoryVo\"\n }\n },\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentVo\"\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n }\n },\n \"description\": \"A value object for {@link Post Post}.\"\n },\n \"Ref\": {\n \"required\": [\n \"group\",\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"Extension group\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Extension kind\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Extension name. This field is mandatory\"\n },\n \"version\": {\n \"type\": \"string\",\n \"description\": \"Extension version\"\n }\n },\n \"description\": \"Extension reference object. The name is mandatory\"\n },\n \"RemoveOperation\": {\n \"required\": [\n \"op\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"remove\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"ReplaceOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"replace\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"Reply\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReplySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/ReplyStatus\"\n }\n }\n },\n \"ReplyRequest\": {\n \"required\": [\n \"content\",\n \"raw\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentEmailOwner\"\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n },\n \"description\": \"A request parameter object for {@link Reply Reply}.\"\n },\n \"ReplySpec\": {\n \"required\": [\n \"allowNotification\",\n \"approved\",\n \"commentName\",\n \"content\",\n \"hidden\",\n \"owner\",\n \"priority\",\n \"raw\",\n \"top\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowNotification\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"approved\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"approvedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"commentName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"content\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"creationTime\": {\n \"type\": \"string\",\n \"description\": \"The user-defined creation time default is \\u003ccode\\u003emetadata.creationTimestamp\\u003c/code\\u003e.\",\n \"format\": \"date-time\"\n },\n \"hidden\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"ipAddress\": {\n \"type\": \"string\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/CommentOwner\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"quoteReply\": {\n \"type\": \"string\"\n },\n \"raw\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"top\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"userAgent\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReplyStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"ReplyVo\": {\n \"required\": [\n \"metadata\",\n \"owner\",\n \"spec\",\n \"stats\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/OwnerInfo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/ReplySpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/CommentStatsVo\"\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ReplyVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReplyVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"SearchOption\": {\n \"required\": [\n \"keyword\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Additional annotations for extending search option by other search engines.\"\n },\n \"filterExposed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether to filter exposed content. If null, it will not filter.\"\n },\n \"filterPublished\": {\n \"type\": \"boolean\",\n \"description\": \"Whether to filter published content. If null, it will not filter.\"\n },\n \"filterRecycled\": {\n \"type\": \"boolean\",\n \"description\": \"Whether to filter recycled content. If null, it will not filter.\"\n },\n \"highlightPostTag\": {\n \"type\": \"string\",\n \"description\": \"Post HTML tag of highlighted fragment.\"\n },\n \"highlightPreTag\": {\n \"type\": \"string\",\n \"description\": \"Pre HTML tag of highlighted fragment.\"\n },\n \"includeCategoryNames\": {\n \"type\": \"array\",\n \"description\": \"Category names to include(and). If null, it will include all categories.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"includeOwnerNames\": {\n \"type\": \"array\",\n \"description\": \"Owner names to include(or). If null, it will include all owners.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"includeTagNames\": {\n \"type\": \"array\",\n \"description\": \"Tag names to include(and). If null, it will include all tags.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"includeTypes\": {\n \"type\": \"array\",\n \"description\": \"Types to include(or). If null, it will include all types.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"keyword\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"Search keyword.\"\n },\n \"limit\": {\n \"maximum\": 1000,\n \"minimum\": 1,\n \"type\": \"integer\",\n \"description\": \"Limit of result.\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Search option. It is used to control search behavior.\"\n },\n \"SearchResult\": {\n \"type\": \"object\",\n \"properties\": {\n \"hits\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/HaloDocument\"\n }\n },\n \"keyword\": {\n \"type\": \"string\"\n },\n \"limit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"processingTimeMillis\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n }\n }\n },\n \"SinglePageSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"SinglePageStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"SinglePageVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"$ref\": \"#/components/schemas/ContentVo\"\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n }\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/ContributorVo\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SinglePageSpec\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/StatsVo\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/SinglePageStatus\"\n }\n },\n \"description\": \"A value object for {@link SinglePage SinglePage}.\"\n },\n \"SiteStatsVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"category\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"comment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"post\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"A value object for site stats.\"\n },\n \"StatsVo\": {\n \"type\": \"object\",\n \"properties\": {\n \"comment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Stats value object.\"\n },\n \"TagSpec\": {\n \"required\": [\n \"displayName\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"color\": {\n \"pattern\": \"^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$\",\n \"type\": \"string\",\n \"description\": \"Color regex explanation.\\n \\u003cpre\\u003e\\n ^ # start of the line\\n # # start with a number sign `#`\\n ( # start of (group 1)\\n [a-fA-F0-9]{6} # support z-f, A-F and 0-9, with a length of 6\\n | # or\\n [a-fA-F0-9]{3} # support z-f, A-F and 0-9, with a length of 3\\n ) # end of (group 1)\\n $ # end of the line\\n \\u003c/pre\\u003e\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TagStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"TagVo\": {\n \"required\": [\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/TagSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/TagStatus\"\n }\n },\n \"description\": \"A value object for {@link Tag Tag}.\"\n },\n \"TagVoList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/TagVo\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"TestOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"test\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"VoteRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"plural\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"securitySchemes\": {\n \"basicAuth\": {\n \"scheme\": \"basic\",\n \"type\": \"http\"\n },\n \"bearerAuth\": {\n \"bearerFormat\": \"JWT\",\n \"scheme\": \"bearer\",\n \"type\": \"http\"\n }\n }\n }\n}" }, { "path": "api-docs/openapi/v3_0/apis_uc.api_v1alpha1.json", "content": "{\n \"openapi\": \"3.0.1\",\n \"info\": {\n \"title\": \"Halo\",\n \"version\": \"2.23.0-SNAPSHOT\"\n },\n \"servers\": [\n {\n \"url\": \"http://localhost:8091\",\n \"description\": \"Generated server url\"\n }\n ],\n \"security\": [\n {\n \"basicAuth\": [],\n \"bearerAuth\": []\n }\n ],\n \"paths\": {\n \"/apis/api.notification.halo.run/v1alpha1/notifiers/{name}/receiver-config\": {\n \"get\": {\n \"description\": \"Fetch receiver config of notifier\",\n \"operationId\": \"FetchReceiverConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Save receiver config of notifier\",\n \"operationId\": \"SaveReceiverConfig\",\n \"parameters\": [\n {\n \"description\": \"Notifier name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {},\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotifierV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notification-preferences\": {\n \"get\": {\n \"description\": \"List notification preferences for the authenticated user.\",\n \"operationId\": \"ListUserNotificationPreferences\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierMatrix\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Save notification preferences for the authenticated user.\",\n \"operationId\": \"SaveUserNotificationPreferences\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierCollectionRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierMatrix\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications\": {\n \"get\": {\n \"description\": \"List notifications for the authenticated user.\",\n \"operationId\": \"ListUserNotifications\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/NotificationList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/-/mark-specified-as-read\": {\n \"put\": {\n \"description\": \"Mark the specified notifications as read.\",\n \"operationId\": \"MarkNotificationsAsRead\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/MarkSpecifiedRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/{name}\": {\n \"delete\": {\n \"description\": \"Delete the specified notification.\",\n \"operationId\": \"DeleteSpecifiedNotification\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Notification name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/{name}/mark-as-read\": {\n \"put\": {\n \"description\": \"Mark the specified notification as read.\",\n \"operationId\": \"MarkNotificationAsRead\",\n \"parameters\": [\n {\n \"description\": \"Username\",\n \"in\": \"path\",\n \"name\": \"username\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Notification name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"NotificationV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.auth.halo.run/v1alpha1/user-connections/{registerId}/disconnect\": {\n \"put\": {\n \"description\": \"Disconnect my connection from a third-party platform.\",\n \"operationId\": \"DisconnectMyConnection\",\n \"parameters\": [\n {\n \"description\": \"The registration ID of the third-party platform.\",\n \"in\": \"path\",\n \"name\": \"registerId\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/UserConnection\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserConnectionV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts\": {\n \"get\": {\n \"description\": \"List posts owned by the current user.\",\n \"operationId\": \"ListMyPosts\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Posts filtered by publish phase.\",\n \"in\": \"query\",\n \"name\": \"publishPhase\",\n \"schema\": {\n \"type\": \"string\",\n \"enum\": [\n \"DRAFT\",\n \"PENDING_APPROVAL\",\n \"PUBLISHED\",\n \"FAILED\"\n ]\n }\n },\n {\n \"description\": \"Posts filtered by keyword.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Posts filtered by category including sub-categories.\",\n \"in\": \"query\",\n \"name\": \"categoryWithChildren\",\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/ListedPostList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Create my post. If you want to create a post with content, please set\\n annotation: \\\"content.halo.run/content-json\\\" into annotations and refer\\n to Content for corresponding data type.\\n\",\n \"operationId\": \"CreateMyPost\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}\": {\n \"get\": {\n \"description\": \"Get post that belongs to the current user.\",\n \"operationId\": \"GetMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n },\n \"put\": {\n \"description\": \"Update my post.\",\n \"operationId\": \"UpdateMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/draft\": {\n \"get\": {\n \"description\": \"Get my post draft.\",\n \"operationId\": \"GetMyPostDraft\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Should include patched content and raw or not.\",\n \"in\": \"query\",\n \"name\": \"patched\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n },\n \"put\": {\n \"description\": \"Update draft of my post. Please make sure set annotation:\\n\\\"content.halo.run/content-json\\\" into annotations and refer to\\nContent for corresponding data type.\\n\",\n \"operationId\": \"UpdateMyPostDraft\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/publish\": {\n \"put\": {\n \"description\": \"Publish my post.\",\n \"operationId\": \"PublishMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/recycle\": {\n \"delete\": {\n \"description\": \"Move my post to recycle bin.\",\n \"operationId\": \"RecycleMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/posts/{name}/unpublish\": {\n \"put\": {\n \"description\": \"Unpublish my post.\",\n \"operationId\": \"UnpublishMyPost\",\n \"parameters\": [\n {\n \"description\": \"Post name\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Post\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PostV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.content.halo.run/v1alpha1/snapshots/{name}\": {\n \"get\": {\n \"description\": \"Get snapshot for one post.\",\n \"operationId\": \"GetSnapshotForPost\",\n \"parameters\": [\n {\n \"description\": \"Snapshot name.\",\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Post name.\",\n \"in\": \"query\",\n \"name\": \"postName\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Should include patched content and raw or not.\",\n \"in\": \"query\",\n \"name\": \"patched\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Snapshot\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"SnapshotV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.halo.run/v1alpha1/annotationsettings\": {\n \"get\": {\n \"description\": \"List available AnnotationSettings for the given targetRef. The available AnnotationSettings are determined by the currently activated theme and started plugins.\",\n \"operationId\": \"listAvailableAnnotationSettings\",\n \"parameters\": [\n {\n \"description\": \"The targetRef of the AnnotationSetting. e.g.: \\u0027content.halo.run/Post\",\n \"in\": \"query\",\n \"name\": \"targetRef\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/AnnotationSetting\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AnnotationSettingV1AlphaUc\"\n ]\n }\n },\n \"/apis/uc.api.halo.run/v1alpha1/user-preferences/{group}\": {\n \"get\": {\n \"description\": \"Get my preference by group.\",\n \"operationId\": \"getMyPreference\",\n \"parameters\": [\n {\n \"description\": \"Group of user preference, e.g. `notification`.\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"UserPreferenceV1alpha1Uc\"\n ]\n },\n \"put\": {\n \"description\": \"Create or update my preference by group.\",\n \"operationId\": \"updateMyPreference\",\n \"parameters\": [\n {\n \"description\": \"Group of user preference, e.g. `notification`.\",\n \"in\": \"path\",\n \"name\": \"group\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"object\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"204\": {\n \"description\": \"No content, preference updated successfully.\"\n }\n },\n \"tags\": [\n \"UserPreferenceV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/settings\": {\n \"get\": {\n \"description\": \"Get Two-factor authentication settings.\",\n \"operationId\": \"GetTwoFactorAuthenticationSettings\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/settings/disabled\": {\n \"put\": {\n \"description\": \"Disable Two-factor authentication\",\n \"operationId\": \"DisableTwoFactor\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PasswordRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/settings/enabled\": {\n \"put\": {\n \"description\": \"Enable Two-factor authentication\",\n \"operationId\": \"EnableTwoFactor\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PasswordRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/totp\": {\n \"post\": {\n \"description\": \"Configure a TOTP\",\n \"operationId\": \"ConfigurerTotp\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TotpRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/totp/-\": {\n \"delete\": {\n \"operationId\": \"DeleteTotp\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PasswordRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TwoFactorAuthSettings\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/authentications/two-factor/totp/auth-link\": {\n \"get\": {\n \"description\": \"Get TOTP auth link, including secret\",\n \"operationId\": \"GetTotpAuthLink\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/TotpAuthLinkResponse\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"TwoFactorAuthV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/devices\": {\n \"get\": {\n \"description\": \"List all user devices\",\n \"operationId\": \"ListDevices\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/UserDevice\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/devices/{deviceId}\": {\n \"delete\": {\n \"description\": \"Revoke a own device\",\n \"operationId\": \"RevokeDevice\",\n \"parameters\": [\n {\n \"description\": \"Device ID\",\n \"in\": \"path\",\n \"name\": \"deviceId\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {\n \"204 NO_CONTENT\": {\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"DeviceV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens\": {\n \"get\": {\n \"description\": \"Obtain PAT list.\",\n \"operationId\": \"ObtainPats\",\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"description\": \"Generate a PAT.\",\n \"operationId\": \"GeneratePat\",\n \"requestBody\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PersonalAccessToken\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens/{name}\": {\n \"delete\": {\n \"description\": \"Delete a PAT\",\n \"operationId\": \"DeletePat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n },\n \"get\": {\n \"description\": \"Obtain a PAT.\",\n \"operationId\": \"ObtainPat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens/{name}/actions/restoration\": {\n \"put\": {\n \"description\": \"Restore a PAT.\",\n \"operationId\": \"RestorePat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens/{name}/actions/revocation\": {\n \"put\": {\n \"description\": \"Revoke a PAT\",\n \"operationId\": \"RevokePat\",\n \"parameters\": [\n {\n \"in\": \"path\",\n \"name\": \"name\",\n \"required\": true,\n \"schema\": {\n \"type\": \"string\"\n }\n }\n ],\n \"responses\": {},\n \"tags\": [\n \"PersonalAccessTokenV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.storage.halo.run/v1alpha1/attachments\": {\n \"get\": {\n \"description\": \"List attachments of the current user uploaded.\",\n \"operationId\": \"ListMyAttachments\",\n \"parameters\": [\n {\n \"description\": \"Page number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"page\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Size number. Default is 0.\",\n \"in\": \"query\",\n \"name\": \"size\",\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n {\n \"description\": \"Label selector. e.g.: hidden!\\u003dtrue\",\n \"in\": \"query\",\n \"name\": \"labelSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Field selector. e.g.: metadata.name\\u003d\\u003dhalo\",\n \"in\": \"query\",\n \"name\": \"fieldSelector\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.\",\n \"in\": \"query\",\n \"name\": \"sort\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n },\n {\n \"description\": \"Filter attachments without group. This parameter will ignore group parameter.\",\n \"in\": \"query\",\n \"name\": \"ungrouped\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n },\n {\n \"description\": \"Keyword for searching.\",\n \"in\": \"query\",\n \"name\": \"keyword\",\n \"schema\": {\n \"type\": \"string\"\n }\n },\n {\n \"description\": \"Acceptable media types.\",\n \"in\": \"query\",\n \"name\": \"accepts\",\n \"schema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/AttachmentList\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n },\n \"post\": {\n \"deprecated\": true,\n \"description\": \"Create attachment for the given post. Deprecated in favor of /attachments/-/upload.\",\n \"operationId\": \"CreateAttachmentForPost\",\n \"parameters\": [\n {\n \"description\": \"Wait for permalink.\",\n \"in\": \"query\",\n \"name\": \"waitForPermalink\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/PostAttachmentRequest\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.storage.halo.run/v1alpha1/attachments/-/upload\": {\n \"post\": {\n \"description\": \"Upload attachment to user center storage.\",\n \"operationId\": \"UploadAttachmentForUc\",\n \"requestBody\": {\n \"content\": {\n \"multipart/form-data\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UploadForm\"\n }\n }\n }\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n }\n },\n \"/apis/uc.api.storage.halo.run/v1alpha1/attachments/-/upload-from-url\": {\n \"post\": {\n \"deprecated\": true,\n \"description\": \"Upload attachment from the given URL.\\nDeprecated in favor of /attachments/-/upload.\",\n \"operationId\": \"ExternalTransferAttachment_1\",\n \"parameters\": [\n {\n \"description\": \"Wait for permalink.\",\n \"in\": \"query\",\n \"name\": \"waitForPermalink\",\n \"schema\": {\n \"type\": \"boolean\"\n }\n }\n ],\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/UcUploadFromUrlRequest\"\n }\n }\n },\n \"required\": true\n },\n \"responses\": {\n \"default\": {\n \"content\": {\n \"*/*\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n }\n },\n \"description\": \"default response\"\n }\n },\n \"tags\": [\n \"AttachmentV1alpha1Uc\"\n ]\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"AddOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"add\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"AnnotationSetting\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AnnotationSettingSpec\"\n }\n }\n },\n \"AnnotationSettingSpec\": {\n \"required\": [\n \"formSchema\",\n \"targetRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"formSchema\": {\n \"minLength\": 1,\n \"type\": \"array\",\n \"items\": {\n \"minLength\": 1,\n \"type\": \"object\"\n }\n },\n \"targetRef\": {\n \"$ref\": \"#/components/schemas/GroupKind\"\n }\n }\n },\n \"Attachment\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/AttachmentSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/AttachmentStatus\"\n }\n }\n },\n \"AttachmentList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Attachment\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"AttachmentSpec\": {\n \"type\": \"object\",\n \"properties\": {\n \"displayName\": {\n \"type\": \"string\",\n \"description\": \"Display name of attachment\"\n },\n \"groupName\": {\n \"type\": \"string\",\n \"description\": \"Group name\"\n },\n \"mediaType\": {\n \"type\": \"string\",\n \"description\": \"Media type of attachment\"\n },\n \"ownerName\": {\n \"type\": \"string\",\n \"description\": \"Name of User who uploads the attachment\"\n },\n \"policyName\": {\n \"type\": \"string\",\n \"description\": \"Policy name\"\n },\n \"size\": {\n \"minimum\": 0,\n \"type\": \"integer\",\n \"description\": \"Size of attachment. Unit is Byte\",\n \"format\": \"int64\"\n },\n \"tags\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"Tags of attachment\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Tag name\"\n }\n }\n }\n },\n \"AttachmentStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\",\n \"description\": \"Permalink of attachment.\\nIf it is in local storage, the public URL will be set.\\nIf it is in s3 storage, the Object URL will be set.\\n\"\n },\n \"thumbnails\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"Category\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/CategorySpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/CategoryStatus\"\n }\n }\n },\n \"CategorySpec\": {\n \"required\": [\n \"displayName\",\n \"priority\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"children\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eWhether to hide the category from the category list.\\u003c/p\\u003e\\n \\u003cp\\u003eWhen set to true, the category including its subcategories and related posts will\\n not be displayed in the category list, but it can still be accessed by permalink.\\u003c/p\\u003e\\n \\u003cp\\u003eLimitation: It only takes effect on the theme-side categorized list and it only\\n allows to be set to true on the first level(root node) of categories.\\u003c/p\\u003e\"\n },\n \"postTemplate\": {\n \"maxLength\": 255,\n \"type\": \"string\",\n \"description\": \"\\u003cp\\u003eUsed to specify the template for the posts associated with the category.\\u003c/p\\u003e\\n \\u003cp\\u003eThe priority is not as high as that of the post.\\u003c/p\\u003e\\n \\u003cp\\u003eIf the post also specifies a template, the post\\u0027s template will prevail.\\u003c/p\\u003e\"\n },\n \"preventParentPostCascadeQuery\": {\n \"type\": \"boolean\",\n \"description\": \"\\u003cp\\u003eif a category is queried for related posts, the default behavior is to\\n query all posts under the category including its subcategories, but if this field is\\n set to true, cascade query behavior will be terminated here.\\u003c/p\\u003e\\n \\u003cp\\u003eFor example, if a category has subcategories A and B, and A has subcategories C and\\n D and C marked this field as true, when querying posts under A category,all posts under A\\n and B will be queried, but C and D will not be queried.\\u003c/p\\u003e\"\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"template\": {\n \"maxLength\": 255,\n \"type\": \"string\"\n }\n }\n },\n \"CategoryStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"description\": \"包括当前和其下所有层级的已发布且公开的文章数量 (depth\\u003dmax).\",\n \"format\": \"int32\"\n }\n }\n },\n \"Condition\": {\n \"required\": [\n \"lastTransitionTime\",\n \"status\",\n \"type\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"lastTransitionTime\": {\n \"type\": \"string\",\n \"description\": \"Last time the condition transitioned from one status to another.\",\n \"format\": \"date-time\"\n },\n \"message\": {\n \"maxLength\": 32768,\n \"type\": \"string\",\n \"description\": \"Human-readable message indicating details about last transition.\\n This may be an empty string.\"\n },\n \"reason\": {\n \"maxLength\": 1024,\n \"pattern\": \"^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$\",\n \"type\": \"string\",\n \"description\": \"Unique, one-word, CamelCase reason for the condition\\u0027s last transition.\"\n },\n \"status\": {\n \"type\": \"string\",\n \"description\": \"Status is the status of the condition. Can be True, False, Unknown.\",\n \"enum\": [\n \"TRUE\",\n \"FALSE\",\n \"UNKNOWN\"\n ]\n },\n \"type\": {\n \"maxLength\": 316,\n \"pattern\": \"^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$\",\n \"type\": \"string\",\n \"description\": \"type of condition in CamelCase or in foo.example.com/CamelCase.\\n example: Ready, Initialized.\\n maxLength: 316.\"\n }\n },\n \"description\": \"EqualsAndHashCode 排除了lastTransitionTime否则失败时，lastTransitionTime 会被更新\\n 导致 equals 为 false，一直被加入队列.\"\n },\n \"Contributor\": {\n \"type\": \"object\",\n \"properties\": {\n \"avatar\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n },\n \"description\": \"Contributor from user.\"\n },\n \"CopyOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"copy\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"Device\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\",\n \"status\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/DeviceSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/DeviceStatus\"\n }\n }\n },\n \"DeviceSpec\": {\n \"required\": [\n \"ipAddress\",\n \"principalName\",\n \"sessionId\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"ipAddress\": {\n \"maxLength\": 129,\n \"type\": \"string\"\n },\n \"lastAccessedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"lastAuthenticatedTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"principalName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"rememberMeSeriesId\": {\n \"type\": \"string\"\n },\n \"sessionId\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"userAgent\": {\n \"maxLength\": 500,\n \"type\": \"string\"\n }\n }\n },\n \"DeviceStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"browser\": {\n \"type\": \"string\"\n },\n \"os\": {\n \"type\": \"string\"\n }\n }\n },\n \"Excerpt\": {\n \"required\": [\n \"autoGenerate\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"autoGenerate\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"raw\": {\n \"type\": \"string\"\n }\n }\n },\n \"GroupKind\": {\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"is group name of Extension.\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"is kind name of Extension.\"\n }\n },\n \"description\": \"GroupKind contains group and kind data only.\"\n },\n \"JsonPatch\": {\n \"minItems\": 1,\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"description\": \"JSON schema for JSONPatch operations\",\n \"items\": {\n \"oneOf\": [\n {\n \"$ref\": \"#/components/schemas/AddOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/ReplaceOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/TestOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/RemoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/MoveOperation\"\n },\n {\n \"$ref\": \"#/components/schemas/CopyOperation\"\n }\n ]\n }\n },\n \"ListedPost\": {\n \"required\": [\n \"categories\",\n \"contributors\",\n \"owner\",\n \"post\",\n \"stats\",\n \"tags\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Category\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n }\n },\n \"owner\": {\n \"$ref\": \"#/components/schemas/Contributor\"\n },\n \"post\": {\n \"$ref\": \"#/components/schemas/Post\"\n },\n \"stats\": {\n \"$ref\": \"#/components/schemas/Stats\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Tag\"\n }\n }\n },\n \"description\": \"A chunk of items.\"\n },\n \"ListedPostList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ListedPost\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"MarkSpecifiedRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"names\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"Metadata\": {\n \"required\": [\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"annotations\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Annotations are like key-value format.\"\n },\n \"creationTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Creation timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"deletionTimestamp\": {\n \"type\": \"string\",\n \"description\": \"Deletion timestamp of the Extension.\",\n \"format\": \"date-time\",\n \"nullable\": true\n },\n \"finalizers\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"nullable\": true,\n \"items\": {\n \"type\": \"string\",\n \"nullable\": true\n }\n },\n \"generateName\": {\n \"type\": \"string\",\n \"description\": \"The name field will be generated automatically according to the given generateName field\"\n },\n \"labels\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n },\n \"description\": \"Labels are like key-value format.\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Metadata name\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Current version of the Extension. It will be bumped up every update.\",\n \"format\": \"int64\",\n \"nullable\": true\n }\n },\n \"description\": \"Metadata of Extension.\"\n },\n \"MoveOperation\": {\n \"required\": [\n \"op\",\n \"from\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"from\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"move\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"Notification\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/NotificationSpec\"\n }\n },\n \"description\": \"\\u003cp\\u003e{@link Notification Notification} is a custom extension that used to store notification information for\\n inner use, it\\u0027s on-site notification.\\u003c/p\\u003e\\n\\n \\u003cp\\u003eSupports the following operations:\\u003c/p\\u003e\\n \\u003cul\\u003e\\n \\u003cli\\u003eMarked as read: {@link NotificationSpec#setUnread(boolean) NotificationSpec#setUnread(boolean)}\\u003c/li\\u003e\\n \\u003cli\\u003eGet the last read time: {@link NotificationSpec#getLastReadAt NotificationSpec#getLastReadAt()}\\u003c/li\\u003e\\n \\u003cli\\u003eFilter by recipient: {@link NotificationSpec#getRecipient NotificationSpec#getRecipient()}\\u003c/li\\u003e\\n \\u003c/ul\\u003e\"\n },\n \"NotificationList\": {\n \"required\": [\n \"first\",\n \"hasNext\",\n \"hasPrevious\",\n \"items\",\n \"last\",\n \"page\",\n \"size\",\n \"total\",\n \"totalPages\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"first\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the first page.\"\n },\n \"hasNext\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"hasPrevious\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page has previous page.\"\n },\n \"items\": {\n \"type\": \"array\",\n \"description\": \"A chunk of items.\",\n \"items\": {\n \"$ref\": \"#/components/schemas/Notification\"\n }\n },\n \"last\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether current page is the last page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Page number, starts from 1. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"size\": {\n \"type\": \"integer\",\n \"description\": \"Size of each page. If not set or equal to 0, it means no pagination.\",\n \"format\": \"int32\"\n },\n \"total\": {\n \"type\": \"integer\",\n \"description\": \"Total elements.\",\n \"format\": \"int64\"\n },\n \"totalPages\": {\n \"type\": \"integer\",\n \"description\": \"Indicates total pages.\",\n \"format\": \"int64\"\n }\n }\n },\n \"NotificationSpec\": {\n \"required\": [\n \"htmlContent\",\n \"rawContent\",\n \"reason\",\n \"recipient\",\n \"title\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"htmlContent\": {\n \"type\": \"string\"\n },\n \"lastReadAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"rawContent\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"The name of reason\"\n },\n \"recipient\": {\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"The name of user\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"unread\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"NotifierInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n }\n }\n },\n \"PasswordRequest\": {\n \"required\": [\n \"password\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"password\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"PatSpec\": {\n \"required\": [\n \"name\",\n \"tokenId\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"expiresAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"lastUsed\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"revoked\": {\n \"type\": \"boolean\"\n },\n \"revokesAt\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"roles\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"scopes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"tokenId\": {\n \"type\": \"string\"\n },\n \"username\": {\n \"type\": \"string\"\n }\n }\n },\n \"PersonalAccessToken\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PatSpec\"\n }\n }\n },\n \"Post\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/PostSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/PostStatus\"\n }\n },\n \"description\": \"\\u003cp\\u003ePost extension.\\u003c/p\\u003e\"\n },\n \"PostAttachmentRequest\": {\n \"required\": [\n \"file\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"format\": \"binary\"\n },\n \"postName\": {\n \"type\": \"string\",\n \"description\": \"Post name.\"\n },\n \"singlePageName\": {\n \"type\": \"string\",\n \"description\": \"Single page name.\"\n }\n }\n },\n \"PostSpec\": {\n \"required\": [\n \"allowComment\",\n \"deleted\",\n \"excerpt\",\n \"pinned\",\n \"priority\",\n \"publish\",\n \"slug\",\n \"title\",\n \"visible\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"allowComment\": {\n \"type\": \"boolean\",\n \"default\": true\n },\n \"baseSnapshot\": {\n \"type\": \"string\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"excerpt\": {\n \"$ref\": \"#/components/schemas/Excerpt\"\n },\n \"headSnapshot\": {\n \"type\": \"string\"\n },\n \"htmlMetas\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n },\n \"owner\": {\n \"type\": \"string\"\n },\n \"pinned\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"priority\": {\n \"type\": \"integer\",\n \"format\": \"int32\",\n \"default\": 0\n },\n \"publish\": {\n \"type\": \"boolean\",\n \"default\": false\n },\n \"publishTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"releaseSnapshot\": {\n \"type\": \"string\",\n \"description\": \"文章引用到的已发布的内容，用于主题端显示.\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"template\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"visible\": {\n \"type\": \"string\",\n \"enum\": [\n \"PUBLIC\",\n \"INTERNAL\",\n \"PRIVATE\"\n ],\n \"default\": \"PUBLIC\"\n }\n }\n },\n \"PostStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"commentsCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"properties\": {\n \"empty\": {\n \"type\": \"boolean\"\n }\n },\n \"items\": {\n \"$ref\": \"#/components/schemas/Condition\"\n }\n },\n \"contributors\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"excerpt\": {\n \"type\": \"string\"\n },\n \"hideFromList\": {\n \"type\": \"boolean\",\n \"description\": \"see {@link Category.CategorySpec#isHideFromList Category.CategorySpec#isHideFromList()}.\"\n },\n \"inProgress\": {\n \"type\": \"boolean\"\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"phase\": {\n \"type\": \"string\"\n }\n }\n },\n \"ReasonTypeInfo\": {\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"uiPermissions\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"ReasonTypeNotifierCollectionRequest\": {\n \"required\": [\n \"reasonTypeNotifiers\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"reasonTypeNotifiers\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonTypeNotifierRequest\"\n }\n }\n }\n },\n \"ReasonTypeNotifierMatrix\": {\n \"type\": \"object\",\n \"properties\": {\n \"notifiers\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/NotifierInfo\"\n }\n },\n \"reasonTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/components/schemas/ReasonTypeInfo\"\n }\n },\n \"stateMatrix\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"boolean\"\n }\n }\n }\n }\n },\n \"ReasonTypeNotifierRequest\": {\n \"type\": \"object\",\n \"properties\": {\n \"notifiers\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"reasonType\": {\n \"type\": \"string\"\n }\n }\n },\n \"Ref\": {\n \"required\": [\n \"group\",\n \"kind\",\n \"name\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"group\": {\n \"type\": \"string\",\n \"description\": \"Extension group\"\n },\n \"kind\": {\n \"type\": \"string\",\n \"description\": \"Extension kind\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"Extension name. This field is mandatory\"\n },\n \"version\": {\n \"type\": \"string\",\n \"description\": \"Extension version\"\n }\n },\n \"description\": \"Extension reference object. The name is mandatory\"\n },\n \"RemoveOperation\": {\n \"required\": [\n \"op\",\n \"path\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"remove\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n }\n }\n },\n \"ReplaceOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"replace\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"SnapShotSpec\": {\n \"required\": [\n \"owner\",\n \"rawType\",\n \"subjectRef\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"contentPatch\": {\n \"type\": \"string\"\n },\n \"contributors\": {\n \"uniqueItems\": true,\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"lastModifyTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"owner\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"parentSnapshotName\": {\n \"type\": \"string\"\n },\n \"rawPatch\": {\n \"type\": \"string\"\n },\n \"rawType\": {\n \"maxLength\": 50,\n \"minLength\": 1,\n \"type\": \"string\",\n \"description\": \"such as: markdown | html | json | asciidoc | latex.\"\n },\n \"subjectRef\": {\n \"$ref\": \"#/components/schemas/Ref\"\n }\n }\n },\n \"Snapshot\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/SnapShotSpec\"\n }\n }\n },\n \"Stats\": {\n \"type\": \"object\",\n \"properties\": {\n \"approvedComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"totalComment\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"upvote\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visit\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n },\n \"description\": \"Stats value object.\"\n },\n \"Tag\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/TagSpec\"\n },\n \"status\": {\n \"$ref\": \"#/components/schemas/TagStatus\"\n }\n }\n },\n \"TagSpec\": {\n \"required\": [\n \"displayName\",\n \"slug\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"color\": {\n \"pattern\": \"^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$\",\n \"type\": \"string\",\n \"description\": \"Color regex explanation.\\n \\u003cpre\\u003e\\n ^ # start of the line\\n # # start with a number sign `#`\\n ( # start of (group 1)\\n [a-fA-F0-9]{6} # support z-f, A-F and 0-9, with a length of 6\\n | # or\\n [a-fA-F0-9]{3} # support z-f, A-F and 0-9, with a length of 3\\n ) # end of (group 1)\\n $ # end of the line\\n \\u003c/pre\\u003e\"\n },\n \"cover\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"displayName\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"slug\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TagStatus\": {\n \"type\": \"object\",\n \"properties\": {\n \"observedVersion\": {\n \"type\": \"integer\",\n \"format\": \"int64\"\n },\n \"permalink\": {\n \"type\": \"string\"\n },\n \"postCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"visiblePostCount\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n },\n \"TestOperation\": {\n \"required\": [\n \"op\",\n \"path\",\n \"value\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"op\": {\n \"type\": \"string\",\n \"enum\": [\n \"test\"\n ]\n },\n \"path\": {\n \"pattern\": \"^(/[^/~]*(~[01][^/~]*)*)*$\",\n \"type\": \"string\",\n \"description\": \"A JSON Pointer path pointing to the location to move/copy from.\",\n \"example\": \"/a/b/c\"\n },\n \"value\": {\n \"description\": \"Value can be any JSON value\"\n }\n }\n },\n \"TotpAuthLinkResponse\": {\n \"type\": \"object\",\n \"properties\": {\n \"authLink\": {\n \"type\": \"string\",\n \"description\": \"QR Code with base64 encoded.\",\n \"format\": \"uri\"\n },\n \"rawSecret\": {\n \"type\": \"string\"\n }\n }\n },\n \"TotpRequest\": {\n \"required\": [\n \"code\",\n \"password\",\n \"secret\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"code\": {\n \"type\": \"string\"\n },\n \"password\": {\n \"minLength\": 1,\n \"type\": \"string\"\n },\n \"secret\": {\n \"minLength\": 1,\n \"type\": \"string\"\n }\n }\n },\n \"TwoFactorAuthSettings\": {\n \"type\": \"object\",\n \"properties\": {\n \"available\": {\n \"type\": \"boolean\",\n \"description\": \"Check if 2FA is available.\"\n },\n \"emailVerified\": {\n \"type\": \"boolean\"\n },\n \"enabled\": {\n \"type\": \"boolean\"\n },\n \"totpConfigured\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"UcUploadFromUrlRequest\": {\n \"required\": [\n \"url\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"Custom file name\"\n },\n \"url\": {\n \"type\": \"string\",\n \"format\": \"url\"\n }\n }\n },\n \"UploadForm\": {\n \"type\": \"object\",\n \"properties\": {\n \"file\": {\n \"type\": \"string\",\n \"description\": \"The file to upload. If not provided, the url will be used.\",\n \"format\": \"binary\"\n },\n \"filename\": {\n \"type\": \"string\",\n \"description\": \"The filename to use when uploading from url. If not provided, the filename will be\\n extracted from the url.\"\n },\n \"url\": {\n \"type\": \"string\",\n \"description\": \"The url to upload from. If not provided, the file will be used.\"\n }\n },\n \"description\": \"Upload form from console. The file and url are mutually exclusive. If both are provided,\\n the file will be used.\"\n },\n \"UserConnection\": {\n \"required\": [\n \"apiVersion\",\n \"kind\",\n \"metadata\",\n \"spec\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"apiVersion\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"type\": \"string\"\n },\n \"metadata\": {\n \"$ref\": \"#/components/schemas/Metadata\"\n },\n \"spec\": {\n \"$ref\": \"#/components/schemas/UserConnectionSpec\"\n }\n },\n \"description\": \"User connection extension.\"\n },\n \"UserConnectionSpec\": {\n \"required\": [\n \"providerUserId\",\n \"registrationId\",\n \"username\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"providerUserId\": {\n \"type\": \"string\",\n \"description\": \"The unique identifier for the user\\u0027s connection to the OAuth provider.\\n for example, the user\\u0027s GitHub id.\"\n },\n \"registrationId\": {\n \"type\": \"string\",\n \"description\": \"The name of the OAuth provider (e.g. Google, Facebook, Twitter).\"\n },\n \"updatedAt\": {\n \"type\": \"string\",\n \"description\": \"The time when the user connection was last updated.\",\n \"format\": \"date-time\"\n },\n \"username\": {\n \"type\": \"string\",\n \"description\": \"The {@link Metadata#getName Metadata#getName()} of the user associated with the OAuth connection.\"\n }\n }\n },\n \"UserDevice\": {\n \"required\": [\n \"active\",\n \"currentDevice\",\n \"device\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"active\": {\n \"type\": \"boolean\"\n },\n \"currentDevice\": {\n \"type\": \"boolean\"\n },\n \"device\": {\n \"$ref\": \"#/components/schemas/Device\"\n }\n }\n }\n },\n \"securitySchemes\": {\n \"basicAuth\": {\n \"scheme\": \"basic\",\n \"type\": \"http\"\n },\n \"bearerAuth\": {\n \"bearerFormat\": \"JWT\",\n \"scheme\": \"bearer\",\n \"type\": \"http\"\n }\n }\n }\n}" }, { "path": "application/build.gradle", "content": "import de.undercouch.gradle.tasks.download.Download\nimport org.gradle.crypto.checksum.Checksum\nimport org.springframework.boot.gradle.tasks.bundling.BootBuildImage\nimport org.springframework.boot.gradle.tasks.bundling.BootJar\nimport org.springframework.util.StringUtils\n\nplugins {\n id 'checkstyle'\n id 'java'\n id 'idea'\n id 'jacoco'\n alias(libs.plugins.spring.boot)\n alias(libs.plugins.spring.dependency.management)\n alias(libs.plugins.git.properties)\n alias(libs.plugins.undercouch.download)\n alias(libs.plugins.lombok)\n alias(libs.plugins.checksum)\n alias(libs.plugins.springdoc.openapi)\n alias(libs.plugins.versions)\n}\n\ngroup = 'run.halo.app'\n\ntasks.withType(JavaCompile).configureEach {\n options.release = 21\n options.encoding = 'UTF-8'\n}\n\njava {\n toolchain {\n languageVersion = JavaLanguageVersion.of(21)\n }\n}\n\nidea {\n module {\n resourceDirs += file(\"../ui/build/dist/\")\n }\n}\n\ncheckstyle {\n toolVersion = libs.versions.checkstyle.get()\n showViolations = false\n ignoreFailures = false\n}\n\nrepositories {\n mavenCentral()\n\n flatDir {\n dir layout.projectDirectory.dir('libs')\n }\n}\n\n\nconfigurations {\n compileOnly {\n extendsFrom annotationProcessor\n }\n}\n\nspringBoot {\n buildInfo {\n properties {\n artifact = 'halo'\n name = 'halo'\n }\n }\n}\n\nbootJar {\n archiveBaseName = 'halo'\n manifest {\n attributes 'Implementation-Title': 'Halo Application',\n 'Implementation-Vendor': 'Halo OSS Team'\n }\n duplicatesStrategy = DuplicatesStrategy.EXCLUDE\n}\n\ngitProperties {\n dotGitDirectory = layout.settingsDirectory.dir('.git')\n}\n\ntasks.named('jar') {\n enabled = false\n}\n\ndependencies {\n implementation project(':api')\n implementation libs.r2dbc.migrate.starter\n // Fix https://github.com/halo-dev/halo/issues/7289\n // Build from https://github.com/halo-dev/thymeleaf/commit/d23498ea297059deff04ba8c3578de59c73ccf03\n runtimeOnly ':thymeleaf:3.1.3.RELEASE'\n runtimeOnly ':thymeleaf-spring6:3.1.3.RELEASE'\n annotationProcessor platform(project(':platform:application'))\n\n annotationProcessor \"org.springframework.boot:spring-boot-configuration-processor\"\n annotationProcessor \"org.springframework:spring-context-indexer\"\n\n testImplementation 'org.springframework.boot:spring-boot-starter-test'\n testImplementation 'org.springframework.boot:spring-boot-webtestclient'\n testImplementation 'org.springframework.security:spring-security-test'\n testImplementation 'io.projectreactor:reactor-test'\n\n testRuntimeOnly 'org.junit.platform:junit-platform-launcher'\n\n annotationProcessor 'com.github.therapi:therapi-runtime-javadoc-scribe'\n\n // webjars\n runtimeOnly 'org.webjars.npm:jsencrypt:3.5.4'\n runtimeOnly 'org.webjars.npm:normalize.css:8.0.1'\n}\n\ntasks.register('createChecksums', Checksum) {\n dependsOn tasks.named('bootJar')\n inputFiles.setFrom(layout.buildDirectory.files('libs'))\n outputDirectory = layout.buildDirectory.dir(\"libs\")\n checksumAlgorithm = Checksum.Algorithm.SHA256\n}\n\ntasks.register('copyUiDist', Copy) {\n from project(':ui').layout.buildDirectory.dir('dist')\n into layout.buildDirectory.dir('resources/main')\n mustRunAfter ':ui:doBuild'\n}\n\ntasks.named('classes') {\n dependsOn tasks.named('copyUiDist')\n mustRunAfter tasks.named('downloadPluginPresets')\n}\n\ntasks.named('build') {\n dependsOn tasks.named('createChecksums')\n}\n\ntasks.named('test', Test) {\n useJUnitPlatform()\n maxHeapSize = '1G'\n finalizedBy jacocoTestReport\n}\n\ntasks.named('jacocoTestReport', JacocoReport) {\n reports {\n xml.required = true\n html.required = false\n }\n}\n\ntasks.register('downloadPluginPresets', Download) {\n def presetPluginUrls = [\n 'https://github.com/halo-dev/plugin-comment-widget/releases/download/v3.0.0/plugin-comment-widget-3.0.0.jar' : 'plugin-comment-widget.jar',\n 'https://github.com/halo-dev/plugin-search-widget/releases/download/v1.7.0/plugin-search-widget-1.7.0.jar' : 'plugin-search-widget.jar',\n 'https://github.com/halo-dev/plugin-sitemap/releases/download/v1.1.2/plugin-sitemap-1.1.2.jar' : 'plugin-sitemap.jar',\n 'https://github.com/halo-dev/plugin-feed/releases/download/v1.5.0/plugin-feed-1.5.0.jar' : 'plugin-feed.jar',\n 'https://github.com/halo-sigs/plugin-shiki/releases/download/v1.0.11/plugin-shiki-1.0.11.jar' : 'plugin-shiki.jar',\n 'https://github.com/halo-sigs/plugin-editor-hyperlink-card/releases/download/v1.6.0/plugin-editor-hyperlink-card-1.6.0.jar': 'plugin-editor-hyperlink-card.jar',\n\n // Currently, plugin-app-store is not open source, so we need to download it from the official website.\n // Please see https://github.com/halo-dev/plugin-app-store/issues/55\n // https://www.halo.run/store/apps/app-VYJbF/releases/app-release-qafgml3o\n 'https://www.halo.run/store/apps/app-VYJbF/releases/download/app-release-qafgml3o/assets/app-release-qafgml3o-wt4v7err' : 'appstore.jar',\n ]\n src presetPluginUrls.keySet()\n dest layout.buildDirectory.dir('resources/main/presets/plugins')\n eachFile { f ->\n f.name = presetPluginUrls[f.sourceURL.toString()]\n }\n}\n\nopenApi {\n outputDir = file(\"$rootDir/api-docs/openapi/v3_0\")\n groupedApiMappings = [\n 'http://localhost:8091/v3/api-docs/apis_aggregated.api_v1alpha1': 'aggregated.json',\n 'http://localhost:8091/v3/api-docs/apis_public.api_v1alpha1' : 'apis_public.api_v1alpha1.json',\n 'http://localhost:8091/v3/api-docs/apis_console.api_v1alpha1' : 'apis_console.api_v1alpha1.json',\n 'http://localhost:8091/v3/api-docs/apis_uc.api_v1alpha1' : 'apis_uc.api_v1alpha1.json',\n 'http://localhost:8091/v3/api-docs/apis_extension.api_v1alpha1' : 'apis_extension.api_v1alpha1.json',\n ]\n customBootRun {\n args = ['--server.port=8091',\n '--spring.profiles.active=doc',\n \"--halo.work-dir=${layout.buildDirectory.get()}/tmp/workdir-for-generating-apidocs\"]\n }\n}\n\ntasks.named('forkedSpringBootRun') {\n dependsOn ':api:jar'\n}\n\ntasks.named('generateOpenApiDocs') {\n outputs.upToDateWhen {\n false\n }\n}\n\ndef branchProvider = providers.exec { commandLine 'git', 'rev-parse', '--abbrev-ref', 'HEAD' }\n .standardOutput\n .asText\n .map { it.trim().replaceAll(\"/\", \"-\") }\ndef abbreviatedIdProvider = providers.exec { commandLine 'git', 'rev-parse', '--short', 'HEAD' }\n .standardOutput\n .asText\n .map { it.trim() }\n\ndef isRelease = project.hasProperty('release') && Boolean.parseBoolean(project.property('release').toString())\ndef repoProvider = providers.provider { isRelease ? 'halo' : 'halo-dev' }\ndef tagProvider = providers.provider {\n isRelease ? \"${project.version}-cnb\" : abbreviatedIdProvider.map { \"sha-${it}-cnb\" }.get()\n}\ndef branchTagProvider = branchProvider.map { \"${it}-cnb\" }\ndef archiveFileProvider = tasks.named('bootJar', BootJar). flatMap { it.archiveFile }\n\ntasks.register('publishToGhcr', BootBuildImage) {\n def ghcrUserProvider = providers.environmentVariable('GHCR_USERNAME')\n def ghcrTokenProvider = providers.environmentVariable('GHCR_TOKEN')\n\n group = 'publishing'\n description = 'Build and publish the Docker image to GitHub Container Registry.'\n imageName = \"ghcr.io/halo-dev/${repoProvider.get()}:${tagProvider.get()}\"\n publish = ghcrTokenProvider.map { StringUtils.hasText(it) }.orElse(false)\n if (!isRelease) {\n tags.add(\"ghcr.io/halo-dev/${repoProvider.get()}:${branchTagProvider.get()}\")\n }\n docker {\n publishRegistry {\n username = ghcrUserProvider\n password = ghcrTokenProvider\n }\n }\n archiveFile.set(archiveFileProvider)\n}\n\ntasks.register('publishToDockerHub', BootBuildImage) {\n def dockerUserProvider = providers.environmentVariable('DOCKER_USERNAME')\n def dockerTokenProvider = providers.environmentVariable('DOCKER_TOKEN')\n group = 'publishing'\n description = 'Build and publish the Docker image to Docker Hub.'\n imageName = \"halohub/${repoProvider.get()}:${tagProvider.get()}\"\n publish = dockerTokenProvider.map { StringUtils.hasText(it) }.orElse(false)\n if (!isRelease) {\n tags.add(\"halohub/${repoProvider.get()}:${branchTagProvider.get()}\")\n }\n docker {\n publishRegistry {\n username = dockerUserProvider\n password = dockerTokenProvider\n }\n }\n archiveFile.set(archiveFileProvider)\n}\n\ntasks.register('publishToAllRegistries') {\n group = 'publishing'\n description = 'Build and publish the Docker image to all configured registries.'\n dependsOn tasks.named('publishToGhcr'), tasks.named('publishToDockerHub')\n}\n" }, { "path": "application/src/main/java/run/halo/app/Application.java", "content": "package run.halo.app;\n\nimport org.springframework.boot.autoconfigure.SpringBootApplication;\nimport org.springframework.boot.builder.SpringApplicationBuilder;\nimport org.springframework.boot.context.metrics.buffering.BufferingApplicationStartup;\nimport org.springframework.boot.context.properties.ConfigurationPropertiesScan;\nimport org.springframework.boot.integration.autoconfigure.IntegrationAutoConfiguration;\nimport org.springframework.scheduling.annotation.EnableScheduling;\n\n/**\n * Halo main class.\n *\n * @author ryanwang\n * @author JohnNiang\n * @author guqing\n * @date 2017-11-14\n */\n@EnableScheduling\n@SpringBootApplication(scanBasePackages = \"run.halo.app\", exclude =\n IntegrationAutoConfiguration.class)\n@ConfigurationPropertiesScan(basePackages = \"run.halo.app.infra.properties\")\npublic class Application {\n\n public static void main(String[] args) {\n new SpringApplicationBuilder(Application.class)\n .applicationStartup(new BufferingApplicationStartup(1024))\n .run(args);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/AbstractContentService.java", "content": "package run.halo.app.content;\n\nimport java.security.Principal;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.UUID;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.Nullable;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\n\n/**\n * Abstract Service for {@link Snapshot}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@AllArgsConstructor\npublic abstract class AbstractContentService {\n\n private final ReactiveExtensionClient client;\n\n public Mono getContent(String snapshotName, String baseSnapshotName) {\n if (StringUtils.isBlank(snapshotName) || StringUtils.isBlank(baseSnapshotName)) {\n return Mono.empty();\n }\n // TODO: refactor this method to use client.get instead of fetch but please be careful\n return client.fetch(Snapshot.class, baseSnapshotName)\n .doOnNext(this::checkBaseSnapshot)\n .flatMap(baseSnapshot -> {\n if (StringUtils.equals(snapshotName, baseSnapshotName)) {\n var contentWrapper = ContentWrapper.patchSnapshot(baseSnapshot, baseSnapshot);\n return Mono.just(contentWrapper);\n }\n return client.fetch(Snapshot.class, snapshotName)\n .map(snapshot -> ContentWrapper.patchSnapshot(snapshot, baseSnapshot));\n })\n .switchIfEmpty(Mono.defer(() -> {\n log.error(\"The content snapshot [{}] or base snapshot [{}] not found.\",\n snapshotName, baseSnapshotName);\n return Mono.empty();\n }));\n }\n\n protected void checkBaseSnapshot(Snapshot snapshot) {\n Assert.notNull(snapshot, \"The snapshot must not be null.\");\n if (!Snapshot.isBaseSnapshot(snapshot)) {\n throw new IllegalArgumentException(\n String.format(\"The snapshot [%s] is not a base snapshot.\",\n snapshot.getMetadata().getName()));\n }\n }\n\n protected Mono draftContent(@Nullable String baseSnapshotName,\n ContentRequest contentRequest,\n @Nullable String parentSnapshotName) {\n return create(baseSnapshotName, contentRequest, parentSnapshotName)\n .flatMap(head -> {\n String baseSnapshotNameToUse =\n StringUtils.defaultIfBlank(baseSnapshotName, head.getMetadata().getName());\n return restoredContent(baseSnapshotNameToUse, head);\n });\n }\n\n protected Mono draftContent(String baseSnapshotName, ContentRequest content) {\n return this.draftContent(baseSnapshotName, content, content.headSnapshotName());\n }\n\n private Mono create(@Nullable String baseSnapshotName,\n ContentRequest contentRequest,\n @Nullable String parentSnapshotName) {\n Snapshot snapshot = contentRequest.toSnapshot();\n snapshot.getMetadata().setName(UUID.randomUUID().toString());\n snapshot.getSpec().setParentSnapshotName(parentSnapshotName);\n\n return client.fetch(Snapshot.class, baseSnapshotName)\n .doOnNext(this::checkBaseSnapshot)\n .defaultIfEmpty(snapshot)\n .map(baseSnapshot -> determineRawAndContentPatch(snapshot, baseSnapshot,\n contentRequest)\n )\n .flatMap(source -> getContextUsername()\n .doOnNext(username -> {\n Snapshot.addContributor(source, username);\n source.getSpec().setOwner(username);\n })\n .thenReturn(source)\n )\n .flatMap(client::create);\n }\n\n protected Mono updateContent(String baseSnapshotName,\n ContentRequest contentRequest) {\n Assert.notNull(contentRequest, \"The contentRequest must not be null\");\n Assert.notNull(baseSnapshotName, \"The baseSnapshotName must not be null\");\n Assert.notNull(contentRequest.headSnapshotName(), \"The headSnapshotName must not be null\");\n return Mono.defer(() -> client.fetch(Snapshot.class, contentRequest.headSnapshotName())\n .flatMap(headSnapshot -> {\n var oldVersion = contentRequest.version();\n var version = headSnapshot.getMetadata().getVersion();\n if (hasConflict(oldVersion, version)) {\n // draft a new snapshot as the head snapshot\n return create(baseSnapshotName, contentRequest,\n contentRequest.headSnapshotName());\n }\n return Mono.just(headSnapshot);\n })\n .flatMap(headSnapshot -> client.fetch(Snapshot.class, baseSnapshotName)\n .map(baseSnapshot -> determineRawAndContentPatch(headSnapshot,\n baseSnapshot, contentRequest))\n )\n .flatMap(headSnapshot -> getContextUsername()\n .doOnNext(username -> Snapshot.addContributor(headSnapshot, username))\n .thenReturn(headSnapshot)\n )\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(throwable -> throwable instanceof OptimisticLockingFailureException))\n .flatMap(head -> restoredContent(baseSnapshotName, head));\n }\n\n protected Flux listSnapshotsBy(Ref ref) {\n var snapshotListOptions = new ListOptions();\n var query = Queries.isNull(\"metadata.deletionTimestamp\")\n .and(Queries.equal(\"spec.subjectRef\", Snapshot.toSubjectRefKey(ref)));\n snapshotListOptions.setFieldSelector(FieldSelector.of(query));\n var sort = Sort.by(\"metadata.creationTimestamp\", \"metadata.name\").descending();\n return client.listAll(Snapshot.class, snapshotListOptions, sort);\n }\n\n boolean hasConflict(Long oldVersion, Long newVersion) {\n return oldVersion != null && !newVersion.equals(oldVersion);\n }\n\n protected Mono restoredContent(String baseSnapshotName, Snapshot headSnapshot) {\n return client.fetch(Snapshot.class, baseSnapshotName)\n .doOnNext(this::checkBaseSnapshot)\n .map(baseSnapshot -> ContentWrapper.patchSnapshot(headSnapshot, baseSnapshot));\n }\n\n protected Snapshot determineRawAndContentPatch(Snapshot snapshotToUse,\n Snapshot baseSnapshot,\n ContentRequest contentRequest) {\n Assert.notNull(baseSnapshot, \"The baseSnapshot must not be null.\");\n Assert.notNull(contentRequest, \"The contentRequest must not be null.\");\n Assert.notNull(snapshotToUse, \"The snapshotToUse not be null.\");\n String originalRaw = baseSnapshot.getSpec().getRawPatch();\n String originalContent = baseSnapshot.getSpec().getContentPatch();\n String baseSnapshotName = baseSnapshot.getMetadata().getName();\n\n snapshotToUse.getSpec().setLastModifyTime(Instant.now());\n // it is the v1 snapshot, set the content directly\n if (StringUtils.equals(baseSnapshotName,\n snapshotToUse.getMetadata().getName())) {\n snapshotToUse.getSpec().setRawPatch(contentRequest.raw());\n snapshotToUse.getSpec().setContentPatch(contentRequest.content());\n MetadataUtil.nullSafeAnnotations(snapshotToUse)\n .put(Snapshot.KEEP_RAW_ANNO, Boolean.TRUE.toString());\n } else {\n // otherwise diff a patch based on the v1 snapshot\n String revisedRaw = contentRequest.rawPatchFrom(originalRaw);\n String revisedContent = contentRequest.contentPatchFrom(originalContent);\n snapshotToUse.getSpec().setRawPatch(revisedRaw);\n snapshotToUse.getSpec().setContentPatch(revisedContent);\n }\n return snapshotToUse;\n }\n\n protected Mono getContextUsername() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/AbstractEventReconciler.java", "content": "package run.halo.app.content;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport org.springframework.context.SmartLifecycle;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.infra.InitializationPhase;\n\n/**\n * An abstract class for reconciling events.\n *\n * @author guqing\n * @since 2.15.0\n */\npublic abstract class AbstractEventReconciler implements Reconciler, SmartLifecycle {\n protected final RequestQueue queue;\n\n protected final Controller controller;\n\n protected volatile boolean running = false;\n\n private final String controllerName;\n\n protected AbstractEventReconciler(String controllerName) {\n this.controllerName = controllerName;\n this.queue = new DefaultQueue<>(Instant::now);\n this.controller = this.setupWith(null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n controllerName,\n this,\n queue,\n null,\n Duration.ofMillis(100),\n Duration.ofMinutes(10)\n );\n }\n\n @Override\n public void start() {\n controller.start();\n running = true;\n }\n\n @Override\n public void stop() {\n running = false;\n controller.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.CONTROLLERS.getPhase();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/CategoryPostCountUpdater.java", "content": "package run.halo.app.content;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport com.google.common.collect.Sets;\nimport java.util.Collection;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.PostDeletedEvent;\nimport run.halo.app.event.post.PostUpdatedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * A class used to update the post count of the category when the post changes.\n *\n * @author guqing\n * @since 2.15.0\n */\n@Component\npublic class CategoryPostCountUpdater\n extends AbstractEventReconciler {\n\n protected final ExtensionClient client;\n private final CategoryPostCountService categoryPostCountService;\n\n public CategoryPostCountUpdater(ExtensionClient client) {\n super(CategoryPostCountUpdater.class.getName());\n this.client = client;\n this.categoryPostCountService = new CategoryPostCountService(client);\n }\n\n @Override\n public Result reconcile(PostRelatedCategories request) {\n var categoryChanges = request.categoryChanges();\n\n categoryPostCountService.recalculatePostCount(categoryChanges);\n\n client.fetch(Post.class, request.postName()).ifPresent(post -> {\n var categories = defaultIfNull(post.getSpec().getCategories(), List.of());\n var annotations = MetadataUtil.nullSafeAnnotations(post);\n var categoryAnno = JsonUtils.objectToJson(categories);\n var oldCategoryAnno = annotations.get(Post.LAST_ASSOCIATED_CATEGORIES_ANNO);\n\n if (!categoryAnno.equals(oldCategoryAnno)) {\n annotations.put(Post.LAST_ASSOCIATED_CATEGORIES_ANNO, categoryAnno);\n client.update(post);\n }\n });\n return Result.doNotRetry();\n }\n\n static class CategoryPostCountService {\n\n private final ExtensionClient client;\n\n public CategoryPostCountService(ExtensionClient client) {\n this.client = client;\n }\n\n public void recalculatePostCount(Collection categoryNames) {\n for (String categoryName : categoryNames) {\n recalculatePostCount(categoryName);\n }\n }\n\n public void recalculatePostCount(String categoryName) {\n var totalPostCount = countTotalPosts(categoryName);\n var visiblePostCount = countVisiblePosts(categoryName);\n client.fetch(Category.class, categoryName).ifPresent(category -> {\n category.getStatusOrDefault().setPostCount(totalPostCount);\n category.getStatusOrDefault().setVisiblePostCount(visiblePostCount);\n\n client.update(category);\n });\n }\n\n private int countTotalPosts(String categoryName) {\n var postListOptions = new ListOptions();\n postListOptions.setFieldSelector(FieldSelector.of(\n basePostQuery(categoryName)\n ));\n return (int) client.listBy(Post.class, postListOptions, PageRequestImpl.ofSize(1))\n .getTotal();\n }\n\n private int countVisiblePosts(String categoryName) {\n var postListOptions = new ListOptions();\n var fieldQuery = basePostQuery(categoryName)\n .and(equal(\"spec.visible\", Post.VisibleEnum.PUBLIC.name()));\n var labelSelector = LabelSelector.builder()\n .eq(Post.PUBLISHED_LABEL, BooleanUtils.TRUE)\n .build();\n postListOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n postListOptions.setLabelSelector(labelSelector);\n return (int) client.listBy(Post.class, postListOptions, PageRequestImpl.ofSize(1))\n .getTotal();\n }\n\n private static Condition basePostQuery(String categoryName) {\n return Queries.isNull(\"metadata.deletionTimestamp\")\n .and(equal(\"spec.deleted\", BooleanUtils.FALSE))\n .and(equal(\"spec.categories\", categoryName));\n }\n }\n\n public record PostRelatedCategories(String postName, Collection categoryChanges) {\n }\n\n @EventListener(PostUpdatedEvent.class)\n public void onPostUpdated(PostUpdatedEvent event) {\n var postName = event.getName();\n var changes = calcCategoriesToUpdate(event.getName());\n queue.addImmediately(new PostRelatedCategories(postName, changes));\n }\n\n @EventListener(PostDeletedEvent.class)\n public void onPostDeleted(PostDeletedEvent event) {\n var postName = event.getName();\n var categories = defaultIfNull(event.getPost().getSpec().getCategories(),\n List.of());\n queue.addImmediately(new PostRelatedCategories(postName, categories));\n }\n\n private Set calcCategoriesToUpdate(String postName) {\n return client.fetch(Post.class, postName)\n .map(post -> {\n var annotations = MetadataUtil.nullSafeAnnotations(post);\n var oldCategories =\n Optional.ofNullable(annotations.get(Post.LAST_ASSOCIATED_CATEGORIES_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(categoriesJson -> JsonUtils.jsonToObject(categoriesJson,\n String[].class))\n .orElse(new String[0]);\n\n Set categoriesToUpdate = Sets.newHashSet(oldCategories);\n var newCategories = post.getSpec().getCategories();\n if (newCategories != null) {\n categoriesToUpdate.addAll(newCategories);\n }\n return categoriesToUpdate;\n })\n .orElse(Set.of());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/CategoryService.java", "content": "package run.halo.app.content;\n\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Category;\n\npublic interface CategoryService {\n\n Flux listChildren(@NonNull String categoryName);\n\n Mono getParentByName(@NonNull String categoryName);\n\n Mono isCategoryHidden(@NonNull String categoryName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/Content.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\n\npublic record Content(@Schema(requiredMode = REQUIRED) String raw,\n @Schema(requiredMode = REQUIRED) String content,\n @Schema(requiredMode = REQUIRED) String rawType) {\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/ContentRequest.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.HashMap;\nimport lombok.Builder;\nimport org.apache.commons.lang3.StringUtils;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Builder\npublic record ContentRequest(@Schema(requiredMode = REQUIRED) Ref subjectRef,\n String headSnapshotName,\n @Schema(requiredMode = NOT_REQUIRED) Long version,\n @Schema(requiredMode = REQUIRED) String raw,\n @Schema(requiredMode = REQUIRED) String content,\n @Schema(requiredMode = REQUIRED) String rawType) {\n\n public Snapshot toSnapshot() {\n final Snapshot snapshot = new Snapshot();\n\n Metadata metadata = new Metadata();\n metadata.setAnnotations(new HashMap<>());\n snapshot.setMetadata(metadata);\n\n Snapshot.SnapShotSpec snapShotSpec = new Snapshot.SnapShotSpec();\n snapShotSpec.setSubjectRef(subjectRef);\n\n snapShotSpec.setRawType(rawType);\n snapShotSpec.setRawPatch(StringUtils.defaultString(raw()));\n snapShotSpec.setContentPatch(StringUtils.defaultString(content()));\n\n snapshot.setSpec(snapShotSpec);\n return snapshot;\n }\n\n public String rawPatchFrom(String originalRaw) {\n // originalRaw content from v1\n return PatchUtils.diffToJsonPatch(originalRaw, this.raw);\n }\n\n public String contentPatchFrom(String originalContent) {\n // originalContent from v1\n return PatchUtils.diffToJsonPatch(originalContent, this.content);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/ContentUpdateParam.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\n\npublic record ContentUpdateParam(Long version, @Schema(requiredMode = REQUIRED) String raw,\n @Schema(requiredMode = REQUIRED) String content,\n @Schema(requiredMode = REQUIRED) String rawType) {\n\n public static ContentUpdateParam from(Content content) {\n return new ContentUpdateParam(null, content.raw(), content.content(),\n content.rawType());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/Contributor.java", "content": "package run.halo.app.content;\n\nimport lombok.Data;\n\n/**\n * Contributor from user.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\npublic class Contributor {\n private String displayName;\n private String avatar;\n private String name;\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/ListedPost.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Tag;\n\n/**\n * An aggregate object of {@link Post} and {@link Category}\n * and {@link Tag} and more for post list.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Accessors(chain = true)\npublic class ListedPost {\n\n @Schema(requiredMode = REQUIRED)\n private Post post;\n\n @Schema(requiredMode = REQUIRED)\n private List categories;\n\n @Schema(requiredMode = REQUIRED)\n private List tags;\n\n @Schema(requiredMode = REQUIRED)\n private List contributors;\n\n @Schema(requiredMode = REQUIRED)\n private Contributor owner;\n\n @Schema(requiredMode = REQUIRED)\n private Stats stats;\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/ListedSinglePage.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport run.halo.app.core.extension.content.SinglePage;\n\n\n/**\n * An aggregate object of {@link SinglePage} and {@link Contributor} single page list.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Accessors(chain = true)\npublic class ListedSinglePage {\n\n @Schema(requiredMode = REQUIRED)\n private SinglePage page;\n\n @Schema(requiredMode = REQUIRED)\n private List contributors;\n\n @Schema(requiredMode = REQUIRED)\n private Contributor owner;\n\n @Schema(requiredMode = REQUIRED)\n private Stats stats;\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/ListedSnapshotDto.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Instant;\nimport lombok.Data;\nimport lombok.experimental.Accessors;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.extension.MetadataOperator;\n\n@Data\n@Accessors(chain = true)\npublic class ListedSnapshotDto {\n @Schema(requiredMode = REQUIRED)\n private MetadataOperator metadata;\n\n @Schema(requiredMode = REQUIRED)\n private Spec spec;\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"ListedSnapshotSpec\")\n public static class Spec {\n @Schema(requiredMode = REQUIRED)\n private String owner;\n\n private Instant modifyTime;\n }\n\n /**\n * Creates from snapshot.\n */\n public static ListedSnapshotDto from(Snapshot snapshot) {\n return new ListedSnapshotDto()\n .setMetadata(snapshot.getMetadata())\n .setSpec(new Spec()\n .setOwner(snapshot.getSpec().getOwner())\n .setModifyTime(snapshot.getSpec().getLastModifyTime())\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/NotificationReasonConst.java", "content": "package run.halo.app.content;\n\n/**\n * Notification reason constants for content module.\n *\n * @author guqing\n * @since 2.9.0\n */\npublic enum NotificationReasonConst {\n ;\n public static final String NEW_COMMENT_ON_POST = \"new-comment-on-post\";\n public static final String NEW_COMMENT_ON_PAGE = \"new-comment-on-single-page\";\n public static final String SOMEONE_REPLIED_TO_YOU = \"someone-replied-to-you\";\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/PostContentServiceImpl.java", "content": "package run.halo.app.content;\n\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\n\n/**\n * Provides ability to get post content for the specified post.\n *\n * @author guqing\n * @since 2.16.0\n */\n@Component\npublic class PostContentServiceImpl extends AbstractContentService implements PostContentService {\n private final ReactiveExtensionClient client;\n\n public PostContentServiceImpl(ReactiveExtensionClient client) {\n super(client);\n this.client = client;\n }\n\n @Override\n public Mono getHeadContent(String postName) {\n return client.get(Post.class, postName)\n .flatMap(post -> {\n var headSnapshot = post.getSpec().getHeadSnapshot();\n return super.getContent(headSnapshot, post.getSpec().getBaseSnapshot());\n });\n }\n\n @Override\n public Mono getReleaseContent(String postName) {\n return client.get(Post.class, postName)\n .flatMap(post -> {\n var releaseSnapshot = post.getSpec().getReleaseSnapshot();\n return super.getContent(releaseSnapshot, post.getSpec().getBaseSnapshot());\n });\n }\n\n @Override\n public Mono getSpecifiedContent(String postName, String snapshotName) {\n return client.get(Post.class, postName)\n .flatMap(post -> {\n var baseSnapshot = post.getSpec().getBaseSnapshot();\n return super.getContent(snapshotName, baseSnapshot);\n });\n }\n\n @Override\n public Flux listSnapshots(String postName) {\n return client.get(Post.class, postName)\n .flatMapMany(page -> listSnapshotsBy(Ref.of(page)))\n .map(snapshot -> snapshot.getMetadata().getName());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/PostHideFromListStateUpdater.java", "content": "package run.halo.app.content;\n\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.time.Duration;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.CategoryHiddenStateChangeEvent;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.ReactiveExtensionPaginatedOperator;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * Synchronize the {@link Post.PostStatus#getHideFromList()} state of the post with the category.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Component\npublic class PostHideFromListStateUpdater\n extends AbstractEventReconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private final ReactiveExtensionPaginatedOperator reactiveExtensionPaginatedOperator;\n private final ReactiveExtensionClient client;\n\n protected PostHideFromListStateUpdater(ReactiveExtensionClient client,\n ReactiveExtensionPaginatedOperator reactiveExtensionPaginatedOperator) {\n super(PostHideFromListStateUpdater.class.getName());\n this.reactiveExtensionPaginatedOperator = reactiveExtensionPaginatedOperator;\n this.client = client;\n }\n\n @Override\n public Result reconcile(CategoryHiddenStateChangeEvent request) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n equal(\"spec.categories\", request.getCategoryName())\n ));\n\n reactiveExtensionPaginatedOperator.list(Post.class, listOptions)\n .flatMap(post -> {\n post.getStatusOrDefault().setHideFromList(request.isHidden());\n return client.update(post);\n })\n .then()\n .block(BLOCKING_TIMEOUT);\n return Result.doNotRetry();\n }\n\n @EventListener(CategoryHiddenStateChangeEvent.class)\n public void onApplicationEvent(@NonNull CategoryHiddenStateChangeEvent event) {\n this.queue.addImmediately(event);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/PostQuery.java", "content": "package run.halo.app.content;\n\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.core.extension.content.Post.PUBLISHED_LABEL;\nimport static run.halo.app.core.extension.content.Post.PostPhase.PENDING_APPROVAL;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.or;\nimport static run.halo.app.extension.router.QueryParamBuildUtil.sortParameter;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Optional;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * A query object for {@link Post} list.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PostQuery extends SortableRequest {\n\n private final String username;\n\n public PostQuery(ServerRequest request) {\n this(request, null);\n }\n\n public PostQuery(ServerRequest request, @Nullable String username) {\n super(request.exchange());\n this.username = username;\n }\n\n @Nullable\n public String getPublishPhase() {\n return queryParams.getFirst(\"publishPhase\");\n }\n\n @Nullable\n public String getCategoryWithChildren() {\n var value = queryParams.getFirst(\"categoryWithChildren\");\n return StringUtils.defaultIfBlank(value, null);\n }\n\n @Nullable\n public String getKeyword() {\n return StringUtils.defaultIfBlank(queryParams.getFirst(\"keyword\"), null);\n }\n\n /**\n * Build a list options from the query object.\n *\n * @return a list options\n */\n @Override\n public ListOptions toListOptions() {\n var builder = ListOptions.builder(super.toListOptions());\n\n Optional.ofNullable(getKeyword())\n .filter(StringUtils::isNotBlank)\n .ifPresent(keyword -> builder.andQuery(or(\n contains(\"status.excerpt\", keyword),\n contains(\"spec.slug\", keyword),\n contains(\"spec.title\", keyword)\n )));\n\n Optional.ofNullable(getPublishPhase())\n .filter(StringUtils::isNotBlank)\n .map(Post.PostPhase::from)\n .ifPresent(phase -> {\n if (PENDING_APPROVAL.equals(phase)) {\n builder.andQuery(equal(\"status.phase\", phase.name()));\n }\n var labelSelector = builder.labelSelector();\n Optional.of(phase)\n .filter(Post.PostPhase.PUBLISHED::equals)\n .ifPresentOrElse(\n published -> labelSelector.eq(PUBLISHED_LABEL, Boolean.TRUE.toString()),\n () -> labelSelector.notEq(PUBLISHED_LABEL, Boolean.TRUE.toString())\n );\n });\n\n Optional.ofNullable(username)\n .filter(StringUtils::isNotBlank)\n .ifPresent(username -> builder.andQuery(equal(\"spec.owner\", username)));\n\n return builder.build();\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(sortParameter())\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"publishPhase\")\n .description(\"Posts filtered by publish phase.\")\n .implementation(Post.PostPhase.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .description(\"Posts filtered by keyword.\")\n .implementation(String.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"categoryWithChildren\")\n .description(\"Posts filtered by category including sub-categories.\")\n .implementation(String.class)\n .required(false));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/PostRequest.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Ref;\n\n/**\n * Post and content data for creating and updating post.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic record PostRequest(@Schema(requiredMode = REQUIRED) @NonNull Post post,\n @Schema(requiredMode = REQUIRED) @NonNull ContentUpdateParam content) {\n\n public ContentRequest contentRequest() {\n Ref subjectRef = Ref.of(post);\n return new ContentRequest(subjectRef, post.getSpec().getHeadSnapshot(), content.version(),\n content.raw(), content.content(), content.rawType());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/PostService.java", "content": "package run.halo.app.content;\n\nimport java.util.List;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListResult;\n\n/**\n * Service for {@link Post}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface PostService {\n\n Mono> listPost(PostQuery query);\n\n Mono draftPost(PostRequest postRequest);\n\n Mono updatePost(PostRequest postRequest);\n\n Mono updateBy(@NonNull Post post);\n\n Mono getHeadContent(String postName);\n\n Mono getHeadContent(Post post);\n\n Mono getReleaseContent(String postName);\n\n Mono getReleaseContent(Post post);\n\n Mono getContent(String snapshotName, String baseSnapshotName);\n\n Flux listSnapshots(String name);\n\n Mono publish(Post post);\n\n Mono unpublish(Post post);\n\n /**\n * Get post by username.\n *\n * @param postName is post name.\n * @param username is username.\n * @return full post data or empty.\n */\n Mono getByUsername(String postName, String username);\n\n Mono revertToSpecifiedSnapshot(String postName, String snapshotName);\n\n Mono deleteContent(String postName, String snapshotName);\n\n Mono recycleBy(String postName, String username);\n\n Flux listCategories(List categories);\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/PostSorter.java", "content": "package run.halo.app.content;\n\nimport java.time.Instant;\nimport java.util.Comparator;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport org.springframework.util.comparator.Comparators;\nimport run.halo.app.core.extension.content.Post;\n\n/**\n * A sorter for {@link Post}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic enum PostSorter {\n PUBLISH_TIME,\n CREATE_TIME;\n\n static final Function name = post -> post.getMetadata().getName();\n\n /**\n * Converts {@link Comparator} from {@link PostSorter} and ascending.\n *\n * @param sorter a {@link PostSorter}\n * @param ascending ascending if true, otherwise descending\n * @return a {@link Comparator} of {@link Post}\n */\n public static Comparator from(PostSorter sorter, Boolean ascending) {\n if (Objects.equals(true, ascending)) {\n return from(sorter);\n }\n return from(sorter).reversed();\n }\n\n /**\n * Converts {@link Comparator} from {@link PostSorter}.\n *\n * @param sorter a {@link PostSorter}\n * @return a {@link Comparator} of {@link Post}\n */\n public static Comparator from(PostSorter sorter) {\n if (sorter == null) {\n return defaultComparator();\n }\n if (CREATE_TIME.equals(sorter)) {\n Function comparatorFunc =\n post -> post.getMetadata().getCreationTimestamp();\n return Comparator.comparing(comparatorFunc)\n .thenComparing(name);\n }\n\n if (PUBLISH_TIME.equals(sorter)) {\n Function comparatorFunc =\n post -> post.getSpec().getPublishTime();\n return Comparator.comparing(comparatorFunc, Comparators.nullsLow())\n .thenComparing(name);\n }\n\n throw new IllegalArgumentException(\"Unsupported sort value: \" + sorter);\n }\n\n static PostSorter convertFrom(String sort) {\n for (PostSorter sorter : values()) {\n if (sorter.name().equalsIgnoreCase(sort)) {\n return sorter;\n }\n }\n return null;\n }\n\n static Comparator defaultComparator() {\n Function createTime =\n post -> post.getMetadata().getCreationTimestamp();\n return Comparator.comparing(createTime)\n .thenComparing(name);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/SinglePageQuery.java", "content": "package run.halo.app.content;\n\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.core.extension.content.Post.PostPhase.PENDING_APPROVAL;\nimport static run.halo.app.core.extension.content.SinglePage.PUBLISHED_LABEL;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.in;\nimport static run.halo.app.extension.index.query.Queries.or;\nimport static run.halo.app.extension.router.QueryParamBuildUtil.sortParameter;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Optional;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * Query parameter for {@link SinglePage} list.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class SinglePageQuery extends SortableRequest {\n\n public SinglePageQuery(ServerRequest request) {\n super(request.exchange());\n }\n\n @Override\n public ListOptions toListOptions() {\n var builder = ListOptions.builder(super.toListOptions());\n\n Optional.ofNullable(queryParams.getFirst(\"keyword\"))\n .filter(StringUtils::isNotBlank)\n .ifPresent(keyword -> builder.andQuery(or(\n contains(\"spec.title\", keyword),\n contains(\"spec.slug\", keyword),\n contains(\"status.excerpt\", keyword)\n )));\n\n Optional.ofNullable(queryParams.getFirst(\"publishPhase\"))\n .filter(StringUtils::isNotBlank)\n .map(Post.PostPhase::from)\n .ifPresent(phase -> {\n if (PENDING_APPROVAL.equals(phase)) {\n builder.andQuery(equal(\"status.phase\", phase.name()));\n }\n var labelSelector = builder.labelSelector();\n Optional.of(phase)\n .filter(Post.PostPhase.PUBLISHED::equals)\n .ifPresentOrElse(\n published -> labelSelector.eq(PUBLISHED_LABEL, Boolean.TRUE.toString()),\n () -> labelSelector.notEq(PUBLISHED_LABEL, Boolean.TRUE.toString())\n );\n });\n\n Optional.ofNullable(queryParams.getFirst(\"visible\"))\n .filter(StringUtils::isNotBlank)\n .map(Post.VisibleEnum::from)\n .ifPresent(visible -> builder.andQuery(equal(\"spec.visible\", visible.name())));\n\n Optional.ofNullable(queryParams.get(\"contributor\"))\n .filter(contributors -> !contributors.isEmpty())\n .ifPresent(contributors -> builder.andQuery(in(\"status.contributors\", contributors)));\n\n return builder.build();\n }\n\n @Override\n public Sort getSort() {\n var sort = super.getSort();\n var orders = sort.stream()\n .map(order -> {\n if (\"creationTimestamp\".equals(order.getProperty())) {\n return order.withProperty(\"metadata.creationTimestamp\");\n }\n if (\"publishTime\".equals(order.getProperty())) {\n return order.withProperty(\"spec.publishTime\");\n }\n return order;\n })\n .toList();\n return Sort.by(orders);\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(sortParameter())\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"contributor\")\n .description(\"SinglePages filtered by contributor.\")\n .implementationArray(String.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"publishPhase\")\n .description(\"SinglePages filtered by publish phase.\")\n .implementation(Post.PostPhase.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"visible\")\n .description(\"SinglePages filtered by visibility.\")\n .implementation(Post.VisibleEnum.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .description(\"SinglePages filtered by keyword.\")\n .implementation(String.class)\n .required(false));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/SinglePageRequest.java", "content": "package run.halo.app.content;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.Ref;\n\n/**\n * A request parameter for {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic record SinglePageRequest(@Schema(requiredMode = REQUIRED) SinglePage page,\n @Schema(requiredMode = REQUIRED) ContentUpdateParam content) {\n\n public ContentRequest contentRequest() {\n Ref subjectRef = Ref.of(page);\n return new ContentRequest(subjectRef, page.getSpec().getHeadSnapshot(), content.version(),\n content.raw(), content.content(), content.rawType());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/SinglePageService.java", "content": "package run.halo.app.content;\n\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ListResult;\n\n/**\n * Single page service.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface SinglePageService {\n\n Mono getHeadContent(String singlePageName);\n\n Mono getReleaseContent(String singlePageName);\n\n Mono getContent(String snapshotName, String baseSnapshotName);\n\n Flux listSnapshots(String pageName);\n\n Mono> list(SinglePageQuery listRequest);\n\n Mono draft(SinglePageRequest pageRequest);\n\n Mono update(SinglePageRequest pageRequest);\n\n Mono revertToSpecifiedSnapshot(String pageName, String snapshotName);\n\n Mono deleteContent(String postName, String snapshotName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/SnapshotService.java", "content": "package run.halo.app.content;\n\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Snapshot;\n\npublic interface SnapshotService {\n\n Mono getBy(String snapshotName);\n\n Mono getPatchedBy(String snapshotName, String baseSnapshotName);\n\n Mono patchAndCreate(@NonNull Snapshot snapshot,\n @Nullable Snapshot baseSnapshot,\n @NonNull Content content);\n\n Mono patchAndUpdate(@NonNull Snapshot snapshot,\n @NonNull Snapshot baseSnapshot,\n @NonNull Content content);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/Stats.java", "content": "package run.halo.app.content;\n\nimport lombok.Builder;\nimport lombok.Data;\n\n/**\n * Stats value object.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\npublic class Stats {\n\n private Integer visit;\n\n private Integer upvote;\n\n private Integer totalComment;\n\n private Integer approvedComment;\n\n public Stats() {\n }\n\n @Builder\n public Stats(Integer visit, Integer upvote, Integer totalComment, Integer approvedComment) {\n this.visit = visit;\n this.upvote = upvote;\n this.totalComment = totalComment;\n this.approvedComment = approvedComment;\n }\n\n public static Stats empty() {\n return Stats.builder()\n .visit(0)\n .upvote(0)\n .totalComment(0)\n .approvedComment(0)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/AbstractCommentService.java", "content": "package run.halo.app.content.comment;\n\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport org.jsoup.Jsoup;\nimport org.jsoup.safety.Safelist;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n@RequiredArgsConstructor\npublic abstract class AbstractCommentService {\n protected final RoleService roleService;\n protected final ReactiveExtensionClient client;\n protected final UserService userService;\n protected final CounterService counterService;\n private final Safelist safelist = Safelist.relaxed()\n // Allow tag, which is used for strikethrough\n .addTags(\"s\")\n // Allow tag's class attribute, for syntax highlighting\n .addAttributes(\"code\", \"class\")\n // Allow tag's target attribute\n .addAttributes(\"a\", \"target\")\n .preserveRelativeLinks(true);\n\n protected Mono fetchCurrentUser() {\n return ReactiveSecurityContextHolder.getContext()\n .map(securityContext -> securityContext.getAuthentication().getName())\n .flatMap(username -> client.fetch(User.class, username));\n }\n\n Mono hasCommentManagePermission() {\n return ReactiveSecurityContextHolder.getContext()\n .flatMap(securityContext -> {\n var authentication = securityContext.getAuthentication();\n var roles = AuthorityUtils.authoritiesToRoles(authentication.getAuthorities());\n return roleService.contains(roles,\n Set.of(AuthorityUtils.COMMENT_MANAGEMENT_ROLE_NAME));\n });\n }\n\n protected Comment.CommentOwner toCommentOwner(User user) {\n Comment.CommentOwner owner = new Comment.CommentOwner();\n owner.setKind(User.KIND);\n owner.setName(user.getMetadata().getName());\n owner.setDisplayName(user.getSpec().getDisplayName());\n return owner;\n }\n\n protected Mono getOwnerInfo(Comment.CommentOwner owner) {\n if (User.KIND.equals(owner.getKind())) {\n return userService.getUserOrGhost(owner.getName())\n .map(OwnerInfo::from);\n }\n if (Comment.CommentOwner.KIND_EMAIL.equals(owner.getKind())) {\n return Mono.just(OwnerInfo.from(owner));\n }\n return Mono.error(new IllegalStateException(\"Unsupported owner kind: \" + owner.getKind()));\n }\n\n protected Mono fetchCommentStats(String commentName) {\n return this.fetchStats(MeterUtils.nameOf(Comment.class, commentName));\n }\n\n protected Mono fetchReplyStats(String replyName) {\n return this.fetchStats(MeterUtils.nameOf(Reply.class, replyName));\n }\n\n private Mono fetchStats(String meterName) {\n Assert.notNull(meterName, \"The reply must not be null.\");\n return counterService.getByName(meterName)\n .map(counter -> CommentStats.builder()\n .upvote(counter.getUpvote())\n .build()\n )\n .switchIfEmpty(Mono.fromSupplier(CommentStats::empty));\n }\n\n /**\n * Check if the given html is a safe HTML.\n *\n * @param html html content\n * @return true if the html is safe, false otherwise\n */\n protected boolean isSafeHtml(@NonNull String html) {\n return Jsoup.isValid(html, safelist);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentEmailOwner.java", "content": "package run.halo.app.content.comment;\n\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.Comment;\n\n/**\n *

The creator info of the comment.

\n * This {@link CommentEmailOwner} is only applicable to the user who is allowed to comment\n * without logging in.\n *\n * @param email email for comment owner\n * @param avatar avatar for comment owner\n * @param displayName display name for comment owner\n * @param website website for comment owner\n */\npublic record CommentEmailOwner(String email, String avatar, String displayName, String website) {\n\n public CommentEmailOwner {\n Assert.hasText(displayName, \"The 'displayName' must not be empty.\");\n }\n\n /**\n * Converts {@link CommentEmailOwner} to {@link Comment.CommentOwner}.\n *\n * @return a comment owner\n */\n public Comment.CommentOwner toCommentOwner() {\n Comment.CommentOwner commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(Comment.CommentOwner.KIND_EMAIL);\n // email nullable\n commentOwner.setName(StringUtils.defaultString(email));\n\n commentOwner.setDisplayName(displayName);\n Map annotations = new LinkedHashMap<>();\n commentOwner.setAnnotations(annotations);\n annotations.put(Comment.CommentOwner.AVATAR_ANNO, avatar);\n annotations.put(Comment.CommentOwner.WEBSITE_ANNO, website);\n return commentOwner;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentNotificationReasonPublisher.java", "content": "package run.halo.app.content.comment;\n\nimport static org.apache.commons.lang3.StringUtils.defaultIfBlank;\nimport static run.halo.app.content.comment.ReplyNotificationSubscriptionHelper.identityFrom;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.Optional;\nimport lombok.Builder;\nimport lombok.RequiredArgsConstructor;\nimport lombok.experimental.UtilityClass;\nimport org.apache.commons.lang3.StringUtils;\nimport org.jsoup.Jsoup;\nimport org.jsoup.nodes.Document;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.event.post.CommentCreatedEvent;\nimport run.halo.app.event.post.ReplyCreatedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.ExternalLinkProcessor;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.notification.NotificationReasonEmitter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Notification reason publisher for {@link Comment} and {@link Reply}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@Component\n@RequiredArgsConstructor\npublic class CommentNotificationReasonPublisher {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private static final GroupVersionKind POST_GVK = GroupVersionKind.fromExtension(Post.class);\n private static final GroupVersionKind PAGE_GVK =\n GroupVersionKind.fromExtension(SinglePage.class);\n\n private final ExtensionClient client;\n private final NewCommentOnPostReasonPublisher newCommentOnPostReasonPublisher;\n private final NewCommentOnPageReasonPublisher newCommentOnPageReasonPublisher;\n private final NewReplyReasonPublisher newReplyReasonPublisher;\n\n /**\n * On new comment.\n */\n @Async\n @EventListener(CommentCreatedEvent.class)\n public void onNewComment(CommentCreatedEvent event) {\n Comment comment = event.getComment();\n if (isPostComment(comment)) {\n newCommentOnPostReasonPublisher.publishReasonBy(comment);\n } else if (isPageComment(comment)) {\n newCommentOnPageReasonPublisher.publishReasonBy(comment);\n }\n }\n\n /**\n * On new reply.\n */\n @Async\n @EventListener(ReplyCreatedEvent.class)\n public void onNewReply(ReplyCreatedEvent event) {\n Reply reply = event.getReply();\n var commentName = reply.getSpec().getCommentName();\n client.fetch(Comment.class, commentName)\n .ifPresent(comment -> newReplyReasonPublisher.publishReasonBy(reply, comment));\n }\n\n boolean isPostComment(Comment comment) {\n return Ref.groupKindEquals(comment.getSpec().getSubjectRef(), POST_GVK);\n }\n\n boolean isPageComment(Comment comment) {\n return Ref.groupKindEquals(comment.getSpec().getSubjectRef(), PAGE_GVK);\n }\n\n /**\n * Comment content converter, convert relative links to absolute links.\n */\n @Component\n @RequiredArgsConstructor\n static class CommentContentConverter {\n private final ExternalLinkProcessor externalLinkProcessor;\n\n /**\n * Convert relative links to absolute links.\n *\n * @param content the content to convert\n * @return the converted content\n */\n public String convertRelativeLinks(String content) {\n Document parse = Jsoup.parse(content);\n parse.select(\"img\").forEach(element -> {\n var src = element.attr(\"src\");\n element.attr(\"src\", externalLinkProcessor.processLink(src));\n });\n return parse.body().html();\n }\n }\n\n @Component\n @RequiredArgsConstructor\n static class NewCommentOnPostReasonPublisher {\n\n private final ExtensionClient client;\n private final NotificationReasonEmitter notificationReasonEmitter;\n private final ExternalLinkProcessor externalLinkProcessor;\n private final CommentContentConverter commentContentConverter;\n\n public void publishReasonBy(Comment comment) {\n Ref subjectRef = comment.getSpec().getSubjectRef();\n Post post = client.fetch(Post.class, subjectRef.getName()).orElseThrow();\n if (doNotEmitReason(comment, post)) {\n return;\n }\n\n String postUrl =\n externalLinkProcessor.processLink(post.getStatusOrDefault().getPermalink());\n var reasonSubject = Reason.Subject.builder()\n .apiVersion(post.getApiVersion())\n .kind(post.getKind())\n .name(subjectRef.getName())\n .title(post.getSpec().getTitle())\n .url(postUrl)\n .build();\n Comment.CommentOwner owner = comment.getSpec().getOwner();\n notificationReasonEmitter.emit(NotificationReasonConst.NEW_COMMENT_ON_POST,\n builder -> {\n var attributes = CommentOnPostReasonData.builder()\n .postName(subjectRef.getName())\n .postOwner(post.getSpec().getOwner())\n .postTitle(post.getSpec().getTitle())\n .postUrl(postUrl)\n .commenter(owner.getDisplayName())\n .content(commentContentConverter.convertRelativeLinks(\n comment.getSpec().getContent()))\n .commentName(comment.getMetadata().getName())\n .build();\n builder.attributes(ReasonDataConverter.toAttributeMap(attributes))\n .author(identityFrom(owner))\n .subject(reasonSubject);\n }).block(BLOCKING_TIMEOUT);\n }\n\n boolean doNotEmitReason(Comment comment, Post post) {\n Comment.CommentOwner commentOwner = comment.getSpec().getOwner();\n return isPostOwner(post, commentOwner);\n }\n\n boolean isPostOwner(Post post, Comment.CommentOwner commentOwner) {\n String kind = commentOwner.getKind();\n String name = commentOwner.getName();\n var postOwner = post.getSpec().getOwner();\n if (Comment.CommentOwner.KIND_EMAIL.equals(kind)) {\n return client.fetch(User.class, postOwner)\n .filter(user -> name.equals(user.getSpec().getEmail()))\n .isPresent();\n }\n return name.equals(postOwner);\n }\n\n @Builder\n record CommentOnPostReasonData(String postName, String postOwner, String postTitle,\n String postUrl, String commenter, String content,\n String commentName) {\n }\n }\n\n @Component\n @RequiredArgsConstructor\n static class NewCommentOnPageReasonPublisher {\n private final ExtensionClient client;\n private final NotificationReasonEmitter notificationReasonEmitter;\n private final ExternalLinkProcessor externalLinkProcessor;\n private final CommentContentConverter commentContentConverter;\n\n public void publishReasonBy(Comment comment) {\n Ref subjectRef = comment.getSpec().getSubjectRef();\n var singlePage = client.fetch(SinglePage.class, subjectRef.getName()).orElseThrow();\n\n if (doNotEmitReason(comment, singlePage)) {\n return;\n }\n\n var pageUrl = externalLinkProcessor\n .processLink(singlePage.getStatusOrDefault().getPermalink());\n\n var reasonSubject = Reason.Subject.builder()\n .apiVersion(singlePage.getApiVersion())\n .kind(singlePage.getKind())\n .name(subjectRef.getName())\n .title(singlePage.getSpec().getTitle())\n .url(pageUrl)\n .build();\n\n Comment.CommentOwner owner = comment.getSpec().getOwner();\n notificationReasonEmitter.emit(NotificationReasonConst.NEW_COMMENT_ON_PAGE,\n builder -> {\n var attributes = CommentOnPageReasonData.builder()\n .pageName(subjectRef.getName())\n .pageOwner(singlePage.getSpec().getOwner())\n .pageTitle(singlePage.getSpec().getTitle())\n .pageUrl(pageUrl)\n .commenter(defaultIfBlank(owner.getDisplayName(), owner.getName()))\n .content(commentContentConverter.convertRelativeLinks(\n comment.getSpec().getContent()))\n .commentName(comment.getMetadata().getName())\n .build();\n builder.attributes(ReasonDataConverter.toAttributeMap(attributes))\n .author(identityFrom(owner))\n .subject(reasonSubject);\n }).block(BLOCKING_TIMEOUT);\n }\n\n public boolean doNotEmitReason(Comment comment, SinglePage page) {\n Comment.CommentOwner commentOwner = comment.getSpec().getOwner();\n return isPageOwner(page, commentOwner);\n }\n\n boolean isPageOwner(SinglePage page, Comment.CommentOwner commentOwner) {\n String kind = commentOwner.getKind();\n String name = commentOwner.getName();\n var pageOwner = page.getSpec().getOwner();\n if (Comment.CommentOwner.KIND_EMAIL.equals(kind)) {\n return client.fetch(User.class, pageOwner)\n .filter(user -> name.equals(user.getSpec().getEmail()))\n .isPresent();\n }\n return name.equals(pageOwner);\n }\n\n @Builder\n record CommentOnPageReasonData(String pageName, String pageOwner, String pageTitle,\n String pageUrl, String commenter, String content,\n String commentName) {\n }\n }\n\n @UtilityClass\n static class ReasonDataConverter {\n public static Map toAttributeMap(T data) {\n Assert.notNull(data, \"Reason attributes must not be null\");\n return JsonUtils.mapper().convertValue(data, new TypeReference<>() {\n });\n }\n }\n\n @Component\n @RequiredArgsConstructor\n static class NewReplyReasonPublisher {\n private final ExtensionClient client;\n private final NotificationReasonEmitter notificationReasonEmitter;\n private final ExtensionGetter extensionGetter;\n private final CommentContentConverter commentContentConverter;\n\n public void publishReasonBy(Reply reply, Comment comment) {\n boolean isQuoteReply = StringUtils.isNotBlank(reply.getSpec().getQuoteReply());\n\n Optional quoteReplyOptional = Optional.of(isQuoteReply)\n .filter(Boolean::booleanValue)\n .flatMap(isQuote -> client.fetch(Reply.class, reply.getSpec().getQuoteReply()));\n\n if (doNotEmitReason(reply, quoteReplyOptional.orElse(null), comment)) {\n return;\n }\n\n var reasonSubject = quoteReplyOptional\n .map(quoteReply -> Subscription.ReasonSubject.builder()\n .apiVersion(quoteReply.getApiVersion())\n .kind(quoteReply.getKind())\n .name(quoteReply.getMetadata().getName())\n .build()\n )\n .orElseGet(() -> Subscription.ReasonSubject.builder()\n .apiVersion(comment.getApiVersion())\n .kind(comment.getKind())\n .name(comment.getMetadata().getName())\n .build()\n );\n\n var reasonSubjectTitle = quoteReplyOptional\n .map(quoteReply -> quoteReply.getSpec().getContent())\n .orElse(comment.getSpec().getContent());\n\n var quoteReplyContent = quoteReplyOptional\n .map(quoteReply -> commentContentConverter\n .convertRelativeLinks(quoteReply.getSpec().getContent()))\n .orElse(null);\n var replyOwner = reply.getSpec().getOwner();\n\n var repliedOwner = quoteReplyOptional\n .map(quoteReply -> quoteReply.getSpec().getOwner())\n .orElseGet(() -> comment.getSpec().getOwner());\n\n var reasonAttributesBuilder = NewReplyReasonData.builder()\n .commentContent(\n commentContentConverter.convertRelativeLinks(comment.getSpec().getContent())\n )\n .isQuoteReply(isQuoteReply)\n .quoteContent(quoteReplyContent)\n .commentName(comment.getMetadata().getName())\n .replier(defaultIfBlank(replyOwner.getDisplayName(), replyOwner.getName()))\n .content(commentContentConverter.convertRelativeLinks(reply.getSpec().getContent()))\n .replyName(reply.getMetadata().getName())\n .replyOwner(identityFrom(replyOwner).name())\n .repliedOwner(identityFrom(repliedOwner).name());\n\n getCommentSubjectDisplay(comment.getSpec().getSubjectRef())\n .ifPresent(subject -> {\n reasonAttributesBuilder.commentSubjectTitle(subject.title());\n reasonAttributesBuilder.commentSubjectUrl(subject.url());\n });\n\n notificationReasonEmitter.emit(NotificationReasonConst.SOMEONE_REPLIED_TO_YOU,\n builder -> {\n var data = ReasonDataConverter.toAttributeMap(reasonAttributesBuilder.build());\n builder.attributes(data)\n .author(identityFrom(replyOwner))\n .subject(Reason.Subject.builder()\n .apiVersion(reasonSubject.getApiVersion())\n .kind(reasonSubject.getKind())\n .name(reasonSubject.getName())\n .title(reasonSubjectTitle)\n .build());\n }).block(BLOCKING_TIMEOUT);\n }\n\n /**\n * To be compatible with older versions, it may be empty, so use optional.\n */\n @SuppressWarnings(\"unchecked\")\n Optional getCommentSubjectDisplay(Ref ref) {\n return extensionGetter.getExtensions(CommentSubject.class)\n .filter(commentSubject -> commentSubject.supports(ref))\n .next()\n .flatMap(subject -> subject.getSubjectDisplay(ref.getName()))\n .blockOptional(BLOCKING_TIMEOUT);\n }\n\n boolean doNotEmitReason(Reply currentReply, Reply quoteReply, Comment comment) {\n boolean isQuoteReply = StringUtils.isNotBlank(currentReply.getSpec().getQuoteReply());\n\n if (isQuoteReply && quoteReply == null) {\n throw new IllegalArgumentException(\n \"quoteReply can not be null when currentReply is reply to quote\");\n }\n\n Comment.CommentOwner commentOwner = isQuoteReply ? quoteReply.getSpec().getOwner()\n : comment.getSpec().getOwner();\n\n var currentReplyOwner = currentReply.getSpec().getOwner();\n // reply to oneself do not emit reason\n return currentReplyOwner.getKind().equals(commentOwner.getKind())\n && currentReplyOwner.getName().equals(commentOwner.getName());\n }\n\n @Builder\n record NewReplyReasonData(String commentContent, String commentSubjectTitle,\n String commentSubjectUrl, boolean isQuoteReply,\n String quoteContent,\n String commentName, String replier, String content,\n String replyName, String replyOwner, String repliedOwner) {\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentQuery.java", "content": "package run.halo.app.content.comment;\n\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springframework.data.domain.Sort.Order.desc;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Optional;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.extension.router.QueryParamBuildUtil;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * Query criteria for comment list.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class CommentQuery extends SortableRequest {\n\n public CommentQuery(ServerRequest request) {\n super(request.exchange());\n }\n\n @Nullable\n public String getKeyword() {\n return queryParams.getFirst(\"keyword\");\n }\n\n @Nullable\n public String getOwnerKind() {\n return queryParams.getFirst(\"ownerKind\");\n }\n\n @Nullable\n public String getOwnerName() {\n return queryParams.getFirst(\"ownerName\");\n }\n\n @Override\n public Sort getSort() {\n // set default sort by last reply time\n return super.getSort().and(Sort.by(desc(\"status.lastReplyTime\")));\n }\n\n /**\n * Convert to list options.\n */\n @Override\n public ListOptions toListOptions() {\n var builder = ListOptions.builder(super.toListOptions());\n\n Optional.ofNullable(getKeyword())\n .filter(StringUtils::isNotBlank)\n .ifPresent(keyword -> builder.andQuery(contains(\"spec.raw\", keyword)));\n\n Optional.ofNullable(getOwnerName())\n .filter(StringUtils::isNotBlank)\n .ifPresent(ownerName -> {\n var ownerKind = Optional.ofNullable(getOwnerKind())\n .filter(StringUtils::isNotBlank)\n .orElse(User.KIND);\n builder.andQuery(\n equal(\"spec.owner\", Comment.CommentOwner.ownerIdentity(ownerKind, ownerName))\n );\n });\n\n return builder.build();\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(QueryParamBuildUtil.sortParameter())\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .description(\"Comments filtered by keyword.\")\n .implementation(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"ownerKind\")\n .description(\"Commenter kind.\")\n .implementation(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"ownerName\")\n .description(\"Commenter name.\")\n .implementation(String.class));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentRequest.java", "content": "package run.halo.app.content.comment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.UUID;\nimport lombok.Data;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\n\n/**\n * Request parameter object for {@link Comment}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\npublic class CommentRequest {\n\n @Schema(requiredMode = REQUIRED)\n private Ref subjectRef;\n\n private CommentEmailOwner owner;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String raw;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String content;\n\n @Schema(defaultValue = \"false\")\n private Boolean allowNotification;\n\n @Schema(defaultValue = \"false\")\n private Boolean hidden;\n\n /**\n * Converts {@link CommentRequest} to {@link Comment}.\n *\n * @return a comment\n */\n public Comment toComment() {\n Comment comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(UUID.randomUUID().toString());\n\n Comment.CommentSpec spec = new Comment.CommentSpec();\n comment.setSpec(spec);\n spec.setSubjectRef(subjectRef);\n spec.setRaw(raw);\n spec.setContent(content);\n spec.setAllowNotification(allowNotification);\n spec.setHidden(hidden);\n\n if (owner != null) {\n spec.setOwner(owner.toCommentOwner());\n }\n return comment;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentService.java", "content": "package run.halo.app.content.comment;\n\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Ref;\n\n/**\n * An application service for {@link Comment}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface CommentService {\n\n Mono> listComment(CommentQuery query);\n\n Mono create(Comment comment);\n\n Mono removeBySubject(@NonNull Ref subjectRef);\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentServiceImpl.java", "content": "package run.halo.app.content.comment;\n\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.function.Function;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.exception.AccessDeniedException;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Comment service implementation.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class CommentServiceImpl extends AbstractCommentService implements CommentService {\n\n private final ExtensionGetter extensionGetter;\n private final SystemConfigFetcher environmentFetcher;\n\n public CommentServiceImpl(RoleService roleService, ReactiveExtensionClient client,\n UserService userService, CounterService counterService, ExtensionGetter extensionGetter,\n SystemConfigFetcher environmentFetcher) {\n super(roleService, client, userService, counterService);\n this.extensionGetter = extensionGetter;\n this.environmentFetcher = environmentFetcher;\n }\n\n @Override\n public Mono> listComment(CommentQuery commentQuery) {\n return this.client.listBy(Comment.class, commentQuery.toListOptions(),\n commentQuery.toPageRequest())\n .flatMap(comments -> Flux.fromStream(comments.get()\n .map(this::toListedComment))\n .flatMapSequential(Function.identity())\n .collectList()\n .map(list -> new ListResult<>(comments.getPage(), comments.getSize(),\n comments.getTotal(), list)\n )\n );\n }\n\n @Override\n public Mono create(Comment comment) {\n if (comment.getSpec() == null\n || comment.getSpec().getContent() == null\n || !isSafeHtml(comment.getSpec().getContent())) {\n return Mono.error(new ServerWebInputException(\"\"\"\n The content of comment must not be empty or contains unsafe HTML.\\\n \"\"\"));\n }\n return environmentFetcher.fetchComment()\n .flatMap(commentSetting -> {\n if (Boolean.FALSE.equals(commentSetting.getEnable())) {\n return Mono.error(\n new AccessDeniedException(\"The comment function has been turned off.\",\n \"problemDetail.comment.turnedOff\", null));\n }\n if (checkCommentOwner(comment, commentSetting.getSystemUserOnly())) {\n return Mono.error(\n new AccessDeniedException(\"Allow only system users to comment.\",\n \"problemDetail.comment.systemUsersOnly\", null));\n }\n\n if (comment.getSpec().getTop() == null) {\n comment.getSpec().setTop(false);\n }\n if (comment.getSpec().getPriority() == null) {\n comment.getSpec().setPriority(0);\n }\n comment.getSpec()\n .setApproved(Boolean.FALSE.equals(commentSetting.getRequireReviewForNew()));\n\n if (BooleanUtils.isTrue(comment.getSpec().getApproved())\n && comment.getSpec().getApprovedTime() == null) {\n comment.getSpec().setApprovedTime(Instant.now());\n }\n\n if (comment.getSpec().getCreationTime() == null) {\n comment.getSpec().setCreationTime(Instant.now());\n }\n\n if (comment.getSpec().getHidden() == null) {\n comment.getSpec().setHidden(false);\n }\n\n return Mono.just(comment);\n })\n .flatMap(populatedComment -> Mono.when(populateOwner(populatedComment),\n populateApproveState(populatedComment))\n .thenReturn(populatedComment)\n )\n .flatMap(client::create);\n }\n\n private Mono populateApproveState(Comment comment) {\n return hasCommentManagePermission()\n .filter(Boolean::booleanValue)\n .doOnNext(hasPermission -> {\n comment.getSpec().setApproved(true);\n comment.getSpec().setApprovedTime(Instant.now());\n })\n .then();\n }\n\n Mono populateOwner(Comment comment) {\n if (comment.getSpec().getOwner() != null) {\n return Mono.empty();\n }\n return fetchCurrentUser()\n .switchIfEmpty(Mono.error(new IllegalStateException(\"The owner must not be null.\")))\n .map(this::toCommentOwner)\n .doOnNext(owner -> comment.getSpec().setOwner(owner))\n .then();\n }\n\n @Override\n public Mono removeBySubject(@NonNull Ref subjectRef) {\n Assert.notNull(subjectRef, \"The subjectRef must not be null.\");\n return cleanupComments(subjectRef, 200);\n }\n\n private Mono cleanupComments(Ref subjectRef, int batchSize) {\n // ascending order by creation time and name\n final var pageRequest = PageRequestImpl.of(1, batchSize,\n Sort.by(\"metadata.creationTimestamp\", \"metadata.name\"));\n // forever loop first page until no more to delete\n return listCommentsByRef(subjectRef, pageRequest)\n .flatMap(page -> Flux.fromIterable(page.getItems())\n .flatMap(this::deleteWithRetry)\n .then(page.hasNext() ? cleanupComments(subjectRef, batchSize) : Mono.empty())\n );\n }\n\n private Mono deleteWithRetry(Comment item) {\n return client.delete(item)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> attemptToDelete(item.getMetadata().getName()));\n }\n\n private Mono attemptToDelete(String name) {\n return Mono.defer(() -> client.fetch(Comment.class, name)\n .flatMap(client::delete)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n Mono> listCommentsByRef(Ref subjectRef, PageRequest pageRequest) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n and(\n equal(\"spec.subjectRef\", Comment.toSubjectRefKey(subjectRef)),\n isNull(\"metadata.deletionTimestamp\")\n )\n ));\n return client.listBy(Comment.class, listOptions, pageRequest);\n }\n\n private boolean checkCommentOwner(Comment comment, Boolean onlySystemUser) {\n Comment.CommentOwner owner = comment.getSpec().getOwner();\n if (Boolean.TRUE.equals(onlySystemUser)) {\n return owner != null && Comment.CommentOwner.KIND_EMAIL.equals(owner.getKind());\n }\n return false;\n }\n\n private Mono toListedComment(Comment comment) {\n var builder = ListedComment.builder().comment(comment);\n // not empty\n var ownerInfoMono = getOwnerInfo(comment.getSpec().getOwner())\n .doOnNext(builder::owner);\n var subjectMono = getCommentSubject(comment.getSpec().getSubjectRef())\n .doOnNext(builder::subject);\n var statsMono = fetchCommentStats(comment.getMetadata().getName())\n .doOnNext(builder::stats);\n return Mono.when(ownerInfoMono, subjectMono, statsMono)\n .then(Mono.fromSupplier(builder::build));\n }\n\n @SuppressWarnings(\"unchecked\")\n Mono getCommentSubject(Ref ref) {\n return extensionGetter.getExtensions(CommentSubject.class)\n .filter(subject -> subject.supports(ref))\n .next()\n .flatMap(subject -> subject.get(ref.getName()));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/CommentStats.java", "content": "package run.halo.app.content.comment;\n\nimport lombok.Builder;\nimport lombok.Value;\n\n/**\n * comment stats value object.\n *\n * @author LIlGG\n * @since 2.0.0\n */\n@Value\n@Builder\npublic class CommentStats {\n\n Integer upvote;\n\n public static CommentStats empty() {\n return CommentStats.builder()\n .upvote(0)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ListedComment.java", "content": "package run.halo.app.content.comment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Builder;\nimport lombok.Data;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.Extension;\n\n/**\n * Listed comment.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\npublic class ListedComment {\n\n @Schema(requiredMode = REQUIRED)\n private Comment comment;\n\n @Schema(requiredMode = REQUIRED)\n private OwnerInfo owner;\n\n private Extension subject;\n\n @Schema(requiredMode = REQUIRED)\n private CommentStats stats;\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ListedReply.java", "content": "package run.halo.app.content.comment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Builder;\nimport lombok.Data;\nimport run.halo.app.core.extension.content.Reply;\n\n/**\n * Listed reply for {@link Reply}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\npublic class ListedReply {\n\n @Schema(requiredMode = REQUIRED)\n private Reply reply;\n\n @Schema(requiredMode = REQUIRED)\n private OwnerInfo owner;\n\n @Schema(requiredMode = REQUIRED)\n private CommentStats stats;\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/OwnerInfo.java", "content": "package run.halo.app.content.comment;\n\nimport lombok.Builder;\nimport lombok.Value;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\n\n/**\n * Comment owner info.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@Builder\npublic class OwnerInfo {\n\n String kind;\n\n String name;\n\n String displayName;\n\n String avatar;\n\n String email;\n\n /**\n * Convert user to owner info by owner that has an email kind .\n *\n * @param owner comment owner reference.\n * @return owner info.\n */\n public static OwnerInfo from(Comment.CommentOwner owner) {\n if (!Comment.CommentOwner.KIND_EMAIL.equals(owner.getKind())) {\n throw new IllegalArgumentException(\"Only support 'email' owner kind.\");\n }\n return OwnerInfo.builder()\n .kind(owner.getKind())\n .name(owner.getName())\n .email(owner.getName())\n .displayName(owner.getDisplayName())\n .avatar(owner.getAnnotation(Comment.CommentOwner.AVATAR_ANNO))\n .build();\n }\n\n /**\n * Convert user to owner info by {@link User}.\n *\n * @param user user extension.\n * @return owner info.\n */\n public static OwnerInfo from(User user) {\n return OwnerInfo.builder()\n .kind(user.getKind())\n .name(user.getMetadata().getName())\n .email(user.getSpec().getEmail())\n .avatar(user.getSpec().getAvatar())\n .displayName(user.getSpec().getDisplayName())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/PostCommentSubject.java", "content": "package run.halo.app.content.comment;\n\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.ExternalLinkProcessor;\n\n/**\n * Comment subject for post.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class PostCommentSubject implements CommentSubject {\n\n private final ReactiveExtensionClient client;\n private final ExternalLinkProcessor externalLinkProcessor;\n\n @Override\n public Mono get(String name) {\n return client.fetch(Post.class, name);\n }\n\n @Override\n public Mono getSubjectDisplay(String name) {\n return get(name)\n .map(post -> {\n var url = externalLinkProcessor\n .processLink(post.getStatusOrDefault().getPermalink());\n return new SubjectDisplay(post.getSpec().getTitle(), url, \"文章\");\n });\n }\n\n @Override\n public boolean supports(Ref ref) {\n Assert.notNull(ref, \"Subject ref must not be null.\");\n var gvk = Post.GVK;\n return Objects.equals(gvk.group(), ref.getGroup())\n && Objects.equals(gvk.kind(), ref.getKind());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ReplyNotificationSubscriptionHelper.java", "content": "package run.halo.app.content.comment;\n\nimport io.micrometer.common.util.StringUtils;\nimport java.time.Duration;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.lang.Nullable;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.notification.UserIdentity;\n\n/**\n * Reply notification subscription helper.\n *\n * @author guqing\n * @since 2.9.0\n */\n@Component\n@RequiredArgsConstructor\npublic class ReplyNotificationSubscriptionHelper {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final NotificationCenter notificationCenter;\n\n /**\n * Subscribe new reply reason for comment.\n *\n * @param comment comment\n */\n public void subscribeNewReplyReasonForComment(Comment comment) {\n subscribeReply(identityFrom(comment.getSpec().getOwner()));\n }\n\n /**\n * Subscribe new reply reason for reply.\n *\n * @param reply reply\n */\n public void subscribeNewReplyReasonForReply(Reply reply) {\n var subjectOwner = reply.getSpec().getOwner();\n subscribeReply(identityFrom(subjectOwner));\n }\n\n void subscribeReply(UserIdentity identity) {\n var subscriber = createSubscriber(identity);\n if (subscriber == null) {\n return;\n }\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(NotificationReasonConst.SOMEONE_REPLIED_TO_YOU);\n interestReason.setExpression(\"props.repliedOwner == '%s'\".formatted(identity.name()));\n notificationCenter.subscribe(subscriber, interestReason).block(BLOCKING_TIMEOUT);\n }\n\n @Nullable\n private Subscription.Subscriber createSubscriber(UserIdentity author) {\n if (StringUtils.isBlank(author.name())) {\n return null;\n }\n\n Subscription.Subscriber subscriber = new Subscription.Subscriber();\n subscriber.setName(author.name());\n return subscriber;\n }\n\n public static UserIdentity identityFrom(Comment.CommentOwner owner) {\n if (Comment.CommentOwner.KIND_EMAIL.equals(owner.getKind())) {\n return UserIdentity.anonymousWithEmail(owner.getName());\n }\n return UserIdentity.of(owner.getName());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ReplyQuery.java", "content": "package run.halo.app.content.comment;\n\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.router.selector.SelectorUtil.labelAndFieldSelectorToListOptions;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.ServerWebInputException;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * Query criteria for {@link Reply} list.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class ReplyQuery extends SortableRequest {\n\n public ReplyQuery(ServerWebExchange exchange) {\n super(exchange);\n }\n\n @Schema(description = \"Replies filtered by commentName.\")\n public String getCommentName() {\n String commentName = queryParams.getFirst(\"commentName\");\n if (StringUtils.isBlank(commentName)) {\n throw new ServerWebInputException(\"The required parameter 'commentName' is missing.\");\n }\n return commentName;\n }\n\n /**\n * Build list options from query criteria.\n */\n public ListOptions toListOptions() {\n var listOptions =\n labelAndFieldSelectorToListOptions(getLabelSelector(), getFieldSelector());\n var newFieldSelector = listOptions.getFieldSelector()\n .andQuery(equal(\"spec.commentName\", getCommentName()));\n listOptions.setFieldSelector(newFieldSelector);\n return listOptions;\n }\n\n public PageRequest toPageRequest() {\n var sort = getSort().and(Sort.by(\"spec.creationTime\").ascending());\n return PageRequestImpl.of(getPage(), getSize(), sort);\n }\n\n public static void buildParameters(Builder builder) {\n SortableRequest.buildParameters(builder);\n builder.parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"commentName\")\n .description(\"Replies filtered by commentName.\")\n .implementation(String.class)\n .required(true));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ReplyRequest.java", "content": "package run.halo.app.content.comment;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.UUID;\nimport lombok.Data;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.Metadata;\n\n/**\n * A request parameter object for {@link Reply}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\npublic class ReplyRequest {\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String raw;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String content;\n\n @Schema(defaultValue = \"false\")\n private Boolean allowNotification;\n\n @Schema(defaultValue = \"false\")\n private Boolean hidden;\n\n private CommentEmailOwner owner;\n\n private String quoteReply;\n\n /**\n * Converts {@link ReplyRequest} to {@link Reply}.\n *\n * @return a reply\n */\n public Reply toReply() {\n Reply reply = new Reply();\n reply.setMetadata(new Metadata());\n reply.getMetadata().setName(UUID.randomUUID().toString());\n\n Reply.ReplySpec spec = new Reply.ReplySpec();\n reply.setSpec(spec);\n spec.setRaw(raw);\n spec.setContent(content);\n spec.setAllowNotification(allowNotification);\n spec.setHidden(hidden);\n spec.setQuoteReply(quoteReply);\n\n if (owner != null) {\n spec.setOwner(owner.toCommentOwner());\n }\n return reply;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ReplyService.java", "content": "package run.halo.app.content.comment;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.ListResult;\n\n/**\n * An application service for {@link Reply}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface ReplyService {\n\n Mono create(String commentName, Reply reply);\n\n Mono> list(ReplyQuery query);\n\n Mono removeAllByComment(String commentName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/ReplyServiceImpl.java", "content": "package run.halo.app.content.comment;\n\nimport static org.apache.commons.lang3.BooleanUtils.isTrue;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.ArrayList;\nimport java.util.function.Function;\nimport java.util.function.Supplier;\nimport java.util.function.UnaryOperator;\nimport org.apache.commons.lang3.StringUtils;\nimport org.reactivestreams.Publisher;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.exception.RequestRestrictedException;\n\n/**\n * A default implementation of {@link ReplyService}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Service\npublic class ReplyServiceImpl extends AbstractCommentService implements ReplyService {\n\n private final Supplier requestRestrictedExceptionSupplier =\n () -> new RequestRestrictedException(\"problemDetail.comment.waitingForApproval\");\n\n public ReplyServiceImpl(RoleService roleService, ReactiveExtensionClient client,\n UserService userService, CounterService counterService) {\n super(roleService, client, userService, counterService);\n }\n\n @Override\n public Mono create(String commentName, Reply reply) {\n if (reply.getSpec() == null\n || reply.getSpec().getContent() == null\n || !isSafeHtml(reply.getSpec().getContent())) {\n return Mono.error(new ServerWebInputException(\"\"\"\n The content of reply must not be empty or contains unsafe HTML.\\\n \"\"\"));\n }\n return client.get(Comment.class, commentName)\n .flatMap(this::approveComment)\n .filter(comment -> isTrue(comment.getSpec().getApproved()))\n .switchIfEmpty(Mono.error(requestRestrictedExceptionSupplier))\n .flatMap(comment -> prepareReply(comment, reply))\n .flatMap(this::doCreateReply);\n }\n\n private Mono doCreateReply(Reply prepared) {\n var quotedReply = prepared.getSpec().getQuoteReply();\n if (StringUtils.isBlank(quotedReply)) {\n return client.create(prepared);\n }\n return approveReply(quotedReply)\n .filter(reply -> isTrue(reply.getSpec().getApproved()))\n .switchIfEmpty(Mono.error(requestRestrictedExceptionSupplier))\n .doOnNext(approvedQuoteReply -> prepared.getSpec()\n .setHidden(approvedQuoteReply.getSpec().getHidden())\n )\n .flatMap(approvedQuoteReply -> client.create(prepared));\n }\n\n private Mono approveComment(Comment comment) {\n return hasCommentManagePermission()\n .flatMap(hasPermission -> {\n if (hasPermission) {\n return doApproveComment(comment);\n }\n return Mono.just(comment);\n });\n }\n\n private Mono doApproveComment(Comment comment) {\n UnaryOperator updateFunc = commentToUpdate -> {\n commentToUpdate.getSpec().setApproved(true);\n commentToUpdate.getSpec().setApprovedTime(Instant.now());\n return commentToUpdate;\n };\n return client.update(updateFunc.apply(comment))\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> updateCommentWithRetry(comment.getMetadata().getName(), updateFunc));\n }\n\n private Mono approveReply(String replyName) {\n return hasCommentManagePermission()\n .flatMap(hasPermission -> {\n if (hasPermission) {\n return doApproveReply(replyName);\n }\n return client.get(Reply.class, replyName);\n });\n }\n\n private Mono doApproveReply(String replyName) {\n return Mono.defer(() -> client.get(Reply.class, replyName)\n .flatMap(reply -> {\n reply.getSpec().setApproved(true);\n reply.getSpec().setApprovedTime(Instant.now());\n return client.update(reply);\n })\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono updateCommentWithRetry(String name, UnaryOperator updateFunc) {\n return Mono.defer(() -> client.get(Comment.class, name)\n .map(updateFunc)\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono prepareReply(Comment comment, Reply reply) {\n reply.getSpec().setCommentName(comment.getMetadata().getName());\n reply.getSpec().setHidden(comment.getSpec().getHidden());\n if (reply.getSpec().getTop() == null) {\n reply.getSpec().setTop(false);\n }\n if (reply.getSpec().getPriority() == null) {\n reply.getSpec().setPriority(0);\n }\n if (reply.getSpec().getCreationTime() == null) {\n reply.getSpec().setCreationTime(Instant.now());\n }\n if (reply.getSpec().getApproved() == null) {\n reply.getSpec().setApproved(false);\n }\n if (isTrue(reply.getSpec().getApproved())\n && reply.getSpec().getApprovedTime() == null) {\n reply.getSpec().setApprovedTime(Instant.now());\n }\n\n var steps = new ArrayList>();\n var approveItMono = hasCommentManagePermission()\n .filter(Boolean::booleanValue)\n .doOnNext(hasPermission -> {\n reply.getSpec().setApproved(true);\n reply.getSpec().setApprovedTime(Instant.now());\n });\n steps.add(approveItMono);\n\n var populateOwnerMono = fetchCurrentUser()\n .switchIfEmpty(\n Mono.error(new IllegalArgumentException(\"Reply owner must not be null.\")))\n .doOnNext(user -> reply.getSpec().setOwner(toCommentOwner(user)));\n if (reply.getSpec().getOwner() == null) {\n steps.add(populateOwnerMono);\n }\n return Mono.when(steps).thenReturn(reply);\n }\n\n @Override\n public Mono> list(ReplyQuery query) {\n return client.listBy(Reply.class, query.toListOptions(), query.toPageRequest())\n .flatMap(list -> Flux.fromStream(list.get()\n .map(this::toListedReply))\n .flatMapSequential(Function.identity())\n .collectList()\n .map(listedReplies -> new ListResult<>(list.getPage(), list.getSize(),\n list.getTotal(), listedReplies))\n );\n }\n\n @Override\n public Mono removeAllByComment(String commentName) {\n Assert.notNull(commentName, \"The commentName must not be null.\");\n return cleanupComments(commentName, 200);\n }\n\n private Mono cleanupComments(String commentName, int batchSize) {\n // ascending order by creation time and name\n final var pageRequest = PageRequestImpl.of(1, batchSize,\n Sort.by(\"metadata.creationTimestamp\", \"metadata.name\"));\n // forever loop first page until no more to delete\n return listRepliesByComment(commentName, pageRequest)\n .flatMap(page -> Flux.fromIterable(page.getItems())\n .flatMap(this::deleteWithRetry)\n .then(page.hasNext() ? cleanupComments(commentName, batchSize) : Mono.empty())\n );\n }\n\n private Mono deleteWithRetry(Reply item) {\n return client.delete(item)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> attemptToDelete(item.getMetadata().getName()));\n }\n\n private Mono attemptToDelete(String name) {\n return Mono.defer(() -> client.fetch(Reply.class, name)\n .flatMap(client::delete)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n Mono> listRepliesByComment(String commentName, PageRequest pageRequest) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n and(\n equal(\"spec.commentName\", commentName),\n isNull(\"metadata.deletionTimestamp\")\n )\n ));\n return client.listBy(Reply.class, listOptions, pageRequest);\n }\n\n private Mono toListedReply(Reply reply) {\n ListedReply.ListedReplyBuilder builder = ListedReply.builder()\n .reply(reply);\n return getOwnerInfo(reply.getSpec().getOwner())\n .map(ownerInfo -> {\n builder.owner(ownerInfo);\n return builder;\n })\n .map(ListedReply.ListedReplyBuilder::build)\n .flatMap(listedReply -> fetchReplyStats(reply.getMetadata().getName())\n .doOnNext(listedReply::setStats)\n .thenReturn(listedReply));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/comment/SinglePageCommentSubject.java", "content": "package run.halo.app.content.comment;\n\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.ExternalLinkProcessor;\n\n/**\n * Comment subject for {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class SinglePageCommentSubject implements CommentSubject {\n\n private final ReactiveExtensionClient client;\n\n private final ExternalLinkProcessor externalLinkProcessor;\n\n @Override\n public Mono get(String name) {\n return client.fetch(SinglePage.class, name);\n }\n\n @Override\n public Mono getSubjectDisplay(String name) {\n return get(name)\n .map(page -> {\n var url = externalLinkProcessor\n .processLink(page.getStatusOrDefault().getPermalink());\n return new SubjectDisplay(page.getSpec().getTitle(), url, \"页面\");\n });\n }\n\n @Override\n public boolean supports(Ref ref) {\n Assert.notNull(ref, \"Subject ref must not be null.\");\n var gvk = SinglePage.GVK;\n return Objects.equals(gvk.group(), ref.getGroup())\n && Objects.equals(gvk.kind(), ref.getKind());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/impl/CategoryServiceImpl.java", "content": "package run.halo.app.content.impl;\n\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\n\n@Component\n@RequiredArgsConstructor\npublic class CategoryServiceImpl implements CategoryService {\n private final ReactiveExtensionClient client;\n\n @Override\n public Flux listChildren(@NonNull String categoryName) {\n return client.fetch(Category.class, categoryName)\n .expand(category -> {\n var children = category.getSpec().getChildren();\n if (children == null || children.isEmpty()) {\n return Mono.empty();\n }\n return Flux.fromIterable(children)\n .flatMap(name -> client.fetch(Category.class, name))\n .filter(this::isNotIndependent);\n });\n }\n\n @Override\n public Mono getParentByName(@NonNull String name) {\n if (StringUtils.isBlank(name)) {\n return Mono.empty();\n }\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n equal(\"spec.children\", name)\n ));\n return client.listBy(Category.class, listOptions,\n PageRequestImpl.of(1, 1, defaultSort())\n )\n .flatMap(result -> Mono.justOrEmpty(ListResult.first(result)));\n }\n\n @Override\n public Mono isCategoryHidden(@NonNull String categoryName) {\n return client.fetch(Category.class, categoryName)\n .expand(category -> getParentByName(category.getMetadata().getName()))\n .filter(category -> category.getSpec().isHideFromList())\n .hasElements();\n }\n\n static Sort defaultSort() {\n return Sort.by(Sort.Order.desc(\"spec.priority\"),\n Sort.Order.desc(\"metadata.creationTimestamp\"),\n Sort.Order.desc(\"metadata.name\"));\n }\n\n private boolean isNotIndependent(Category category) {\n return !category.getSpec().isPreventParentPostCascadeQuery();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/impl/PostServiceImpl.java", "content": "package run.halo.app.content.impl;\n\nimport static run.halo.app.extension.index.query.Queries.in;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport java.util.function.ToIntFunction;\nimport java.util.function.UnaryOperator;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.content.AbstractContentService;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.content.ContentRequest;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.Contributor;\nimport run.halo.app.content.ListedPost;\nimport run.halo.app.content.ListedSnapshotDto;\nimport run.halo.app.content.PostQuery;\nimport run.halo.app.content.PostRequest;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.Stats;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionStatus;\n\n/**\n * A default implementation of {@link PostService}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class PostServiceImpl extends AbstractContentService implements PostService {\n private final ReactiveExtensionClient client;\n private final CounterService counterService;\n private final UserService userService;\n private final CategoryService categoryService;\n\n public PostServiceImpl(ReactiveExtensionClient client, CounterService counterService,\n UserService userService, CategoryService categoryService) {\n super(client);\n this.client = client;\n this.counterService = counterService;\n this.userService = userService;\n this.categoryService = categoryService;\n }\n\n @Override\n public Mono> listPost(PostQuery query) {\n return buildListOptions(query)\n .flatMap(listOptions ->\n client.listBy(Post.class, listOptions, query.toPageRequest())\n )\n .flatMap(listResult -> Flux.fromStream(listResult.get())\n .map(this::getListedPost)\n .flatMapSequential(Function.identity())\n .collectList()\n .map(listedPosts -> new ListResult<>(listResult.getPage(), listResult.getSize(),\n listResult.getTotal(), listedPosts)\n )\n .defaultIfEmpty(ListResult.emptyResult())\n );\n }\n\n Mono buildListOptions(PostQuery query) {\n var categoryName = query.getCategoryWithChildren();\n if (categoryName == null) {\n return Mono.just(query.toListOptions());\n }\n return categoryService.listChildren(categoryName)\n .collectList()\n .map(categories -> {\n var categoryNames = categories.stream()\n .map(Category::getMetadata)\n .map(MetadataOperator::getName)\n .toList();\n var listOptions = query.toListOptions();\n var newFiledSelector = listOptions.getFieldSelector()\n .andQuery(in(\"spec.categories\", categoryNames));\n listOptions.setFieldSelector(newFiledSelector);\n return listOptions;\n });\n }\n\n Mono fetchStats(Post post) {\n Assert.notNull(post, \"The post must not be null.\");\n String name = post.getMetadata().getName();\n return counterService.getByName(MeterUtils.nameOf(Post.class, name))\n .map(counter -> Stats.builder()\n .visit(counter.getVisit())\n .upvote(counter.getUpvote())\n .totalComment(counter.getTotalComment())\n .approvedComment(counter.getApprovedComment())\n .build()\n )\n .defaultIfEmpty(Stats.empty());\n }\n\n private Mono getListedPost(Post post) {\n Assert.notNull(post, \"The post must not be null.\");\n var listedPost = new ListedPost().setPost(post);\n\n var statsMono = fetchStats(post)\n .doOnNext(listedPost::setStats);\n\n var tagsMono = listTags(post.getSpec().getTags())\n .collectList()\n .doOnNext(listedPost::setTags);\n\n var categoriesMono = listCategories(post.getSpec().getCategories())\n .collectList()\n .doOnNext(listedPost::setCategories);\n\n var contributorsMono = listContributors(post.getStatusOrDefault().getContributors())\n .collectList()\n .doOnNext(listedPost::setContributors);\n\n var ownerMono = userService.getUserOrGhost(post.getSpec().getOwner())\n .map(user -> {\n Contributor contributor = new Contributor();\n contributor.setName(user.getMetadata().getName());\n contributor.setDisplayName(user.getSpec().getDisplayName());\n contributor.setAvatar(user.getSpec().getAvatar());\n return contributor;\n })\n .doOnNext(listedPost::setOwner);\n return Mono.when(statsMono, tagsMono, categoriesMono, contributorsMono, ownerMono)\n .thenReturn(listedPost);\n }\n\n private Flux listTags(List tagNames) {\n if (CollectionUtils.isEmpty(tagNames)) {\n return Flux.empty();\n }\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(in(\"metadata.name\", tagNames)));\n return client.listAll(Tag.class, listOptions, Sort.by(\"metadata.creationTimestamp\"));\n }\n\n @Override\n public Flux listCategories(List categoryNames) {\n if (CollectionUtils.isEmpty(categoryNames)) {\n return Flux.empty();\n }\n ToIntFunction comparator =\n category -> categoryNames.indexOf(category.getMetadata().getName());\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(in(\"metadata.name\", categoryNames)));\n return client.listAll(Category.class, listOptions, Sort.unsorted())\n .sort(Comparator.comparingInt(comparator));\n }\n\n private Flux listContributors(List usernames) {\n if (CollectionUtils.isEmpty(usernames)) {\n return Flux.empty();\n }\n return Flux.fromIterable(usernames)\n .flatMapSequential(userService::getUserOrGhost)\n .map(user -> {\n Contributor contributor = new Contributor();\n contributor.setName(user.getMetadata().getName());\n contributor.setDisplayName(user.getSpec().getDisplayName());\n contributor.setAvatar(user.getSpec().getAvatar());\n return contributor;\n });\n }\n\n @Override\n public Mono draftPost(PostRequest postRequest) {\n return Mono.defer(\n () -> {\n var post = postRequest.post();\n return getContextUsername()\n .doOnNext(username -> post.getSpec().setOwner(username))\n .thenReturn(post);\n })\n .flatMap(client::create)\n .flatMap(post -> {\n if (postRequest.content() == null) {\n return Mono.just(post);\n }\n var contentRequest =\n new ContentRequest(Ref.of(post), post.getSpec().getHeadSnapshot(),\n null,\n postRequest.content().raw(), postRequest.content().content(),\n postRequest.content().rawType());\n return draftContent(post.getSpec().getBaseSnapshot(), contentRequest)\n .flatMap(contentWrapper -> waitForPostToDraftConcludingWork(\n post.getMetadata().getName(),\n contentWrapper)\n );\n })\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono waitForPostToDraftConcludingWork(String postName,\n ContentWrapper contentWrapper) {\n return Mono.defer(() -> client.fetch(Post.class, postName)\n .flatMap(post -> {\n post.getSpec().setBaseSnapshot(contentWrapper.getSnapshotName());\n post.getSpec().setHeadSnapshot(contentWrapper.getSnapshotName());\n if (Objects.equals(true, post.getSpec().getPublish())) {\n post.getSpec().setReleaseSnapshot(post.getSpec().getHeadSnapshot());\n }\n Condition condition = Condition.builder()\n .type(Post.PostPhase.DRAFT.name())\n .reason(\"DraftedSuccessfully\")\n .message(\"Drafted post successfully.\")\n .status(ConditionStatus.TRUE)\n .lastTransitionTime(Instant.now())\n .build();\n Post.PostStatus status = post.getStatusOrDefault();\n status.setPhase(Post.PostPhase.DRAFT.name());\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n return client.update(post);\n }))\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n @Override\n public Mono updatePost(PostRequest postRequest) {\n Post post = postRequest.post();\n String headSnapshot = post.getSpec().getHeadSnapshot();\n String releaseSnapshot = post.getSpec().getReleaseSnapshot();\n String baseSnapshot = post.getSpec().getBaseSnapshot();\n\n if (StringUtils.equals(releaseSnapshot, headSnapshot)) {\n // create new snapshot to update first\n return draftContent(baseSnapshot, postRequest.contentRequest(), headSnapshot)\n .flatMap(contentWrapper -> {\n post.getSpec().setHeadSnapshot(contentWrapper.getSnapshotName());\n return client.update(post);\n });\n }\n return updateContent(baseSnapshot, postRequest.contentRequest())\n .flatMap(contentWrapper -> {\n post.getSpec().setHeadSnapshot(contentWrapper.getSnapshotName());\n return client.update(post);\n });\n }\n\n @Override\n public Mono updateBy(@NonNull Post post) {\n return client.update(post);\n }\n\n @Override\n public Mono getHeadContent(String postName) {\n return client.get(Post.class, postName)\n .flatMap(this::getHeadContent);\n }\n\n @Override\n public Mono getHeadContent(Post post) {\n var headSnapshot = post.getSpec().getHeadSnapshot();\n return getContent(headSnapshot, post.getSpec().getBaseSnapshot());\n }\n\n @Override\n public Mono getReleaseContent(String postName) {\n return client.get(Post.class, postName)\n .flatMap(this::getReleaseContent);\n }\n\n @Override\n public Mono getReleaseContent(Post post) {\n var releaseSnapshot = post.getSpec().getReleaseSnapshot();\n return getContent(releaseSnapshot, post.getSpec().getBaseSnapshot());\n }\n\n @Override\n public Flux listSnapshots(String name) {\n return client.fetch(Post.class, name)\n .flatMapMany(page -> listSnapshotsBy(Ref.of(page)))\n .map(ListedSnapshotDto::from);\n }\n\n @Override\n public Mono publish(Post post) {\n var spec = post.getSpec();\n spec.setPublish(true);\n if (spec.getHeadSnapshot() == null) {\n spec.setHeadSnapshot(spec.getBaseSnapshot());\n }\n spec.setReleaseSnapshot(spec.getHeadSnapshot());\n return client.update(post);\n }\n\n @Override\n public Mono unpublish(Post post) {\n post.getSpec().setPublish(false);\n return client.update(post);\n }\n\n @Override\n public Mono getByUsername(String postName, String username) {\n return client.get(Post.class, postName)\n .filter(post -> post.getSpec() != null)\n .filter(post -> Objects.equals(username, post.getSpec().getOwner()));\n }\n\n @Override\n public Mono revertToSpecifiedSnapshot(String postName, String snapshotName) {\n return client.get(Post.class, postName)\n .filter(post -> {\n var head = post.getSpec().getHeadSnapshot();\n return !StringUtils.equals(head, snapshotName);\n })\n .flatMap(post -> {\n var baseSnapshot = post.getSpec().getBaseSnapshot();\n return getContent(snapshotName, baseSnapshot)\n .map(content -> ContentRequest.builder()\n .subjectRef(Ref.of(post))\n .headSnapshotName(post.getSpec().getHeadSnapshot())\n .content(content.getContent())\n .raw(content.getRaw())\n .rawType(content.getRawType())\n .build()\n )\n .flatMap(contentRequest -> draftContent(baseSnapshot, contentRequest))\n .flatMap(content -> {\n post.getSpec().setHeadSnapshot(content.getSnapshotName());\n return publishPostWithRetry(post);\n });\n });\n }\n\n @Override\n public Mono deleteContent(String postName, String snapshotName) {\n return client.get(Post.class, postName)\n .flatMap(post -> {\n var headSnapshotName = post.getSpec().getHeadSnapshot();\n if (StringUtils.equals(headSnapshotName, snapshotName)) {\n return updatePostWithRetry(post, record -> {\n // update head to release\n record.getSpec().setHeadSnapshot(record.getSpec().getReleaseSnapshot());\n return record;\n });\n }\n return Mono.just(post);\n })\n .flatMap(post -> {\n var baseSnapshotName = post.getSpec().getBaseSnapshot();\n var releaseSnapshotName = post.getSpec().getReleaseSnapshot();\n if (StringUtils.equals(releaseSnapshotName, snapshotName)) {\n return Mono.error(new ServerWebInputException(\n \"The snapshot to delete is the release snapshot, please\"\n + \" revert to another snapshot first.\"));\n }\n if (StringUtils.equals(baseSnapshotName, snapshotName)) {\n return Mono.error(\n new ServerWebInputException(\"The first snapshot cannot be deleted.\"));\n }\n return client.fetch(Snapshot.class, snapshotName)\n .flatMap(client::delete)\n .flatMap(deleted -> restoredContent(baseSnapshotName, deleted));\n });\n }\n\n @Override\n public Mono recycleBy(String postName, String username) {\n return getByUsername(postName, username)\n .flatMap(post -> updatePostWithRetry(post, record -> {\n record.getSpec().setDeleted(true);\n return record;\n }));\n }\n\n private Mono updatePostWithRetry(Post post, UnaryOperator func) {\n return client.update(func.apply(post))\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> Mono.defer(() -> client.get(Post.class, post.getMetadata().getName())\n .map(func)\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n );\n }\n\n Mono publishPostWithRetry(Post post) {\n return publish(post)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> Mono.defer(() -> client.get(Post.class, post.getMetadata().getName())\n .flatMap(this::publish))\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/impl/SinglePageServiceImpl.java", "content": "package run.halo.app.content.impl;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport java.util.function.UnaryOperator;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.content.AbstractContentService;\nimport run.halo.app.content.ContentRequest;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.Contributor;\nimport run.halo.app.content.ListedSinglePage;\nimport run.halo.app.content.ListedSnapshotDto;\nimport run.halo.app.content.SinglePageQuery;\nimport run.halo.app.content.SinglePageRequest;\nimport run.halo.app.content.SinglePageService;\nimport run.halo.app.content.Stats;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionStatus;\n\n/**\n * Single page service implementation.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Service\npublic class SinglePageServiceImpl extends AbstractContentService implements SinglePageService {\n\n private final ReactiveExtensionClient client;\n private final CounterService counterService;\n private final UserService userService;\n\n public SinglePageServiceImpl(ReactiveExtensionClient client, CounterService counterService,\n UserService userService) {\n super(client);\n this.client = client;\n this.counterService = counterService;\n this.userService = userService;\n }\n\n @Override\n public Mono getHeadContent(String singlePageName) {\n return client.get(SinglePage.class, singlePageName)\n .flatMap(singlePage -> {\n String headSnapshot = singlePage.getSpec().getHeadSnapshot();\n return getContent(headSnapshot, singlePage.getSpec().getBaseSnapshot());\n });\n }\n\n @Override\n public Mono getReleaseContent(String singlePageName) {\n return client.get(SinglePage.class, singlePageName)\n .flatMap(singlePage -> {\n String releaseSnapshot = singlePage.getSpec().getReleaseSnapshot();\n return getContent(releaseSnapshot, singlePage.getSpec().getBaseSnapshot());\n });\n }\n\n @Override\n public Flux listSnapshots(String pageName) {\n return client.fetch(SinglePage.class, pageName)\n .flatMapMany(page -> listSnapshotsBy(Ref.of(page)))\n .map(ListedSnapshotDto::from);\n }\n\n @Override\n public Mono> list(SinglePageQuery query) {\n return client.listBy(SinglePage.class, query.toListOptions(), query.toPageRequest())\n .flatMap(listResult -> Flux.fromStream(listResult.get().map(this::getListedSinglePage))\n .flatMapSequential(Function.identity())\n .collectList()\n .map(listedSinglePages -> new ListResult<>(\n listResult.getPage(),\n listResult.getSize(),\n listResult.getTotal(),\n listedSinglePages)\n )\n );\n }\n\n @Override\n public Mono draft(SinglePageRequest pageRequest) {\n return Mono.defer(\n () -> {\n SinglePage page = pageRequest.page();\n return getContextUsername()\n .doOnNext(username -> page.getSpec().setOwner(username))\n .thenReturn(page);\n }\n )\n .flatMap(client::create)\n .flatMap(page -> {\n var contentRequest =\n new ContentRequest(Ref.of(page), page.getSpec().getHeadSnapshot(),\n null,\n pageRequest.content().raw(), pageRequest.content().content(),\n pageRequest.content().rawType());\n return draftContent(page.getSpec().getBaseSnapshot(), contentRequest)\n .flatMap(\n contentWrapper -> waitForPageToDraftConcludingWork(\n page.getMetadata().getName(),\n contentWrapper\n )\n );\n });\n }\n\n private Mono waitForPageToDraftConcludingWork(String pageName,\n ContentWrapper contentWrapper) {\n return Mono.defer(() -> client.fetch(SinglePage.class, pageName)\n .flatMap(page -> {\n page.getSpec().setBaseSnapshot(contentWrapper.getSnapshotName());\n page.getSpec().setHeadSnapshot(contentWrapper.getSnapshotName());\n if (Objects.equals(true, page.getSpec().getPublish())) {\n page.getSpec().setReleaseSnapshot(page.getSpec().getHeadSnapshot());\n }\n Condition condition = Condition.builder()\n .type(Post.PostPhase.DRAFT.name())\n .reason(\"DraftedSuccessfully\")\n .message(\"Drafted page successfully\")\n .status(ConditionStatus.TRUE)\n .lastTransitionTime(Instant.now())\n .build();\n SinglePage.SinglePageStatus status = page.getStatusOrDefault();\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n status.setPhase(Post.PostPhase.DRAFT.name());\n return client.update(page);\n }))\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance)\n );\n }\n\n @Override\n public Mono update(SinglePageRequest pageRequest) {\n SinglePage page = pageRequest.page();\n String headSnapshot = page.getSpec().getHeadSnapshot();\n String releaseSnapshot = page.getSpec().getReleaseSnapshot();\n String baseSnapshot = page.getSpec().getBaseSnapshot();\n\n // create new snapshot to update first\n if (StringUtils.equals(headSnapshot, releaseSnapshot)) {\n return draftContent(baseSnapshot, pageRequest.contentRequest(), headSnapshot)\n .flatMap(contentWrapper -> {\n page.getSpec().setHeadSnapshot(contentWrapper.getSnapshotName());\n return client.update(page);\n });\n }\n return updateContent(baseSnapshot, pageRequest.contentRequest())\n .flatMap(contentWrapper -> {\n page.getSpec().setHeadSnapshot(contentWrapper.getSnapshotName());\n return client.update(page);\n });\n }\n\n @Override\n public Mono revertToSpecifiedSnapshot(String pageName, String snapshotName) {\n return client.get(SinglePage.class, pageName)\n .filter(page -> {\n var head = page.getSpec().getHeadSnapshot();\n return !StringUtils.equals(head, snapshotName);\n })\n .flatMap(page -> {\n var baseSnapshot = page.getSpec().getBaseSnapshot();\n return getContent(snapshotName, baseSnapshot)\n .map(content -> ContentRequest.builder()\n .subjectRef(Ref.of(page))\n .headSnapshotName(page.getSpec().getHeadSnapshot())\n .content(content.getContent())\n .raw(content.getRaw())\n .rawType(content.getRawType())\n .build()\n )\n .flatMap(contentRequest -> draftContent(baseSnapshot, contentRequest))\n .flatMap(content -> {\n page.getSpec().setHeadSnapshot(content.getSnapshotName());\n return publishPageWithRetry(page);\n });\n });\n }\n\n @Override\n public Mono deleteContent(String pageName, String snapshotName) {\n return client.get(SinglePage.class, pageName)\n .flatMap(page -> {\n var headSnapshotName = page.getSpec().getHeadSnapshot();\n if (StringUtils.equals(headSnapshotName, snapshotName)) {\n return updatePageWithRetry(page, record -> {\n // update head to release\n page.getSpec().setHeadSnapshot(page.getSpec().getReleaseSnapshot());\n return record;\n });\n }\n return Mono.just(page);\n })\n .flatMap(page -> {\n var baseSnapshotName = page.getSpec().getBaseSnapshot();\n var releaseSnapshotName = page.getSpec().getReleaseSnapshot();\n if (StringUtils.equals(releaseSnapshotName, snapshotName)) {\n return Mono.error(new ServerWebInputException(\n \"The snapshot to delete is the release snapshot, please\"\n + \" revert to another snapshot first.\"));\n }\n if (StringUtils.equals(baseSnapshotName, snapshotName)) {\n return Mono.error(\n new ServerWebInputException(\"The first snapshot cannot be deleted.\"));\n }\n return client.fetch(Snapshot.class, snapshotName)\n .flatMap(client::delete)\n .flatMap(deleted -> restoredContent(baseSnapshotName, deleted));\n });\n }\n\n private Mono updatePageWithRetry(SinglePage page, UnaryOperator func) {\n return client.update(func.apply(page))\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> Mono.defer(() -> client.get(SinglePage.class, page.getMetadata().getName())\n .map(func)\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n );\n }\n\n private Mono publish(SinglePage singlePage) {\n var spec = singlePage.getSpec();\n spec.setPublish(true);\n if (spec.getHeadSnapshot() == null) {\n spec.setHeadSnapshot(spec.getBaseSnapshot());\n }\n spec.setReleaseSnapshot(spec.getHeadSnapshot());\n return client.update(singlePage);\n }\n\n Mono publishPageWithRetry(SinglePage page) {\n return publish(page)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> Mono.defer(() -> client.get(SinglePage.class, page.getMetadata().getName())\n .flatMap(this::publish))\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n );\n }\n\n private Mono getListedSinglePage(SinglePage singlePage) {\n Assert.notNull(singlePage, \"The singlePage must not be null.\");\n var listedSinglePage = new ListedSinglePage()\n .setPage(singlePage);\n\n var statsMono = fetchStats(singlePage)\n .doOnNext(listedSinglePage::setStats);\n\n var contributorsMono = listContributors(singlePage.getStatusOrDefault().getContributors())\n .collectList()\n .doOnNext(listedSinglePage::setContributors);\n\n var ownerMono = userService.getUserOrGhost(singlePage.getSpec().getOwner())\n .map(user -> {\n Contributor contributor = new Contributor();\n contributor.setName(user.getMetadata().getName());\n contributor.setDisplayName(user.getSpec().getDisplayName());\n contributor.setAvatar(user.getSpec().getAvatar());\n return contributor;\n })\n .doOnNext(listedSinglePage::setOwner);\n return Mono.when(statsMono, contributorsMono, ownerMono)\n .thenReturn(listedSinglePage);\n }\n\n Mono fetchStats(SinglePage singlePage) {\n Assert.notNull(singlePage, \"The singlePage must not be null.\");\n String name = singlePage.getMetadata().getName();\n return counterService.getByName(MeterUtils.nameOf(SinglePage.class, name))\n .map(counter -> Stats.builder()\n .visit(counter.getVisit())\n .upvote(counter.getUpvote())\n .totalComment(counter.getTotalComment())\n .approvedComment(counter.getApprovedComment())\n .build()\n )\n .defaultIfEmpty(Stats.empty());\n }\n\n private Flux listContributors(List usernames) {\n if (usernames == null) {\n return Flux.empty();\n }\n return Flux.fromIterable(usernames)\n .flatMap(userService::getUserOrGhost)\n .map(user -> {\n Contributor contributor = new Contributor();\n contributor.setName(user.getMetadata().getName());\n contributor.setDisplayName(user.getSpec().getDisplayName());\n contributor.setAvatar(user.getSpec().getAvatar());\n return contributor;\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/impl/SnapshotServiceImpl.java", "content": "package run.halo.app.content.impl;\n\nimport java.time.Clock;\nimport java.util.HashMap;\nimport java.util.Objects;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport org.springframework.stereotype.Service;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.Content;\nimport run.halo.app.content.PatchUtils;\nimport run.halo.app.content.SnapshotService;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@Service\npublic class SnapshotServiceImpl implements SnapshotService {\n\n private final ReactiveExtensionClient client;\n\n private final Clock clock;\n\n public SnapshotServiceImpl(ReactiveExtensionClient client) {\n this.client = client;\n this.clock = Clock.systemDefaultZone();\n }\n\n @Override\n public Mono getBy(String snapshotName) {\n return client.get(Snapshot.class, snapshotName);\n }\n\n @Override\n public Mono getPatchedBy(String snapshotName, String baseSnapshotName) {\n if (StringUtils.isBlank(snapshotName) || StringUtils.isBlank(baseSnapshotName)) {\n return Mono.empty();\n }\n\n return client.fetch(Snapshot.class, baseSnapshotName)\n .filter(Snapshot::isBaseSnapshot)\n .switchIfEmpty(Mono.error(() -> new IllegalArgumentException(\n \"The snapshot \" + baseSnapshotName + \" is not a base snapshot.\")))\n .flatMap(baseSnapshot ->\n Mono.defer(() -> {\n if (Objects.equals(snapshotName, baseSnapshotName)) {\n return Mono.just(baseSnapshot);\n }\n return client.fetch(Snapshot.class, snapshotName);\n }).doOnNext(snapshot -> {\n var baseRaw = baseSnapshot.getSpec().getRawPatch();\n var baseContent = baseSnapshot.getSpec().getContentPatch();\n\n var rawPatch = snapshot.getSpec().getRawPatch();\n var contentPatch = snapshot.getSpec().getContentPatch();\n\n var annotations = snapshot.getMetadata().getAnnotations();\n if (annotations == null) {\n annotations = new HashMap<>();\n snapshot.getMetadata().setAnnotations(annotations);\n }\n\n String patchedContent = baseContent;\n String patchedRaw = baseRaw;\n if (!Objects.equals(snapshot, baseSnapshot)) {\n patchedContent = PatchUtils.applyPatch(baseContent, contentPatch);\n patchedRaw = PatchUtils.applyPatch(baseRaw, rawPatch);\n }\n\n annotations.put(Snapshot.PATCHED_CONTENT_ANNO, patchedContent);\n annotations.put(Snapshot.PATCHED_RAW_ANNO, patchedRaw);\n })\n );\n }\n\n @Override\n public Mono patchAndCreate(@NonNull Snapshot snapshot,\n @Nullable Snapshot baseSnapshot,\n @NonNull Content content) {\n return Mono.just(snapshot)\n .doOnNext(s -> this.patch(s, baseSnapshot, content))\n .flatMap(client::create);\n }\n\n @Override\n public Mono patchAndUpdate(@NonNull Snapshot snapshot,\n @NonNull Snapshot baseSnapshot,\n @NonNull Content content) {\n return Mono.just(snapshot)\n .doOnNext(s -> this.patch(s, baseSnapshot, content))\n .flatMap(client::update);\n }\n\n private void patch(@NonNull Snapshot snapshot,\n @Nullable Snapshot baseSnapshot,\n @NonNull Content content) {\n var annotations = snapshot.getMetadata().getAnnotations();\n if (annotations != null) {\n annotations.remove(Snapshot.PATCHED_CONTENT_ANNO);\n annotations.remove(Snapshot.PATCHED_RAW_ANNO);\n }\n var spec = snapshot.getSpec();\n if (spec == null) {\n spec = new Snapshot.SnapShotSpec();\n }\n spec.setRawType(content.rawType());\n if (baseSnapshot == null || Objects.equals(snapshot, baseSnapshot)) {\n // indicate the snapshot is a base snapshot\n // update raw and content directly\n spec.setRawPatch(content.raw());\n spec.setContentPatch(content.content());\n } else {\n // apply the patch and set the raw and content\n var baseSpec = baseSnapshot.getSpec();\n var baseContent = baseSpec.getContentPatch();\n var baseRaw = baseSpec.getRawPatch();\n\n var rawPatch = PatchUtils.diffToJsonPatch(baseRaw, content.raw());\n var contentPatch = PatchUtils.diffToJsonPatch(baseContent, content.content());\n spec.setRawPatch(rawPatch);\n spec.setContentPatch(contentPatch);\n }\n spec.setLastModifyTime(clock.instant());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/permalinks/CategoryPermalinkPolicy.java", "content": "package run.halo.app.content.permalinks;\n\nimport static org.springframework.web.util.UriUtils.encode;\n\nimport java.nio.charset.StandardCharsets;\nimport java.time.Duration;\nimport java.util.Map;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.theme.utils.PatternUtils;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class CategoryPermalinkPolicy implements PermalinkPolicy {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private static final String DEFAULT_PERMALINK_PREFIX =\n SystemSetting.ThemeRouteRules.empty().getCategories();\n\n private final ExternalUrlSupplier externalUrlSupplier;\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public String permalink(Category category) {\n Map annotations = MetadataUtil.nullSafeAnnotations(category);\n String permalinkPrefix =\n annotations.getOrDefault(Constant.PERMALINK_PATTERN_ANNO, DEFAULT_PERMALINK_PREFIX);\n String slug = encode(category.getSpec().getSlug(), StandardCharsets.UTF_8);\n String path = PathUtils.combinePath(permalinkPrefix, slug);\n return externalUrlSupplier.get()\n .resolve(path)\n .normalize().toString();\n }\n\n public String pattern() {\n return environmentFetcher.fetchRouteRules()\n .map(SystemSetting.ThemeRouteRules::getCategories)\n .defaultIfEmpty(DEFAULT_PERMALINK_PREFIX)\n .map(PatternUtils::normalizePattern)\n .block(BLOCKING_TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/permalinks/ExtensionLocator.java", "content": "package run.halo.app.content.permalinks;\n\nimport java.util.Objects;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * Slug can be modified, so it is not included in {@link #equals(Object)} and {@link #hashCode()}.\n *\n * @param gvk group version kind\n * @param name extension name\n * @param slug extension slug\n */\npublic record ExtensionLocator(GroupVersionKind gvk, String name, String slug) {\n\n /**\n * Create a new {@link ExtensionLocator} instance.\n *\n * @param gvk group version kind\n * @param name extension name\n * @param slug extension slug\n */\n public ExtensionLocator {\n Objects.requireNonNull(gvk, \"Group version kind must not be null\");\n Objects.requireNonNull(name, \"Extension name must not be null\");\n Objects.requireNonNull(slug, \"Extension slug must not be null\");\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n ExtensionLocator locator = (ExtensionLocator) o;\n return gvk.equals(locator.gvk) && name.equals(locator.name);\n }\n\n @Override\n public int hashCode() {\n return Objects.hash(gvk, name);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/permalinks/PermalinkPolicy.java", "content": "package run.halo.app.content.permalinks;\n\nimport org.springframework.util.PropertyPlaceholderHelper;\nimport run.halo.app.extension.AbstractExtension;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic interface PermalinkPolicy {\n\n PropertyPlaceholderHelper PROPERTY_PLACEHOLDER_HELPER =\n new PropertyPlaceholderHelper(\"{\", \"}\");\n\n String permalink(T extension);\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/permalinks/PostPermalinkPolicy.java", "content": "package run.halo.app.content.permalinks;\n\nimport static org.springframework.web.util.UriUtils.encode;\n\nimport java.nio.charset.StandardCharsets;\nimport java.text.DecimalFormat;\nimport java.text.NumberFormat;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.time.ZoneId;\nimport java.time.ZonedDateTime;\nimport java.util.Map;\nimport java.util.Properties;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.theme.utils.PatternUtils;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class PostPermalinkPolicy implements PermalinkPolicy {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n public static final String DEFAULT_CATEGORY = \"default\";\n private static final String DEFAULT_PERMALINK_PATTERN =\n SystemSetting.ThemeRouteRules.empty().getPost();\n private static final NumberFormat NUMBER_FORMAT = new DecimalFormat(\"00\");\n\n private final SystemConfigFetcher environmentFetcher;\n private final ExternalUrlSupplier externalUrlSupplier;\n private final PostService postService;\n\n @Override\n public String permalink(Post post) {\n Map annotations = MetadataUtil.nullSafeAnnotations(post);\n String permalinkPattern =\n annotations.getOrDefault(Constant.PERMALINK_PATTERN_ANNO, DEFAULT_PERMALINK_PATTERN);\n return createPermalink(post, permalinkPattern);\n }\n\n public String pattern() {\n return environmentFetcher.fetchRouteRules()\n .map(PatternUtils::normalizePostPattern)\n .defaultIfEmpty(DEFAULT_PERMALINK_PATTERN)\n .block(BLOCKING_TIMEOUT);\n }\n\n private String createPermalink(Post post, String pattern) {\n Instant archiveTime = post.getSpec().getPublishTime();\n if (archiveTime == null) {\n archiveTime = post.getMetadata().getCreationTimestamp();\n }\n ZonedDateTime zonedDateTime = archiveTime.atZone(ZoneId.systemDefault());\n Properties properties = new Properties();\n properties.put(\"name\", post.getMetadata().getName());\n properties.put(\"slug\", encode(post.getSpec().getSlug(), StandardCharsets.UTF_8));\n properties.put(\"year\", String.valueOf(zonedDateTime.getYear()));\n properties.put(\"month\", NUMBER_FORMAT.format(zonedDateTime.getMonthValue()));\n properties.put(\"day\", NUMBER_FORMAT.format(zonedDateTime.getDayOfMonth()));\n\n var categorySlug = postService.listCategories(post.getSpec().getCategories())\n .next()\n .blockOptional(BLOCKING_TIMEOUT)\n .map(category -> category.getSpec().getSlug())\n .orElse(DEFAULT_CATEGORY);\n properties.put(\"categorySlug\", categorySlug);\n\n String simplifiedPattern = PathUtils.simplifyPathPattern(pattern);\n String permalink =\n PROPERTY_PLACEHOLDER_HELPER.replacePlaceholders(simplifiedPattern, properties);\n return externalUrlSupplier.get()\n .resolve(permalink)\n .normalize()\n .toString();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/permalinks/TagPermalinkPolicy.java", "content": "package run.halo.app.content.permalinks;\n\nimport java.nio.charset.StandardCharsets;\nimport java.time.Duration;\nimport java.util.Map;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.util.UriUtils;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.theme.utils.PatternUtils;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class TagPermalinkPolicy implements PermalinkPolicy {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private static final String DEFAULT_PERMALINK_PREFIX =\n SystemSetting.ThemeRouteRules.empty().getTags();\n private final ExternalUrlSupplier externalUrlSupplier;\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public String permalink(Tag tag) {\n Map annotations = MetadataUtil.nullSafeAnnotations(tag);\n String permalinkPrefix =\n annotations.getOrDefault(Constant.PERMALINK_PATTERN_ANNO, DEFAULT_PERMALINK_PREFIX);\n\n String slug = UriUtils.encode(tag.getSpec().getSlug(), StandardCharsets.UTF_8);\n String path = PathUtils.combinePath(permalinkPrefix, slug);\n return externalUrlSupplier.get()\n .resolve(path)\n .normalize().toString();\n }\n\n public String pattern() {\n return environmentFetcher.fetchRouteRules()\n .map(SystemSetting.ThemeRouteRules::getTags)\n .defaultIfEmpty(DEFAULT_PERMALINK_PREFIX)\n .map(PatternUtils::normalizePattern)\n .block(BLOCKING_TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/stats/PostStatsUpdater.java", "content": "package run.halo.app.content.stats;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.Stats;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.PostStatsChangedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.infra.InitializationPhase;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@Component\npublic class PostStatsUpdater implements Reconciler,\n SmartLifecycle {\n\n private volatile boolean running = false;\n\n private final ExtensionClient client;\n private final RequestQueue queue;\n private final Controller controller;\n\n public PostStatsUpdater(ExtensionClient client) {\n this.client = client;\n queue = new DefaultQueue<>(Instant::now);\n controller = this.setupWith(null);\n }\n\n @Override\n public Result reconcile(StatsRequest request) {\n client.fetch(Post.class, request.postName()).ifPresent(post -> {\n var annotations = MetadataUtil.nullSafeAnnotations(post);\n annotations.put(Post.STATS_ANNO, JsonUtils.objectToJson(request.stats()));\n client.update(post);\n });\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n this.getClass().getName(),\n this,\n queue,\n null,\n Duration.ofMillis(100),\n Duration.ofMinutes(10));\n }\n\n @Override\n public void start() {\n this.controller.start();\n this.running = true;\n }\n\n @Override\n public void stop() {\n this.running = false;\n this.controller.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return this.running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.CONTROLLERS.getPhase();\n }\n\n @EventListener(PostStatsChangedEvent.class)\n public void onReplyEvent(PostStatsChangedEvent event) {\n var counter = event.getCounter();\n var stats = Stats.builder()\n .visit(counter.getVisit())\n .upvote(counter.getUpvote())\n .totalComment(counter.getTotalComment())\n .approvedComment(counter.getApprovedComment())\n .build();\n var request = new StatsRequest(event.getPostName(), stats);\n queue.addImmediately(request);\n }\n\n public record StatsRequest(String postName, Stats stats) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/stats/ReplyEventReconciler.java", "content": "package run.halo.app.content.stats;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.greaterThan;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Optional;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.event.post.CommentUnreadReplyCountChangedEvent;\nimport run.halo.app.event.post.ReplyEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.InitializationPhase;\n\n/**\n * Update the comment status after receiving the reply event.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class ReplyEventReconciler\n implements Reconciler, SmartLifecycle {\n private volatile boolean running = false;\n\n private final ExtensionClient client;\n private final RequestQueue replyEventQueue;\n private final Controller replyEventController;\n\n public ReplyEventReconciler(ExtensionClient client) {\n this.client = client;\n replyEventQueue = new DefaultQueue<>(Instant::now);\n replyEventController = this.setupWith(null);\n }\n\n @Override\n public Result reconcile(CommentName request) {\n String commentName = request.name();\n\n client.fetch(Comment.class, commentName)\n // if the comment has been deleted, then do nothing.\n .filter(comment -> comment.getMetadata().getDeletionTimestamp() == null)\n .ifPresent(comment -> {\n // order by reply creation time desc to get first as last reply time\n var baseQuery = and(\n equal(\"spec.commentName\", commentName),\n isNull(\"metadata.deletionTimestamp\")\n );\n var pageRequest = PageRequestImpl.ofSize(1).withSort(\n Sort.by(\"spec.creationTime\", \"metadata.name\").descending()\n );\n final Comment.CommentStatus status = comment.getStatusOrDefault();\n\n var replyPageResult =\n client.listBy(Reply.class, listOptionsWithFieldQuery(baseQuery), pageRequest);\n // total reply count\n status.setReplyCount((int) replyPageResult.getTotal());\n\n // calculate last reply time from total replies(top 1)\n Instant lastReplyTime = replyPageResult.get()\n .map(reply -> reply.getSpec().getCreationTime())\n .findFirst()\n .orElse(null);\n status.setLastReplyTime(lastReplyTime);\n\n // calculate visible reply count(only approved and not hidden)\n var visibleReplyPageResult =\n client.listBy(Reply.class, listOptionsWithFieldQuery(and(\n baseQuery,\n equal(\"spec.approved\", BooleanUtils.TRUE),\n equal(\"spec.hidden\", BooleanUtils.FALSE)\n )), pageRequest);\n status.setVisibleReplyCount((int) visibleReplyPageResult.getTotal());\n\n // calculate unread reply count(after last read time)\n var unReadQuery = Optional.ofNullable(comment.getSpec().getLastReadTime())\n .map(lastReadTime -> and(\n baseQuery,\n greaterThan(\"spec.creationTime\", lastReadTime.toString())\n ))\n .orElse(baseQuery);\n var unReadPageResult =\n client.listBy(Reply.class, listOptionsWithFieldQuery(unReadQuery), pageRequest);\n status.setUnreadReplyCount((int) unReadPageResult.getTotal());\n\n status.setHasNewReply(defaultIfNull(status.getUnreadReplyCount(), 0) > 0);\n\n client.update(comment);\n });\n return new Result(false, null);\n }\n\n public record CommentName(String name) {\n public static CommentName of(String name) {\n return new CommentName(name);\n }\n }\n\n static ListOptions listOptionsWithFieldQuery(Condition query) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(query));\n return listOptions;\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n this.getClass().getName(),\n this,\n replyEventQueue,\n null,\n Duration.ofMillis(300),\n Duration.ofMinutes(5));\n }\n\n @Override\n public void start() {\n this.replyEventController.start();\n this.running = true;\n }\n\n @Override\n public void stop() {\n this.running = false;\n this.replyEventController.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return this.running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.CONTROLLERS.getPhase();\n }\n\n @EventListener(ReplyEvent.class)\n public void onReplyEvent(ReplyEvent replyEvent) {\n var commentName = replyEvent.getReply().getSpec().getCommentName();\n replyEventQueue.addImmediately(CommentName.of(commentName));\n }\n\n @EventListener(CommentUnreadReplyCountChangedEvent.class)\n public void onUnreadReplyCountChangedEvent(CommentUnreadReplyCountChangedEvent event) {\n replyEventQueue.addImmediately(CommentName.of(event.getCommentName()));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/stats/TagPostCountUpdater.java", "content": "package run.halo.app.content.stats;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport com.google.common.collect.Sets;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.AbstractEventReconciler;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.extension.content.Tag.TagStatus;\nimport run.halo.app.event.post.PostDeletedEvent;\nimport run.halo.app.event.post.PostEvent;\nimport run.halo.app.event.post.PostUpdatedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Update {@link TagStatus#postCount} when post related to tag is updated.\n *\n * @author guqing\n * @since 2.13.0\n */\n@Component\npublic class TagPostCountUpdater\n extends AbstractEventReconciler {\n private final ExtensionClient client;\n\n public TagPostCountUpdater(ExtensionClient client) {\n super(TagPostCountUpdater.class.getName());\n this.client = client;\n }\n\n @Override\n public Result reconcile(PostRelatedTags postRelatedTags) {\n for (var tag : postRelatedTags.tags()) {\n updateTagRelatedPostCount(tag);\n }\n\n // Update last associated tags when handled\n client.fetch(Post.class, postRelatedTags.postName()).ifPresent(post -> {\n var tags = defaultIfNull(post.getSpec().getTags(), List.of());\n var annotations = MetadataUtil.nullSafeAnnotations(post);\n var tagAnno = JsonUtils.objectToJson(tags);\n var oldTagAnno = annotations.get(Post.LAST_ASSOCIATED_TAGS_ANNO);\n\n if (!tagAnno.equals(oldTagAnno)) {\n annotations.put(Post.LAST_ASSOCIATED_TAGS_ANNO, tagAnno);\n client.update(post);\n }\n });\n return Result.doNotRetry();\n }\n\n /**\n * Listen to post event to calculate post related to tag for updating.\n */\n @EventListener(PostEvent.class)\n public void onPostUpdated(PostEvent postEvent) {\n var postName = postEvent.getName();\n if (postEvent instanceof PostUpdatedEvent) {\n var tagsToUpdate = calcTagsToUpdate(postEvent.getName());\n queue.addImmediately(new PostRelatedTags(postName, tagsToUpdate));\n return;\n }\n\n if (postEvent instanceof PostDeletedEvent deletedEvent) {\n var tags = defaultIfNull(deletedEvent.getPost().getSpec().getTags(),\n List.of());\n queue.addImmediately(new PostRelatedTags(postName, Sets.newHashSet(tags)));\n }\n }\n\n private Set calcTagsToUpdate(String postName) {\n var post = client.fetch(Post.class, postName).orElseThrow();\n var annotations = MetadataUtil.nullSafeAnnotations(post);\n var oldTags = Optional.ofNullable(annotations.get(Post.LAST_ASSOCIATED_TAGS_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(tagsJson -> JsonUtils.jsonToObject(tagsJson, String[].class))\n .orElse(new String[0]);\n\n var tagsToUpdate = Sets.newHashSet(oldTags);\n var newTags = post.getSpec().getTags();\n if (newTags != null) {\n tagsToUpdate.addAll(newTags);\n }\n return tagsToUpdate;\n }\n\n public record PostRelatedTags(String postName, Set tags) {\n }\n\n private void updateTagRelatedPostCount(String tagName) {\n client.fetch(Tag.class, tagName).ifPresent(tag -> {\n var commonFieldQuery = and(\n equal(\"spec.tags\", tag.getMetadata().getName()),\n isNull(\"metadata.deletionTimestamp\")\n );\n // Update post count\n var allPostOptions = new ListOptions();\n allPostOptions.setFieldSelector(FieldSelector.of(commonFieldQuery));\n var result = client.listBy(Post.class, allPostOptions, PageRequestImpl.ofSize(1));\n tag.getStatusOrDefault().setPostCount((int) result.getTotal());\n\n // Update visible post count\n var publicPostOptions = new ListOptions();\n publicPostOptions.setLabelSelector(LabelSelector.builder()\n .eq(Post.PUBLISHED_LABEL, \"true\")\n .build());\n publicPostOptions.setFieldSelector(FieldSelector.of(\n and(\n commonFieldQuery,\n equal(\"spec.deleted\", \"false\"),\n equal(\"spec.visible\", Post.VisibleEnum.PUBLIC.name())\n )\n ));\n var publicPosts =\n client.listBy(Post.class, publicPostOptions, PageRequestImpl.ofSize(1));\n tag.getStatusOrDefault().setVisiblePostCount((int) publicPosts.getTotal());\n\n client.update(tag);\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/stats/VisitedEventReconciler.java", "content": "package run.halo.app.content.stats;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Iterator;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.concurrent.ConcurrentHashMap;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.ObjectUtils;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.scheduling.annotation.Scheduled;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.event.post.VisitedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.infra.InitializationPhase;\n\n/**\n * Update counters after receiving visit event.\n * It will cache the count in memory for one minute and then batch update to the database.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class VisitedEventReconciler\n implements Reconciler, SmartLifecycle {\n private volatile boolean running = false;\n\n private final ExtensionClient client;\n private final RequestQueue visitedEventQueue;\n private final Map pooledVisitsMap = new ConcurrentHashMap<>();\n private final Controller visitedEventController;\n\n public VisitedEventReconciler(ExtensionClient client) {\n this.client = client;\n visitedEventQueue = new DefaultQueue<>(Instant::now);\n visitedEventController = this.setupWith(null);\n }\n\n @Override\n public Result reconcile(VisitCountBucket visitCountBucket) {\n createOrUpdateVisits(visitCountBucket.name(), visitCountBucket.visits());\n return new Result(false, null);\n }\n\n private void createOrUpdateVisits(String name, Integer visits) {\n client.fetch(Counter.class, name)\n .ifPresentOrElse(counter -> {\n Integer existingVisit = ObjectUtils.defaultIfNull(counter.getVisit(), 0);\n counter.setVisit(existingVisit + visits);\n client.update(counter);\n }, () -> {\n Counter counter = Counter.emptyCounter(name);\n counter.setVisit(visits);\n client.create(counter);\n });\n }\n\n /**\n * Put the merged data into the queue every minute for updating to the database.\n */\n @Scheduled(cron = \"0 0/1 * * * ?\")\n public void queuedVisitBucketTask() {\n Iterator> iterator = pooledVisitsMap.entrySet().iterator();\n while (iterator.hasNext()) {\n Map.Entry item = iterator.next();\n visitedEventQueue.addImmediately(new VisitCountBucket(item.getKey(), item.getValue()));\n iterator.remove();\n }\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n this.getClass().getName(),\n this,\n visitedEventQueue,\n null,\n Duration.ofMillis(300),\n Duration.ofMinutes(5));\n }\n\n @Override\n public void start() {\n this.visitedEventController.start();\n this.running = true;\n }\n\n @Override\n public void stop() {\n log.debug(\"Persist visits to database before destroy...\");\n try {\n Iterator> iterator = pooledVisitsMap.entrySet().iterator();\n while (iterator.hasNext()) {\n Map.Entry item = iterator.next();\n createOrUpdateVisits(item.getKey(), item.getValue());\n iterator.remove();\n }\n } catch (Exception e) {\n log.error(\"Failed to persist visits to database.\", e);\n }\n this.running = false;\n this.visitedEventController.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return this.running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.CONTROLLERS.getPhase();\n }\n\n public record VisitCountBucket(String name, int visits) {\n }\n\n @Component\n @RequiredArgsConstructor\n public class VisitedEventListener {\n private final SchemeManager schemeManager;\n\n @Async\n @EventListener(VisitedEvent.class)\n public void onVisited(VisitedEvent visitedEvent) {\n mergeVisits(visitedEvent);\n }\n\n private void mergeVisits(VisitedEvent event) {\n var gpn = new GroupPluralName(event.getGroup(), event.getPlural(), event.getName());\n if (!checkVisitSubject(gpn)) {\n log.debug(\"Skip visit event for: {}\", gpn);\n return;\n }\n String counterName =\n MeterUtils.nameOf(event.getGroup(), event.getPlural(), event.getName());\n pooledVisitsMap.compute(counterName, (name, visits) -> {\n if (visits == null) {\n return 1;\n } else {\n return visits + 1;\n }\n });\n }\n\n private boolean checkVisitSubject(GroupPluralName groupPluralName) {\n Optional schemeOptional = schemeManager.schemes().stream()\n .filter(scheme -> {\n GroupVersionKind gvk = scheme.groupVersionKind();\n return scheme.plural().equals(groupPluralName.plural())\n && gvk.group().equals(groupPluralName.group());\n })\n .findFirst();\n return schemeOptional.map(\n scheme -> client.fetch(scheme.groupVersionKind(), groupPluralName.name())\n .isPresent()\n )\n .orElse(false);\n }\n\n record GroupPluralName(String group, String plural, String name) {\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/content/stats/VotedEventReconciler.java", "content": "package run.halo.app.content.stats;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Optional;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.ObjectUtils;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.event.post.DownvotedEvent;\nimport run.halo.app.event.post.UpvotedEvent;\nimport run.halo.app.event.post.VotedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.infra.InitializationPhase;\n\n/**\n * Update counters after receiving upvote or downvote event.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class VotedEventReconciler implements Reconciler, SmartLifecycle {\n private volatile boolean running = false;\n\n private final ExtensionClient client;\n private final RequestQueue votedEventQueue;\n private final Controller votedEventController;\n\n public VotedEventReconciler(ExtensionClient client) {\n this.client = client;\n votedEventQueue = new DefaultQueue<>(Instant::now);\n votedEventController = this.setupWith(null);\n }\n\n @Override\n public Result reconcile(VotedEvent votedEvent) {\n String counterName =\n MeterUtils.nameOf(votedEvent.getGroup(), votedEvent.getPlural(), votedEvent.getName());\n client.fetch(Counter.class, counterName)\n .ifPresentOrElse(counter -> {\n if (votedEvent instanceof UpvotedEvent) {\n Integer existingVote = ObjectUtils.defaultIfNull(counter.getUpvote(), 0);\n counter.setUpvote(existingVote + 1);\n } else if (votedEvent instanceof DownvotedEvent) {\n Integer existingVote = ObjectUtils.defaultIfNull(counter.getDownvote(), 0);\n counter.setDownvote(existingVote + 1);\n }\n client.update(counter);\n }, () -> {\n Counter counter = Counter.emptyCounter(counterName);\n if (votedEvent instanceof UpvotedEvent) {\n counter.setUpvote(1);\n } else if (votedEvent instanceof DownvotedEvent) {\n counter.setDownvote(1);\n }\n client.create(counter);\n });\n return new Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n this.getClass().getName(),\n this,\n votedEventQueue,\n null,\n Duration.ofMillis(300),\n Duration.ofMinutes(5));\n }\n\n @Override\n public void start() {\n this.votedEventController.start();\n this.running = true;\n }\n\n @Override\n public void stop() {\n this.running = false;\n this.votedEventController.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return this.running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.CONTROLLERS.getPhase();\n }\n\n @Component\n @RequiredArgsConstructor\n public class VotedEventListener {\n private final SchemeManager schemeManager;\n\n /**\n * Add up/down vote event to queue.\n */\n @Async\n @EventListener(VotedEvent.class)\n public void onVoted(VotedEvent event) {\n var gpn = new GroupPluralName(event.getGroup(), event.getPlural(), event.getName());\n if (!checkSubject(gpn)) {\n log.debug(\"Skip voted event for: {}\", gpn);\n return;\n }\n votedEventQueue.addImmediately(event);\n }\n\n private boolean checkSubject(\n GroupPluralName groupPluralName) {\n Optional schemeOptional = schemeManager.schemes().stream()\n .filter(scheme -> {\n GroupVersionKind gvk = scheme.groupVersionKind();\n return scheme.plural().equals(groupPluralName.plural())\n && gvk.group().equals(groupPluralName.group());\n })\n .findFirst();\n return schemeOptional.map(\n scheme -> client.fetch(scheme.groupVersionKind(), groupPluralName.name())\n .isPresent()\n )\n .orElse(false);\n }\n\n record GroupPluralName(String group, String plural, String name) {\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/AttachmentChangedEvent.java", "content": "package run.halo.app.core.attachment;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.attachment.Attachment;\n\n/**\n * Event triggered when an attachment is created, updated, or deleted.\n *\n * @author johnniang\n */\npublic class AttachmentChangedEvent extends ApplicationEvent {\n\n @Getter\n private final Attachment attachment;\n\n public AttachmentChangedEvent(Object source, Attachment attachment) {\n super(source);\n this.attachment = attachment;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/AttachmentLister.java", "content": "package run.halo.app.core.attachment;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.extension.ListResult;\n\npublic interface AttachmentLister {\n\n Mono> listBy(SearchRequest searchRequest);\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/AttachmentRootGetter.java", "content": "package run.halo.app.core.attachment;\n\nimport java.nio.file.Path;\nimport java.util.function.Supplier;\n\n/**\n * Gets the root path(work dir) of the local attachment.\n */\npublic interface AttachmentRootGetter extends Supplier {\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/PolicyConfigChangeDetector.java", "content": "package run.halo.app.core.attachment;\n\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.List;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionMatcher;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\n\n/**\n *

Detects changes to {@link ConfigMap} that are referenced by {@link Policy} and updates the\n * {@link Attachment} with the {@link Policy} reference to reflect the change.

\n *

Without this, the link to the attachment corresponding to the storage policy configuration\n * change may not be correctly updated and only the service can be restarted.

\n *\n * @author guqing\n * @since 2.20.0\n */\n@Component\n@RequiredArgsConstructor\npublic class PolicyConfigChangeDetector implements Reconciler {\n static final String POLICY_UPDATED_AT = \"storage.halo.run/policy-updated-at\";\n private final GroupVersionKind attachmentGvk = GroupVersionKind.fromExtension(Attachment.class);\n private final ExtensionClient client;\n private final AttachmentUpdateTrigger attachmentUpdateTrigger;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(ConfigMap.class, request.name())\n .ifPresent(configMap -> {\n var labels = configMap.getMetadata().getLabels();\n if (labels == null) {\n return;\n }\n var policyName = labels.get(Policy.POLICY_OWNER_LABEL);\n if (StringUtils.hasText(policyName)) {\n var options = ListOptions.builder()\n .andQuery(equal(\"spec.policyName\", policyName))\n .build();\n var attachmentNames =\n client.listAllNames(Attachment.class, options, Sort.unsorted());\n attachmentUpdateTrigger.addAll(attachmentNames);\n }\n });\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n ExtensionMatcher matcher = extension -> {\n var configMap = (ConfigMap) extension;\n var labels = configMap.getMetadata().getLabels();\n return labels != null && labels.containsKey(Policy.POLICY_OWNER_LABEL);\n };\n return builder\n .extension(new ConfigMap())\n .syncAllOnStart(false)\n .onAddMatcher(matcher)\n .onUpdateMatcher(matcher)\n .onDeleteMatcher(matcher)\n .build();\n }\n\n @Component\n static class AttachmentUpdateTrigger implements Reconciler, SmartLifecycle {\n private final RequestQueue queue;\n\n private final Controller controller;\n\n private volatile boolean running = false;\n\n private final ExtensionClient client;\n\n public AttachmentUpdateTrigger(ExtensionClient client) {\n this.client = client;\n this.queue = new DefaultQueue<>(Instant::now);\n this.controller = this.setupWith(null);\n }\n\n @Override\n public Result reconcile(String name) {\n client.fetch(Attachment.class, name).ifPresent(attachment -> {\n var annotations = MetadataUtil.nullSafeAnnotations(attachment);\n annotations.put(POLICY_UPDATED_AT, Instant.now().toString());\n client.update(attachment);\n });\n return Result.doNotRetry();\n }\n\n void addAll(List names) {\n for (String name : names) {\n queue.addImmediately(name);\n }\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n \"PolicyChangeAttachmentUpdater\",\n this,\n queue,\n null,\n Duration.ofMillis(100),\n Duration.ofMinutes(10)\n );\n }\n\n @Override\n public void start() {\n controller.start();\n running = true;\n }\n\n @Override\n public void stop() {\n running = false;\n controller.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/SearchRequest.java", "content": "package run.halo.app.core.attachment;\n\nimport static org.springdoc.core.fn.builders.arrayschema.Builder.arraySchemaBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springframework.boot.convert.ApplicationConversionService.getSharedInstance;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.in;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.extension.index.query.Queries.not;\nimport static run.halo.app.extension.index.query.Queries.or;\nimport static run.halo.app.extension.index.query.Queries.startsWith;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.List;\nimport java.util.Optional;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.extension.router.QueryParamBuildUtil;\nimport run.halo.app.extension.router.SortableRequest;\n\npublic class SearchRequest extends SortableRequest {\n\n public SearchRequest(ServerRequest request) {\n super(request.exchange());\n }\n\n public Optional getKeyword() {\n return Optional.ofNullable(queryParams.getFirst(\"keyword\"))\n .filter(StringUtils::hasText);\n }\n\n public Optional getUngrouped() {\n return Optional.ofNullable(queryParams.getFirst(\"ungrouped\"))\n .map(ungroupedStr -> getSharedInstance().convert(ungroupedStr, Boolean.class));\n }\n\n public Optional> getAccepts() {\n return Optional.ofNullable(queryParams.get(\"accepts\"))\n .filter(accepts -> !accepts.isEmpty()\n && !accepts.contains(\"*\")\n && !accepts.contains(\"*/*\")\n );\n }\n\n public ListOptions toListOptions(List hiddenGroups) {\n var builder = ListOptions.builder(super.toListOptions());\n\n getKeyword().ifPresent(keyword -> {\n builder.andQuery(contains(\"spec.displayName\", keyword));\n });\n\n getUngrouped()\n .filter(ungrouped -> ungrouped)\n .ifPresent(ungrouped -> builder.andQuery(isNull(\"spec.groupName\")));\n\n if (!CollectionUtils.isEmpty(hiddenGroups)) {\n builder.andQuery(or(isNull(\"spec.groupName\"), not(in(\"spec.groupName\", hiddenGroups))));\n }\n\n getAccepts().flatMap(accepts -> accepts.stream()\n .filter(StringUtils::hasText)\n .map(accept -> accept.replace(\"/*\", \"/\").toLowerCase())\n .distinct()\n .map(accept -> startsWith(\"spec.mediaType\", accept))\n .reduce(Queries::or)\n )\n .ifPresent(builder::andQuery);\n\n return builder.build();\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(QueryParamBuildUtil.sortParameter())\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"ungrouped\")\n .required(false)\n .description(\"\"\"\n Filter attachments without group. This parameter will ignore group \\\n parameter.\\\n \"\"\")\n .implementation(Boolean.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .required(false)\n .description(\"Keyword for searching.\")\n .implementation(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"accepts\")\n .required(false)\n .description(\"Acceptable media types.\")\n .array(\n arraySchemaBuilder()\n .uniqueItems(true)\n .schema(schemaBuilder()\n .implementation(String.class)\n .example(\"image/*\"))\n )\n .implementationArray(String.class)\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/endpoint/AttachmentEndpoint.java", "content": "package run.halo.app.core.attachment.endpoint;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static run.halo.app.extension.ListResult.generateGenericClass;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.net.URL;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.http.codec.multipart.FormFieldPart;\nimport org.springframework.http.codec.multipart.Part;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.BodyExtractors;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.AttachmentLister;\nimport run.halo.app.core.attachment.SearchRequest;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.extension.service.AttachmentService;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class AttachmentEndpoint implements CustomEndpoint {\n\n private final AttachmentService attachmentService;\n\n private final AttachmentLister attachmentLister;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"AttachmentV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .POST(\"/attachments/upload\", contentType(MediaType.MULTIPART_FORM_DATA),\n request -> request.body(BodyExtractors.toMultipartData())\n .map(UploadRequest::new)\n .flatMap(uploadReq -> {\n var policyName = uploadReq.getPolicyName();\n var groupName = uploadReq.getGroupName();\n var filePart = uploadReq.getFile();\n return attachmentService.upload(policyName,\n groupName,\n filePart.filename(),\n filePart.content(),\n filePart.headers().getContentType());\n })\n .flatMap(attachment -> ServerResponse.ok().bodyValue(attachment)),\n builder -> builder\n .operationId(\"UploadAttachment\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(IUploadRequest.class))\n ))\n .response(responseBuilder().implementation(Attachment.class))\n .build())\n .POST(\"/attachments/-/upload-from-url\", contentType(MediaType.APPLICATION_JSON),\n request -> request.bodyToMono(UploadFromUrlRequest.class)\n .flatMap(uploadFromUrlRequest -> {\n var url = uploadFromUrlRequest.url();\n var policyName = uploadFromUrlRequest.policyName();\n var groupName = uploadFromUrlRequest.groupName();\n var fileName = uploadFromUrlRequest.filename();\n return attachmentService.uploadFromUrl(url, policyName,\n groupName, fileName);\n })\n .flatMap(attachment -> ServerResponse.ok().bodyValue(attachment)),\n builder -> builder\n .operationId(\"ExternalTransferAttachment\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder().implementation(UploadFromUrlRequest.class))\n ))\n .response(responseBuilder().implementation(Attachment.class))\n .build()\n )\n .GET(\"/attachments\", this::search,\n builder -> {\n builder\n .operationId(\"SearchAttachments\")\n .tag(tag)\n .response(\n responseBuilder().implementation(generateGenericClass(Attachment.class))\n );\n SearchRequest.buildParameters(builder);\n }\n )\n .build();\n }\n\n Mono search(ServerRequest request) {\n var searchRequest = new SearchRequest(request);\n return attachmentLister.listBy(searchRequest)\n .flatMap(listResult -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(listResult)\n );\n }\n\n public record UploadFromUrlRequest(@Schema(requiredMode = REQUIRED) URL url,\n @Schema(requiredMode = REQUIRED, description = \"Storage \"\n + \"policy name\") String policyName,\n @Schema(description = \"The name of the group to which the \"\n + \"attachment belongs\") String groupName,\n @Schema(description = \"Custom file name\") String filename) {\n public UploadFromUrlRequest {\n if (Objects.isNull(url)) {\n throw new ServerWebInputException(\"Required url is missing.\");\n }\n\n if (!StringUtils.hasText(policyName)) {\n throw new ServerWebInputException(\"Policy name must not be blank\");\n }\n }\n }\n\n @Schema(types = \"object\")\n public interface IUploadRequest {\n\n @Schema(requiredMode = REQUIRED, description = \"Attachment file\")\n FilePart getFile();\n\n @Schema(requiredMode = REQUIRED, description = \"Storage policy name\")\n String getPolicyName();\n\n @Schema(description = \"The name of the group to which the attachment belongs\")\n String getGroupName();\n\n }\n\n public record UploadRequest(MultiValueMap formData) implements IUploadRequest {\n\n public FilePart getFile() {\n if (formData.getFirst(\"file\") instanceof FilePart file) {\n return file;\n }\n throw new ServerWebInputException(\"Invalid part of file\");\n }\n\n public String getPolicyName() {\n if (formData.getFirst(\"policyName\") instanceof FormFieldPart form) {\n return form.value();\n }\n throw new ServerWebInputException(\"Invalid part of policyName\");\n }\n\n @Override\n public String getGroupName() {\n if (formData.getFirst(\"groupName\") instanceof FormFieldPart form) {\n return form.value();\n }\n return null;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/endpoint/LocalAttachmentUploadHandler.java", "content": "package run.halo.app.core.attachment.endpoint;\n\nimport static java.nio.file.StandardOpenOption.CREATE_NEW;\nimport static run.halo.app.infra.utils.FileNameUtils.randomFileName;\nimport static run.halo.app.infra.utils.FileUtils.checkDirectoryTraversal;\nimport static run.halo.app.infra.utils.FileUtils.deleteFileSilently;\n\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.net.URI;\nimport java.nio.charset.StandardCharsets;\nimport java.nio.file.FileAlreadyExistsException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.UUID;\nimport java.util.concurrent.atomic.AtomicReference;\nimport java.util.stream.Collectors;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.io.FilenameUtils;\nimport org.apache.commons.lang3.RandomStringUtils;\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.StringUtils;\nimport org.springframework.util.unit.DataSize;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.publisher.SynchronousSink;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.attachment.thumbnail.LocalThumbnailService;\nimport run.halo.app.core.attachment.thumbnail.ThumbnailUtils;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Attachment.AttachmentSpec;\nimport run.halo.app.core.extension.attachment.Constant;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.core.extension.attachment.endpoint.AttachmentHandler;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.FileCategoryMatcher;\nimport run.halo.app.infra.exception.AttachmentAlreadyExistsException;\nimport run.halo.app.infra.exception.FileSizeExceededException;\nimport run.halo.app.infra.exception.FileTypeNotAllowedException;\nimport run.halo.app.infra.utils.FileNameUtils;\nimport run.halo.app.infra.utils.FileTypeDetectUtils;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass LocalAttachmentUploadHandler implements AttachmentHandler {\n\n private static final String UPLOAD_PATH = \"upload\";\n\n private final AttachmentRootGetter attachmentDirGetter;\n\n private final LocalThumbnailService localThumbnailService;\n\n private Clock clock = Clock.systemUTC();\n\n /**\n * Set clock for test.\n *\n * @param clock new clock\n */\n void setClock(Clock clock) {\n this.clock = clock;\n }\n\n @Override\n public Mono upload(UploadContext uploadOption) {\n return Mono.just(uploadOption)\n .filter(option -> this.shouldHandle(option.policy()))\n .flatMap(option -> {\n var configMap = option.configMap();\n var setting = Optional.ofNullable(configMap)\n .map(ConfigMap::getData)\n .map(data -> data.get(\"default\"))\n .map(json -> JsonUtils.jsonToObject(json, PolicySetting.class))\n .orElseGet(PolicySetting::new);\n\n final var attachmentsRoot = attachmentDirGetter.get();\n final var uploadRoot = attachmentsRoot.resolve(UPLOAD_PATH);\n final var file = option.file();\n final Path attachmentPath;\n final String filename = getFilename(file.filename(), setting);\n if (StringUtils.hasText(setting.getLocation())) {\n attachmentPath =\n uploadRoot.resolve(setting.getLocation()).resolve(filename);\n } else {\n attachmentPath = uploadRoot.resolve(filename);\n }\n checkDirectoryTraversal(uploadRoot, attachmentPath);\n\n return validateFile(file, setting).then(Mono.fromRunnable(\n () -> {\n try {\n // init parent folders\n Files.createDirectories(attachmentPath.getParent());\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n }\n })\n .subscribeOn(Schedulers.boundedElastic())\n .then(writeContent(file.content(), attachmentPath, true))\n .map(path -> {\n log.info(\"Wrote attachment {} into {}\", filename, path);\n // TODO check the file extension\n var metadata = new Metadata();\n metadata.setName(UUID.randomUUID().toString());\n var relativePath = attachmentsRoot.relativize(path).toString();\n\n var pathSegments = new ArrayList();\n pathSegments.add(UPLOAD_PATH);\n for (Path p : uploadRoot.relativize(path)) {\n pathSegments.add(p.toString());\n }\n\n var uri = UriComponentsBuilder.newInstance()\n .pathSegment(pathSegments.toArray(String[]::new))\n .encode(StandardCharsets.UTF_8)\n .build()\n .toString();\n metadata.setAnnotations(Map.of(\n Constant.LOCAL_REL_PATH_ANNO_KEY, relativePath,\n Constant.URI_ANNO_KEY, uri));\n var spec = new AttachmentSpec();\n spec.setSize(path.toFile().length());\n spec.setMediaType(Optional.ofNullable(file.headers().getContentType())\n .map(MediaType::toString)\n .orElse(null));\n spec.setDisplayName(path.getFileName().toString());\n var attachment = new Attachment();\n attachment.setMetadata(metadata);\n attachment.setSpec(spec);\n\n attachment.setStatus(new Attachment.AttachmentStatus());\n doGetPermalink(attachment).ifPresent(permalink ->\n attachment.getStatus().setPermalink(permalink.toASCIIString())\n );\n var thumbnailLinks = doGetThumbnailLinks(attachment);\n var thumbnails = thumbnailLinks.keySet().stream()\n .collect(Collectors.toMap(\n ThumbnailSize::name,\n size -> thumbnailLinks.get(size).toASCIIString()\n ));\n if (!thumbnails.isEmpty()) {\n attachment.getStatus().setThumbnails(thumbnails);\n }\n return attachment;\n })\n .onErrorMap(FileAlreadyExistsException.class,\n e -> new AttachmentAlreadyExistsException(e.getFile()))\n );\n });\n }\n\n private Mono validateFile(FilePart file, PolicySetting setting) {\n var validations = new ArrayList>(2);\n var maxSize = setting.getMaxFileSize();\n if (maxSize != null && maxSize.toBytes() > 0) {\n validations.add(\n file.content()\n .map(DataBuffer::readableByteCount)\n .reduce(0L, Long::sum)\n .filter(size -> size <= setting.getMaxFileSize().toBytes())\n .switchIfEmpty(Mono.error(new FileSizeExceededException(\n \"File size exceeds the maximum limit\",\n \"problemDetail.attachment.upload.fileSizeExceeded\",\n new Object[] {setting.getMaxFileSize().toKilobytes() + \"KB\"})\n ))\n );\n }\n if (!CollectionUtils.isEmpty(setting.getAllowedFileTypes())) {\n var typeValidator = file.content()\n .next()\n .handle((dataBuffer, sink) -> {\n var mimeType = detectMimeType(dataBuffer.asInputStream(), file.filename());\n if (!FileTypeDetectUtils.isValidExtensionForMime(mimeType, file.filename())) {\n handleFileTypeError(sink, \"fileTypeNotMatch\", mimeType);\n return;\n }\n var isAllow = setting.getAllowedFileTypes()\n .stream()\n .map(FileCategoryMatcher::of)\n .anyMatch(matcher -> matcher.match(mimeType));\n if (isAllow) {\n sink.next(dataBuffer);\n return;\n }\n handleFileTypeError(sink, \"fileTypeNotSupported\", mimeType);\n });\n validations.add(typeValidator);\n }\n return Mono.when(validations);\n }\n\n private static void handleFileTypeError(SynchronousSink sink, String detailCode,\n String mimeType) {\n sink.error(new FileTypeNotAllowedException(\"File type is not allowed\",\n \"problemDetail.attachment.upload.\" + detailCode,\n new Object[] {mimeType})\n );\n }\n\n @NonNull\n private String detectMimeType(InputStream inputStream, String name) {\n try {\n return FileTypeDetectUtils.detectMimeType(inputStream, name);\n } catch (IOException e) {\n log.warn(\"Failed to detect file type\", e);\n return \"Unknown\";\n }\n }\n\n @Override\n public Mono delete(DeleteContext deleteContext) {\n return Mono.just(deleteContext)\n .filter(context -> this.shouldHandle(context.policy()))\n .publishOn(Schedulers.boundedElastic())\n .doOnNext(context -> {\n var attachment = context.attachment();\n log.info(\"Trying to delete {} from local\", attachment.getMetadata().getName());\n var annotations = attachment.getMetadata().getAnnotations();\n if (annotations != null) {\n var localRelativePath = annotations.get(Constant.LOCAL_REL_PATH_ANNO_KEY);\n if (StringUtils.hasText(localRelativePath)) {\n var attachmentsRoot = attachmentDirGetter.get();\n var attachmentPath = attachmentsRoot.resolve(localRelativePath);\n deleteAttachmentFile(attachmentPath);\n deleteThumbnails(attachmentPath);\n }\n }\n })\n .map(DeleteContext::attachment);\n }\n\n @Override\n public Mono getPermalink(Attachment attachment, Policy policy, ConfigMap configMap) {\n if (!this.shouldHandle(policy)) {\n return Mono.empty();\n }\n return Mono.justOrEmpty(doGetPermalink(attachment));\n }\n\n @Override\n public Mono getSharedURL(Attachment attachment,\n Policy policy,\n ConfigMap configMap,\n Duration ttl) {\n return getPermalink(attachment, policy, configMap);\n }\n\n @Override\n public Mono> getThumbnailLinks(Attachment attachment, Policy policy,\n ConfigMap configMap) {\n if (!this.shouldHandle(policy)) {\n return Mono.empty();\n }\n\n return Mono.just(doGetThumbnailLinks(attachment));\n }\n\n protected Optional doGetPermalink(Attachment attachment) {\n var annotations = attachment.getMetadata().getAnnotations();\n if (annotations == null\n || !annotations.containsKey(Constant.URI_ANNO_KEY)) {\n return Optional.empty();\n }\n var uriStr = annotations.get(Constant.URI_ANNO_KEY);\n return Optional.of(HaloUtils.safeToUri(uriStr));\n }\n\n private Map doGetThumbnailLinks(Attachment attachment) {\n if (attachment.getStatus() == null\n || !StringUtils.hasText(attachment.getStatus().getPermalink())) {\n return Map.of();\n }\n // Check media type first, then check file extension from permalink\n var supported = Optional.ofNullable(attachment.getSpec().getMediaType())\n .map(MediaType::parseMediaType)\n .map(ThumbnailUtils::isSupportedImage)\n .filter(Boolean::booleanValue)\n .or(() -> Optional.ofNullable(attachment.getStatus().getPermalink())\n .map(permalink -> {\n var path = URI.create(permalink).getPath();\n return FilenameUtils.getExtension(path);\n })\n .map(ThumbnailUtils::isSupportedImage)\n .filter(Boolean::booleanValue)\n )\n .isPresent();\n if (!supported) {\n return Map.of();\n }\n var permalinkUri = URI.create(attachment.getStatus().getPermalink());\n return ThumbnailUtils.buildSrcsetMap(permalinkUri);\n }\n\n private void deleteAttachmentFile(Path attachmentPath) {\n var attachmentsRoot = attachmentDirGetter.get();\n checkDirectoryTraversal(attachmentsRoot, attachmentPath);\n try {\n Files.deleteIfExists(attachmentPath);\n log.info(\"Deleted attachment file {}\", attachmentPath);\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n }\n }\n\n private void deleteThumbnails(Path attachmentPath) {\n this.localThumbnailService.delete(attachmentPath);\n }\n\n private boolean shouldHandle(Policy policy) {\n if (policy == null\n || policy.getSpec() == null\n || !StringUtils.hasText(policy.getSpec().getTemplateName())) {\n return false;\n }\n return \"local\".equals(policy.getSpec().getTemplateName());\n }\n\n /**\n * Write content into file. We will detect duplicate filename and auto-rename it with 3 times\n * retry.\n *\n * @param content is file content\n * @param targetPath is target path\n * @return file path\n */\n private Mono writeContent(Flux content,\n Path targetPath,\n boolean renameIfExists) {\n return Mono.defer(() -> {\n final var pathRef = new AtomicReference<>(targetPath);\n return Mono.defer(\n // we have to use defer method to obtain a fresh path\n () -> DataBufferUtils.write(content, pathRef.get(), CREATE_NEW))\n .retryWhen(Retry.max(3)\n .filter(t -> {\n if (renameIfExists) {\n return t instanceof FileAlreadyExistsException;\n }\n return false;\n })\n .doAfterRetry(signal -> {\n // rename the path\n var oldPath = pathRef.get();\n var fileName = randomFileName(oldPath.toString(), 4);\n pathRef.set(oldPath.resolveSibling(fileName));\n }))\n // Delete file already wrote partially into attachment folder\n // in case of content is terminated with an error\n .onErrorResume(t -> deleteFileSilently(pathRef.get()).then(Mono.error(t)))\n .then(Mono.fromSupplier(pathRef::get));\n });\n }\n\n private String getFilename(String filename, PolicySetting setting) {\n if (!setting.isAlwaysRenameFilename()) {\n return filename;\n }\n var renameStrategy = setting.getRenameStrategy();\n if (renameStrategy == null) {\n return filename;\n }\n var renameMethod = renameStrategy.getMethod();\n if (renameMethod == null) {\n renameMethod = RenameMethod.RANDOM;\n }\n var excludeOriginalFilename = renameStrategy.isExcludeOriginalFilename();\n switch (renameMethod) {\n case TIMESTAMP -> {\n return FileNameUtils.renameFilename(\n filename,\n () -> {\n var now = clock.instant();\n return now.toEpochMilli() + \"\";\n },\n excludeOriginalFilename);\n }\n case UUID -> {\n return FileNameUtils.renameFilename(\n filename,\n () -> UUID.randomUUID().toString(),\n excludeOriginalFilename\n );\n }\n default -> {\n return FileNameUtils.renameFilename(\n filename,\n () -> {\n var length = renameStrategy.getRandomLength();\n if (length < 8) {\n length = 8;\n } else if (length > 64) {\n // The max filename length is 256, so we limit the random length to 64\n // for most cases.\n length = 64;\n }\n return RandomStringUtils.secure().nextAlphabetic(length);\n },\n excludeOriginalFilename);\n }\n }\n }\n\n\n @Data\n public static class PolicySetting {\n\n private String location;\n\n private DataSize maxFileSize;\n\n private Set allowedFileTypes;\n\n private boolean alwaysRenameFilename;\n\n private RenameStrategy renameStrategy;\n\n public void setMaxFileSize(String maxFileSize) {\n if (!StringUtils.hasText(maxFileSize)) {\n return;\n }\n this.maxFileSize = DataSize.parse(maxFileSize);\n }\n }\n\n public enum RenameMethod {\n RANDOM,\n UUID,\n TIMESTAMP\n }\n\n @Data\n public static class RenameStrategy {\n\n private RenameMethod method;\n\n private int randomLength = 32;\n\n private boolean excludeOriginalFilename;\n\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/endpoint/PolicyEndpoint.java", "content": "package run.halo.app.core.attachment.endpoint;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springframework.http.HttpStatus.NO_CONTENT;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.HashMap;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.transaction.reactive.TransactionalOperator;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport tools.jackson.databind.JsonNode;\nimport tools.jackson.databind.json.JsonMapper;\n\n@Component\n@RequiredArgsConstructor\nclass PolicyEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n\n private final JsonMapper mapper;\n\n private final ReactiveTransactionManager txManager;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"PolicyAlpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\n \"/policies/{name}/configs/{group}\",\n this::getPolicyConfigByGroup,\n builder -> builder.operationId(\"getPolicyConfigByGroup\")\n .description(\"Get policy config by group\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Name of the policy\")\n .required(true)\n .implementation(String.class)\n )\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"group\")\n .description(\"Name of the group\")\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder().implementation(Object.class))\n )\n .PUT(\n \"/policies/{name}/configs/{group}\",\n RequestPredicates.contentType(MediaType.APPLICATION_JSON),\n this::updatePolicyConfigByGroup,\n builder -> builder.operationId(\"updatePolicyConfigByGroup\")\n .description(\"Update policy config by group\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Name of the policy\")\n .required(true)\n .implementation(String.class)\n )\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"group\")\n .description(\"Name of the group\")\n .required(true)\n .implementation(String.class)\n )\n .requestBody(\n requestBodyBuilder().required(true).implementation(Object.class))\n .response(\n responseBuilder().responseCode(String.valueOf(NO_CONTENT.value()))\n )\n )\n .build();\n }\n\n private Mono updatePolicyConfigByGroup(ServerRequest serverRequest) {\n var policyName = serverRequest.pathVariable(\"name\");\n var configGroup = serverRequest.pathVariable(\"group\");\n return serverRequest.bodyToMono(JsonNode.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Request body is required.\")\n ))\n .flatMap(jsonNode -> {\n var tx = TransactionalOperator.create(txManager);\n return client.get(Policy.class, policyName)\n .flatMap(policy -> Mono.justOrEmpty(policy.getSpec())\n .mapNotNull(Policy.PolicySpec::getConfigMapName)\n .filter(StringUtils::hasText)\n .flatMap(cmName -> client.fetch(ConfigMap.class, cmName))\n .switchIfEmpty(Mono.fromSupplier(() -> {\n // create a new configmap\n var cm = new ConfigMap();\n cm.setMetadata(new Metadata());\n cm.getMetadata().setGenerateName(policyName + \"-config-\");\n return cm;\n }))\n .flatMap(cm -> Mono.fromCallable(() -> {\n if (cm.getData() == null) {\n cm.setData(new HashMap<>());\n }\n var oldJson = cm.getData().get(configGroup);\n if (StringUtils.hasText(oldJson)\n && Objects.equals(jsonNode, mapper.readTree(oldJson))) {\n // skip if no change\n return null;\n }\n var newJson = mapper.writeValueAsString(jsonNode);\n cm.getData().put(configGroup, newJson);\n return cm;\n }))\n .flatMap(cm -> {\n if (cm.getMetadata().getVersion() != null) {\n return client.update(cm);\n }\n return client.create(cm);\n })\n .flatMap(cm -> {\n var cmName = cm.getMetadata().getName();\n if (policy.getSpec() != null\n && Objects.equals(policy.getSpec().getConfigMapName(), cmName)) {\n return Mono.just(cm);\n }\n if (policy.getSpec() == null) {\n policy.setSpec(new Policy.PolicySpec());\n }\n policy.getSpec().setConfigMapName(cmName);\n return client.update(policy);\n })\n )\n .as(tx::transactional);\n })\n .then(ServerResponse.noContent().build());\n }\n\n private Mono getPolicyConfigByGroup(ServerRequest serverRequest) {\n var policyName = serverRequest.pathVariable(\"name\");\n var configGroup = serverRequest.pathVariable(\"group\");\n\n return client.get(Policy.class, policyName)\n .filter(p -> p.getSpec() != null)\n .map(p -> p.getSpec().getConfigMapName())\n .filter(StringUtils::hasText)\n .flatMap(cmName -> client.fetch(ConfigMap.class, cmName))\n .filter(cm -> cm.getData() != null && cm.getData().containsKey(configGroup))\n .map(cm -> cm.getData().get(configGroup))\n .flatMap(json -> Mono.fromCallable(() -> mapper.readTree(json)))\n .defaultIfEmpty(mapper.nullNode())\n .flatMap(config -> ServerResponse.ok().bodyValue(config));\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"console.api.storage.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/extension/LocalThumbnail.java", "content": "package run.halo.app.core.attachment.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.Getter;\nimport lombok.experimental.Accessors;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"storage.halo.run\", version = \"v1alpha1\", kind = \"LocalThumbnail\",\n plural = \"localthumbnails\", singular = \"localthumbnail\")\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic class LocalThumbnail extends AbstractExtension {\n public static final String UNIQUE_IMAGE_AND_SIZE_INDEX = \"uniqueImageAndSize\";\n public static final String REQUEST_TO_GENERATE_ANNO = \"storage.halo.run/request-to-generate\";\n\n @Schema(requiredMode = REQUIRED)\n private Spec spec;\n\n @Getter(onMethod_ = @NonNull)\n @Schema(requiredMode = NOT_REQUIRED)\n private Status status = new Status();\n\n public void setStatus(Status status) {\n this.status = (status == null ? new Status() : status);\n }\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"LocalThumbnailSpec\")\n public static class Spec {\n /**\n * A hash signature for the image uri.\n *\n * @see #getImageUri()\n */\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String imageSignature;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String imageUri;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String thumbnailUri;\n\n /**\n * A hash signature for the thumbnail uri.\n *\n * @see #getThumbnailUri()\n */\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String thumbSignature;\n\n @Schema(requiredMode = REQUIRED)\n private ThumbnailSize size;\n\n /**\n * Consider the compatibility of the system and migration, use unix-style relative paths\n * here.\n *\n * @see AttachmentRootGetter\n */\n @Schema(requiredMode = REQUIRED)\n private String filePath;\n }\n\n @Data\n @Schema(name = \"LocalThumbnailStatus\")\n public static class Status {\n private Phase phase;\n }\n\n public enum Phase {\n PENDING, SUCCEEDED, FAILED\n }\n\n public static String uniqueImageAndSize(LocalThumbnail localThumbnail) {\n return uniqueImageAndSize(localThumbnail.getSpec().getImageSignature(),\n localThumbnail.getSpec().getSize());\n }\n\n public static String uniqueImageAndSize(String imageSignature, ThumbnailSize size) {\n return imageSignature + \"-\" + size.name();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/extension/Thumbnail.java", "content": "package run.halo.app.core.attachment.extension;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.experimental.Accessors;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@Data\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"storage.halo.run\", version = \"v1alpha1\", kind = \"Thumbnail\",\n plural = \"thumbnails\", singular = \"thumbnail\")\n@Deprecated(forRemoval = true, since = \"2.22.0\")\npublic class Thumbnail extends AbstractExtension {\n\n public static final String ID_INDEX = \"thumbnail-id\";\n\n @Schema(requiredMode = REQUIRED)\n private Spec spec;\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"ThumbnailSpec\")\n public static class Spec {\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String imageSignature;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String imageUri;\n\n @Schema(requiredMode = REQUIRED)\n private ThumbnailSize size;\n\n @Schema(requiredMode = REQUIRED, minLength = 1)\n private String thumbnailUri;\n }\n\n public static String idIndexFunc(Thumbnail thumbnail) {\n return idIndexFunc(thumbnail.getSpec().getImageSignature(),\n thumbnail.getSpec().getSize().name());\n }\n\n public static String idIndexFunc(String imageHash, String size) {\n return imageHash + \"-\" + size;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/impl/AttachmentListerImpl.java", "content": "package run.halo.app.core.attachment.impl;\n\nimport java.util.List;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.AttachmentLister;\nimport run.halo.app.core.attachment.SearchRequest;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Group;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@Component\n@RequiredArgsConstructor\npublic class AttachmentListerImpl implements AttachmentLister {\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono> listBy(SearchRequest searchRequest) {\n var groupListOptions = ListOptions.builder()\n .labelSelector()\n .exists(Group.HIDDEN_LABEL)\n .end()\n .build();\n return client.listAll(Group.class, groupListOptions, Sort.unsorted())\n .map(group -> group.getMetadata().getName())\n .collectList()\n .defaultIfEmpty(List.of())\n .flatMap(hiddenGroups -> client.listBy(Attachment.class,\n searchRequest.toListOptions(hiddenGroups),\n searchRequest.toPageRequest()\n ));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/impl/AttachmentRootGetterImpl.java", "content": "package run.halo.app.core.attachment.impl;\n\nimport java.nio.file.Path;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@Component\n@RequiredArgsConstructor\npublic class AttachmentRootGetterImpl implements AttachmentRootGetter {\n private final HaloProperties haloProp;\n\n @Override\n public Path get() {\n return haloProp.getWorkDir().resolve(\"attachments\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/reconciler/AttachmentReconciler.java", "content": "package run.halo.app.core.attachment.reconciler;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\n\nimport java.net.URI;\nimport java.time.Duration;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.attachment.AttachmentChangedEvent;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Attachment.AttachmentStatus;\nimport run.halo.app.core.extension.attachment.Constant;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.controller.RequeueException;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass AttachmentReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n private final AttachmentService attachmentService;\n\n private final ApplicationEventPublisher eventPublisher;\n\n @Override\n public Result reconcile(Request request) {\n return client.fetch(Attachment.class, request.name()).map(attachment -> {\n if (ExtensionUtil.isDeleted(attachment)) {\n if (removeFinalizers(attachment.getMetadata(),\n Set.of(Constant.FINALIZER_NAME))) {\n cleanUpResources(attachment);\n client.update(attachment);\n this.eventPublisher.publishEvent(new AttachmentChangedEvent(this, attachment));\n }\n return null;\n }\n // add finalizer\n addFinalizers(attachment.getMetadata(), Set.of(Constant.FINALIZER_NAME));\n\n if (attachment.getStatus() == null) {\n attachment.setStatus(new AttachmentStatus());\n }\n var permalink = attachmentService.getPermalink(attachment)\n .map(URI::toASCIIString)\n .blockOptional(Duration.ofSeconds(10))\n .orElseThrow(() -> new RequeueException(new Result(true, null),\n \"Attachment handler is unavailable, requeue the request\"\n ));\n log.debug(\"Set attachment permalink: {} for {}\", permalink, request.name());\n attachment.getStatus().setPermalink(permalink);\n var thumbnails = attachmentService.getThumbnailLinks(attachment)\n .map(map -> map.keySet()\n .stream()\n .collect(Collectors.toMap(Enum::name, k -> map.get(k).toString()))\n )\n .blockOptional(Duration.ofSeconds(10))\n .orElse(null);\n Result result = null;\n if (thumbnails == null) {\n log.warn(\"\"\"\n Failed to get thumbnails for attachment: {}, \\\n consider upgrading storage plugins\"\"\", request.name()\n );\n result = new Result(true, Duration.ofSeconds(10));\n }\n attachment.getStatus().setThumbnails(thumbnails);\n log.debug(\"Set attachment thumbnails: {} for {}\", thumbnails, request.name());\n client.update(attachment);\n this.eventPublisher.publishEvent(new AttachmentChangedEvent(this, attachment));\n return result;\n }).orElse(null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Attachment())\n .build();\n }\n\n void cleanUpResources(Attachment attachment) {\n attachmentService.delete(attachment).block(Duration.ofSeconds(20));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/reconciler/LocalThumbnailsReconciler.java", "content": "package run.halo.app.core.attachment.reconciler;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.extension.LocalThumbnail;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\n@Deprecated(forRemoval = true, since = \"2.22.0\")\nclass LocalThumbnailsReconciler implements Reconciler {\n\n private static final String CLEAN_UP_FINALIZER = \"thumbnail-cleaner\";\n\n private final ExtensionClient client;\n\n private final AttachmentRootGetter attachmentRoot;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(LocalThumbnail.class, request.name())\n .ifPresent(thumbnail -> {\n if (ExtensionUtil.isDeleted(thumbnail)) {\n if (removeFinalizers(thumbnail.getMetadata(), Set.of(CLEAN_UP_FINALIZER))) {\n // clean up thumbnail file\n cleanUpThumbnailFile(thumbnail);\n client.update(thumbnail);\n }\n return;\n }\n // Cleanup all existing local thumbnails\n addFinalizers(thumbnail.getMetadata(), Set.of(CLEAN_UP_FINALIZER));\n log.info(\"Cleaning up local thumbnail: {}\", thumbnail.getMetadata().getName());\n client.delete(thumbnail);\n });\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new LocalThumbnail())\n .build();\n }\n\n private void cleanUpThumbnailFile(LocalThumbnail thumbnail) {\n var filePath = thumbnail.getSpec().getFilePath();\n if (StringUtils.hasText(filePath)) {\n var thumbnailFile = attachmentRoot.get().resolve(filePath);\n try {\n if (Files.deleteIfExists(thumbnailFile)) {\n log.info(\"Deleted thumbnail file: {} for {}\",\n thumbnailFile, thumbnail.getMetadata().getName());\n }\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/reconciler/PolicyReconciler.java", "content": "package run.halo.app.core.attachment.reconciler;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n@Component\n@RequiredArgsConstructor\npublic class PolicyReconciler implements Reconciler {\n private final ExtensionClient client;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Policy.class, request.name())\n .ifPresent(this::checkOwnerLabel);\n return Result.doNotRetry();\n }\n\n private void checkOwnerLabel(Policy policy) {\n var policyName = policy.getMetadata().getName();\n var configMapName = policy.getSpec().getConfigMapName();\n client.fetch(ConfigMap.class, configMapName)\n .ifPresent(configMap -> {\n var labels = MetadataUtil.nullSafeLabels(configMap);\n labels.put(Policy.POLICY_OWNER_LABEL, policyName);\n client.update(configMap);\n });\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Policy())\n // sync on start for compatible with previous data\n .syncAllOnStart(true)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/reconciler/ThumbnailReconciler.java", "content": "package run.halo.app.core.attachment.reconciler;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.attachment.extension.Thumbnail;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n@Slf4j\n@Component\n@Deprecated(forRemoval = true, since = \"2.22.0\")\nclass ThumbnailReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n ThumbnailReconciler(ExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Thumbnail.class, request.name())\n .ifPresent(thumbnail -> {\n if (ExtensionUtil.isDeleted(thumbnail)) {\n return;\n }\n log.info(\"Clean up thumbnail: {}\", thumbnail.getMetadata().getName());\n client.delete(thumbnail);\n });\n return null;\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Thumbnail())\n .build();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/DefaultLocalThumbnailService.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static java.nio.file.StandardCopyOption.REPLACE_EXISTING;\nimport static java.nio.file.StandardOpenOption.READ;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.Arrays;\nimport java.util.Optional;\nimport java.util.concurrent.CompletableFuture;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.TimeUnit;\nimport lombok.extern.slf4j.Slf4j;\nimport net.coobird.thumbnailator.ThumbnailParameter;\nimport net.coobird.thumbnailator.Thumbnails;\nimport net.coobird.thumbnailator.resizers.configurations.Rendering;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.core.io.PathResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.stereotype.Service;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.infra.properties.AttachmentProperties;\nimport run.halo.app.infra.properties.HaloProperties;\n\n/**\n * Default implementation of {@link LocalThumbnailService} that generates thumbnails using\n * Thumbnailator library and deletes them when no longer needed.\n *\n * @author johnniang\n * @since 2.22.0\n */\n@Slf4j\n@Service\nclass DefaultLocalThumbnailService implements LocalThumbnailService, DisposableBean {\n\n private static final String THUMBNAIL_ROOT = \"thumbnails\";\n\n private static final int DEFAULT_GENERATION_TIMEOUT_SECONDS = 60;\n\n private static final int DEFAULT_GENERATION_CONCURRENT_THREADS = 5;\n\n private ExecutorService executorService;\n\n private final AttachmentRootGetter attachmentRootGetter;\n\n /**\n * Map to track in-progress thumbnail generation tasks. The key is the filename, and the\n * value\n * is a CompletableFuture representing the generation task.\n */\n private final ConcurrentMap> inProgress;\n\n private final AttachmentProperties.ThumbnailProperties thumbnailProperties;\n\n public DefaultLocalThumbnailService(AttachmentRootGetter attachmentRootGetter,\n HaloProperties haloProperties) {\n this.attachmentRootGetter = attachmentRootGetter;\n this.thumbnailProperties = haloProperties.getAttachment().getThumbnail();\n var concurrentThreads = this.thumbnailProperties.getConcurrentThreads();\n if (concurrentThreads == null || concurrentThreads < 1) {\n concurrentThreads = DEFAULT_GENERATION_CONCURRENT_THREADS;\n }\n this.executorService =\n Executors.newFixedThreadPool(concurrentThreads, Thread.ofPlatform()\n .daemon()\n .name(\"thumbnail-generator-\", 0)\n .factory());\n this.inProgress = new ConcurrentHashMap<>();\n }\n\n void setExecutorService(ExecutorService executorService) {\n this.executorService = executorService;\n }\n\n @Override\n public void destroy() throws Exception {\n this.executorService.close();\n }\n\n @Override\n public Mono generate(Path source, ThumbnailSize size) {\n if (thumbnailProperties.isDisabled()) {\n return Mono.empty();\n }\n var optionalThumbnailPath = resolveThumbnailPath(source, size);\n if (optionalThumbnailPath.isEmpty()) {\n log.warn(\"Failed to resolve thumbnail path for source: {}, size: {}\", source, size);\n return Mono.empty();\n }\n var thumbnailPath = optionalThumbnailPath.get();\n var thumbnailResource = new PathResource(thumbnailPath);\n if (thumbnailResource.isReadable()) {\n log.trace(\"Thumbnail already exists: {}\", thumbnailPath);\n return Mono.just(thumbnailResource);\n }\n return Mono.fromFuture(() -> inProgress.computeIfAbsent(thumbnailPath, f ->\n CompletableFuture.supplyAsync(() -> generateThumbnail(\n source, thumbnailPath, size\n ),\n this.executorService\n )\n .orTimeout(\n DEFAULT_GENERATION_TIMEOUT_SECONDS,\n TimeUnit.SECONDS\n )\n )\n .whenComplete((p, t) -> inProgress.remove(thumbnailPath)),\n // We don't want to cancel the thumbnail generation task\n // when some requests are cancelled\n true\n )\n .map(PathResource::new);\n }\n\n @Override\n public void delete(Path source) {\n Arrays.stream(ThumbnailSize.values()).forEach(size -> {\n var thumbnailPath = resolveThumbnailPath(source, size);\n if (thumbnailPath.isEmpty()) {\n log.warn(\"Failed to resolve thumbnail path for source: {}, size: {}\", source, size);\n return;\n }\n try {\n var deleted = Files.deleteIfExists(thumbnailPath.get());\n if (deleted) {\n log.info(\"Deleted thumbnail: {} for {}\", thumbnailPath.get(), source);\n }\n } catch (IOException e) {\n // Ignore the error\n log.error(\"Failed to delete thumbnail: {}\", thumbnailPath.get(), e);\n }\n });\n }\n\n Optional resolveThumbnailPath(Path source, ThumbnailSize size) {\n var attachmentRoot = this.attachmentRootGetter.get();\n Path relativize;\n try {\n relativize = attachmentRoot.relativize(source);\n } catch (IllegalArgumentException e) {\n // The source path is not under the attachment root\n if (log.isDebugEnabled()) {\n log.warn(\"Failed to resolve thumbnail path for source: {}, size: {}\",\n source, size, e);\n }\n return Optional.empty();\n }\n var thumbnailPath = attachmentRoot.resolve(THUMBNAIL_ROOT)\n .resolve(\"w\" + size.getWidth())\n .resolve(relativize);\n return Optional.of(thumbnailPath);\n }\n\n private Path generateThumbnail(Path sourcePath, Path thumbnailPath, ThumbnailSize size) {\n if (!Files.exists(sourcePath)) {\n log.trace(\"Attachment path does not exist: {}\", sourcePath);\n return null;\n }\n\n // Double check if the thumbnail already exists\n if (Files.exists(thumbnailPath)) {\n return thumbnailPath;\n }\n if (log.isDebugEnabled()) {\n log.debug(\n \"Generating thumbnail for path: {}, target: {}, size: {}\",\n sourcePath, thumbnailPath, size);\n }\n boolean shouldCleanup = true;\n try (var inputStream = Files.newInputStream(sourcePath, READ)) {\n Files.createDirectories(thumbnailPath.getParent());\n // Pass InputStream or File here.\n // See https://github.com/coobird/thumbnailator/issues/159#issuecomment-694978197\n // for more.\n var builder = Thumbnails.of(inputStream)\n .width(size.getWidth())\n .imageType(ThumbnailParameter.DEFAULT_IMAGE_TYPE)\n .rendering(Rendering.SPEED)\n .useExifOrientation(true);\n if (thumbnailProperties.getQuality() != null) {\n builder.outputQuality(thumbnailProperties.getQuality());\n }\n builder.toFile(thumbnailPath.toFile());\n log.info(\"Generated thumbnail for path: {}, target: {}, size: {}\",\n sourcePath, thumbnailPath, size);\n // check size of thumbnails\n var attachmentFileSize = Files.size(sourcePath);\n var thumbnailFileSize = Files.size(thumbnailPath);\n if (attachmentFileSize < thumbnailFileSize) {\n Files.copy(sourcePath, thumbnailPath, REPLACE_EXISTING);\n log.info(\"\"\"\n Replaced thumbnail with original file since it's smaller, \\\n path: {}, size: {} < {}\\\n \"\"\",\n thumbnailPath, attachmentFileSize, thumbnailFileSize);\n }\n shouldCleanup = false;\n return thumbnailPath;\n } catch (IOException e) {\n log.warn(\"Failed to generate thumbnail for path: {}\",\n sourcePath, e);\n // return the original attachment path\n return null;\n } finally {\n if (shouldCleanup) {\n // delete the possibly created file\n try {\n Files.deleteIfExists(thumbnailPath);\n } catch (IOException ex) {\n // ignore this error\n log.warn(\"Failed to delete possibly created thumbnail file: {}\",\n thumbnailPath, ex);\n }\n }\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/DefaultThumbnailService.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport com.github.benmanes.caffeine.cache.Cache;\nimport com.github.benmanes.caffeine.cache.Caffeine;\nimport java.net.URI;\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Objects;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.filter.reactive.ServerWebExchangeContextFilter;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.AttachmentChangedEvent;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.infra.ExternalUrlSupplier;\n\n/**\n * Implementation of {@link ThumbnailService}.\n *\n *

\n * Caches thumbnail links in memory for better performance.\n *\n * @author johnniang\n * @since 2.22.0\n */\n@Slf4j\n@Component\nclass DefaultThumbnailService implements ThumbnailService {\n\n private static final Map EMPTY_THUMBNAILS = Map.of();\n\n private final Cache> thumbnailCache;\n\n private final ReactiveExtensionClient client;\n\n private final ExternalUrlSupplier externalUrlSupplier;\n\n public DefaultThumbnailService(ReactiveExtensionClient client,\n ExternalUrlSupplier externalUrlSupplier) {\n this.client = client;\n this.externalUrlSupplier = externalUrlSupplier;\n this.thumbnailCache = Caffeine.newBuilder()\n // TODO make it configurable\n .maximumSize(10_000)\n .build();\n }\n\n @EventListener\n void handleAttachmentChangedEvent(AttachmentChangedEvent event) {\n updateCache(event.getAttachment());\n }\n\n void updateCache(Attachment attachment) {\n if (attachment.getStatus() == null) {\n return;\n }\n var permalink = attachment.getStatus().getPermalink();\n if (!StringUtils.hasText(permalink)) {\n return;\n }\n if (ExtensionUtil.isDeleted(attachment)) {\n thumbnailCache.invalidate(permalink);\n return;\n }\n var thumbnails = attachment.getStatus().getThumbnails();\n if (CollectionUtils.isEmpty(thumbnails)) {\n thumbnailCache.put(permalink, EMPTY_THUMBNAILS);\n return;\n }\n Map validThumbnails = new HashMap<>();\n thumbnails.forEach((key, value) -> {\n var size = ThumbnailSize.optionalValueOf(key);\n if (size.isPresent() && StringUtils.hasText(value)) {\n validThumbnails.put(size.get(), URI.create(value));\n }\n });\n if (validThumbnails.isEmpty()) {\n thumbnailCache.put(permalink, EMPTY_THUMBNAILS);\n } else {\n thumbnailCache.put(permalink, Collections.unmodifiableMap(validThumbnails));\n }\n }\n\n @Override\n public Mono get(URI permalink, ThumbnailSize size) {\n return get(permalink).mapNotNull(thumbnails -> thumbnails.get(size));\n }\n\n @Override\n public Mono> get(URI permalink) {\n var encodedPermalink = URI.create(permalink.toASCIIString());\n if (!encodedPermalink.isAbsolute()) {\n // build permalinks\n return Mono.just(ThumbnailUtils.buildSrcsetMap(encodedPermalink));\n }\n // TODO Optimize concurrent requests for the same permalink\n return Mono.deferContextual(contextView -> {\n var externalUrl = ServerWebExchangeContextFilter.getExchange(contextView)\n .map(exchange -> externalUrlSupplier.getURL(exchange.getRequest()))\n .orElseGet(externalUrlSupplier::getRaw);\n // check if the permalink is from local site\n if (externalUrl != null\n && Objects.equals(externalUrl.getAuthority(), encodedPermalink.getAuthority())) {\n return Mono.just(ThumbnailUtils.buildSrcsetMap(encodedPermalink));\n }\n var permalinkString = encodedPermalink.toASCIIString();\n var thumbnails = thumbnailCache.getIfPresent(permalinkString);\n if (thumbnails != null) {\n return Mono.just(thumbnails);\n }\n // query from attachments\n var listOptions = ListOptions.builder()\n .andQuery(Queries.equal(\"status.permalink\", permalinkString))\n .build();\n return client.listAll(Attachment.class, listOptions, ExtensionUtil.defaultSort())\n .next()\n // Here we allow concurrent updates\n .doOnNext(this::updateCache)\n .mapNotNull(attachment -> this.thumbnailCache.getIfPresent(permalinkString))\n .switchIfEmpty(Mono.fromSupplier(() -> {\n // No attachment or no thumbnails, cache empty map to avoid cache miss again and\n // again.\n this.thumbnailCache.put(permalinkString, EMPTY_THUMBNAILS);\n return EMPTY_THUMBNAILS;\n }));\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/LocalThumbnailService.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport java.nio.file.Path;\nimport org.springframework.core.io.Resource;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\n/**\n * Service for generating and deleting local image thumbnails.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface LocalThumbnailService {\n\n /**\n * Generates thumbnail for the source image. If the thumbnail already exists, it will return the\n * existing one.\n *\n * @param source the source image path\n * @param size the thumbnail size\n * @return the generated thumbnail resource\n */\n Mono generate(Path source, ThumbnailSize size);\n\n /**\n * Deletes thumbnails associated with the source image.\n *\n * @param source the source image path\n */\n void delete(Path source);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/ThumbnailImgTagPostProcessor.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static org.thymeleaf.templatemode.TemplateMode.HTML;\n\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.function.Predicate;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.engine.ElementNames;\nimport org.thymeleaf.model.IAttribute;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.element.MatchingElementName;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.theme.dialect.ElementTagPostProcessor;\n\n@Slf4j\n@Component\nclass ThumbnailImgTagPostProcessor implements ElementTagPostProcessor {\n\n private static final String DEFAULT_SIZES = \"\"\"\n (max-width: 640px) 94vw, \\\n (max-width: 768px) 92vw, \\\n (max-width: 1024px) 88vw, \\\n min(800px, 85vw)\\\n \"\"\";\n\n private final MatchingElementName matchingElementName;\n\n private final ThumbnailService thumbnailService;\n\n public ThumbnailImgTagPostProcessor(ThumbnailService thumbnailService) {\n this.thumbnailService = thumbnailService;\n this.matchingElementName =\n MatchingElementName.forElementName(HTML, ElementNames.forHTMLName(\"img\"));\n }\n\n\n @Override\n public Mono process(ITemplateContext context,\n IProcessableElementTag tag) {\n if (!matchingElementName.matches(tag.getElementDefinition().getElementName())) {\n return Mono.empty();\n }\n if (tag.hasAttribute(\"srcset\")) {\n return Mono.empty();\n }\n var srcValue = Optional.ofNullable(tag.getAttribute(\"src\"))\n .map(IAttribute::getValue)\n .filter(StringUtils::hasText)\n .map(String::trim)\n .map(HaloUtils::safeToUri);\n if (srcValue.isEmpty()) {\n log.debug(\"Skip processing img tag without src attribute\");\n return Mono.empty();\n }\n // get img tag\n var imageUri = srcValue.get();\n\n return thumbnailService.get(imageUri)\n .filter(Predicate.not(Map::isEmpty))\n .map(thumbnails -> {\n var modelFactory = context.getModelFactory();\n var newTag = tag;\n if (!newTag.hasAttribute(\"sizes\")) {\n newTag = modelFactory.setAttribute(newTag, \"sizes\", DEFAULT_SIZES);\n }\n var srcset = thumbnails.keySet().stream()\n .map(size -> {\n var uri = thumbnails.get(size);\n return uri + \" \" + size.getWidth() + \"w\";\n })\n .collect(Collectors.joining(\", \"));\n newTag = modelFactory.setAttribute(newTag, \"srcset\", srcset);\n return newTag;\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/ThumbnailResourceTransformer.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport java.io.IOException;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.core.io.PathResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.resource.ResourceTransformer;\nimport org.springframework.web.reactive.resource.ResourceTransformerChain;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\n/**\n * A {@link ResourceTransformer} to generate and serve image thumbnails on the fly.\n *\n * @author johnniang\n * @since 2.22.0\n */\n@Slf4j\npublic class ThumbnailResourceTransformer implements ResourceTransformer {\n\n private final LocalThumbnailService localThumbnailService;\n\n public ThumbnailResourceTransformer(LocalThumbnailService localThumbnailService) {\n this.localThumbnailService = localThumbnailService;\n }\n\n @Override\n public Mono transform(ServerWebExchange exchange, Resource resource,\n ResourceTransformerChain transformerChain) {\n var width = exchange.getRequest().getQueryParams().getFirst(\"width\");\n if (!StringUtils.hasText(width) || !resource.isFile()) {\n return transformerChain.transform(exchange, resource);\n }\n var extension = StringUtils.getFilenameExtension(resource.getFilename());\n if (!ThumbnailUtils.isSupportedImage(extension)) {\n log.trace(\"Not a supported image type: {}\", extension);\n return transformerChain.transform(exchange, resource);\n }\n var size = ThumbnailSize.fromWidth(width);\n try {\n var source = resource.getFile().toPath();\n return localThumbnailService.generate(source, size)\n .switchIfEmpty(Mono.fromSupplier(() -> new PathResource(source)))\n .flatMap(transformed -> transformerChain.transform(exchange, transformed));\n } catch (IOException e) {\n return Mono.error(e);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/ThumbnailService.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport java.net.URI;\nimport java.util.Map;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\n/**\n * Service for managing thumbnails.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface ThumbnailService {\n\n /**\n * Get the thumbnail link for the given image URI and size.\n *\n * @param permalink the permalink of the image\n * @param size the size of the thumbnail\n * @return the thumbnail link\n */\n Mono get(URI permalink, ThumbnailSize size);\n\n /**\n * Get all thumbnail links for the given image URI.\n *\n * @param permalink the permalink of the image\n * @return the map of thumbnail size to thumbnail link\n */\n Mono> get(URI permalink);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/attachment/thumbnail/ThumbnailUtils.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport java.net.URI;\nimport java.util.Arrays;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport org.apache.commons.io.FilenameUtils;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.http.MediaType;\nimport org.springframework.util.MimeType;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\npublic enum ThumbnailUtils {\n ;\n\n private static final Set SUPPORTED_IMAGE_SUFFIXES = Set.of(\n \"jpg\", \"jpeg\", \"png\", \"bmp\", \"wbmp\"\n );\n\n private static final Set SUPPORTED_IMAGE_MIME_TYPES = Set.of(\n \"image/jpg\", \"image/jpeg\", \"image/png\", \"image/bmp\", \"image/vnd.wap.wbmp\"\n )\n .stream()\n .map(MediaType::parseMediaType)\n .collect(Collectors.toSet());\n\n /**\n * Check if the given file suffix is a supported image format for thumbnail generation.\n *\n * @param fileSuffix the file suffix to check (without the dot)\n * @return true if the file suffix is supported, false otherwise\n */\n public static boolean isSupportedImage(@Nullable String fileSuffix) {\n if (!StringUtils.hasText(fileSuffix)) {\n return false;\n }\n return SUPPORTED_IMAGE_SUFFIXES.contains(fileSuffix.toLowerCase());\n }\n\n public static boolean isSupportedImage(@Nullable MimeType mimeType) {\n return SUPPORTED_IMAGE_MIME_TYPES.stream()\n .anyMatch(supported -> supported.isCompatibleWith(mimeType));\n }\n\n /**\n * Build a map of thumbnail size to its corresponding URI based on the given permalink.\n *\n * @param permalink permalink of the attachment in local storage. Make sure it's encoded.\n * @return a map where the key is the thumbnail size and the value is the URI of the thumbnail\n */\n public static Map buildSrcsetMap(URI permalink) {\n var fileSuffix = FilenameUtils.getExtension(permalink.getPath());\n if (!isSupportedImage(fileSuffix)) {\n return Map.of();\n }\n return Arrays.stream(ThumbnailSize.values())\n .collect(Collectors.toMap(t -> t, t ->\n UriComponentsBuilder.fromUri(permalink)\n .queryParam(\"width\", t.getWidth())\n .build(true)\n .toUri()\n ));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/counter/CounterService.java", "content": "package run.halo.app.core.counter;\n\nimport java.util.Collection;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Counter;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic interface CounterService {\n\n Mono getByName(String counterName);\n\n Flux getByNames(Collection names);\n\n Mono deleteByName(String counterName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/counter/CounterServiceImpl.java", "content": "package run.halo.app.core.counter;\n\nimport java.util.Collection;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\n\n/**\n * Counter service implementation.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Service\npublic class CounterServiceImpl implements CounterService {\n\n private final ReactiveExtensionClient client;\n\n public CounterServiceImpl(ReactiveExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public Mono getByName(String counterName) {\n return client.fetch(Counter.class, counterName);\n }\n\n @Override\n public Flux getByNames(Collection names) {\n if (CollectionUtils.isEmpty(names)) {\n return Flux.empty();\n }\n var options = ListOptions.builder()\n .andQuery(Queries.in(\"metadata.name\", names))\n .build();\n return client.listAll(Counter.class, options, ExtensionUtil.defaultSort());\n }\n\n @Override\n public Mono deleteByName(String counterName) {\n return client.fetch(Counter.class, counterName)\n .flatMap(client::delete);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/counter/MeterUtils.java", "content": "package run.halo.app.core.counter;\n\nimport io.micrometer.core.instrument.Counter;\nimport io.micrometer.core.instrument.MeterRegistry;\nimport io.micrometer.core.instrument.Tag;\nimport io.micrometer.core.instrument.Tags;\nimport org.apache.commons.lang3.StringUtils;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * Meter utils.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class MeterUtils {\n\n public static final Tag METRICS_COMMON_TAG = Tag.of(\"metrics.halo.run\", \"true\");\n public static final String SCENE = \"scene\";\n public static final String VISIT_SCENE = \"visit\";\n public static final String UPVOTE_SCENE = \"upvote\";\n public static final String DOWNVOTE_SCENE = \"downvote\";\n public static final String TOTAL_COMMENT_SCENE = \"total_comment\";\n public static final String APPROVED_COMMENT_SCENE = \"approved_comment\";\n\n /**\n * Build a counter name.\n *\n * @param group extension group\n * @param plural extension plural\n * @param name extension name\n * @return counter name\n */\n public static String nameOf(String group, String plural, String name) {\n if (StringUtils.isBlank(group)) {\n return String.join(\"/\", plural, name);\n }\n return String.join(\".\", plural, group) + \"/\" + name;\n }\n\n public static String nameOf(Class clazz, String name) {\n GVK annotation = clazz.getAnnotation(GVK.class);\n return nameOf(annotation.group(), annotation.plural(), name);\n }\n\n public static Counter visitCounter(MeterRegistry registry, String name) {\n return counter(registry, name, Tag.of(SCENE, VISIT_SCENE));\n }\n\n public static Counter upvoteCounter(MeterRegistry registry, String name) {\n return counter(registry, name, Tag.of(SCENE, UPVOTE_SCENE));\n }\n\n public static Counter downvoteCounter(MeterRegistry registry, String name) {\n return counter(registry, name, Tag.of(SCENE, DOWNVOTE_SCENE));\n }\n\n public static Counter totalCommentCounter(MeterRegistry registry, String name) {\n return counter(registry, name, Tag.of(SCENE, TOTAL_COMMENT_SCENE));\n }\n\n public static Counter approvedCommentCounter(MeterRegistry registry, String name) {\n return counter(registry, name, Tag.of(SCENE, APPROVED_COMMENT_SCENE));\n }\n\n public static boolean isVisitCounter(Counter counter) {\n String sceneValue = counter.getId().getTag(SCENE);\n if (StringUtils.isBlank(sceneValue)) {\n return false;\n }\n return VISIT_SCENE.equals(sceneValue);\n }\n\n public static boolean isUpvoteCounter(Counter counter) {\n String sceneValue = counter.getId().getTag(SCENE);\n if (StringUtils.isBlank(sceneValue)) {\n return false;\n }\n return UPVOTE_SCENE.equals(sceneValue);\n }\n\n public static boolean isDownvoteCounter(Counter counter) {\n String sceneValue = counter.getId().getTag(SCENE);\n if (StringUtils.isBlank(sceneValue)) {\n return false;\n }\n return DOWNVOTE_SCENE.equals(sceneValue);\n }\n\n public static boolean isTotalCommentCounter(Counter counter) {\n String sceneValue = counter.getId().getTag(SCENE);\n if (StringUtils.isBlank(sceneValue)) {\n return false;\n }\n return TOTAL_COMMENT_SCENE.equals(sceneValue);\n }\n\n public static boolean isApprovedCommentCounter(Counter counter) {\n String sceneValue = counter.getId().getTag(SCENE);\n if (StringUtils.isBlank(sceneValue)) {\n return false;\n }\n return APPROVED_COMMENT_SCENE.equals(sceneValue);\n }\n\n /**\n * Build a {@link Counter} for halo extension.\n *\n * @param registry meter registry\n * @param name counter name,build by {@link #nameOf(String, String, String)}\n * @return counter find by name from registry if exists, otherwise create a new one.\n */\n private static Counter counter(MeterRegistry registry, String name, Tag... tags) {\n Tags withTags = Tags.of(METRICS_COMMON_TAG).and(tags);\n Counter counter = registry.find(name)\n .tags(withTags)\n .counter();\n if (counter == null) {\n return registry.counter(name, withTags);\n }\n return counter;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/AttachmentHandler.java", "content": "package run.halo.app.core.endpoint;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.util.Optional;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport lombok.NoArgsConstructor;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.Nullable;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.infra.SystemSetting.Attachment.UploadOptions;\n\n@Slf4j\n@RequiredArgsConstructor\n@Component\npublic class AttachmentHandler {\n\n private final AttachmentService attachmentService;\n\n /**\n * Build OpenAPI doc of request and response for upload attachment endpoint.\n *\n * @param builder the operation builder\n */\n public void buildDoc(Builder builder) {\n builder.requestBody(requestBodyBuilder()\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(UploadForm.class))\n )\n )\n .response(responseBuilder().implementation(Attachment.class));\n }\n\n /**\n * Handle upload attachment request.\n *\n * @param serverRequest the server request\n * @param getConfig the upload options fetcher\n * @return the server response\n */\n public Mono handleUpload(ServerRequest serverRequest,\n Mono getConfig) {\n var getForm = serverRequest.bind(UploadForm.class);\n var uploadAttachment = Mono.zip(getForm, getConfig)\n .flatMap(tuple2 -> {\n var form = tuple2.getT1();\n var config = tuple2.getT2();\n var file = form.getFile();\n var upload = Mono.defer(() -> {\n if (file != null) {\n var mediaType = Optional.ofNullable(file.headers().getContentType())\n .orElse(MediaType.APPLICATION_OCTET_STREAM);\n if (log.isDebugEnabled()) {\n log.debug(\"Preparing to upload attachment [filename={} mediaType={}]\",\n file.name(), mediaType);\n }\n return attachmentService.upload(\n config.policyName(),\n config.groupName(),\n file.filename(),\n file.content(),\n mediaType\n );\n }\n if (log.isDebugEnabled()) {\n log.debug(\"Preparing to upload attachment from url [{}], filename: {}\",\n form.getUrl(), form.getFilename());\n }\n var url = Optional.ofNullable(form.getUrl())\n .filter(StringUtils::hasText)\n .map(URI::create)\n .map(uri -> {\n try {\n return uri.toURL();\n } catch (MalformedURLException e) {\n throw new RuntimeException(e);\n }\n })\n .orElse(null);\n if (url == null) {\n return Mono.error(new ServerWebInputException(\n \"Invalid url provided: \" + form.getUrl()\n ));\n }\n return attachmentService.uploadFromUrl(\n url, config.policyName(), config.groupName(), form.getFilename()\n );\n });\n return upload.flatMap(a -> attachmentService.getPermalink(a)\n .doOnNext(permalink -> a.getStatus().setPermalink(permalink.toString()))\n .thenReturn(a)\n );\n });\n return ServerResponse.ok().body(uploadAttachment, Attachment.class);\n }\n\n /**\n * Upload form from console. The file and url are mutually exclusive. If both are provided,\n * the file will be used.\n *\n */\n @Data\n @NoArgsConstructor\n @AllArgsConstructor\n public static class UploadForm {\n\n /**\n * The file to upload. If not provided, the url will be used.\n */\n @Nullable\n private FilePart file;\n\n /**\n * The filename to use when uploading from url. If not provided, the filename will be\n * extracted from the url.\n */\n @Nullable\n private String filename;\n\n /**\n * The url to upload from. If not provided, the file will be used.\n */\n @Nullable\n private String url;\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/WebSocketEndpointManager.java", "content": "package run.halo.app.core.endpoint;\n\nimport java.util.Collection;\n\n/**\n * Interface for managing WebSocket endpoints, including registering and unregistering.\n *\n * @author johnniang\n */\npublic interface WebSocketEndpointManager {\n\n void register(Collection endpoints);\n\n void unregister(Collection endpoints);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/WebSocketHandlerMapping.java", "content": "package run.halo.app.core.endpoint;\n\nimport com.google.common.collect.BiMap;\nimport com.google.common.collect.HashBiMap;\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.List;\nimport java.util.concurrent.locks.ReadWriteLock;\nimport java.util.concurrent.locks.ReentrantReadWriteLock;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.server.reactive.observation.ServerRequestObservationContext;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.web.reactive.handler.AbstractHandlerMapping;\nimport org.springframework.web.reactive.socket.WebSocketHandler;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.util.pattern.PathPattern;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.ui.WebSocketUtils;\n\npublic class WebSocketHandlerMapping extends AbstractHandlerMapping\n implements WebSocketEndpointManager, InitializingBean {\n\n private final BiMap endpointMap;\n\n private final ReadWriteLock rwLock;\n\n public WebSocketHandlerMapping() {\n this.endpointMap = HashBiMap.create();\n this.rwLock = new ReentrantReadWriteLock();\n }\n\n @Override\n @NonNull\n public Mono getHandlerInternal(ServerWebExchange exchange) {\n var request = exchange.getRequest();\n if (!HttpMethod.GET.equals(request.getMethod())\n || !WebSocketUtils.isWebSocketUpgrade(request.getHeaders())) {\n // skip getting handler if the request is not a WebSocket.\n return Mono.empty();\n }\n\n var lock = rwLock.readLock();\n lock.lock();\n try {\n // Refer to org.springframework.web.reactive.handler.AbstractUrlHandlerMapping\n // .lookupHandler\n var pathContainer = request.getPath().pathWithinApplication();\n List matches = null;\n for (var pattern : this.endpointMap.keySet()) {\n if (pattern.matches(pathContainer)) {\n if (matches == null) {\n matches = new ArrayList<>();\n }\n matches.add(pattern);\n }\n }\n if (matches == null) {\n return Mono.empty();\n }\n\n if (matches.size() > 1) {\n matches.sort(PathPattern.SPECIFICITY_COMPARATOR);\n }\n\n var pattern = matches.get(0);\n exchange.getAttributes().put(BEST_MATCHING_PATTERN_ATTRIBUTE, pattern);\n\n var handler = endpointMap.get(pattern).handler();\n exchange.getAttributes().put(BEST_MATCHING_HANDLER_ATTRIBUTE, handler);\n\n ServerRequestObservationContext.findCurrent(exchange.getAttributes())\n .ifPresent(context -> context.setPathPattern(pattern.toString()));\n\n var pathWithinMapping = pattern.extractPathWithinPattern(pathContainer);\n exchange.getAttributes().put(PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE, pathWithinMapping);\n\n var matchInfo = pattern.matchAndExtract(pathContainer);\n Assert.notNull(matchInfo, \"Expect a match\");\n exchange.getAttributes()\n .put(URI_TEMPLATE_VARIABLES_ATTRIBUTE, matchInfo.getUriVariables());\n return Mono.just(handler);\n } catch (Exception e) {\n return Mono.error(e);\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public void register(Collection endpoints) {\n if (CollectionUtils.isEmpty(endpoints)) {\n return;\n }\n var lock = rwLock.writeLock();\n lock.lock();\n try {\n endpoints.forEach(endpoint -> {\n var urlPath = endpoint.urlPath();\n urlPath = StringUtils.prependIfMissing(urlPath, \"/\");\n var groupVersion = endpoint.groupVersion();\n var parser = getPathPatternParser();\n var pattern = parser.parse(\"/apis/\" + groupVersion + urlPath);\n endpointMap.put(pattern, endpoint);\n });\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public void unregister(Collection endpoints) {\n if (CollectionUtils.isEmpty(endpoints)) {\n return;\n }\n var lock = rwLock.writeLock();\n lock.lock();\n try {\n BiMap inverseMap = endpointMap.inverse();\n endpoints.forEach(inverseMap::remove);\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public void afterPropertiesSet() {\n var endpoints = obtainApplicationContext().getBeanProvider(WebSocketEndpoint.class)\n .orderedStream()\n .toList();\n register(endpoints);\n }\n\n BiMap getEndpointMap() {\n return endpointMap;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/AttachmentConsoleEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\n\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.endpoint.AttachmentHandler;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass AttachmentConsoleEndpoint implements CustomEndpoint {\n\n private final SystemConfigFetcher systemConfigFetcher;\n\n private final AttachmentHandler attachmentHandler;\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"console.api.storage.halo.run/v1alpha1\");\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"AttachmentV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .POST(\n path(\"/attachments/-/upload\")\n .and(contentType(MediaType.MULTIPART_FORM_DATA)),\n this::handleUpload,\n builder -> {\n builder.operationId(\"uploadAttachmentForConsole\")\n .tag(tag)\n .description(\"Upload attachment endpoint for console.\");\n this.attachmentHandler.buildDoc(builder);\n }\n )\n .build();\n }\n\n private Mono handleUpload(ServerRequest serverRequest) {\n var getConfig = systemConfigFetcher.fetch(\n SystemSetting.Attachment.GROUP,\n SystemSetting.Attachment.class\n )\n .mapNotNull(SystemSetting.Attachment::console)\n .filter(ac -> StringUtils.hasText(ac.policyName()))\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Attachment system setting is not configured for console\"\n )));\n return attachmentHandler.handleUpload(serverRequest, getConfig);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/AuthProviderEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.AuthProvider;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.security.AuthProviderService;\nimport run.halo.app.security.ListedAuthProvider;\n\n/**\n * Auth provider endpoint.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class AuthProviderEndpoint implements CustomEndpoint {\n\n private final AuthProviderService authProviderService;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"AuthProviderV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"auth-providers\", this::listAuthProviders,\n builder -> builder.operationId(\"listAuthProviders\")\n .description(\"Lists all auth providers\")\n .tag(tag)\n .response(responseBuilder()\n .implementationArray(ListedAuthProvider.class))\n )\n .PUT(\"auth-providers/{name}/enable\", this::enableAuthProvider,\n builder -> builder.operationId(\"enableAuthProvider\")\n .description(\"Enables an auth provider\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(AuthProvider.class))\n )\n .PUT(\"auth-providers/{name}/disable\", this::disableAuthProvider,\n builder -> builder.operationId(\"disableAuthProvider\")\n .description(\"Disables an auth provider\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(AuthProvider.class))\n )\n .build();\n }\n\n private Mono enableAuthProvider(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return authProviderService.enable(name)\n .flatMap(authProvider -> ServerResponse.ok().bodyValue(authProvider));\n }\n\n private Mono disableAuthProvider(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return authProviderService.disable(name)\n .flatMap(authProvider -> ServerResponse.ok().bodyValue(authProvider));\n }\n\n Mono listAuthProviders(ServerRequest request) {\n return authProviderService.listAll()\n .flatMap(providers -> ServerResponse.ok().bodyValue(providers));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/CommentEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.time.Instant;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.comment.CommentQuery;\nimport run.halo.app.content.comment.CommentRequest;\nimport run.halo.app.content.comment.CommentService;\nimport run.halo.app.content.comment.ListedComment;\nimport run.halo.app.content.comment.ReplyRequest;\nimport run.halo.app.content.comment.ReplyService;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.IpAddressUtils;\n\n\n/**\n * Endpoint for managing comment.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class CommentEndpoint implements CustomEndpoint {\n\n private final CommentService commentService;\n private final ReplyService replyService;\n\n public CommentEndpoint(CommentService commentService, ReplyService replyService) {\n this.commentService = commentService;\n this.replyService = replyService;\n }\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"CommentV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"comments\", this::listComments, builder -> {\n builder.operationId(\"ListComments\")\n .description(\"List comments.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ListedComment.class))\n );\n CommentQuery.buildParameters(builder);\n }\n )\n .POST(\"comments\", this::createComment,\n builder -> builder.operationId(\"CreateComment\")\n .description(\"Create a comment.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(CommentRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Comment.class))\n )\n .POST(\"comments/{name}/reply\", this::createReply,\n builder -> builder.operationId(\"CreateReply\")\n .description(\"Create a reply.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(ReplyRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Reply.class))\n )\n .build();\n }\n\n Mono listComments(ServerRequest request) {\n CommentQuery commentQuery = new CommentQuery(request);\n return commentService.listComment(commentQuery)\n .flatMap(listedComments -> ServerResponse.ok().bodyValue(listedComments));\n }\n\n Mono createComment(ServerRequest request) {\n return request.bodyToMono(CommentRequest.class)\n .flatMap(commentRequest -> {\n Comment comment = commentRequest.toComment();\n comment.getSpec().setIpAddress(IpAddressUtils.getIpAddress(request));\n comment.getSpec().setUserAgent(HaloUtils.userAgentFrom(request));\n return commentService.create(comment);\n })\n .flatMap(comment -> ServerResponse.ok().bodyValue(comment));\n }\n\n Mono createReply(ServerRequest request) {\n String commentName = request.pathVariable(\"name\");\n return request.bodyToMono(ReplyRequest.class)\n .flatMap(replyRequest -> {\n Reply reply = replyRequest.toReply();\n // Create via console without audit\n reply.getSpec().setApproved(true);\n reply.getSpec().setApprovedTime(Instant.now());\n reply.getSpec().setIpAddress(IpAddressUtils.getIpAddress(request));\n reply.getSpec().setUserAgent(HaloUtils.userAgentFrom(request));\n // fix gh-2951\n if (reply.getSpec().getHidden() == null) {\n reply.getSpec().setHidden(false);\n }\n return replyService.create(commentName, reply);\n })\n .flatMap(comment -> ServerResponse.ok().bodyValue(comment));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/ConsoleUserEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Objects;\nimport org.springdoc.core.fn.builders.parameter.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * User endpoint for console.\n *\n * @author johnniang\n */\n@Component\nclass ConsoleUserEndpoint implements CustomEndpoint {\n\n private final UserService userService;\n\n ConsoleUserEndpoint(UserService userService) {\n this.userService = userService;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"UserV1alpha1Console\";\n return RouterFunctions.nest(RequestPredicates.path(\"/users\"), SpringdocRouteBuilder.route()\n .POST(\"/{username}/disable\", this::handleDisableUser, ops -> {\n ops.operationId(\"DisableUser\")\n .tag(tag)\n .description(\"Disable user by username\")\n .parameter(Builder.parameterBuilder()\n .name(\"username\")\n .in(ParameterIn.PATH)\n .description(\"Username\")\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(User.class)\n .description(\"The user has been disabled.\")\n );\n })\n .POST(\"/{username}/enable\", this::handleEnableUser, ops -> {\n ops.operationId(\"EnableUser\")\n .tag(tag)\n .description(\"Enable user by username\")\n .parameter(Builder.parameterBuilder()\n .name(\"username\")\n .in(ParameterIn.PATH)\n .description(\"Username\")\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(User.class)\n .description(\"The user has been enabled.\")\n );\n })\n .build());\n }\n\n private Mono handleEnableUser(ServerRequest request) {\n return userService.enable(request.pathVariable(\"username\"))\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"The user was not found or has been enabled.\"))\n )\n .flatMap(user -> ServerResponse.ok().bodyValue(user));\n }\n\n private Mono handleDisableUser(ServerRequest request) {\n var username = request.pathVariable(\"username\");\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName)\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"The current user is not authenticated.\"))\n )\n .filter(currentUsername -> !Objects.equals(currentUsername, username))\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"The user is the current user, can't disable it.\"\n )))\n .then(Mono.defer(() -> userService.disable(username)))\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"The user was not found or has been disabled.\"))\n )\n .flatMap(user -> ServerResponse.ok().bodyValue(user));\n }\n\n @Override\n public GroupVersion groupVersion() {\n return new GroupVersion(\"console.api.security.halo.run\", \"v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/CustomEndpointsBuilder.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport java.util.HashMap;\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Map;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\n\npublic class CustomEndpointsBuilder {\n\n private final Map>> routerFunctionsMap;\n\n public CustomEndpointsBuilder() {\n routerFunctionsMap = new HashMap<>();\n }\n\n public CustomEndpointsBuilder add(CustomEndpoint customEndpoint) {\n routerFunctionsMap\n .computeIfAbsent(customEndpoint.groupVersion(), gv -> new LinkedList<>())\n .add(customEndpoint.endpoint());\n return this;\n }\n\n public RouterFunction build() {\n SpringdocRouteBuilder routeBuilder = SpringdocRouteBuilder.route();\n routerFunctionsMap.forEach((gv, routerFunctions) ->\n routeBuilder.nest(RequestPredicates.path(\"/apis/\" + gv),\n () -> routerFunctions.stream().reduce(RouterFunction::and).orElse(null)\n )\n );\n if (routerFunctionsMap.isEmpty()) {\n // return empty route.\n return request -> Mono.empty();\n }\n routerFunctionsMap.clear();\n return routeBuilder.build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/PluginEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springframework.boot.convert.ApplicationConversionService.getSharedInstance;\nimport static org.springframework.core.io.buffer.DataBufferUtils.write;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static run.halo.app.extension.ListResult.generateGenericClass;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.or;\nimport static run.halo.app.extension.router.QueryParamBuildUtil.sortParameter;\nimport static run.halo.app.infra.utils.FileUtils.deleteFileSilently;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.net.URI;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.function.Function;\nimport lombok.Data;\nimport lombok.extern.slf4j.Slf4j;\nimport org.reactivestreams.Publisher;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.http.CacheControl;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.http.codec.multipart.FormFieldPart;\nimport org.springframework.http.codec.multipart.Part;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.BodyInserters;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.reactive.resource.NoResourceFoundException;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.user.service.SettingConfigService;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.extension.router.SortableRequest;\nimport run.halo.app.infra.ReactiveUrlDataBufferFetcher;\nimport run.halo.app.infra.utils.SettingUtils;\nimport run.halo.app.plugin.PluginService;\nimport tools.jackson.databind.node.ObjectNode;\n\n@Slf4j\n@Component\npublic class PluginEndpoint implements CustomEndpoint, InitializingBean {\n\n private final ReactiveExtensionClient client;\n\n private final PluginService pluginService;\n\n private final ReactiveUrlDataBufferFetcher reactiveUrlDataBufferFetcher;\n\n private final SettingConfigService settingConfigService;\n\n private final WebProperties webProperties;\n\n private final Scheduler scheduler = Schedulers.boundedElastic();\n\n private boolean useLastModified;\n\n private CacheControl bundleCacheControl = CacheControl.empty();\n\n public PluginEndpoint(ReactiveExtensionClient client,\n PluginService pluginService,\n ReactiveUrlDataBufferFetcher reactiveUrlDataBufferFetcher,\n SettingConfigService settingConfigService,\n WebProperties webProperties) {\n this.client = client;\n this.pluginService = pluginService;\n this.reactiveUrlDataBufferFetcher = reactiveUrlDataBufferFetcher;\n this.settingConfigService = settingConfigService;\n this.webProperties = webProperties;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"PluginV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .POST(\"plugins/install\", contentType(MediaType.MULTIPART_FORM_DATA),\n this::install, builder -> builder.operationId(\"InstallPlugin\")\n .description(\"Install a plugin by uploading a Jar file.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(InstallRequest.class))\n ))\n .response(responseBuilder().implementation(Plugin.class))\n )\n .POST(\"plugins/-/install-from-uri\", this::installFromUri,\n builder -> builder.operationId(\"InstallPluginFromUri\")\n .description(\"Install a plugin from uri.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(InstallFromUriRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Plugin.class))\n )\n .POST(\"plugins/{name}/upgrade-from-uri\", this::upgradeFromUri,\n builder -> builder.operationId(\"UpgradePluginFromUri\")\n .description(\"Upgrade a plugin from uri.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(UpgradeFromUriRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Plugin.class))\n )\n .POST(\"plugins/{name}/upgrade\", contentType(MediaType.MULTIPART_FORM_DATA),\n this::upgrade, builder -> builder.operationId(\"UpgradePlugin\")\n .description(\"Upgrade a plugin by uploading a Jar file\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\").in(ParameterIn.PATH).required(true))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder().mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(InstallRequest.class))))\n )\n .PUT(\"plugins/{name}/json-config\", this::updatePluginJsonConfig,\n builder -> builder.operationId(\"updatePluginJsonConfig\")\n .description(\"Update the config of plugin setting.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder().mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder().implementation(Object.class))))\n .response(responseBuilder()\n .responseCode(String.valueOf(HttpStatus.NO_CONTENT.value()))\n .implementation(Void.class))\n )\n .PUT(\"plugins/{name}/reset-config\", this::resetSettingConfig,\n builder -> builder.operationId(\"ResetPluginConfig\")\n .description(\"Reset the configMap of plugin setting.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(ConfigMap.class))\n )\n .PUT(\"plugins/{name}/reload\", this::reload,\n builder -> builder.operationId(\"reloadPlugin\")\n .description(\"Reload a plugin by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(Plugin.class))\n )\n .PUT(\"plugins/{name}/plugin-state\", this::changePluginRunningState,\n builder -> builder.operationId(\"ChangePluginRunningState\")\n .description(\"Change the running state of a plugin by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(RunningStateRequest.class))\n )\n )\n .response(responseBuilder()\n .implementation(Plugin.class))\n )\n .GET(\"plugins\", this::list, builder -> {\n builder.operationId(\"ListPlugins\")\n .tag(tag)\n .description(\"List plugins using query criteria and sort params\")\n .response(responseBuilder().implementation(generateGenericClass(Plugin.class)));\n ListRequest.buildParameters(builder);\n })\n .GET(\"plugins/{name}/setting\", this::fetchPluginSetting,\n builder -> builder.operationId(\"fetchPluginSetting\")\n .description(\"Fetch setting of plugin.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(Setting.class))\n )\n .GET(\"plugins/{name}/json-config\", this::fetchPluginJsonConfig,\n builder -> builder.operationId(\"fetchPluginJsonConfig\")\n .description(\n \"Fetch converted json config of plugin by configured configMapName.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(Object.class))\n )\n .GET(\"plugins/-/bundle.js\", this::fetchJsBundle,\n builder -> builder.operationId(\"fetchJsBundle\")\n .description(\"Merge all JS bundles of enabled plugins into one.\")\n .tag(tag)\n .response(responseBuilder().implementation(String.class))\n )\n .GET(\"plugins/-/bundle.css\", this::fetchCssBundle,\n builder -> builder.operationId(\"fetchCssBundle\")\n .description(\"Merge all CSS bundles of enabled plugins into one.\")\n .tag(tag)\n .response(responseBuilder().implementation(String.class))\n )\n .build();\n }\n\n private Mono fetchPluginJsonConfig(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return client.fetch(Plugin.class, name)\n .mapNotNull(plugin -> plugin.getSpec().getConfigMapName())\n .flatMap(settingConfigService::fetchConfig)\n .flatMap(json -> ServerResponse.ok().bodyValue(json));\n }\n\n private Mono updatePluginJsonConfig(ServerRequest request) {\n final var pluginName = request.pathVariable(\"name\");\n return client.fetch(Plugin.class, pluginName)\n .doOnNext(plugin -> {\n String configMapName = plugin.getSpec().getConfigMapName();\n if (!StringUtils.hasText(configMapName)) {\n throw new ServerWebInputException(\n \"Unable to complete the request because the plugin configMapName is blank\");\n }\n })\n .flatMap(plugin -> {\n final String configMapName = plugin.getSpec().getConfigMapName();\n return request.bodyToMono(ObjectNode.class)\n .switchIfEmpty(\n Mono.error(new ServerWebInputException(\"Required request body is missing\")))\n .flatMap(configMapJsonData ->\n settingConfigService.upsertConfig(configMapName, configMapJsonData));\n })\n .then(ServerResponse.noContent().build());\n }\n\n Mono changePluginRunningState(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return request.bodyToMono(RunningStateRequest.class)\n .flatMap(runningState -> {\n var enable = runningState.isEnable();\n var async = runningState.isAsync();\n return pluginService.changeState(name, enable, !async);\n })\n .flatMap(plugin -> ServerResponse.ok().bodyValue(plugin));\n }\n\n @Override\n public void afterPropertiesSet() {\n var cache = this.webProperties.getResources().getCache();\n this.useLastModified = cache.isUseLastModified();\n var cacheControl = cache.getCachecontrol().toHttpCacheControl();\n if (cacheControl != null) {\n this.bundleCacheControl = cacheControl;\n }\n }\n\n @Data\n @Schema(name = \"PluginRunningStateRequest\")\n static class RunningStateRequest {\n private boolean enable;\n private boolean async;\n }\n\n private Mono fetchJsBundle(ServerRequest request) {\n var versionOption = request.queryParam(\"v\");\n return versionOption.map(s -> pluginService.getJsBundle(s).flatMap(\n jsRes -> {\n var bodyBuilder = ServerResponse.ok()\n .cacheControl(bundleCacheControl)\n .contentType(MediaType.valueOf(\"text/javascript\"));\n if (useLastModified) {\n try {\n var lastModified = Instant.ofEpochMilli(jsRes.lastModified());\n bodyBuilder = bodyBuilder.lastModified(lastModified);\n } catch (IOException e) {\n if (e instanceof FileNotFoundException) {\n return Mono.error(\n new NoResourceFoundException(request.uri(), \"bundle.js\")\n );\n }\n return Mono.error(e);\n }\n }\n return bodyBuilder.body(BodyInserters.fromResource(jsRes));\n }))\n .orElseGet(() -> pluginService.generateBundleVersion()\n .flatMap(version -> ServerResponse\n .temporaryRedirect(buildJsBundleUri(\"js\", version))\n .cacheControl(CacheControl.noStore())\n .build()));\n }\n\n private Mono fetchCssBundle(ServerRequest request) {\n return request.queryParam(\"v\")\n .map(s -> pluginService.getCssBundle(s).flatMap(cssRes -> {\n var bodyBuilder = ServerResponse.ok()\n .cacheControl(bundleCacheControl)\n .contentType(MediaType.valueOf(\"text/css\"));\n if (useLastModified) {\n try {\n var lastModified = Instant.ofEpochMilli(cssRes.lastModified());\n bodyBuilder = bodyBuilder.lastModified(lastModified);\n } catch (IOException e) {\n if (e instanceof FileNotFoundException) {\n return Mono.error(\n new NoResourceFoundException(request.uri(), \"bundle.css\")\n );\n }\n return Mono.error(e);\n }\n }\n return bodyBuilder.body(BodyInserters.fromResource(cssRes));\n }))\n .orElseGet(() -> pluginService.generateBundleVersion()\n .flatMap(version -> ServerResponse\n .temporaryRedirect(buildJsBundleUri(\"css\", version))\n .cacheControl(CacheControl.noStore())\n .build()));\n\n }\n\n URI buildJsBundleUri(String type, String version) {\n return URI.create(\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.\" + type + \"?v=\" + version);\n }\n\n private Mono upgradeFromUri(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var content = request.bodyToMono(UpgradeFromUriRequest.class)\n .map(UpgradeFromUriRequest::uri)\n .flatMapMany(reactiveUrlDataBufferFetcher::fetch);\n\n return Mono.usingWhen(\n writeToTempFile(content),\n path -> pluginService.upgrade(name, path),\n this::deleteFileIfExists)\n .flatMap(upgradedPlugin -> ServerResponse.ok().bodyValue(upgradedPlugin));\n }\n\n private Mono installFromUri(ServerRequest request) {\n var content = request.bodyToMono(InstallFromUriRequest.class)\n .map(InstallFromUriRequest::uri)\n .flatMapMany(reactiveUrlDataBufferFetcher::fetch);\n\n return Mono.usingWhen(\n writeToTempFile(content),\n pluginService::install,\n this::deleteFileIfExists\n )\n .flatMap(newPlugin -> ServerResponse.ok().bodyValue(newPlugin));\n }\n\n public record InstallFromUriRequest(@Schema(requiredMode = REQUIRED) URI uri) {\n }\n\n public record UpgradeFromUriRequest(@Schema(requiredMode = REQUIRED) URI uri) {\n }\n\n private Mono reload(ServerRequest serverRequest) {\n var name = serverRequest.pathVariable(\"name\");\n return ServerResponse.ok().body(pluginService.reload(name), Plugin.class);\n }\n\n private Mono fetchPluginConfig(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return client.fetch(Plugin.class, name)\n .mapNotNull(plugin -> plugin.getSpec().getConfigMapName())\n .flatMap(configMapName -> client.fetch(ConfigMap.class, configMapName))\n .flatMap(configMap -> ServerResponse.ok().bodyValue(configMap));\n }\n\n private Mono fetchPluginSetting(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return client.fetch(Plugin.class, name)\n .mapNotNull(plugin -> plugin.getSpec().getSettingName())\n .flatMap(settingName -> client.fetch(Setting.class, settingName))\n .flatMap(setting -> ServerResponse.ok().bodyValue(setting));\n }\n\n private Mono updatePluginConfig(ServerRequest request) {\n final var pluginName = request.pathVariable(\"name\");\n return client.fetch(Plugin.class, pluginName)\n .doOnNext(plugin -> {\n String configMapName = plugin.getSpec().getConfigMapName();\n if (!StringUtils.hasText(configMapName)) {\n throw new ServerWebInputException(\n \"Unable to complete the request because the plugin configMapName is blank\");\n }\n })\n .flatMap(plugin -> {\n final String configMapName = plugin.getSpec().getConfigMapName();\n return request.bodyToMono(ConfigMap.class)\n .doOnNext(configMapToUpdate -> {\n var configMapNameToUpdate = configMapToUpdate.getMetadata().getName();\n if (!configMapName.equals(configMapNameToUpdate)) {\n throw new ServerWebInputException(\n \"The name from the request body does not match the plugin \"\n + \"configMapName name.\");\n }\n })\n .flatMap(configMapToUpdate -> client.fetch(ConfigMap.class, configMapName)\n .map(persisted -> {\n configMapToUpdate.getMetadata()\n .setVersion(persisted.getMetadata().getVersion());\n return configMapToUpdate;\n })\n .switchIfEmpty(client.create(configMapToUpdate))\n )\n .flatMap(client::update)\n .retryWhen(Retry.backoff(5, Duration.ofMillis(300))\n .filter(OptimisticLockingFailureException.class::isInstance)\n );\n })\n .flatMap(configMap -> ServerResponse.ok().bodyValue(configMap));\n }\n\n private Mono resetSettingConfig(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return client.fetch(Plugin.class, name)\n .filter(plugin -> StringUtils.hasText(plugin.getSpec().getSettingName()))\n .flatMap(plugin -> {\n String configMapName = plugin.getSpec().getConfigMapName();\n String settingName = plugin.getSpec().getSettingName();\n return client.fetch(Setting.class, settingName)\n .map(SettingUtils::settingDefinedDefaultValueMap)\n .flatMap(data -> updateConfigMapData(configMapName, data));\n })\n .flatMap(configMap -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(configMap));\n }\n\n private Mono updateConfigMapData(String configMapName, Map data) {\n return client.fetch(ConfigMap.class, configMapName)\n .flatMap(configMap -> {\n configMap.setData(data);\n return client.update(configMap);\n })\n .retryWhen(Retry.fixedDelay(10, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException));\n }\n\n\n private Mono install(ServerRequest request) {\n return request.multipartData()\n .map(InstallRequest::new)\n .flatMap(installRequest -> installRequest.getSource()\n .flatMap(source -> {\n if (InstallSource.FILE.equals(source)) {\n return installFromFile(installRequest.getFile(), pluginService::install);\n }\n return Mono.error(\n new UnsupportedOperationException(\"Unsupported install source \" + source));\n }))\n .flatMap(plugin -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(plugin));\n }\n\n private Mono upgrade(ServerRequest request) {\n var pluginName = request.pathVariable(\"name\");\n return request.multipartData()\n .map(InstallRequest::new)\n .flatMap(installRequest -> installRequest.getSource()\n .flatMap(source -> {\n if (InstallSource.FILE.equals(source)) {\n return installFromFile(installRequest.getFile(),\n path -> pluginService.upgrade(pluginName, path));\n }\n return Mono.error(\n new UnsupportedOperationException(\"Unsupported install source \" + source));\n }))\n .flatMap(upgradedPlugin -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(upgradedPlugin));\n }\n\n private Mono installFromFile(FilePart filePart,\n Function> resourceClosure) {\n return Mono.usingWhen(\n writeToTempFile(filePart.content()),\n resourceClosure,\n this::deleteFileIfExists);\n }\n\n public static class ListRequest extends SortableRequest {\n\n public ListRequest(ServerRequest request) {\n super(request.exchange());\n }\n\n @Schema(name = \"keyword\", description = \"Keyword of plugin name or description\")\n public String getKeyword() {\n return queryParams.getFirst(\"keyword\");\n }\n\n @Schema(name = \"enabled\", description = \"Whether the plugin is enabled\")\n public Boolean getEnabled() {\n var enabled = queryParams.getFirst(\"enabled\");\n return enabled == null ? null : getSharedInstance().convert(enabled, Boolean.class);\n }\n\n @Override\n public Sort getSort() {\n var orders = super.getSort().stream()\n .map(order -> {\n if (\"creationTimestamp\".equals(order.getProperty())) {\n return order.withProperty(\"metadata.creationTimestamp\");\n }\n return order;\n })\n .toList();\n return Sort.by(orders);\n }\n\n @Override\n public ListOptions toListOptions() {\n var builder = ListOptions.builder(super.toListOptions());\n\n Optional.ofNullable(queryParams.getFirst(\"keyword\"))\n .filter(StringUtils::hasText)\n .ifPresent(keyword -> builder.andQuery(or(\n contains(\"spec.displayName\", keyword),\n contains(\"spec.description\", keyword)\n )));\n\n Optional.ofNullable(queryParams.getFirst(\"enabled\"))\n .map(Boolean::parseBoolean)\n .ifPresent(enabled -> builder.andQuery(equal(\"spec.enabled\", enabled.toString())));\n\n return builder.build();\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(sortParameter());\n builder.parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .description(\"Keyword of plugin name or description\")\n .implementation(String.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"enabled\")\n .description(\"Whether the plugin is enabled\")\n .implementation(Boolean.class)\n .required(false));\n }\n }\n\n Mono list(ServerRequest request) {\n return Mono.just(request)\n .map(ListRequest::new)\n .flatMap(listRequest -> client.listBy(\n Plugin.class,\n listRequest.toListOptions(),\n listRequest.toPageRequest()\n ))\n .flatMap(listResult -> ServerResponse.ok().bodyValue(listResult));\n }\n\n @Schema(name = \"PluginInstallRequest\", types = \"object\")\n public static class InstallRequest {\n\n private final MultiValueMap multipartData;\n\n public InstallRequest(MultiValueMap multipartData) {\n this.multipartData = multipartData;\n }\n\n @Schema(requiredMode = NOT_REQUIRED, description = \"Plugin Jar file.\")\n public FilePart getFile() {\n var part = multipartData.getFirst(\"file\");\n if (part == null) {\n throw new ServerWebInputException(\"Form field file is required\");\n }\n if (!(part instanceof FilePart file)) {\n throw new ServerWebInputException(\"Invalid parameter of file\");\n }\n if (!Paths.get(file.filename()).toString().endsWith(\".jar\")) {\n throw new ServerWebInputException(\"Invalid file type, only jar is supported\");\n }\n return file;\n }\n\n @Schema(requiredMode = NOT_REQUIRED,\n description = \"Plugin preset name. We will find the plugin from plugin presets\")\n public Mono getPresetName() {\n var part = multipartData.getFirst(\"presetName\");\n if (part == null) {\n return Mono.error(new ServerWebInputException(\n \"Form field presetName is required.\"));\n }\n if (!(part instanceof FormFieldPart presetName)) {\n return Mono.error(new ServerWebInputException(\n \"Invalid format of presetName field, string required\"));\n }\n if (!StringUtils.hasText(presetName.value())) {\n return Mono.error(new ServerWebInputException(\"presetName must not be blank\"));\n }\n return Mono.just(presetName.value());\n }\n\n @Schema(requiredMode = NOT_REQUIRED, description = \"Install source. Default is file.\")\n public Mono getSource() {\n var part = multipartData.getFirst(\"source\");\n if (part == null) {\n return Mono.just(InstallSource.FILE);\n }\n if (!(part instanceof FormFieldPart sourcePart)) {\n return Mono.error(new ServerWebInputException(\n \"Invalid format of source field, string required.\"));\n }\n var installSource = InstallSource.valueOf(sourcePart.value().toUpperCase());\n return Mono.just(installSource);\n }\n }\n\n public enum InstallSource {\n FILE,\n PRESET,\n URL\n }\n\n Mono deleteFileIfExists(Path path) {\n return deleteFileSilently(path, this.scheduler).then();\n }\n\n private Mono writeToTempFile(Publisher content) {\n return Mono.fromCallable(() -> Files.createTempFile(\"halo-plugin-\", \".jar\"))\n .flatMap(path -> write(content, path).thenReturn(path))\n .subscribeOn(this.scheduler);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/PostEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static run.halo.app.extension.MetadataUtil.nullSafeLabels;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Duration;\nimport java.util.Objects;\nimport java.util.function.Predicate;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerErrorException;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.content.Content;\nimport run.halo.app.content.ContentUpdateParam;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.ListedPost;\nimport run.halo.app.content.ListedSnapshotDto;\nimport run.halo.app.content.PostQuery;\nimport run.halo.app.content.PostRequest;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Endpoint for managing posts.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class PostEndpoint implements CustomEndpoint {\n\n private int maxAttemptsWaitForPublish = 10;\n private final PostService postService;\n private final ReactiveExtensionClient client;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"PostV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"posts\", this::listPost, builder -> {\n builder.operationId(\"ListPosts\")\n .description(\"List posts.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ListedPost.class))\n );\n PostQuery.buildParameters(builder);\n }\n )\n .GET(\"posts/{name}/head-content\", this::fetchHeadContent,\n builder -> builder.operationId(\"fetchPostHeadContent\")\n .description(\"Fetch head content of post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .GET(\"posts/{name}/content\", this::fetchContent,\n builder -> builder.operationId(\"fetchPostContent\")\n .description(\"Fetch content of post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .parameter(parameterBuilder()\n .name(\"snapshotName\")\n .in(ParameterIn.QUERY)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .GET(\"posts/{name}/release-content\", this::fetchReleaseContent,\n builder -> builder.operationId(\"fetchPostReleaseContent\")\n .description(\"Fetch release content of post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .GET(\"posts/{name}/snapshot\", this::listSnapshots,\n builder -> builder.operationId(\"listPostSnapshots\")\n .description(\"List all snapshots for post content.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementationArray(ListedSnapshotDto.class))\n )\n .POST(\"posts\", this::draftPost,\n builder -> builder.operationId(\"DraftPost\")\n .description(\"Draft a post.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(PostRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"posts/{name}\", this::updatePost,\n builder -> builder.operationId(\"UpdateDraftPost\")\n .description(\"Update a post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(PostRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"posts/{name}/content\", this::updateContent,\n builder -> builder.operationId(\"UpdatePostContent\")\n .description(\"Update a post's content.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(Content.class))\n ))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"posts/{name}/revert-content\", this::revertToSpecifiedSnapshot,\n builder -> builder.operationId(\"revertToSpecifiedSnapshotForPost\")\n .description(\"Revert to specified snapshot for post content.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(RevertSnapshotParam.class))\n ))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"posts/{name}/publish\", this::publishPost,\n builder -> builder.operationId(\"PublishPost\")\n .description(\"Publish a post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .parameter(parameterBuilder().name(\"headSnapshot\")\n .description(\"Head snapshot name of content.\")\n .in(ParameterIn.QUERY)\n .required(false))\n .parameter(parameterBuilder()\n .name(\"async\")\n .in(ParameterIn.QUERY)\n .implementation(Boolean.class)\n .required(false))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"posts/{name}/unpublish\", this::unpublishPost,\n builder -> builder.operationId(\"UnpublishPost\")\n .description(\"UnPublish a post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true))\n .response(responseBuilder()\n .implementation(Post.class)))\n .PUT(\"posts/{name}/recycle\", this::recyclePost,\n builder -> builder.operationId(\"RecyclePost\")\n .description(\"Recycle a post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)))\n .DELETE(\"posts/{name}/content\", this::deleteContent,\n builder -> builder.operationId(\"deletePostContent\")\n .description(\"Delete a content for post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .parameter(parameterBuilder()\n .name(\"snapshotName\")\n .in(ParameterIn.QUERY)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .build();\n }\n\n private Mono deleteContent(ServerRequest request) {\n final var postName = request.pathVariable(\"name\");\n final var snapshotName = request.queryParam(\"snapshotName\").orElseThrow();\n return postService.deleteContent(postName, snapshotName)\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n private Mono revertToSpecifiedSnapshot(ServerRequest request) {\n final var postName = request.pathVariable(\"name\");\n return request.bodyToMono(RevertSnapshotParam.class)\n .switchIfEmpty(\n Mono.error(new ServerWebInputException(\"Required request body is missing.\")))\n .flatMap(param -> postService.revertToSpecifiedSnapshot(postName, param.snapshotName))\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n @Schema(name = \"RevertSnapshotForPostParam\")\n record RevertSnapshotParam(\n @Schema(requiredMode = Schema.RequiredMode.REQUIRED, minLength = 1) String snapshotName) {\n }\n\n private Mono fetchContent(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n final var snapshotName = request.queryParam(\"snapshotName\").orElseThrow();\n return client.fetch(Post.class, name)\n .flatMap(post -> {\n var baseSnapshot = post.getSpec().getBaseSnapshot();\n return postService.getContent(snapshotName, baseSnapshot);\n })\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n private Mono listSnapshots(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n var resultFlux = postService.listSnapshots(name);\n return ServerResponse.ok().body(resultFlux, ListedSnapshotDto.class);\n }\n\n private Mono fetchReleaseContent(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return postService.getReleaseContent(name)\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n private Mono fetchHeadContent(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return postService.getHeadContent(name)\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n Mono draftPost(ServerRequest request) {\n return request.bodyToMono(PostRequest.class)\n .flatMap(postService::draftPost)\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n Mono updateContent(ServerRequest request) {\n String postName = request.pathVariable(\"name\");\n return request.bodyToMono(ContentUpdateParam.class)\n .flatMap(content -> Mono.defer(() -> client.fetch(Post.class, postName)\n .flatMap(post -> {\n PostRequest postRequest = new PostRequest(post, content);\n return postService.updatePost(postRequest);\n }))\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(throwable -> throwable instanceof OptimisticLockingFailureException))\n )\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n Mono updatePost(ServerRequest request) {\n return request.bodyToMono(PostRequest.class)\n .flatMap(postService::updatePost)\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n Mono publishPost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n boolean asyncPublish = request.queryParam(\"async\")\n .map(Boolean::parseBoolean)\n .orElse(false);\n\n return Mono.defer(() -> client.get(Post.class, name)\n .doOnNext(post -> {\n var spec = post.getSpec();\n request.queryParam(\"headSnapshot\").ifPresent(spec::setHeadSnapshot);\n spec.setPublish(true);\n if (spec.getHeadSnapshot() == null) {\n spec.setHeadSnapshot(spec.getBaseSnapshot());\n }\n spec.setReleaseSnapshot(spec.getHeadSnapshot());\n })\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException))\n .filter(post -> asyncPublish)\n .switchIfEmpty(Mono.defer(() -> awaitPostPublished(name)))\n .onErrorMap(Exceptions::isRetryExhausted, err -> new ServerErrorException(\n \"Post publishing failed, please try again later.\", err))\n .flatMap(publishResult -> ServerResponse.ok().bodyValue(publishResult));\n }\n\n private Mono awaitPostPublished(String postName) {\n Predicate schedulePublish = post -> {\n var labels = nullSafeLabels(post);\n return BooleanUtils.TRUE.equals(labels.get(Post.SCHEDULING_PUBLISH_LABEL));\n };\n return Mono.defer(() -> client.get(Post.class, postName)\n .filter(post -> {\n var releasedSnapshot = MetadataUtil.nullSafeAnnotations(post)\n .get(Post.LAST_RELEASED_SNAPSHOT_ANNO);\n var expectReleaseSnapshot = post.getSpec().getReleaseSnapshot();\n return Objects.equals(releasedSnapshot, expectReleaseSnapshot)\n || schedulePublish.test(post);\n })\n .switchIfEmpty(Mono.error(\n () -> new IllegalStateException(\"Retry to check post publish status\"))\n ))\n .retryWhen(Retry.backoff(maxAttemptsWaitForPublish, Duration.ofMillis(100))\n .filter(IllegalStateException.class::isInstance)\n );\n }\n\n private Mono unpublishPost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return Mono.defer(() -> client.get(Post.class, name)\n .doOnNext(post -> {\n var spec = post.getSpec();\n spec.setPublish(false);\n })\n .flatMap(client::update))\n .retryWhen(Retry.backoff(3, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException))\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n private Mono recyclePost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return Mono.defer(() -> client.get(Post.class, name)\n .doOnNext(post -> {\n var spec = post.getSpec();\n spec.setDeleted(true);\n })\n .flatMap(client::update))\n .retryWhen(Retry.backoff(3, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException))\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n Mono listPost(ServerRequest request) {\n PostQuery postQuery = new PostQuery(request);\n return postService.listPost(postQuery)\n .flatMap(listedPosts -> ServerResponse.ok().bodyValue(listedPosts));\n }\n\n /**\n * Convenient for testing, to avoid waiting too long for post published when testing.\n */\n void setMaxAttemptsWaitForPublish(int maxAttempts) {\n this.maxAttemptsWaitForPublish = maxAttempts;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/ReplyEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\n\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.comment.ListedReply;\nimport run.halo.app.content.comment.ReplyQuery;\nimport run.halo.app.content.comment.ReplyService;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ListResult;\n\n/**\n * Endpoint for managing {@link Reply}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class ReplyEndpoint implements CustomEndpoint {\n\n private final ReplyService replyService;\n\n public ReplyEndpoint(ReplyService replyService) {\n this.replyService = replyService;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"ReplyV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"replies\", this::listReplies, builder -> {\n builder.operationId(\"ListReplies\")\n .description(\"List replies.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ListedReply.class))\n );\n ReplyQuery.buildParameters(builder);\n }\n )\n .build();\n }\n\n Mono listReplies(ServerRequest request) {\n ReplyQuery replyQuery = new ReplyQuery(request.exchange());\n return replyService.list(replyQuery)\n .flatMap(listedReplies -> ServerResponse.ok().bodyValue(listedReplies));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/SinglePageEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.time.Duration;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport org.thymeleaf.util.StringUtils;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.content.Content;\nimport run.halo.app.content.ContentUpdateParam;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.ListedSinglePage;\nimport run.halo.app.content.ListedSnapshotDto;\nimport run.halo.app.content.SinglePageQuery;\nimport run.halo.app.content.SinglePageRequest;\nimport run.halo.app.content.SinglePageService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Endpoint for managing {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@AllArgsConstructor\npublic class SinglePageEndpoint implements CustomEndpoint {\n\n private final SinglePageService singlePageService;\n private final ReactiveExtensionClient client;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"SinglePageV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"singlepages\", this::listSinglePage, builder -> {\n builder.operationId(\"ListSinglePages\")\n .description(\"List single pages.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ListedSinglePage.class))\n );\n SinglePageQuery.buildParameters(builder);\n }\n )\n .GET(\"singlepages/{name}/head-content\", this::fetchHeadContent,\n builder -> builder.operationId(\"fetchSinglePageHeadContent\")\n .description(\"Fetch head content of single page.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .GET(\"singlepages/{name}/release-content\", this::fetchReleaseContent,\n builder -> builder.operationId(\"fetchSinglePageReleaseContent\")\n .description(\"Fetch release content of single page.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .GET(\"singlepages/{name}/content\", this::fetchContent,\n builder -> builder.operationId(\"fetchSinglePageContent\")\n .description(\"Fetch content of single page.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .parameter(parameterBuilder().name(\"snapshotName\")\n .in(ParameterIn.QUERY)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .GET(\"singlepages/{name}/snapshot\", this::listSnapshots,\n builder -> builder.operationId(\"listSinglePageSnapshots\")\n .description(\"List all snapshots for single page content.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementationArray(ListedSnapshotDto.class))\n )\n .POST(\"singlepages\", this::draftSinglePage,\n builder -> builder.operationId(\"DraftSinglePage\")\n .description(\"Draft a single page.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(SinglePageRequest.class))\n ))\n .response(responseBuilder()\n .implementation(SinglePage.class))\n )\n .PUT(\"singlepages/{name}\", this::updateSinglePage,\n builder -> builder.operationId(\"UpdateDraftSinglePage\")\n .description(\"Update a single page.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(SinglePageRequest.class))\n ))\n .response(responseBuilder()\n .implementation(SinglePage.class))\n )\n .PUT(\"singlepages/{name}/content\", this::updateContent,\n builder -> builder.operationId(\"UpdateSinglePageContent\")\n .description(\"Update a single page's content.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(Content.class))\n ))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"singlepages/{name}/revert-content\", this::revertToSpecifiedSnapshot,\n builder -> builder.operationId(\"revertToSpecifiedSnapshotForSinglePage\")\n .description(\"Revert to specified snapshot for single page content.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(RevertSnapshotParam.class))\n ))\n .response(responseBuilder()\n .implementation(Post.class))\n )\n .PUT(\"singlepages/{name}/publish\", this::publishSinglePage,\n builder -> builder.operationId(\"PublishSinglePage\")\n .description(\"Publish a single page.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(SinglePage.class))\n )\n .DELETE(\"singlepages/{name}/content\", this::deleteContent,\n builder -> builder.operationId(\"deleteSinglePageContent\")\n .description(\"Delete a content for post.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .parameter(parameterBuilder()\n .name(\"snapshotName\")\n .in(ParameterIn.QUERY)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(ContentWrapper.class))\n )\n .build();\n }\n\n private Mono deleteContent(ServerRequest request) {\n final var postName = request.pathVariable(\"name\");\n final var snapshotName = request.queryParam(\"snapshotName\").orElseThrow();\n return singlePageService.deleteContent(postName, snapshotName)\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n private Mono revertToSpecifiedSnapshot(ServerRequest request) {\n final var postName = request.pathVariable(\"name\");\n return request.bodyToMono(RevertSnapshotParam.class)\n .switchIfEmpty(\n Mono.error(new ServerWebInputException(\"Required request body is missing.\")))\n .flatMap(\n param -> singlePageService.revertToSpecifiedSnapshot(postName, param.snapshotName))\n .flatMap(page -> ServerResponse.ok().bodyValue(page));\n }\n\n @Schema(name = \"RevertSnapshotForSingleParam\")\n record RevertSnapshotParam(\n @Schema(requiredMode = Schema.RequiredMode.REQUIRED, minLength = 1) String snapshotName) {\n }\n\n private Mono fetchContent(ServerRequest request) {\n final var snapshotName = request.queryParam(\"snapshotName\").orElseThrow();\n return client.fetch(SinglePage.class, request.pathVariable(\"name\"))\n .flatMap(page -> {\n var baseSnapshot = page.getSpec().getBaseSnapshot();\n return singlePageService.getContent(snapshotName, baseSnapshot);\n })\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n private Mono listSnapshots(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n var resultFlux = singlePageService.listSnapshots(name);\n return ServerResponse.ok().body(resultFlux, ListedSnapshotDto.class);\n }\n\n private Mono fetchReleaseContent(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return singlePageService.getReleaseContent(name)\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n private Mono fetchHeadContent(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return singlePageService.getHeadContent(name)\n .flatMap(content -> ServerResponse.ok().bodyValue(content));\n }\n\n Mono draftSinglePage(ServerRequest request) {\n return request.bodyToMono(SinglePageRequest.class)\n .flatMap(singlePageService::draft)\n .flatMap(singlePage -> ServerResponse.ok().bodyValue(singlePage));\n }\n\n Mono updateContent(ServerRequest request) {\n String pageName = request.pathVariable(\"name\");\n return request.bodyToMono(ContentUpdateParam.class)\n .flatMap(content -> Mono.defer(() -> client.fetch(SinglePage.class, pageName)\n .flatMap(page -> {\n SinglePageRequest pageRequest = new SinglePageRequest(page, content);\n return singlePageService.update(pageRequest);\n }))\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(throwable -> throwable instanceof OptimisticLockingFailureException))\n )\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n Mono updateSinglePage(ServerRequest request) {\n return request.bodyToMono(SinglePageRequest.class)\n .flatMap(singlePageService::update)\n .flatMap(page -> ServerResponse.ok().bodyValue(page));\n }\n\n Mono publishSinglePage(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n boolean asyncPublish = request.queryParam(\"async\")\n .map(Boolean::parseBoolean)\n .orElse(false);\n return Mono.defer(() -> client.get(SinglePage.class, name)\n .flatMap(singlePage -> {\n SinglePage.SinglePageSpec spec = singlePage.getSpec();\n spec.setPublish(true);\n if (spec.getHeadSnapshot() == null) {\n spec.setHeadSnapshot(spec.getBaseSnapshot());\n }\n spec.setReleaseSnapshot(spec.getHeadSnapshot());\n return client.update(singlePage);\n })\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException))\n .flatMap(post -> {\n if (asyncPublish) {\n return Mono.just(post);\n }\n return client.fetch(SinglePage.class, name)\n .flatMap(latest -> {\n var latestReleasedSnapshotName = MetadataUtil.nullSafeAnnotations(latest)\n .get(Post.LAST_RELEASED_SNAPSHOT_ANNO);\n if (!StringUtils.equals(latestReleasedSnapshotName,\n latest.getSpec().getReleaseSnapshot())) {\n return Mono.error(new IllegalStateException(\n \"SinglePage publishing status is not as expected\"\n ));\n }\n return Mono.just(latest);\n })\n .retryWhen(Retry.fixedDelay(10, Duration.ofMillis(100))\n .filter(IllegalStateException.class::isInstance)\n )\n .doOnError(IllegalStateException.class, err -> {\n log.error(\"Failed to publish single page [{}]\", name, err);\n throw new IllegalStateException(\"Publishing wait timeout.\");\n });\n })\n .flatMap(page -> ServerResponse.ok().bodyValue(page));\n }\n\n Mono listSinglePage(ServerRequest request) {\n var listRequest = new SinglePageQuery(request);\n return singlePageService.list(listRequest)\n .flatMap(listedPages -> ServerResponse.ok().bodyValue(listedPages));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/StatsEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport lombok.Data;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Stats endpoint.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class StatsEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n\n public StatsEndpoint(ReactiveExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"SystemV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"stats\", this::getStats, builder -> builder.operationId(\"getStats\")\n .description(\"Get stats.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(DashboardStats.class)\n )\n )\n .build();\n }\n\n Mono getStats(ServerRequest request) {\n var stats = DashboardStats.emptyStats();\n Mono setFromCounters = client.listAll(\n Counter.class, ListOptions.builder().build(), Sort.unsorted()\n )\n .doOnNext(counter -> {\n var visit = counter.getVisit();\n if (visit != null) {\n stats.setVisits(stats.getVisits() + visit);\n }\n var totalComment = counter.getTotalComment();\n if (totalComment != null) {\n stats.setComments(stats.getComments() + totalComment);\n }\n var approvedComment = counter.getApprovedComment();\n if (approvedComment != null) {\n stats.setApprovedComments(\n stats.getApprovedComments() + approvedComment\n );\n }\n var upvote = counter.getUpvote();\n if (upvote != null) {\n stats.setUpvotes(stats.getUpvotes() + upvote);\n }\n })\n .then();\n\n Mono setUsers = client.countBy(User.class, ListOptions.builder()\n .labelSelector()\n .notEq(User.HIDDEN_USER_LABEL, \"true\")\n .end()\n .andQuery(isNull(\"metadata.deletionTimestamp\"))\n .build()\n )\n .doOnNext(stats::setUsers)\n .then();\n Mono setPosts = client.countBy(Post.class, ListOptions.builder()\n .andQuery(and(\n isNull(\"metadata.deletionTimestamp\"),\n equal(\"spec.deleted\", \"false\")\n ))\n .build()\n )\n .doOnNext(stats::setPosts)\n .then();\n\n return Mono.when(setFromCounters, setUsers, setPosts)\n .thenReturn(stats)\n .flatMap(body -> ServerResponse.ok().bodyValue(body));\n }\n\n @Data\n public static class DashboardStats {\n private long visits;\n private long comments;\n private long approvedComments;\n private long upvotes;\n private long users;\n private long posts;\n\n /**\n * Creates an empty stats that populated initialize value.\n *\n * @return stats with initialize value.\n */\n public static DashboardStats emptyStats() {\n DashboardStats stats = new DashboardStats();\n stats.setVisits(0L);\n stats.setComments(0L);\n stats.setApprovedComments(0L);\n stats.setUpvotes(0L);\n stats.setUsers(0L);\n stats.setPosts(0L);\n return stats;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/SystemConfigEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.time.Duration;\nimport java.util.HashMap;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport tools.jackson.databind.json.JsonMapper;\nimport tools.jackson.databind.node.ObjectNode;\n\n@Component\n@RequiredArgsConstructor\npublic class SystemConfigEndpoint implements CustomEndpoint {\n private final SystemConfigFetcher configurableEnvironmentFetcher;\n private final ReactiveExtensionClient client;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"SystemConfigV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"/systemconfigs/{group}\", this::getConfigByGroup,\n builder -> builder.operationId(\"getSystemConfigByGroup\")\n .description(\"Get system config by group\")\n .tag(tag)\n .response(responseBuilder()\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n )\n .implementation(Object.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"group\")\n .required(true)\n .description(\"Group of the system config\")\n )\n )\n .PUT(\"/systemconfigs/{group}\", this::updateConfigByGroup,\n builder -> builder.operationId(\"updateSystemConfigByGroup\")\n .description(\"Update system config by group\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"group\")\n .required(true)\n .description(\"Group of the system config\")\n )\n .requestBody(requestBodyBuilder().implementation(Object.class))\n .response(responseBuilder()\n .responseCode(String.valueOf(HttpStatus.NO_CONTENT))\n .implementation(Void.class)\n )\n )\n .build();\n }\n\n private Mono updateConfigByGroup(ServerRequest request) {\n final var group = request.pathVariable(\"group\");\n return request.bodyToMono(ObjectNode.class)\n .flatMap(objectNode -> configurableEnvironmentFetcher.getConfigMap()\n .flatMap(cm -> {\n if (cm.getData() == null) {\n cm.setData(new HashMap<>());\n }\n cm.getData().put(group, objectNode.toString());\n return client.update(cm);\n })\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n .then(ServerResponse.noContent().build());\n }\n\n private Mono getConfigByGroup(ServerRequest request) {\n final var group = request.pathVariable(\"group\");\n return configurableEnvironmentFetcher.fetch(group, ObjectNode.class)\n .switchIfEmpty(Mono.fromSupplier(JsonMapper.shared()::createObjectNode))\n .flatMap(json -> ServerResponse.ok().bodyValue(json));\n }\n\n @Override\n public GroupVersion groupVersion() {\n return new GroupVersion(\"console.api.halo.run\", \"v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/TagEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.or;\nimport static run.halo.app.extension.router.QueryParamBuildUtil.sortParameter;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Optional;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * post tag endpoint.\n *\n * @author LIlGG\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class TagEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"TagV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"tags\", this::listTag, builder -> {\n builder.operationId(\"ListPostTags\")\n .description(\"List Post Tags.\")\n .tag(tag)\n .response(\n responseBuilder()\n .implementation(ListResult.generateGenericClass(Tag.class))\n );\n TagQuery.buildParameters(builder);\n }\n )\n .build();\n }\n\n Mono listTag(ServerRequest request) {\n var tagQuery = new TagQuery(request);\n return client.listBy(Tag.class, tagQuery.toListOptions(),\n PageRequestImpl.of(tagQuery.getPage(), tagQuery.getSize(), tagQuery.getSort())\n )\n .flatMap(tags -> ServerResponse.ok().bodyValue(tags));\n }\n\n public static class TagQuery extends SortableRequest {\n\n public TagQuery(ServerRequest request) {\n super(request.exchange());\n }\n\n public Optional getKeyword() {\n return Optional.ofNullable(queryParams.getFirst(\"keyword\"))\n .filter(StringUtils::hasText);\n }\n\n @Override\n public ListOptions toListOptions() {\n var builder = ListOptions.builder(super.toListOptions());\n getKeyword().ifPresent(keyword -> builder.andQuery(\n or(\n contains(\"spec.displayName\", keyword),\n contains(\"spec.slug\", keyword)\n )\n ));\n return builder.build();\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(sortParameter())\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .description(\"Post tags filtered by keyword.\")\n .implementation(String.class)\n .required(false));\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/TrackerEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.event.post.DownvotedEvent;\nimport run.halo.app.event.post.UpvotedEvent;\nimport run.halo.app.event.post.VisitedEvent;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * Metrics counter endpoint.\n *\n * @author guqing\n * @since 2.0.0\n */\n@AllArgsConstructor\n@Component\npublic class TrackerEndpoint implements CustomEndpoint {\n\n private final ApplicationEventPublisher eventPublisher;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"MetricsV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .POST(\"trackers/counter\", this::increaseVisit,\n builder -> builder.operationId(\"count\")\n .description(\"Count an extension resource visits.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(CounterRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Void.class))\n )\n .POST(\"trackers/upvote\", this::upvote,\n builder -> builder.operationId(\"upvote\")\n .description(\"Upvote an extension resource.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(VoteRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Void.class))\n )\n .POST(\"trackers/downvote\", this::downvote,\n builder -> builder.operationId(\"downvote\")\n .description(\"Downvote an extension resource.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(VoteRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Void.class))\n )\n .build();\n }\n\n private Mono increaseVisit(ServerRequest request) {\n return request.bodyToMono(CounterRequest.class)\n .switchIfEmpty(\n Mono.error(new IllegalArgumentException(\"Counter request body must not be empty\")))\n .doOnNext(counterRequest -> {\n eventPublisher.publishEvent(new VisitedEvent(this, counterRequest.group(),\n counterRequest.name(), counterRequest.plural()));\n })\n .then(ServerResponse.ok().build());\n }\n\n private Mono upvote(ServerRequest request) {\n return request.bodyToMono(VoteRequest.class)\n .switchIfEmpty(\n Mono.error(new IllegalArgumentException(\"Upvote request body must not be empty\")))\n .doOnNext(voteRequest -> {\n eventPublisher.publishEvent(new UpvotedEvent(this, voteRequest.group(),\n voteRequest.name(), voteRequest.plural()));\n })\n .then(ServerResponse.ok().build());\n }\n\n private Mono downvote(ServerRequest request) {\n return request.bodyToMono(VoteRequest.class)\n .switchIfEmpty(\n Mono.error(new IllegalArgumentException(\"Downvote request body must not be empty\")))\n .doOnNext(voteRequest -> {\n eventPublisher.publishEvent(new DownvotedEvent(this, voteRequest.group(),\n voteRequest.name(), voteRequest.plural()));\n })\n .then(ServerResponse.ok().build());\n }\n\n public record VoteRequest(String group, String plural, String name) {\n }\n\n public record CounterRequest(String group, String plural, String name, String hostname,\n String screen, String language, String referrer) {\n /**\n * Construct counter request.\n * group and session uid can be empty.\n */\n public CounterRequest {\n Assert.notNull(plural, \"The plural must not be null.\");\n Assert.notNull(name, \"The name must not be null.\");\n group = StringUtils.defaultString(group);\n }\n }\n\n @Override\n public GroupVersion groupVersion() {\n return new GroupVersion(\"api.halo.run\", \"v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/console/UserEndpoint.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static org.apache.commons.lang3.StringUtils.defaultIfBlank;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static run.halo.app.extension.ListResult.generateGenericClass;\nimport static run.halo.app.extension.index.query.Queries.contains;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.in;\nimport static run.halo.app.extension.index.query.Queries.or;\nimport static run.halo.app.extension.router.selector.SelectorUtil.labelAndFieldSelectorToListOptions;\nimport static run.halo.app.security.authorization.AuthorityUtils.authoritiesToRoles;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport com.google.common.io.Files;\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport io.github.resilience4j.ratelimiter.RequestNotPermitted;\nimport io.github.resilience4j.reactor.ratelimiter.operator.RateLimiterOperator;\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport jakarta.validation.constraints.Email;\nimport jakarta.validation.constraints.NotBlank;\nimport java.security.Principal;\nimport java.time.Duration;\nimport java.util.Arrays;\nimport java.util.Collection;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport java.util.LinkedHashSet;\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.UUID;\nimport java.util.concurrent.atomic.AtomicInteger;\nimport java.util.stream.Collectors;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.http.codec.multipart.Part;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.util.unit.DataSize;\nimport org.springframework.validation.Validator;\nimport org.springframework.web.reactive.function.BodyExtractors;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.core.user.service.EmailVerificationService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.SortableRequest;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemSetting.Attachment.UploadOptions;\nimport run.halo.app.infra.ValidationUtils;\nimport run.halo.app.infra.exception.RateLimitExceededException;\nimport run.halo.app.infra.exception.RestrictedNameException;\nimport run.halo.app.infra.exception.UnsatisfiedAttributeValueException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@Component\n@RequiredArgsConstructor\npublic class UserEndpoint implements CustomEndpoint {\n\n private static final String SELF_USER = \"-\";\n private static final String USER_AVATAR_GROUP_NAME = \"user-avatar-group\";\n private static final String DEFAULT_USER_AVATAR_ATTACHMENT_POLICY_NAME = \"default-policy\";\n private static final DataSize MAX_AVATAR_FILE_SIZE = DataSize.ofMegabytes(2L);\n private final ReactiveExtensionClient client;\n private final UserService userService;\n private final RoleService roleService;\n private final AttachmentService attachmentService;\n private final EmailVerificationService emailVerificationService;\n private final RateLimiterRegistry rateLimiterRegistry;\n private final SystemConfigFetcher environmentFetcher;\n private final Validator validator;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"UserV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"/users/-\", this::me, builder -> builder.operationId(\"GetCurrentUserDetail\")\n .description(\"Get current user detail\")\n .tag(tag)\n .response(responseBuilder().implementation(DetailedUser.class)))\n .GET(\"/users/{name}\", this::getUserByName,\n builder -> builder.operationId(\"GetUserDetail\")\n .description(\"Get user detail by name\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"User name\")\n .required(true)\n )\n .response(responseBuilder().implementation(DetailedUser.class)))\n .PUT(\"/users/-\", this::updateProfile,\n builder -> builder.operationId(\"UpdateCurrentUser\")\n .description(\"Update current user profile, but password.\")\n .tag(tag)\n .requestBody(requestBodyBuilder().required(true).implementation(User.class))\n .response(responseBuilder().implementation(User.class)))\n .POST(\"/users/{name}/permissions\", this::grantPermission,\n builder -> builder.operationId(\"GrantPermission\")\n .description(\"Grant permissions to user\")\n .tag(tag)\n .parameter(parameterBuilder().in(ParameterIn.PATH).name(\"name\")\n .description(\"User name\")\n .required(true))\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(GrantRequest.class))\n .response(responseBuilder().implementation(User.class)))\n .POST(\"/users\", this::createUser,\n builder -> builder.operationId(\"CreateUser\")\n .description(\"Creates a new user.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(CreateUserRequest.class))\n .response(responseBuilder().implementation(User.class)))\n .GET(\"/users/{name}/permissions\", this::getUserPermission,\n builder -> builder.operationId(\"GetPermissions\")\n .description(\"Get permissions of user\")\n .tag(tag)\n .parameter(parameterBuilder().in(ParameterIn.PATH).name(\"name\")\n .description(\"User name\")\n .required(true))\n .response(responseBuilder().implementation(UserPermission.class)))\n .PUT(\"/users/-/password\", this::changeOwnPassword,\n builder -> builder.operationId(\"ChangeOwnPassword\")\n .description(\"Change own password of user.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(ChangeOwnPasswordRequest.class))\n .response(responseBuilder()\n .implementation(User.class))\n )\n .PUT(\"/users/{name}/password\", this::changeAnyonePasswordForAdmin,\n builder -> builder.operationId(\"ChangeAnyonePassword\")\n .description(\"Change anyone password of user for admin.\")\n .tag(tag)\n .parameter(parameterBuilder().in(ParameterIn.PATH).name(\"name\")\n .description(\n \"Name of user. If the name is equal to '-', it will change the \"\n + \"password of current user.\")\n .required(true))\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(ChangePasswordRequest.class))\n .response(responseBuilder()\n .implementation(User.class))\n )\n .GET(\"users\", this::list, builder -> {\n builder.operationId(\"ListUsers\")\n .tag(tag)\n .description(\"List users\")\n .response(responseBuilder()\n .implementation(generateGenericClass(ListedUser.class)));\n ListRequest.buildParameters(builder);\n })\n .POST(\"users/{name}/avatar\", contentType(MediaType.MULTIPART_FORM_DATA),\n this::uploadUserAvatar,\n builder -> builder\n .operationId(\"UploadUserAvatar\")\n .description(\"upload user avatar\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"User name\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(IAvatarUploadRequest.class))\n ))\n .response(responseBuilder().implementation(User.class))\n )\n .DELETE(\"users/{name}/avatar\", this::deleteUserAvatar, builder -> builder\n .tag(tag)\n .operationId(\"DeleteUserAvatar\")\n .description(\"delete user avatar\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"User name\")\n .required(true)\n )\n .response(responseBuilder().implementation(User.class))\n .build())\n .POST(\"users/-/send-email-verification-code\",\n this::sendEmailVerificationCode,\n builder -> builder\n .tag(tag)\n .operationId(\"SendEmailVerificationCode\")\n .requestBody(requestBodyBuilder()\n .implementation(EmailVerifyRequest.class)\n .required(true)\n )\n .description(\"Send email verification code for user\")\n .response(responseBuilder().implementation(Void.class))\n .build()\n )\n .POST(\"users/-/verify-email\", this::verifyEmail,\n builder -> builder\n .tag(tag)\n .operationId(\"VerifyEmail\")\n .description(\"Verify email for user by code.\")\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(VerifyCodeRequest.class))\n .response(responseBuilder().implementation(Void.class))\n .build()\n )\n .build();\n }\n\n private Mono verifyEmail(ServerRequest request) {\n return request.bodyToMono(VerifyCodeRequest.class)\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"Request body is required.\"))\n )\n .flatMap(this::doVerifyCode)\n .then(ServerResponse.ok().build());\n }\n\n private Mono doVerifyCode(VerifyCodeRequest verifyCodeRequest) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName)\n .flatMap(username -> verifyPasswordAndCode(username, verifyCodeRequest));\n }\n\n private Mono verifyPasswordAndCode(String username, VerifyCodeRequest verifyCodeRequest) {\n return userService.confirmPassword(username, verifyCodeRequest.password())\n .filter(Boolean::booleanValue)\n .switchIfEmpty(Mono.error(new UnsatisfiedAttributeValueException(\n \"Password is incorrect.\", \"problemDetail.user.password.notMatch\", null)))\n .flatMap(verified -> verifyEmailCode(username, verifyCodeRequest.code()));\n }\n\n private Mono verifyEmailCode(String username, String code) {\n return Mono.just(username)\n .transformDeferred(verificationEmailRateLimiter(username))\n .flatMap(name -> emailVerificationService.verify(username, code))\n .onErrorMap(RequestNotPermitted.class, RateLimitExceededException::new);\n }\n\n public record EmailVerifyRequest(\n @Schema(requiredMode = REQUIRED)\n @Email\n @NotBlank\n String email) {\n }\n\n public record VerifyCodeRequest(\n @Schema(requiredMode = REQUIRED) String password,\n @Schema(requiredMode = REQUIRED, minLength = 1) String code) {\n }\n\n private Mono sendEmailVerificationCode(ServerRequest request) {\n var emailMono = request.bodyToMono(EmailVerifyRequest.class)\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"Request body is required.\"))\n )\n .doOnNext(emailReq -> {\n var bindingResult =\n ValidationUtils.validate(emailReq, validator, request.exchange());\n if (bindingResult.hasErrors()) {\n // only email field is validated\n throw new ServerWebInputException(\"validation.error.email.pattern\");\n }\n })\n .map(EmailVerifyRequest::email)\n .map(String::toLowerCase);\n return Mono.zip(emailMono, getAuthenticatedUserName())\n .flatMap(tuple -> {\n var email = tuple.getT1();\n var username = tuple.getT2();\n return Mono.just(username)\n .transformDeferred(sendEmailVerificationCodeRateLimiter(username, email))\n .flatMap(u -> emailVerificationService.sendVerificationCode(username, email))\n .onErrorMap(RequestNotPermitted.class, RateLimitExceededException::new);\n })\n .then(ServerResponse.ok().build());\n }\n\n RateLimiterOperator verificationEmailRateLimiter(String username) {\n String rateLimiterKey = \"verify-email-\" + username;\n var rateLimiter =\n rateLimiterRegistry.rateLimiter(rateLimiterKey, \"verify-email\");\n return RateLimiterOperator.of(rateLimiter);\n }\n\n RateLimiterOperator sendEmailVerificationCodeRateLimiter(String username, String email) {\n String rateLimiterKey = \"send-email-verification-code-\" + username + \":\" + email;\n var rateLimiter =\n rateLimiterRegistry.rateLimiter(rateLimiterKey, \"send-email-verification-code\");\n return RateLimiterOperator.of(rateLimiter);\n }\n\n private Mono deleteUserAvatar(ServerRequest request) {\n final var nameInPath = request.pathVariable(\"name\");\n return getUserOrSelf(nameInPath)\n .flatMap(user -> {\n MetadataUtil.nullSafeAnnotations(user)\n .remove(User.AVATAR_ATTACHMENT_NAME_ANNO);\n user.getSpec().setAvatar(null);\n return client.update(user);\n })\n .flatMap(user -> ServerResponse.ok().bodyValue(user));\n }\n\n private Mono getUserOrSelf(String name) {\n if (!SELF_USER.equals(name)) {\n return client.get(User.class, name);\n }\n return getAuthenticatedUserName()\n .flatMap(currentUserName -> client.get(User.class, currentUserName));\n }\n\n private Mono uploadUserAvatar(ServerRequest request) {\n final var username = request.pathVariable(\"name\");\n return request.body(BodyExtractors.toMultipartData())\n .map(AvatarUploadRequest::new)\n .flatMap(this::uploadAvatar)\n .flatMap(attachment -> getUserOrSelf(username)\n .flatMap(user -> {\n MetadataUtil.nullSafeAnnotations(user)\n .put(User.AVATAR_ATTACHMENT_NAME_ANNO,\n attachment.getMetadata().getName());\n return client.update(user);\n })\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n )\n .flatMap(user -> ServerResponse.ok().bodyValue(user));\n }\n\n @Schema(types = \"object\")\n public interface IAvatarUploadRequest {\n @Schema(requiredMode = REQUIRED, description = \"Avatar file\")\n FilePart getFile();\n }\n\n public record AvatarUploadRequest(MultiValueMap formData) {\n public FilePart getFile() {\n Part file = formData.getFirst(\"file\");\n if (file == null) {\n throw new ServerWebInputException(\"No file part found in the request\");\n }\n\n if (!(file instanceof FilePart filePart)) {\n throw new ServerWebInputException(\"Invalid part of file\");\n }\n\n if (!filePart.filename().endsWith(\".png\")) {\n throw new ServerWebInputException(\"Only support avatar in PNG format\");\n }\n return filePart;\n }\n }\n\n private Mono uploadAvatar(AvatarUploadRequest uploadRequest) {\n var fallbackSetting =\n environmentFetcher.fetch(SystemSetting.User.GROUP, SystemSetting.User.class)\n .mapNotNull(SystemSetting.User::getAvatarPolicy)\n .filter(StringUtils::isNotBlank);\n var getAvatarPolicy = environmentFetcher.fetch(\n SystemSetting.Attachment.GROUP, SystemSetting.Attachment.class\n )\n .mapNotNull(SystemSetting.Attachment::avatar)\n .mapNotNull(UploadOptions::policyName)\n .filter(StringUtils::isNotBlank)\n .switchIfEmpty(fallbackSetting)\n .defaultIfEmpty(DEFAULT_USER_AVATAR_ATTACHMENT_POLICY_NAME);\n return getAvatarPolicy.flatMap(avatarPolicy -> {\n FilePart filePart = uploadRequest.getFile();\n var ext = Files.getFileExtension(filePart.filename());\n return attachmentService.upload(avatarPolicy,\n USER_AVATAR_GROUP_NAME,\n UUID.randomUUID() + \".\" + ext,\n maxSizeCheck(filePart.content()),\n filePart.headers().getContentType()\n );\n });\n }\n\n private Flux maxSizeCheck(Flux content) {\n var lenRef = new AtomicInteger(0);\n return content.doOnNext(dataBuffer -> {\n int len = lenRef.accumulateAndGet(dataBuffer.readableByteCount(), Integer::sum);\n if (len > MAX_AVATAR_FILE_SIZE.toBytes()) {\n throw new ServerWebInputException(\"The avatar file needs to be smaller than \"\n + MAX_AVATAR_FILE_SIZE.toMegabytes() + \" MB.\");\n }\n });\n }\n\n private Mono createUser(ServerRequest request) {\n return request.bodyToMono(CreateUserRequest.class)\n .doOnNext(createUserRequest -> {\n if (StringUtils.isBlank(createUserRequest.name())) {\n throw new ServerWebInputException(\"Name is required\");\n }\n if (StringUtils.isBlank(createUserRequest.email())) {\n throw new ServerWebInputException(\"Email is required\");\n }\n })\n .flatMap(userRequest -> {\n User newUser = CreateUserRequest.from(userRequest);\n var encryptedPwd = userService.encryptPassword(userRequest.password());\n newUser.getSpec().setPassword(encryptedPwd);\n return userService.createUser(newUser, userRequest.roles());\n })\n .flatMap(user -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(user)\n );\n }\n\n private Mono getUserByName(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return userService.getUser(name)\n .flatMap(user -> roleService.getRolesByUsername(name)\n .collectList()\n .flatMap(roleNames -> roleService.list(new HashSet<>(roleNames), true)\n .collectList()\n .map(roles -> new DetailedUser(user, roles))\n )\n )\n .flatMap(detailedUser -> ServerResponse.ok().bodyValue(detailedUser));\n }\n\n record CreateUserRequest(@Schema(requiredMode = REQUIRED) String name,\n @Schema(requiredMode = REQUIRED) String email,\n String displayName,\n String avatar,\n String phone,\n String password,\n String bio,\n Map annotations,\n Set roles) {\n\n /**\n *

Creates a new user from {@link CreateUserRequest}.

\n * Note: this method will not set password.\n *\n * @param userRequest user request\n * @return user from request\n */\n public static User from(CreateUserRequest userRequest) {\n var user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(userRequest.name());\n user.getMetadata().setAnnotations(new HashMap<>());\n Map annotations =\n defaultIfNull(userRequest.annotations(), Map.of());\n user.getMetadata().getAnnotations().putAll(annotations);\n\n var spec = new User.UserSpec();\n user.setSpec(spec);\n spec.setEmail(userRequest.email());\n spec.setDisplayName(defaultIfBlank(userRequest.displayName(), userRequest.name()));\n spec.setAvatar(userRequest.avatar());\n spec.setPhone(userRequest.phone());\n spec.setBio(userRequest.bio());\n return user;\n }\n }\n\n private Mono updateProfile(ServerRequest request) {\n return getAuthenticatedUserName()\n .flatMap(currentUserName -> client.get(User.class, currentUserName))\n .flatMap(currentUser -> request.bodyToMono(User.class)\n .filter(user -> user.getMetadata() != null\n && Objects.equals(user.getMetadata().getName(),\n currentUser.getMetadata().getName())\n )\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Username didn't match.\")))\n .flatMap(user -> {\n var newDisplayName = user.getSpec().getDisplayName();\n var oldDisplayName = currentUser.getSpec().getDisplayName();\n return Mono.just(user)\n .filterWhen(u -> {\n if (Objects.equals(oldDisplayName, newDisplayName)) {\n return Mono.just(true);\n }\n return environmentFetcher.fetch(SystemSetting.User.GROUP,\n SystemSetting.User.class)\n .map(setting -> isDisplayNameAllowed(setting, newDisplayName))\n .defaultIfEmpty(false);\n })\n .switchIfEmpty(Mono.defer(() -> Mono.error(new RestrictedNameException(\n \"The display name is restricted.\",\n \"problemDetail.user.displayName.restricted\",\n new Object[] {newDisplayName}\n ))));\n })\n .map(user -> {\n Map oldAnnotations =\n MetadataUtil.nullSafeAnnotations(currentUser);\n Map newAnnotations = user.getMetadata().getAnnotations();\n if (!CollectionUtils.isEmpty(newAnnotations)) {\n newAnnotations.put(User.LAST_AVATAR_ATTACHMENT_NAME_ANNO,\n oldAnnotations.get(User.LAST_AVATAR_ATTACHMENT_NAME_ANNO));\n newAnnotations.put(User.AVATAR_ATTACHMENT_NAME_ANNO,\n oldAnnotations.get(User.AVATAR_ATTACHMENT_NAME_ANNO));\n newAnnotations.put(User.EMAIL_TO_VERIFY,\n oldAnnotations.get(User.EMAIL_TO_VERIFY));\n currentUser.getMetadata().setAnnotations(newAnnotations);\n }\n var spec = currentUser.getSpec();\n var newSpec = user.getSpec();\n spec.setBio(newSpec.getBio());\n spec.setDisplayName(newSpec.getDisplayName());\n spec.setTwoFactorAuthEnabled(newSpec.getTwoFactorAuthEnabled());\n spec.setPhone(newSpec.getPhone());\n return currentUser;\n })\n )\n .flatMap(client::update)\n .flatMap(updatedUser -> ServerResponse.ok().bodyValue(updatedUser));\n }\n\n private static Mono getAuthenticatedUserName() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName);\n }\n\n Mono changeAnyonePasswordForAdmin(ServerRequest request) {\n final var nameInPath = request.pathVariable(\"name\");\n return ReactiveSecurityContextHolder.getContext()\n .map(ctx -> SELF_USER.equals(nameInPath) ? ctx.getAuthentication().getName()\n : nameInPath)\n .flatMap(username -> request.bodyToMono(ChangePasswordRequest.class)\n .switchIfEmpty(Mono.defer(() ->\n Mono.error(new ServerWebInputException(\"Request body is empty\"))))\n .flatMap(changePasswordRequest -> {\n var password = changePasswordRequest.password();\n // encode password\n return userService.updateWithRawPassword(username, password);\n }))\n .flatMap(updatedUser -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(updatedUser));\n }\n\n Mono changeOwnPassword(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(ctx -> ctx.getAuthentication().getName())\n .flatMap(username -> request.bodyToMono(ChangeOwnPasswordRequest.class)\n .switchIfEmpty(Mono.defer(() ->\n Mono.error(new ServerWebInputException(\"Request body is empty\"))))\n .flatMap(changePasswordRequest -> {\n var rawOldPassword = changePasswordRequest.oldPassword();\n return userService.confirmPassword(username, rawOldPassword)\n .filter(Boolean::booleanValue)\n .switchIfEmpty(Mono.error(new UnsatisfiedAttributeValueException(\n \"Old password is incorrect.\",\n \"problemDetail.user.oldPassword.notMatch\",\n null))\n )\n .thenReturn(changePasswordRequest);\n })\n .flatMap(changePasswordRequest -> {\n var password = changePasswordRequest.password();\n // encode password\n return userService.updateWithRawPassword(username, password);\n }))\n .flatMap(updatedUser -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(updatedUser));\n }\n\n record ChangeOwnPasswordRequest(\n @Schema(description = \"Old password.\", requiredMode = REQUIRED)\n String oldPassword,\n @Schema(description = \"New password.\", requiredMode = REQUIRED, minLength = 5)\n String password) {\n\n public ChangeOwnPasswordRequest {\n if (password == null || password.length() < 5 || password.length() > 257) {\n throw new UnsatisfiedAttributeValueException(\n \"password is required.\",\n \"validation.error.password.size\",\n new Object[] {5, 257});\n }\n }\n }\n\n record ChangePasswordRequest(\n @Schema(description = \"New password.\", requiredMode = REQUIRED, minLength = 5)\n String password) {\n }\n\n @NonNull\n Mono me(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(Authentication::isAuthenticated)\n .flatMap(auth -> userService.getUser(auth.getName())\n .flatMap(user -> {\n var roleNames = authoritiesToRoles(auth.getAuthorities());\n return roleService.list(roleNames, true)\n .collectList()\n .map(roles -> new DetailedUser(user, roles));\n })\n )\n .flatMap(detailedUser -> ServerResponse.ok().bodyValue(detailedUser));\n }\n\n record DetailedUser(@Schema(requiredMode = REQUIRED) User user,\n @Schema(requiredMode = REQUIRED) List roles) {\n\n }\n\n @NonNull\n Mono grantPermission(ServerRequest request) {\n var username = request.pathVariable(\"name\");\n return request.bodyToMono(GrantRequest.class)\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Request body is empty\")))\n .flatMap(grantRequest -> userService.grantRoles(username, grantRequest.roles())\n .then(ServerResponse.ok().build()));\n }\n\n record GrantRequest(Set roles) {\n }\n\n @NonNull\n private Mono getUserPermission(ServerRequest request) {\n var username = request.pathVariable(\"name\");\n return Mono.defer(() -> {\n if (SELF_USER.equals(username)) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(auth -> authoritiesToRoles(auth.getAuthorities()));\n }\n return roleService.getRolesByUsername(username)\n .collect(Collectors.toCollection(LinkedHashSet::new));\n }).flatMap(roleNames -> {\n var up = new UserPermission();\n var setRoles = roleService.list(roleNames, true)\n .distinct()\n .collectSortedList()\n .doOnNext(up::setRoles);\n var setPerms = roleService.listPermissions(roleNames)\n .distinct()\n .collectSortedList()\n .doOnNext(permissions -> {\n up.setPermissions(permissions);\n up.setUiPermissions(uiPermissions(permissions));\n });\n return Mono.when(setRoles, setPerms).thenReturn(up);\n }).flatMap(userPermission -> ServerResponse.ok().bodyValue(userPermission));\n }\n\n private List uiPermissions(Collection roles) {\n if (CollectionUtils.isEmpty(roles)) {\n return List.of();\n }\n var uiPerms = new LinkedList();\n roles.forEach(role -> Optional.ofNullable(role.getMetadata().getAnnotations())\n .map(annotations -> annotations.get(Role.UI_PERMISSIONS_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(json -> JsonUtils.jsonToObject(json, new TypeReference>() {\n }))\n .ifPresent(uiPerms::addAll)\n );\n return uiPerms.stream().distinct().sorted().toList();\n }\n\n @Data\n public static class UserPermission {\n @Schema(requiredMode = REQUIRED)\n private List roles;\n\n @Schema(requiredMode = REQUIRED)\n private List permissions;\n\n @Schema(requiredMode = REQUIRED)\n private List uiPermissions;\n\n }\n\n public static class ListRequest extends SortableRequest {\n\n public ListRequest(ServerRequest request) {\n super(request.exchange());\n }\n\n @Schema(name = \"keyword\")\n public String getKeyword() {\n return queryParams.getFirst(\"keyword\");\n }\n\n @Schema(name = \"role\")\n public String getRole() {\n return queryParams.getFirst(\"role\");\n }\n\n /**\n * Converts query parameters to list options.\n */\n public ListOptions toListOptions() {\n var defaultListOptions =\n labelAndFieldSelectorToListOptions(getLabelSelector(), getFieldSelector());\n\n var builder = ListOptions.builder(defaultListOptions);\n\n Optional.ofNullable(getKeyword())\n .filter(StringUtils::isNotBlank)\n .ifPresent(keyword -> builder.andQuery(or(\n equal(\"spec.email\", keyword),\n contains(\"spec.displayName\", keyword),\n equal(\"metadata.name\", keyword)\n )));\n\n Optional.ofNullable(getRole())\n .filter(StringUtils::isNotBlank)\n .ifPresent(role -> builder.andQuery(in(User.USER_RELATED_ROLES_INDEX, role)));\n\n return builder.build();\n }\n\n public static void buildParameters(Builder builder) {\n SortableRequest.buildParameters(builder);\n builder.parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"keyword\")\n .description(\"Keyword to search\")\n .implementation(String.class)\n .required(false))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"role\")\n .description(\"Role name\")\n .implementation(String.class)\n .required(false));\n }\n\n }\n\n record ListedUser(@Schema(requiredMode = REQUIRED) User user,\n @Schema(requiredMode = REQUIRED) List roles) {\n }\n\n Mono list(ServerRequest request) {\n return Mono.just(request)\n .map(UserEndpoint.ListRequest::new)\n .flatMap(listRequest -> client.listBy(User.class, listRequest.toListOptions(),\n PageRequestImpl.of(\n listRequest.getPage(), listRequest.getSize(), listRequest.getSort()\n )\n ))\n .flatMap(this::toListedUser)\n .flatMap(listResult -> ServerResponse.ok().bodyValue(listResult));\n }\n\n private Mono> toListedUser(ListResult listResult) {\n var usernames = listResult.getItems().stream()\n .map(user -> user.getMetadata().getName())\n .collect(Collectors.toList());\n return roleService.getRolesByUsernames(usernames)\n .flatMap(usernameRolesMap -> {\n var allRoleNames = new HashSet();\n usernameRolesMap.values().forEach(allRoleNames::addAll);\n return roleService.list(allRoleNames)\n .collectMap(role -> role.getMetadata().getName())\n .map(roleMap -> {\n var listedUsers = listResult.getItems().stream()\n .map(user -> {\n var username = user.getMetadata().getName();\n var roles = Optional.ofNullable(usernameRolesMap.get(username))\n .map(roleNames -> roleNames.stream()\n .map(roleMap::get)\n .filter(Objects::nonNull)\n .toList()\n )\n .orElseGet(List::of);\n return new ListedUser(user, roles);\n })\n .toList();\n return convertFrom(listResult, listedUsers);\n });\n });\n }\n\n ListResult convertFrom(ListResult listResult, List items) {\n Assert.notNull(listResult, \"listResult must not be null\");\n Assert.notNull(items, \"items must not be null\");\n return new ListResult<>(listResult.getPage(), listResult.getSize(),\n listResult.getTotal(), items);\n }\n\n private boolean isDisplayNameAllowed(SystemSetting.User setting, String displayName) {\n String protectedUsernamesStr = setting.getProtectedUsernames();\n if (protectedUsernamesStr == null || protectedUsernamesStr.trim().isEmpty()) {\n return true;\n }\n Set protectedLowerSet = Arrays.stream(protectedUsernamesStr.split(\",\"))\n .map(String::trim)\n .filter(n -> !n.isEmpty())\n .map(String::toLowerCase)\n .collect(Collectors.toUnmodifiableSet());\n return !protectedLowerSet.contains(displayName.trim().toLowerCase());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/CategoryQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.core.endpoint.theme.PublicApiUtils.toAnotherListResult;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.SortableRequest;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.vo.CategoryVo;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\n\n/**\n * Endpoint for category query APIs.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class CategoryQueryEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n private final PostPublicQueryService postPublicQueryService;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"CategoryV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"categories\", this::listCategories,\n builder -> {\n builder.operationId(\"queryCategories\")\n .description(\"Lists categories.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(CategoryVo.class))\n );\n CategoryPublicQuery.buildParameters(builder);\n }\n )\n .GET(\"categories/{name}\", this::getByName,\n builder -> builder.operationId(\"queryCategoryByName\")\n .description(\"Gets category by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Category name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(CategoryVo.class)\n )\n )\n .GET(\"categories/{name}/posts\", this::listPostsByCategoryName,\n builder -> {\n builder.operationId(\"queryPostsByCategoryName\")\n .description(\"Lists posts by category name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Category name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ListedPostVo.class))\n );\n PostPublicQuery.buildParameters(builder);\n }\n )\n .build();\n }\n\n private Mono listPostsByCategoryName(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n final var query = new PostPublicQuery(request.exchange());\n var listOptions = query.toListOptions();\n var newFieldSelector = listOptions.getFieldSelector()\n .andQuery(Queries.equal(\"spec.categories\", name));\n listOptions.setFieldSelector(newFieldSelector);\n return postPublicQueryService.list(listOptions, query.toPageRequest())\n .flatMap(result -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n private Mono getByName(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return client.get(Category.class, name)\n .map(CategoryVo::from)\n .flatMap(categoryVo -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(categoryVo)\n );\n }\n\n private Mono listCategories(ServerRequest request) {\n CategoryPublicQuery query = new CategoryPublicQuery(request.exchange());\n return client.listBy(Category.class, query.toListOptions(), query.toPageRequest())\n .map(listResult -> toAnotherListResult(listResult, CategoryVo::from))\n .flatMap(result -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n public static class CategoryPublicQuery extends SortableRequest {\n public CategoryPublicQuery(ServerWebExchange exchange) {\n super(exchange);\n }\n\n public static void buildParameters(Builder builder) {\n SortableRequest.buildParameters(builder);\n }\n }\n\n @Override\n public GroupVersion groupVersion() {\n return PublicApiUtils.groupVersion(new Category());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/CommentFinderEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.apache.commons.lang3.BooleanUtils.isFalse;\nimport static org.apache.commons.lang3.BooleanUtils.isTrue;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static run.halo.app.extension.router.QueryParamBuildUtil.sortParameter;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport io.github.resilience4j.ratelimiter.RequestNotPermitted;\nimport io.github.resilience4j.reactor.ratelimiter.operator.RateLimiterOperator;\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.ArraySchema;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.List;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.content.comment.CommentRequest;\nimport run.halo.app.content.comment.CommentService;\nimport run.halo.app.content.comment.ReplyRequest;\nimport run.halo.app.content.comment.ReplyService;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.extension.endpoint.SortResolver;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.exception.AccessDeniedException;\nimport run.halo.app.infra.exception.RateLimitExceededException;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.IpAddressUtils;\nimport run.halo.app.theme.finders.CommentFinder;\nimport run.halo.app.theme.finders.CommentPublicQueryService;\nimport run.halo.app.theme.finders.vo.CommentVo;\nimport run.halo.app.theme.finders.vo.CommentWithReplyVo;\nimport run.halo.app.theme.finders.vo.ReplyVo;\n\n/**\n * Endpoint for {@link CommentFinder}.\n */\n@Component\n@RequiredArgsConstructor\npublic class CommentFinderEndpoint implements CustomEndpoint {\n\n private final CommentPublicQueryService commentPublicQueryService;\n private final CommentService commentService;\n private final ReplyService replyService;\n private final SystemConfigFetcher environmentFetcher;\n private final RateLimiterRegistry rateLimiterRegistry;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"CommentV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .POST(\"comments\", this::createComment,\n builder -> builder.operationId(\"CreateComment_1\")\n .description(\"Create a comment.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(CommentRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Comment.class))\n )\n .POST(\"comments/{name}/reply\", this::createReply,\n builder -> builder.operationId(\"CreateReply_1\")\n .description(\"Create a reply.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(ReplyRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Reply.class))\n )\n .GET(\"comments\", this::listComments, builder -> {\n builder.operationId(\"ListComments_1\")\n .description(\"List comments.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(CommentWithReplyVo.class))\n );\n CommentQuery.buildParameters(builder);\n })\n .GET(\"comments/{name}\", this::getComment, builder -> {\n builder.operationId(\"GetComment\")\n .description(\"Get a comment.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(CommentVo.class))\n );\n })\n .GET(\"comments/{name}/reply\", this::listCommentReplies, builder -> {\n builder.operationId(\"ListCommentReplies\")\n .description(\"List comment replies.\")\n .tag(tag)\n .parameter(parameterBuilder().name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class))\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ReplyVo.class))\n );\n PageableRequest.buildParameters(builder);\n })\n .build();\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"api.halo.run/v1alpha1\");\n }\n\n Mono createComment(ServerRequest request) {\n return request.bodyToMono(CommentRequest.class)\n .flatMap(commentRequest -> {\n Comment comment = commentRequest.toComment();\n comment.getSpec().setIpAddress(IpAddressUtils.getIpAddress(request));\n comment.getSpec().setUserAgent(HaloUtils.userAgentFrom(request));\n return commentService.create(comment);\n })\n .flatMap(comment -> ServerResponse.ok().bodyValue(comment))\n .transformDeferred(createIpBasedRateLimiter(request))\n .onErrorMap(RequestNotPermitted.class, RateLimitExceededException::new);\n }\n\n private RateLimiterOperator createIpBasedRateLimiter(ServerRequest request) {\n var clientIp = IpAddressUtils.getIpAddress(request);\n var rateLimiter = rateLimiterRegistry.rateLimiter(\"comment-creation-from-ip-\" + clientIp,\n \"comment-creation\");\n return RateLimiterOperator.of(rateLimiter);\n }\n\n Mono createReply(ServerRequest request) {\n String commentName = request.pathVariable(\"name\");\n return request.bodyToMono(ReplyRequest.class)\n .flatMap(replyRequest -> {\n Reply reply = replyRequest.toReply();\n reply.getSpec().setIpAddress(IpAddressUtils.getIpAddress(request));\n reply.getSpec().setUserAgent(HaloUtils.userAgentFrom(request));\n return environmentFetcher.fetchComment()\n .map(commentSetting -> {\n if (isFalse(commentSetting.getEnable())) {\n throw new AccessDeniedException(\n \"The comment function has been turned off.\",\n \"problemDetail.comment.turnedOff\", null);\n }\n if (checkReplyOwner(reply, commentSetting.getSystemUserOnly())) {\n throw new AccessDeniedException(\"Allow only system users to comment.\",\n \"problemDetail.comment.systemUsersOnly\", null);\n }\n reply.getSpec()\n .setApproved(isFalse(commentSetting.getRequireReviewForNew()));\n\n if (reply.getSpec().getHidden() == null) {\n reply.getSpec().setHidden(false);\n }\n\n return reply;\n })\n .defaultIfEmpty(reply);\n })\n .flatMap(reply -> replyService.create(commentName, reply))\n .flatMap(comment -> ServerResponse.ok().bodyValue(comment))\n .transformDeferred(createIpBasedRateLimiter(request))\n .onErrorMap(RequestNotPermitted.class, RateLimitExceededException::new);\n }\n\n private boolean checkReplyOwner(Reply reply, Boolean onlySystemUser) {\n Comment.CommentOwner owner = reply.getSpec().getOwner();\n if (isTrue(onlySystemUser)) {\n return owner != null && Comment.CommentOwner.KIND_EMAIL.equals(owner.getKind());\n }\n return false;\n }\n\n Mono listComments(ServerRequest request) {\n CommentQuery commentQuery = new CommentQuery(request);\n return commentPublicQueryService.list(commentQuery.toRef(), commentQuery.toPageRequest())\n .flatMap(result -> {\n if (commentQuery.getWithReplies()) {\n return commentPublicQueryService.convertToWithReplyVo(result,\n commentQuery.getReplySize());\n }\n return Mono.just(result);\n })\n .flatMap(list -> ServerResponse.ok().bodyValue(list));\n }\n\n Mono getComment(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return Mono.defer(() -> Mono.justOrEmpty(commentPublicQueryService.getByName(name)))\n .subscribeOn(Schedulers.boundedElastic())\n .flatMap(comment -> ServerResponse.ok().bodyValue(comment));\n }\n\n Mono listCommentReplies(ServerRequest request) {\n String commentName = request.pathVariable(\"name\");\n IListRequest.QueryListRequest queryParams =\n new IListRequest.QueryListRequest(request.queryParams());\n return commentPublicQueryService.listReply(commentName, queryParams.getPage(),\n queryParams.getSize())\n .flatMap(list -> ServerResponse.ok().bodyValue(list));\n }\n\n public static class CommentQuery extends PageableRequest {\n\n private final ServerWebExchange exchange;\n\n public CommentQuery(ServerRequest request) {\n super(request.queryParams());\n this.exchange = request.exchange();\n }\n\n @Schema(description = \"The comment subject group.\")\n public String getGroup() {\n return queryParams.getFirst(\"group\");\n }\n\n @Schema(requiredMode = REQUIRED, description = \"The comment subject version.\")\n public String getVersion() {\n return emptyToNull(queryParams.getFirst(\"version\"));\n }\n\n /**\n * Gets the {@link Ref}s kind.\n *\n * @return comment subject ref kind\n */\n @Schema(requiredMode = REQUIRED, description = \"The comment subject kind.\")\n public String getKind() {\n String kind = emptyToNull(queryParams.getFirst(\"kind\"));\n if (kind == null) {\n throw new ServerWebInputException(\"The kind must not be null.\");\n }\n return kind;\n }\n\n /**\n * Gets the {@link Ref}s name.\n *\n * @return comment subject ref name\n */\n @Schema(requiredMode = REQUIRED, description = \"The comment subject name.\")\n public String getName() {\n String name = emptyToNull(queryParams.getFirst(\"name\"));\n if (name == null) {\n throw new ServerWebInputException(\"The name must not be null.\");\n }\n return name;\n }\n\n @Schema(description = \"Whether to include replies. Default is false.\",\n defaultValue = \"false\")\n public Boolean getWithReplies() {\n var withReplies = queryParams.getFirst(\"withReplies\");\n return StringUtils.isNotBlank(withReplies) && Boolean.parseBoolean(withReplies);\n }\n\n @Schema(description = \"Reply size of the comment, default is 10, only works when \"\n + \"withReplies is true.\", defaultValue = \"10\")\n public int getReplySize() {\n var replySize = queryParams.getFirst(\"replySize\");\n return StringUtils.isNotBlank(replySize) ? Integer.parseInt(replySize) : 10;\n }\n\n @ArraySchema(uniqueItems = true,\n arraySchema = @Schema(name = \"sort\",\n description = \"Sort property and direction of the list result. Supported fields: \"\n + \"creationTimestamp\"),\n schema = @Schema(description = \"like field,asc or field,desc\",\n implementation = String.class,\n example = \"creationTimestamp,desc\"))\n public Sort getSort() {\n return SortResolver.defaultInstance.resolve(exchange);\n }\n\n Ref toRef() {\n Ref ref = new Ref();\n ref.setGroup(getGroup());\n ref.setKind(getKind());\n ref.setVersion(getVersion());\n ref.setName(getName());\n return ref;\n }\n\n public PageRequest toPageRequest() {\n return PageRequestImpl.of(getPage(), getSize(), getSort());\n }\n\n String emptyToNull(String str) {\n return StringUtils.isBlank(str) ? null : str;\n }\n\n public static void buildParameters(Builder builder) {\n PageableRequest.buildParameters(builder);\n builder.parameter(sortParameter())\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"group\")\n .description(\"The comment subject group.\")\n .required(false)\n .implementation(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"version\")\n .description(\"The comment subject version.\")\n .required(true)\n .implementation(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"kind\")\n .description(\"The comment subject kind.\")\n .required(true))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"name\")\n .description(\"The comment subject name.\")\n .required(true)\n .implementation(String.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"withReplies\")\n .description(\"Whether to include replies. Default is false.\")\n .required(false)\n .implementation(Boolean.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"replySize\")\n .description(\"Reply size of the comment, default is 10, only works when \"\n + \"withReplies is true.\")\n .required(false)\n .schema(schemaBuilder()\n .implementation(Integer.class)\n .defaultValue(\"10\")));\n }\n }\n\n public static class PageableRequest extends IListRequest.QueryListRequest {\n\n public PageableRequest(MultiValueMap queryParams) {\n super(queryParams);\n }\n\n @Override\n @JsonIgnore\n public List getLabelSelector() {\n throw new UnsupportedOperationException(\"Unsupported this parameter\");\n }\n\n @Override\n @JsonIgnore\n public List getFieldSelector() {\n throw new UnsupportedOperationException(\"Unsupported this parameter\");\n }\n\n public static void buildParameters(Builder builder) {\n builder.parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"page\")\n .implementation(Integer.class)\n .required(false)\n .description(\"Page number. Default is 0.\"))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"size\")\n .implementation(Integer.class)\n .required(false)\n .description(\"Size number. Default is 0.\"));\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/MenuQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.finders.MenuFinder;\nimport run.halo.app.theme.finders.vo.MenuVo;\n\n/**\n * Endpoint for menu query APIs.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class MenuQueryEndpoint implements CustomEndpoint {\n\n private final MenuFinder menuFinder;\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"MenuV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"menus/-\", this::getByName,\n builder -> builder.operationId(\"queryPrimaryMenu\")\n .description(\"Gets primary menu.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(MenuVo.class)\n )\n )\n .GET(\"menus/{name}\", this::getByName,\n builder -> builder.operationId(\"queryMenuByName\")\n .description(\"Gets menu by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Menu name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(MenuVo.class)\n )\n )\n .build();\n }\n\n private Mono getByName(ServerRequest request) {\n return determineMenuName(request)\n .flatMap(menuFinder::getByName)\n .flatMap(menuVo -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(menuVo)\n );\n }\n\n private Mono determineMenuName(ServerRequest request) {\n String name = request.pathVariables().getOrDefault(\"name\", \"-\");\n if (!\"-\".equals(name)) {\n return Mono.just(name);\n }\n // If name is \"-\", then get primary menu.\n return environmentFetcher.fetch(SystemSetting.Menu.GROUP, SystemSetting.Menu.class)\n .mapNotNull(SystemSetting.Menu::getPrimary)\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Primary menu is not configured.\"))\n );\n }\n\n @Override\n public GroupVersion groupVersion() {\n return PublicApiUtils.groupVersion(new Menu());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/PluginQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.theme.finders.PluginFinder;\n\n/**\n * Endpoint for plugin query APIs.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class PluginQueryEndpoint implements CustomEndpoint {\n\n private final PluginFinder pluginFinder;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"PluginV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"plugins/{name}/available\", this::availableByName,\n builder -> builder.operationId(\"queryPluginAvailableByName\")\n .description(\"Gets plugin available by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Plugin name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(Boolean.class)\n )\n )\n .build();\n }\n\n private Mono availableByName(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n boolean available = pluginFinder.available(name);\n return ServerResponse.ok().bodyValue(available);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return PublicApiUtils.groupVersion(new Plugin());\n }\n}" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/PostPublicQuery.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springframework.web.server.ServerWebExchange;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * Query parameters for post public APIs.\n *\n * @author guqing\n * @since 2.5.0\n */\npublic class PostPublicQuery extends SortableRequest {\n\n public PostPublicQuery(ServerWebExchange exchange) {\n super(exchange);\n }\n\n public static void buildParameters(Builder builder) {\n SortableRequest.buildParameters(builder);\n }\n}" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/PostQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.NavigationPostVo;\nimport run.halo.app.theme.finders.vo.PostVo;\n\n/**\n * Endpoint for post query.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class PostQueryEndpoint implements CustomEndpoint {\n\n private final PostFinder postFinder;\n private final PostPublicQueryService postPublicQueryService;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"PostV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"posts\", this::listPosts,\n builder -> {\n builder.operationId(\"queryPosts\")\n .description(\"Lists posts.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(ListedPostVo.class))\n );\n PostPublicQuery.buildParameters(builder);\n }\n )\n .GET(\"posts/{name}\", this::getPostByName,\n builder -> builder.operationId(\"queryPostByName\")\n .description(\"Gets a post by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Post name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(PostVo.class)\n )\n )\n .GET(\"posts/{name}/navigation\", this::getPostNavigationByName,\n builder -> builder.operationId(\"queryPostNavigationByName\")\n .description(\"Gets a post navigation by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Post name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(NavigationPostVo.class)\n )\n )\n .build();\n }\n\n private Mono getPostNavigationByName(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return postFinder.cursor(name)\n .flatMap(result -> ServerResponse.ok().bodyValue(result));\n }\n\n private Mono getPostByName(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return postFinder.getByName(name)\n .switchIfEmpty(Mono.error(() -> new NotFoundException(\"Post not found\")))\n .flatMap(post -> ServerResponse.ok().contentType(MediaType.APPLICATION_JSON)\n .bodyValue(post)\n );\n }\n\n private Mono listPosts(ServerRequest request) {\n PostPublicQuery query = new PostPublicQuery(request.exchange());\n return postPublicQueryService.list(query.toListOptions(), query.toPageRequest())\n .flatMap(result -> ServerResponse.ok().contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n @Override\n public GroupVersion groupVersion() {\n return PublicApiUtils.groupVersion(new Post());\n }\n}" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/PublicApiUtils.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport java.util.Collection;\nimport java.util.List;\nimport java.util.function.Function;\nimport lombok.experimental.UtilityClass;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ListResult;\n\n/**\n * Utility class for public api.\n *\n * @author guqing\n * @since 2.5.0\n */\n@UtilityClass\npublic class PublicApiUtils {\n\n /**\n * Get group version from extension for public api.\n *\n * @param extension extension\n * @return api.{group}/{version} if group is not empty,\n * otherwise api.halo.run/{version}.\n */\n public static GroupVersion groupVersion(Extension extension) {\n GroupVersionKind groupVersionKind = extension.groupVersionKind();\n String group = StringUtils.defaultIfBlank(groupVersionKind.group(), \"halo.run\");\n return new GroupVersion(\"api.\" + group, groupVersionKind.version());\n }\n\n /**\n * Converts list result to another list result.\n *\n * @param listResult list result to be converted\n * @param mapper mapper function to convert item\n * @param item type\n * @param converted item type\n * @return converted list result\n */\n public static ListResult toAnotherListResult(ListResult listResult,\n Function mapper) {\n Assert.notNull(listResult, \"List result must not be null\");\n Assert.notNull(mapper, \"The mapper must not be null\");\n List mappedItems = listResult.get()\n .map(mapper)\n .toList();\n return new ListResult<>(listResult.getPage(), listResult.getSize(), listResult.getTotal(),\n mappedItems);\n }\n\n /**\n * Checks whether collection contains element.\n *\n * @param element type\n * @return true if collection contains element, otherwise false.\n */\n public static boolean containsElement(@Nullable Collection collection,\n @Nullable T element) {\n if (collection != null && element != null) {\n return collection.contains(element);\n }\n return false;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/SinglePageQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.router.SortableRequest;\nimport run.halo.app.theme.finders.SinglePageConversionService;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.finders.vo.ListedSinglePageVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * Endpoint for single page query.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class SinglePageQueryEndpoint implements CustomEndpoint {\n\n private final SinglePageFinder singlePageFinder;\n\n private final SinglePageConversionService singlePageConversionService;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"SinglePageV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"singlepages\", this::listSinglePages,\n builder -> {\n builder.operationId(\"querySinglePages\")\n .description(\"Lists single pages\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(\n ListResult.generateGenericClass(ListedSinglePageVo.class))\n );\n SinglePagePublicQuery.buildParameters(builder);\n }\n )\n .GET(\"singlepages/{name}\", this::getByName,\n builder -> builder.operationId(\"querySinglePageByName\")\n .description(\"Gets single page by name\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"SinglePage name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(SinglePageVo.class)\n )\n )\n .build();\n }\n\n private Mono getByName(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return singlePageFinder.getByName(name)\n .flatMap(result -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n private Mono listSinglePages(ServerRequest request) {\n var query = new SinglePagePublicQuery(request.exchange());\n return singlePageConversionService.listBy(query.toListOptions(), query.toPageRequest())\n .flatMap(result -> ServerResponse.ok().bodyValue(result));\n }\n\n static class SinglePagePublicQuery extends SortableRequest {\n\n public SinglePagePublicQuery(ServerWebExchange exchange) {\n super(exchange);\n }\n\n public static void buildParameters(Builder builder) {\n SortableRequest.buildParameters(builder);\n }\n }\n\n @Override\n public GroupVersion groupVersion() {\n return PublicApiUtils.groupVersion(new SinglePage());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/SiteStatsQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.theme.finders.SiteStatsFinder;\nimport run.halo.app.theme.finders.vo.SiteStatsVo;\n\n/**\n * Endpoint for site stats query APIs.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class SiteStatsQueryEndpoint implements CustomEndpoint {\n\n private final SiteStatsFinder siteStatsFinder;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"SystemV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"stats/-\", this::getStats,\n builder -> builder.operationId(\"queryStats\")\n .description(\"Gets site stats\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(SiteStatsVo.class)\n )\n )\n .build();\n }\n\n private Mono getStats(ServerRequest request) {\n return siteStatsFinder.getStats()\n .flatMap(result -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n @Override\n public GroupVersion groupVersion() {\n return new GroupVersion(\"api.halo.run\", \"v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/TagQueryEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.SortableRequest;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.TagVo;\n\n/**\n * Endpoint for tag query APIs.\n *\n * @author guqing\n * @since 2.5.0\n */\n@Component\n@RequiredArgsConstructor\npublic class TagQueryEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n private final TagFinder tagFinder;\n private final PostPublicQueryService postPublicQueryService;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"TagV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"tags\", this::listTags,\n builder -> {\n builder.operationId(\"queryTags\")\n .description(\"Lists tags\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(\n ListResult.generateGenericClass(TagVo.class))\n );\n TagPublicQuery.buildParameters(builder);\n }\n )\n .GET(\"tags/{name}\", this::getTagByName,\n builder -> builder.operationId(\"queryTagByName\")\n .description(\"Gets tag by name\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Tag name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(TagVo.class)\n )\n )\n .GET(\"tags/{name}/posts\", this::listPostsByTagName,\n builder -> {\n builder.operationId(\"queryPostsByTagName\")\n .description(\"Lists posts by tag name\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Tag name\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(ListedPostVo.class)\n );\n PostPublicQuery.buildParameters(builder);\n }\n )\n .build();\n }\n\n private Mono getTagByName(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return tagFinder.getByName(name)\n .flatMap(tag -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(tag)\n );\n }\n\n private Mono listPostsByTagName(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n final var query = new PostPublicQuery(request.exchange());\n var listOptions = query.toListOptions();\n var newFieldSelector = listOptions.getFieldSelector()\n .andQuery(Queries.equal(\"spec.tags\", name));\n listOptions.setFieldSelector(newFieldSelector);\n return postPublicQueryService.list(listOptions, query.toPageRequest())\n .flatMap(result -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n private Mono listTags(ServerRequest request) {\n var query = new TagPublicQuery(request.exchange());\n return client.listBy(Tag.class, query.toListOptions(), query.toPageRequest())\n .map(result -> {\n var tagVos = tagFinder.convertToVo(result.getItems());\n return new ListResult<>(result.getPage(), result.getSize(),\n result.getTotal(), tagVos);\n })\n .flatMap(result -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(result)\n );\n }\n\n static class TagPublicQuery extends SortableRequest {\n public TagPublicQuery(ServerWebExchange exchange) {\n super(exchange);\n }\n\n public static void buildParameters(Builder builder) {\n SortableRequest.buildParameters(builder);\n }\n }\n\n @Override\n public GroupVersion groupVersion() {\n return PublicApiUtils.groupVersion(new Tag());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/theme/ThumbnailEndpoint.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Arrays;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.core.io.Resource;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.attachment.thumbnail.ThumbnailService;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.infra.utils.HaloUtils;\n\n/**\n * Thumbnail endpoint for thumbnail resource access.\n *\n * @author guqing\n * @author johnniang\n * @since 2.19.0\n */\n@Component\n@RequiredArgsConstructor\npublic class ThumbnailEndpoint implements CustomEndpoint {\n\n private final ThumbnailService thumbnailService;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"ThumbnailV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(\"/thumbnails/-/via-uri\", this::getThumbnailByUri, builder -> {\n builder.operationId(\"GetThumbnailByUri\")\n .description(\"Get thumbnail by URI\")\n .tag(tag)\n .response(responseBuilder().implementation(Resource.class))\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"uri\")\n .description(\"The URI of the image\")\n .required(true)\n )\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"size\")\n\n .implementation(ThumbnailSize.class)\n .description(\"The size of the thumbnail\")\n .required(true)\n )\n .parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"width\")\n .schema(Builder.schemaBuilder()\n .type(\"integer\")\n .allowableValues(Arrays.stream(ThumbnailSize.allowedWidths())\n .map(String::valueOf)\n .toArray(String[]::new)\n )\n )\n .description(\"\"\"\n The width of the thumbnail, if 'size' is not provided, this \\\n parameter will be used to determine the size\\\n \"\"\")\n .required(false)\n );\n })\n .build();\n }\n\n private Mono getThumbnailByUri(ServerRequest request) {\n var uri = request.queryParam(\"uri\")\n .filter(StringUtils::isNotBlank)\n .map(HaloUtils::safeToUri);\n if (uri.isEmpty()) {\n return Mono.error(\n new ServerWebInputException(\"Required parameter 'uri' is missing or invalid\")\n );\n }\n var size = request.queryParam(\"size\")\n .filter(StringUtils::isNotBlank)\n .flatMap(ThumbnailSize::optionalValueOf)\n .or(() -> request.queryParam(\"width\")\n .filter(StringUtils::isNotBlank)\n .map(ThumbnailSize::fromWidth)\n );\n if (size.isEmpty()) {\n return Mono.error(new ServerWebInputException(\n \"Required parameter 'size' or 'width' is missing or invalid\"\n ));\n }\n return thumbnailService.get(uri.get(), size.get())\n .defaultIfEmpty(uri.get())\n .flatMap(thumbnailLink -> ServerResponse.status(HttpStatus.FOUND)\n .location(thumbnailLink)\n .build()\n );\n }\n\n @Override\n public GroupVersion groupVersion() {\n return new GroupVersion(\"api.storage.halo.run\", \"v1alpha1\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/uc/AnnotationSettingEndpoint.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Optional;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.apiresponse.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.plugin.PluginConst;\nimport run.halo.app.plugin.PluginService;\nimport run.halo.app.theme.service.ThemeService;\n\n/**\n * The endpoint for managing AnnotationSettings.\n *\n * @author johnniang\n * @since 2.22.3\n */\n@Component\n@RequiredArgsConstructor\nclass AnnotationSettingEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n\n private final ThemeService themeService;\n\n private final PluginService pluginService;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"AnnotationSettingV1AlphaUc\";\n return SpringdocRouteBuilder.route()\n .GET(\n \"/annotationsettings\",\n this::listAvailableAnnotationSettings,\n builder -> builder\n .operationId(\"listAvailableAnnotationSettings\")\n .description(\"\"\"\n List available AnnotationSettings for the given targetRef. \\\n The available AnnotationSettings are determined by \\\n the currently activated theme and started plugins.\"\"\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"targetRef\")\n .in(ParameterIn.QUERY)\n .description(\n \"The targetRef of the AnnotationSetting. e.g.: 'content.halo.run/Post\"\n )\n .required(true)\n .implementation(String.class)\n )\n .response(Builder.responseBuilder()\n .implementationArray(AnnotationSetting.class)\n )\n )\n .build();\n }\n\n private Mono listAvailableAnnotationSettings(ServerRequest serverRequest) {\n var targetRef = serverRequest.queryParam(\"targetRef\")\n .filter(StringUtils::hasText)\n .orElse(null);\n if (targetRef == null) {\n return Mono.error(new ServerWebInputException(\"Query param 'targetRef' is required\"));\n }\n var getActivatedTheme = themeService.fetchActivatedThemeName()\n .map(Optional::of)\n .defaultIfEmpty(Optional.empty());\n var getStartedPlugins = pluginService.getStartedPluginNames().collectList();\n var annotationSettings = Mono.zip(getActivatedTheme, getStartedPlugins,\n (themeName, pluginNames) -> {\n Condition labelConditions = null;\n if (themeName.isPresent()) {\n labelConditions = Queries.labelEqual(Theme.THEME_NAME_LABEL,\n themeName.get());\n }\n if (!CollectionUtils.isEmpty(pluginNames)) {\n var pluginLabelCondition =\n Queries.labelIn(PluginConst.PLUGIN_NAME_LABEL_NAME, pluginNames);\n if (labelConditions == null) {\n labelConditions = pluginLabelCondition;\n } else {\n labelConditions = labelConditions.or(pluginLabelCondition);\n }\n }\n if (labelConditions == null) {\n labelConditions = Queries.empty();\n }\n var builder = ListOptions.builder()\n .andQuery(labelConditions)\n .andQuery(Queries.equal(\"spec.targetRef\", targetRef));\n return builder.build();\n })\n .flatMapMany(\n listOptions -> client.listAll(AnnotationSetting.class, listOptions, defaultSort())\n );\n return ServerResponse.ok().body(annotationSettings, AnnotationSetting.class);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.halo.run/v1alpha1\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/uc/AttachmentUcEndpoint.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springdoc.webflux.core.fn.SpringdocRouteBuilder.route;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.net.URL;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.function.Consumer;\nimport lombok.Getter;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.http.codec.multipart.FormFieldPart;\nimport org.springframework.http.codec.multipart.Part;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.web.reactive.function.BodyExtractors;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.attachment.AttachmentLister;\nimport run.halo.app.core.attachment.SearchRequest;\nimport run.halo.app.core.endpoint.AttachmentHandler;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.NotFoundException;\n\n@Component\n@RequiredArgsConstructor\npublic class AttachmentUcEndpoint implements CustomEndpoint {\n\n public static final String POST_NAME_LABEL = \"content.halo.run/post-name\";\n public static final String SINGLE_PAGE_NAME_LABEL = \"content.halo.run/single-page-name\";\n\n private final AttachmentService attachmentService;\n\n private final AttachmentLister attachmentLister;\n\n private final PostService postService;\n\n private final SystemConfigFetcher systemSettingFetcher;\n\n private final AttachmentHandler attachmentHandler;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"AttachmentV1alpha1Uc\";\n return route()\n .POST(\"/attachments\",\n this::createAttachmentForPost,\n builder -> builder.operationId(\"CreateAttachmentForPost\").tag(tag)\n .description(\"\"\"\n Create attachment for the given post. \\\n Deprecated in favor of /attachments/-/upload.\"\"\"\n )\n .deprecated(true)\n .parameter(parameterBuilder()\n .name(\"waitForPermalink\")\n .description(\"Wait for permalink.\")\n .in(ParameterIn.QUERY)\n .required(false)\n .implementation(boolean.class))\n .requestBody(requestBodyBuilder()\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(PostAttachmentRequest.class)))\n )\n .response(responseBuilder().implementation(Attachment.class))\n )\n .POST(\n \"/attachments/-/upload\",\n contentType(MediaType.MULTIPART_FORM_DATA),\n this::uploadAttachment,\n builder -> {\n builder.operationId(\"UploadAttachmentForUc\")\n .description(\"Upload attachment to user center storage.\")\n .tag(tag);\n this.attachmentHandler.buildDoc(builder);\n }\n )\n .POST(\"/attachments/-/upload-from-url\", contentType(MediaType.APPLICATION_JSON),\n this::uploadFromUrlForPost,\n builder -> builder\n .operationId(\"ExternalTransferAttachment_1\")\n .description(\"\"\"\n Upload attachment from the given URL.\n Deprecated in favor of /attachments/-/upload.\"\"\")\n .tag(tag)\n .deprecated(true)\n .parameter(parameterBuilder()\n .name(\"waitForPermalink\")\n .description(\"Wait for permalink.\")\n .in(ParameterIn.QUERY)\n .required(false)\n .implementation(boolean.class))\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder().implementation(UploadFromUrlRequest.class))\n ))\n .response(responseBuilder().implementation(Attachment.class))\n .build()\n )\n .GET(\"/attachments\", this::listMyAttachments, builder -> {\n builder.operationId(\"ListMyAttachments\")\n .description(\"List attachments of the current user uploaded.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(Attachment.class))\n );\n SearchRequest.buildParameters(builder);\n })\n .build();\n }\n\n private Mono uploadAttachment(ServerRequest request) {\n var getConfigFromUser = systemSettingFetcher.fetch(\n SystemSetting.User.GROUP,\n SystemSetting.User.class\n )\n .mapNotNull(SystemSetting.User::getUcAttachmentPolicy)\n .filter(StringUtils::isNotBlank)\n .map(policyName -> SystemSetting.Attachment.UploadOptions.builder()\n .policyName(policyName)\n .build()\n );\n var getConfig = systemSettingFetcher.fetch(\n SystemSetting.Attachment.GROUP,\n SystemSetting.Attachment.class\n )\n .mapNotNull(SystemSetting.Attachment::uc)\n .filter(uo -> StringUtils.isNotBlank(uo.policyName()))\n .switchIfEmpty(Mono.defer(() -> getConfigFromUser))\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Attachment system setting is not configured for console\"\n )));\n return attachmentHandler.handleUpload(request, getConfig);\n }\n\n private Mono listMyAttachments(ServerRequest request) {\n return getCurrentUser()\n .flatMap(username -> {\n var searchRequest = new UcSearchRequest(request, username);\n return attachmentLister.listBy(searchRequest)\n .flatMap(listResult -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(listResult)\n );\n });\n }\n\n @Getter\n public static class UcSearchRequest extends SearchRequest {\n private final String owner;\n\n public UcSearchRequest(ServerRequest request, String owner) {\n super(request);\n Assert.state(StringUtils.isNotBlank(owner), \"Owner must not be blank.\");\n this.owner = owner;\n }\n\n @Override\n public ListOptions toListOptions(List hiddenGroups) {\n var listOptions = super.toListOptions(hiddenGroups);\n return ListOptions.builder(listOptions)\n .andQuery((equal(\"spec.ownerName\", owner)))\n .build();\n }\n }\n\n private Mono uploadFromUrlForPost(ServerRequest request) {\n var uploadFromUrlRequestMono = request.bodyToMono(UploadFromUrlRequest.class);\n\n var uploadAttachment = getPostSettingMono()\n .flatMap(postSetting -> uploadFromUrlRequestMono.flatMap(\n uploadFromUrlRequest -> {\n var url = uploadFromUrlRequest.url();\n var fileName = uploadFromUrlRequest.filename();\n return attachmentService.uploadFromUrl(url,\n postSetting.getAttachmentPolicyName(),\n postSetting.getAttachmentGroupName(),\n fileName\n );\n })\n );\n\n var waitForPermalink = request.queryParam(\"waitForPermalink\")\n .map(Boolean::valueOf)\n .orElse(false);\n if (waitForPermalink) {\n uploadAttachment = waitForPermalink(uploadAttachment);\n }\n return ServerResponse.ok().body(uploadAttachment, Attachment.class);\n }\n\n private Mono createAttachmentForPost(ServerRequest request) {\n var postAttachmentRequestMono = request.body(BodyExtractors.toMultipartData())\n .map(PostAttachmentRequest::from)\n .cache();\n\n // get settings\n var createdAttachment =\n getPostSettingMono().flatMap(postSetting -> postAttachmentRequestMono\n .flatMap(postAttachmentRequest -> getCurrentUser().flatMap(\n username -> attachmentService.upload(username,\n postSetting.getAttachmentPolicyName(),\n postSetting.getAttachmentGroupName(),\n postAttachmentRequest.file(),\n linkWith(postAttachmentRequest)))));\n\n var waitForPermalink = request.queryParam(\"waitForPermalink\")\n .map(Boolean::valueOf)\n .orElse(false);\n if (waitForPermalink) {\n createdAttachment = waitForPermalink(createdAttachment);\n }\n return ServerResponse.ok().body(createdAttachment, Attachment.class);\n }\n\n private Mono waitForPermalink(Mono createdAttachment) {\n createdAttachment = createdAttachment.flatMap(attachment ->\n attachmentService.getPermalink(attachment)\n .doOnNext(permalink -> {\n var status = attachment.getStatus();\n if (status == null) {\n status = new Attachment.AttachmentStatus();\n attachment.setStatus(status);\n }\n status.setPermalink(permalink.toString());\n })\n .thenReturn(attachment));\n return createdAttachment;\n }\n\n private Mono getPostSettingMono() {\n return systemSettingFetcher.fetchPost().handle((postSetting, sink) -> {\n var attachmentPolicyName = postSetting.getAttachmentPolicyName();\n if (StringUtils.isBlank(attachmentPolicyName)) {\n sink.error(new ServerWebInputException(\n \"Please configure storage policy for post attachment first.\"));\n return;\n }\n sink.next(postSetting);\n });\n }\n\n private Consumer linkWith(PostAttachmentRequest request) {\n return attachment -> {\n var labels = attachment.getMetadata().getLabels();\n if (labels == null) {\n labels = new HashMap<>();\n attachment.getMetadata().setLabels(labels);\n }\n if (StringUtils.isNotBlank(request.postName())) {\n labels.put(POST_NAME_LABEL, request.postName());\n }\n if (StringUtils.isNotBlank(request.singlePageName())) {\n labels.put(SINGLE_PAGE_NAME_LABEL, request.singlePageName());\n }\n };\n }\n\n private Mono checkPostOwnership(Mono postAttachmentRequest) {\n // check the post\n var postNotFoundError = Mono.error(\n () -> new NotFoundException(\"The post was not found or deleted.\")\n );\n return postAttachmentRequest.map(PostAttachmentRequest::postName)\n .flatMap(postName -> getCurrentUser()\n .flatMap(username -> postService.getByUsername(postName, username)\n .switchIfEmpty(postNotFoundError)))\n .then();\n }\n\n private Mono getCurrentUser() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.storage.halo.run/v1alpha1\");\n }\n\n @Schema(name = \"UcUploadFromUrlRequest\")\n public record UploadFromUrlRequest(@Schema(requiredMode = REQUIRED) URL url,\n @Schema(description = \"Custom file name\") String filename) {\n public UploadFromUrlRequest {\n if (Objects.isNull(url)) {\n throw new ServerWebInputException(\"Required url is missing.\");\n }\n }\n }\n\n @Schema(types = \"object\")\n public record PostAttachmentRequest(\n @Schema(requiredMode = REQUIRED, description = \"Attachment data.\")\n FilePart file,\n\n @Schema(requiredMode = NOT_REQUIRED, description = \"Post name.\")\n String postName,\n\n @Schema(requiredMode = NOT_REQUIRED, description = \"Single page name.\")\n String singlePageName\n ) {\n\n /**\n * Convert multipart data into PostAttachmentRequest.\n *\n * @param multipartData is multipart data from request.\n * @return post attachment request data.\n */\n public static PostAttachmentRequest from(MultiValueMap multipartData) {\n var part = multipartData.getFirst(\"postName\");\n String postName = null;\n if (part instanceof FormFieldPart formFieldPart) {\n postName = formFieldPart.value();\n }\n\n part = multipartData.getFirst(\"singlePageName\");\n String singlePageName = null;\n if (part instanceof FormFieldPart formFieldPart) {\n singlePageName = formFieldPart.value();\n }\n\n part = multipartData.getFirst(\"file\");\n if (!(part instanceof FilePart file)) {\n throw new ServerWebInputException(\"Invalid type of parameter 'file'.\");\n }\n\n return new PostAttachmentRequest(file, postName, singlePageName);\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/uc/UcPostEndpoint.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.webflux.core.fn.SpringdocRouteBuilder.route;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.Objects;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.Content;\nimport run.halo.app.content.ContentUpdateParam;\nimport run.halo.app.content.ListedPost;\nimport run.halo.app.content.PostQuery;\nimport run.halo.app.content.PostRequest;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.SnapshotService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@Component\npublic class UcPostEndpoint implements CustomEndpoint {\n\n private static final String CONTENT_JSON_ANNO = \"content.halo.run/content-json\";\n\n private final PostService postService;\n\n private final SnapshotService snapshotService;\n\n public UcPostEndpoint(PostService postService, SnapshotService snapshotService) {\n this.postService = postService;\n this.snapshotService = snapshotService;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"PostV1alpha1Uc\";\n var namePathParam = parameterBuilder().name(\"name\")\n .description(\"Post name\")\n .in(ParameterIn.PATH)\n .required(true);\n return route().nest(\n path(\"/posts\"),\n () -> route()\n .GET(this::listMyPost, builder -> {\n builder.operationId(\"ListMyPosts\")\n .description(\"List posts owned by the current user.\")\n .tag(tag)\n .response(responseBuilder().implementation(\n ListResult.generateGenericClass(ListedPost.class)));\n PostQuery.buildParameters(builder);\n }\n )\n .POST(this::createMyPost, builder -> builder.operationId(\"CreateMyPost\")\n .tag(tag)\n .description(\"\"\"\n Create my post. If you want to create a post with content, please set\n annotation: \"content.halo.run/content-json\" into annotations and refer\n to Content for corresponding data type.\n \"\"\")\n .requestBody(requestBodyBuilder().implementation(Post.class))\n .response(responseBuilder().implementation(Post.class))\n )\n .GET(\"/{name}\", this::getMyPost, builder -> builder.operationId(\"GetMyPost\")\n .tag(tag)\n .parameter(namePathParam)\n .description(\"Get post that belongs to the current user.\")\n .response(responseBuilder().implementation(Post.class))\n )\n .PUT(\"/{name}\", this::updateMyPost, builder ->\n builder.operationId(\"UpdateMyPost\")\n .tag(tag)\n .parameter(namePathParam)\n .description(\"Update my post.\")\n .requestBody(requestBodyBuilder().implementation(Post.class))\n .response(responseBuilder().implementation(Post.class))\n )\n .GET(\"/{name}/draft\", this::getMyPostDraft, builder -> builder.tag(tag)\n .operationId(\"GetMyPostDraft\")\n .description(\"Get my post draft.\")\n .parameter(namePathParam)\n .parameter(parameterBuilder()\n .name(\"patched\")\n .in(ParameterIn.QUERY)\n .required(false)\n .implementation(Boolean.class)\n .description(\"Should include patched content and raw or not.\")\n )\n .response(responseBuilder().implementation(Snapshot.class))\n )\n .PUT(\"/{name}/draft\", this::updateMyPostDraft, builder -> builder.tag(tag)\n .operationId(\"UpdateMyPostDraft\")\n .description(\"\"\"\n Update draft of my post. Please make sure set annotation: \n \"content.halo.run/content-json\" into annotations and refer to \n Content for corresponding data type.\n \"\"\")\n .parameter(namePathParam)\n .requestBody(requestBodyBuilder().implementation(Snapshot.class))\n .response(responseBuilder().implementation(Snapshot.class)))\n .PUT(\"/{name}/publish\", this::publishMyPost, builder -> builder.tag(tag)\n .operationId(\"PublishMyPost\")\n .description(\"Publish my post.\")\n .parameter(namePathParam)\n .response(responseBuilder().implementation(Post.class)))\n .PUT(\"/{name}/unpublish\", this::unpublishMyPost, builder -> builder.tag(tag)\n .operationId(\"UnpublishMyPost\")\n .description(\"Unpublish my post.\")\n .parameter(namePathParam)\n .response(responseBuilder().implementation(Post.class))\n )\n .DELETE(\"/{name}/recycle\", this::recycleMyPost, builder -> builder.tag(tag)\n .operationId(\"RecycleMyPost\")\n .description(\"Move my post to recycle bin.\")\n .parameter(namePathParam)\n .response(responseBuilder().implementation(Post.class))\n )\n .build()\n )\n .build();\n }\n\n private Mono recycleMyPost(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return getCurrentUser()\n .flatMap(username -> postService.recycleBy(name, username))\n .flatMap(post -> ServerResponse.ok().bodyValue(post));\n }\n\n private Mono getMyPostDraft(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var patched = request.queryParam(\"patched\").map(Boolean::valueOf).orElse(false);\n var draft = getMyPost(name)\n .flatMap(post -> {\n var headSnapshotName = post.getSpec().getHeadSnapshot();\n var baseSnapshotName = post.getSpec().getBaseSnapshot();\n if (StringUtils.isBlank(headSnapshotName)) {\n headSnapshotName = baseSnapshotName;\n }\n if (patched) {\n return snapshotService.getPatchedBy(headSnapshotName, baseSnapshotName);\n }\n return snapshotService.getBy(headSnapshotName);\n });\n return ServerResponse.ok().body(draft, Snapshot.class);\n }\n\n private Mono unpublishMyPost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var postMono = getCurrentUser()\n .flatMap(username -> postService.getByUsername(name, username));\n var unpublishedPost = postMono.flatMap(postService::unpublish);\n return ServerResponse.ok().body(unpublishedPost, Post.class);\n }\n\n private Mono publishMyPost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var postMono = getCurrentUser()\n .flatMap(username -> postService.getByUsername(name, username));\n\n var publishedPost = postMono.flatMap(postService::publish);\n return ServerResponse.ok().body(publishedPost, Post.class);\n }\n\n private Mono updateMyPostDraft(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var postMono = getMyPost(name).cache();\n var snapshotMono = request.bodyToMono(Snapshot.class).cache();\n\n var contentMono = snapshotMono\n .map(Snapshot::getMetadata)\n .filter(metadata -> {\n var annotations = metadata.getAnnotations();\n return annotations != null && annotations.containsKey(CONTENT_JSON_ANNO);\n })\n .map(metadata -> {\n var contentJson = metadata.getAnnotations().remove(CONTENT_JSON_ANNO);\n return JsonUtils.jsonToObject(contentJson, Content.class);\n })\n .cache();\n\n // check the snapshot belongs to the post.\n var checkSnapshot = postMono.flatMap(post -> snapshotMono.filter(\n snapshot -> Ref.equals(snapshot.getSpec().getSubjectRef(), post)\n ).switchIfEmpty(Mono.error(() ->\n new ServerWebInputException(\"The snapshot does not belong to the given post.\"))\n ).filter(snapshot -> {\n var snapshotName = snapshot.getMetadata().getName();\n var headSnapshotName = post.getSpec().getHeadSnapshot();\n return Objects.equals(snapshotName, headSnapshotName);\n }).switchIfEmpty(Mono.error(() ->\n new ServerWebInputException(\"The snapshot was not the head snapshot of the post.\")))\n ).then();\n\n var setContributor = getCurrentUser().flatMap(username ->\n snapshotMono.doOnNext(snapshot -> Snapshot.addContributor(snapshot, username)));\n\n var getBaseSnapshot = postMono.map(post -> post.getSpec().getBaseSnapshot())\n .flatMap(snapshotService::getBy);\n\n var updatedSnapshot = getBaseSnapshot.flatMap(\n baseSnapshot -> contentMono.flatMap(content -> postMono.flatMap(post -> {\n var postName = post.getMetadata().getName();\n var headSnapshotName = post.getSpec().getHeadSnapshot();\n var releaseSnapshotName = post.getSpec().getReleaseSnapshot();\n if (!Objects.equals(headSnapshotName, releaseSnapshotName)) {\n // patch and update\n return snapshotMono.flatMap(\n s -> snapshotService.patchAndUpdate(s, baseSnapshot, content));\n }\n // patch and create\n return getCurrentUser().map(\n username -> {\n var metadata = new Metadata();\n metadata.setGenerateName(postName + \"-snapshot-\");\n var spec = new Snapshot.SnapShotSpec();\n spec.setParentSnapshotName(headSnapshotName);\n spec.setOwner(username);\n spec.setSubjectRef(Ref.of(post));\n\n var snapshot = new Snapshot();\n snapshot.setMetadata(metadata);\n snapshot.setSpec(spec);\n Snapshot.addContributor(snapshot, username);\n return snapshot;\n })\n .flatMap(s -> snapshotService.patchAndCreate(s, baseSnapshot, content))\n .flatMap(createdSnapshot -> {\n post.getSpec().setHeadSnapshot(createdSnapshot.getMetadata().getName());\n return postService.updateBy(post).thenReturn(createdSnapshot);\n });\n })));\n\n return ServerResponse.ok()\n .body(checkSnapshot.and(setContributor).then(updatedSnapshot), Snapshot.class);\n }\n\n private Mono updateMyPost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n\n var postBody = request.bodyToMono(Post.class)\n .doOnNext(post -> {\n var annotations = post.getMetadata().getAnnotations();\n if (annotations != null) {\n // we don't support updating content while updating post.\n annotations.remove(CONTENT_JSON_ANNO);\n }\n })\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required.\")));\n\n var updatedPost = getMyPost(name).flatMap(oldPost ->\n postBody.doOnNext(post -> {\n var oldSpec = oldPost.getSpec();\n // restrict fields of post.spec.\n var spec = post.getSpec();\n spec.setOwner(oldSpec.getOwner());\n spec.setPublish(oldSpec.getPublish());\n spec.setHeadSnapshot(oldSpec.getHeadSnapshot());\n spec.setBaseSnapshot(oldSpec.getBaseSnapshot());\n spec.setReleaseSnapshot(oldSpec.getReleaseSnapshot());\n spec.setDeleted(oldSpec.getDeleted());\n post.getMetadata().setName(oldPost.getMetadata().getName());\n }))\n .flatMap(postService::updateBy);\n return ServerResponse.ok().body(updatedPost, Post.class);\n }\n\n private Mono createMyPost(ServerRequest request) {\n var postFromRequest = request.bodyToMono(Post.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required.\")));\n\n var createdPost = getCurrentUser()\n .flatMap(username -> postFromRequest\n .doOnNext(post -> {\n if (post.getSpec() == null) {\n post.setSpec(new Post.PostSpec());\n }\n post.getSpec().setOwner(username);\n }))\n .map(post -> new PostRequest(post, ContentUpdateParam.from(getContent(post))))\n .flatMap(postService::draftPost);\n return ServerResponse.ok().body(createdPost, Post.class);\n }\n\n private Content getContent(Post post) {\n Content content = null;\n var annotations = post.getMetadata().getAnnotations();\n if (annotations != null && annotations.containsKey(CONTENT_JSON_ANNO)) {\n var contentJson = annotations.remove(CONTENT_JSON_ANNO);\n content = JsonUtils.jsonToObject(contentJson, Content.class);\n }\n return content;\n }\n\n private Mono listMyPost(ServerRequest request) {\n var posts = getCurrentUser()\n .map(username -> new PostQuery(request, username))\n .flatMap(postService::listPost);\n return ServerResponse.ok().body(posts, ListedPost.class);\n }\n\n private Mono getMyPost(ServerRequest request) {\n var postName = request.pathVariable(\"name\");\n var post = getMyPost(postName);\n return ServerResponse.ok().body(post, Post.class);\n }\n\n private Mono getMyPost(String postName) {\n return getCurrentUser()\n .flatMap(username -> postService.getByUsername(postName, username)\n .switchIfEmpty(\n Mono.error(() -> new NotFoundException(\"The post was not found or deleted\"))\n )\n );\n }\n\n private Mono getCurrentUser() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.content.halo.run/v1alpha1\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/uc/UcSnapshotEndpoint.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.webflux.core.fn.SpringdocRouteBuilder.route;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.SnapshotService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.exception.NotFoundException;\n\n@Component\npublic class UcSnapshotEndpoint implements CustomEndpoint {\n\n private final PostService postService;\n\n private final SnapshotService snapshotService;\n\n public UcSnapshotEndpoint(PostService postService, SnapshotService snapshotService) {\n this.postService = postService;\n this.snapshotService = snapshotService;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"SnapshotV1alpha1Uc\";\n return route().nest(path(\"/snapshots\"),\n () -> route()\n .GET(\"/{name}\",\n this::getSnapshot,\n builder -> builder.operationId(\"GetSnapshotForPost\")\n .description(\"Get snapshot for one post.\")\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .description(\"Snapshot name.\")\n )\n .parameter(parameterBuilder()\n .name(\"postName\")\n .in(ParameterIn.QUERY)\n .required(true)\n .description(\"Post name.\")\n )\n .parameter(parameterBuilder()\n .name(\"patched\")\n .in(ParameterIn.QUERY)\n .required(false)\n .implementation(Boolean.class)\n .description(\"Should include patched content and raw or not.\")\n )\n .response(responseBuilder().implementation(Snapshot.class))\n .tag(tag))\n .build()\n )\n .build();\n }\n\n private Mono getSnapshot(ServerRequest request) {\n var snapshotName = request.pathVariable(\"name\");\n var postName = request.queryParam(\"postName\")\n .orElseThrow(() -> new ServerWebInputException(\"Query parameter postName is required\"));\n var patched = request.queryParam(\"patched\").map(Boolean::valueOf).orElse(false);\n\n var postNotFoundError = Mono.error(\n () -> new NotFoundException(\"The post was not found or deleted.\")\n );\n var snapshotNotFoundError = Mono.error(\n () -> new NotFoundException(\"The snapshot was not found or deleted.\")\n );\n\n var postMono = getCurrentUser().flatMap(username ->\n postService.getByUsername(postName, username).switchIfEmpty(postNotFoundError)\n );\n\n // check the post belongs to the current user.\n var snapshotMono = postMono.flatMap(post -> Mono.defer(\n () -> {\n if (patched) {\n var baseSnapshotName = post.getSpec().getBaseSnapshot();\n return snapshotService.getPatchedBy(snapshotName, baseSnapshotName);\n }\n return snapshotService.getBy(snapshotName);\n })\n .filter(snapshot -> {\n var subjectRef = snapshot.getSpec().getSubjectRef();\n return Ref.equals(subjectRef, post);\n })\n .switchIfEmpty(snapshotNotFoundError)\n );\n\n return ServerResponse.ok().body(snapshotMono, Snapshot.class);\n }\n\n private Mono getCurrentUser() {\n return ReactiveSecurityContextHolder\n .getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.content.halo.run/v1alpha1\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/uc/UcUserPreferenceEndpoint.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.HashMap;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.requestbody.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ResponseStatusException;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport tools.jackson.databind.JsonNode;\nimport tools.jackson.databind.json.JsonMapper;\n\n/**\n * User preference endpoint for UC (User Center).\n * This endpoint allows users to get and update their preferences by group.\n *\n * @author JohnNiang\n * @since 2.21.0\n */\n@Component\n@RequiredArgsConstructor\nclass UcUserPreferenceEndpoint implements CustomEndpoint {\n\n private static final String PREFERENCE_PREFIX = \"user-preferences-\";\n\n private final AuthenticationTrustResolver trustResolver = new AuthenticationTrustResolverImpl();\n\n private final ReactiveExtensionClient client;\n\n private final JsonMapper mapper;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"UserPreferenceV1alpha1Uc\";\n return SpringdocRouteBuilder.route()\n .GET(\n \"/user-preferences/{group}\",\n this::getMyPreference,\n builder -> builder.operationId(\"getMyPreference\")\n .tag(tag)\n .description(\"Get my preference by group.\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"group\")\n .description(\"Group of user preference, e.g. `notification`.\")\n .implementation(String.class)\n .required(true)\n )\n .response(responseBuilder().implementation(Object.class))\n )\n .PUT(\n \"/user-preferences/{group}\",\n this::updateMyPreference,\n builder -> builder.operationId(\"updateMyPreference\")\n .tag(tag)\n .description(\"Create or update my preference by group.\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"group\")\n .description(\"Group of user preference, e.g. `notification`.\")\n .implementation(String.class)\n .required(true)\n )\n .requestBody(Builder.requestBodyBuilder()\n .required(true)\n .implementation(Object.class))\n .response(responseBuilder()\n .description(\"No content, preference updated successfully.\")\n .responseCode(String.valueOf(HttpStatus.NO_CONTENT.value()))\n )\n )\n .build();\n }\n\n private Mono updateMyPreference(ServerRequest serverRequest) {\n var group = serverRequest.pathVariable(\"group\");\n return authenticated()\n .map(Authentication::getName)\n .flatMap(username -> client.fetch(ConfigMap.class, PREFERENCE_PREFIX + username)\n .switchIfEmpty(Mono.fromSupplier(() -> {\n var cm = new ConfigMap();\n cm.setMetadata(new Metadata());\n cm.getMetadata().setName(PREFERENCE_PREFIX + username);\n return cm;\n }))\n )\n .flatMap(cm -> serverRequest.bodyToMono(JsonNode.class)\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Request body is required.\"))\n )\n .flatMap(jsonNode -> Mono.fromCallable(() -> {\n if (cm.getData() == null) {\n cm.setData(new HashMap<>());\n }\n var json = mapper.writeValueAsString(jsonNode);\n if (Objects.equals(json, cm.getData().get(group))) {\n return null;\n }\n cm.getData().put(group, json);\n return cm;\n }))\n .flatMap(extension -> {\n if (extension.getMetadata().getVersion() == null) {\n return client.create(extension);\n }\n return client.update(extension);\n })\n .defaultIfEmpty(cm)\n )\n .flatMap(cm -> ServerResponse.noContent().build());\n }\n\n private Mono getMyPreference(ServerRequest serverRequest) {\n var group = serverRequest.pathVariable(\"group\");\n return authenticated()\n .map(Authentication::getName)\n .flatMap(username -> client.fetch(ConfigMap.class, PREFERENCE_PREFIX + username))\n .mapNotNull(ConfigMap::getData)\n .mapNotNull(data -> data.get(group))\n .flatMap(json -> Mono.fromCallable(() -> mapper.readTree(json)))\n .switchIfEmpty(Mono.fromSupplier(mapper::nullNode))\n .flatMap(jsonNode -> ServerResponse.ok().bodyValue(jsonNode));\n }\n\n private Mono authenticated() {\n return ReactiveSecurityContextHolder.getContext()\n .mapNotNull(SecurityContext::getAuthentication)\n .filter(trustResolver::isAuthenticated)\n .switchIfEmpty(Mono.error(() -> new ResponseStatusException(HttpStatus.FORBIDDEN,\n \"Anonymous user is not allowed to access user preference.\"\n )));\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/endpoint/uc/UserConnectionEndpoint.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport org.springdoc.core.fn.builders.parameter.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.user.service.UserConnectionService;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * User connection endpoint.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\npublic class UserConnectionEndpoint implements CustomEndpoint {\n\n private final UserConnectionService connectionService;\n\n private final AuthenticationTrustResolver authenticationTrustResolver =\n new AuthenticationTrustResolverImpl();\n\n public UserConnectionEndpoint(UserConnectionService connectionService) {\n this.connectionService = connectionService;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"UserConnectionV1alpha1Uc\";\n return SpringdocRouteBuilder.route()\n .PUT(\n \"/user-connections/{registerId}/disconnect\",\n request -> {\n var removedUserConnections = ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(authenticationTrustResolver::isAuthenticated)\n .map(Authentication::getName)\n .flatMapMany(username -> connectionService.removeUserConnection(\n request.pathVariable(\"registerId\"), username)\n );\n return ServerResponse.ok().body(removedUserConnections, UserConnection.class);\n },\n builder -> builder.operationId(\"DisconnectMyConnection\")\n .description(\"Disconnect my connection from a third-party platform.\")\n .tag(tag)\n .parameter(Builder.parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"registerId\")\n .description(\"The registration ID of the third-party platform.\")\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder().implementationArray(UserConnection.class))\n )\n .build();\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.auth.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/AnnotationSettingReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.util.StringUtils;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.GroupKind;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n * Reconciler for {@link AnnotationSetting}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class AnnotationSettingReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n @Override\n public Result reconcile(Request request) {\n populateDefaultLabels(request.name());\n return new Result(false, null);\n }\n\n private void populateDefaultLabels(String name) {\n client.fetch(AnnotationSetting.class, name).ifPresent(annotationSetting -> {\n Map labels = MetadataUtil.nullSafeLabels(annotationSetting);\n String oldTargetRef = labels.get(AnnotationSetting.TARGET_REF_LABEL);\n\n GroupKind targetRef = annotationSetting.getSpec().getTargetRef();\n String targetRefLabel = targetRef.group() + \"/\" + targetRef.kind();\n labels.put(AnnotationSetting.TARGET_REF_LABEL, targetRefLabel);\n\n if (!StringUtils.equals(oldTargetRef, targetRefLabel)) {\n client.update(annotationSetting);\n }\n });\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new AnnotationSetting())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/AuthProviderReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport java.time.Duration;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.AuthProvider;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.security.AuthProviderService;\n\n/**\n * Reconciler for {@link AuthProvider}.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Component\n@RequiredArgsConstructor\npublic class AuthProviderReconciler implements Reconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private final ExtensionClient client;\n private final AuthProviderService authProviderService;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(AuthProvider.class, request.name())\n .ifPresent(this::handlePrivileged);\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new AuthProvider())\n .build();\n }\n\n private void handlePrivileged(AuthProvider authProvider) {\n if (privileged(authProvider)) {\n authProviderService.enable(authProvider.getMetadata().getName())\n .block(BLOCKING_TIMEOUT);\n }\n }\n\n private boolean privileged(AuthProvider authProvider) {\n return BooleanUtils.TRUE.equals(MetadataUtil.nullSafeLabels(authProvider)\n .get(AuthProvider.PRIVILEGED_LABEL));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/CategoryReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.MetadataUtil.nullSafeAnnotations;\n\nimport java.time.Duration;\nimport java.util.Set;\nimport lombok.AllArgsConstructor;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.content.permalinks.CategoryPermalinkPolicy;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.CategoryHiddenStateChangeEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * Reconciler for {@link Category}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class CategoryReconciler implements Reconciler {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n static final String FINALIZER_NAME = \"category-protection\";\n private final ExtensionClient client;\n private final CategoryPermalinkPolicy categoryPermalinkPolicy;\n private final CategoryService categoryService;\n private final ApplicationEventPublisher eventPublisher;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Category.class, request.name())\n .ifPresent(category -> {\n if (ExtensionUtil.isDeleted(category)) {\n if (removeFinalizers(category.getMetadata(), Set.of(FINALIZER_NAME))) {\n refreshHiddenState(category, false);\n updateCategoryForPost(category.getMetadata().getName());\n client.update(category);\n }\n return;\n }\n addFinalizers(category.getMetadata(), Set.of(FINALIZER_NAME));\n\n populatePermalinkPattern(category);\n populatePermalink(category);\n checkHiddenState(category);\n\n client.update(category);\n });\n return Result.doNotRetry();\n }\n\n private void checkHiddenState(Category category) {\n final boolean hidden = categoryService.isCategoryHidden(category.getMetadata().getName())\n .blockOptional(BLOCKING_TIMEOUT)\n .orElse(false);\n refreshHiddenState(category, hidden);\n }\n\n /**\n * TODO move this logic to before-create/update hook in the future see {@code gh-4343}.\n */\n private void refreshHiddenState(Category category, boolean hidden) {\n category.getSpec().setHideFromList(hidden);\n if (isHiddenStateChanged(category)) {\n publishHiddenStateChangeEvent(category);\n }\n var children = category.getSpec().getChildren();\n if (CollectionUtils.isEmpty(children)) {\n return;\n }\n for (String childName : children) {\n client.fetch(Category.class, childName)\n .ifPresent(child -> {\n child.getSpec().setHideFromList(hidden);\n if (isHiddenStateChanged(child)) {\n publishHiddenStateChangeEvent(child);\n }\n client.update(child);\n });\n }\n }\n\n private void publishHiddenStateChangeEvent(Category category) {\n var hidden = category.getSpec().isHideFromList();\n nullSafeAnnotations(category).put(Category.LAST_HIDDEN_STATE_ANNO, String.valueOf(hidden));\n eventPublisher.publishEvent(new CategoryHiddenStateChangeEvent(this,\n category.getMetadata().getName(), hidden));\n }\n\n boolean isHiddenStateChanged(Category category) {\n var lastHiddenState = nullSafeAnnotations(category).get(Category.LAST_HIDDEN_STATE_ANNO);\n return !String.valueOf(category.getSpec().isHideFromList()).equals(lastHiddenState);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Category())\n .build();\n }\n\n void populatePermalinkPattern(Category category) {\n var annotations = nullSafeAnnotations(category);\n if (!annotations.containsKey(Constant.PERMALINK_PATTERN_ANNO)) {\n var newPattern = categoryPermalinkPolicy.pattern();\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, newPattern);\n }\n }\n\n void populatePermalink(Category category) {\n category.getStatusOrDefault()\n .setPermalink(categoryPermalinkPolicy.permalink(category));\n }\n\n private void updateCategoryForPost(String categoryName) {\n var posts = client.listAll(Post.class, ListOptions.builder()\n .fieldQuery(Queries.equal(\"spec.categories\", categoryName))\n .build(), Sort.by(\"metadata.creationTimestamp\", \"metadata.name\")\n );\n for (Post post : posts) {\n var categoryNames = post.getSpec().getCategories();\n if (!CollectionUtils.isEmpty(categoryNames)) {\n categoryNames.remove(categoryName);\n }\n client.update(post);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/CommentReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.isDeleted;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.comment.ReplyNotificationSubscriptionHelper;\nimport run.halo.app.content.comment.ReplyService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.event.post.CommentCreatedEvent;\nimport run.halo.app.event.post.CommentUnreadReplyCountChangedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * Reconciler for {@link Comment}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class CommentReconciler implements Reconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n public static final String FINALIZER_NAME = \"comment-protection\";\n private final ExtensionClient client;\n private final SchemeManager schemeManager;\n private final ReplyService replyService;\n private final ApplicationEventPublisher eventPublisher;\n\n private final ReplyNotificationSubscriptionHelper replyNotificationSubscriptionHelper;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Comment.class, request.name())\n .ifPresent(comment -> {\n if (isDeleted(comment)) {\n if (removeFinalizers(comment.getMetadata(), Set.of(FINALIZER_NAME))) {\n cleanUpResources(comment);\n client.update(comment);\n }\n return;\n }\n if (addFinalizers(comment.getMetadata(), Set.of(FINALIZER_NAME))) {\n replyNotificationSubscriptionHelper.subscribeNewReplyReasonForComment(comment);\n client.update(comment);\n eventPublisher.publishEvent(new CommentCreatedEvent(this, comment));\n }\n\n compatibleCreationTime(comment);\n Comment.CommentStatus status = comment.getStatusOrDefault();\n status.setHasNewReply(defaultIfNull(status.getUnreadReplyCount(), 0) > 0);\n\n updateUnReplyCountIfNecessary(comment);\n updateSameSubjectRefCommentCounter(comment);\n\n // version + 1 is required to truly equal version\n // as a version will be incremented after the update\n comment.getStatusOrDefault()\n .setObservedVersion(comment.getMetadata().getVersion() + 1);\n\n client.update(comment);\n });\n return new Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n var extension = new Comment();\n return builder\n .extension(extension)\n .syncAllListOptions(ListOptions.builder()\n .andQuery(equal(Comment.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, true))\n .build())\n .build();\n }\n\n /**\n * If the comment creation time is null, set it to the approved time or the current time.\n * TODO remove this method in the future and fill in attributes in hook mode instead.\n */\n void compatibleCreationTime(Comment comment) {\n var creationTime = comment.getSpec().getCreationTime();\n if (creationTime == null) {\n creationTime = defaultIfNull(comment.getSpec().getApprovedTime(),\n comment.getMetadata().getCreationTimestamp());\n }\n comment.getSpec().setCreationTime(creationTime);\n }\n\n private void updateUnReplyCountIfNecessary(Comment comment) {\n Instant lastReadTime = comment.getSpec().getLastReadTime();\n Map annotations = MetadataUtil.nullSafeAnnotations(comment);\n String lastReadTimeAnno = annotations.get(Constant.LAST_READ_TIME_ANNO);\n if (lastReadTime != null && lastReadTime.toString().equals(lastReadTimeAnno)) {\n return;\n }\n // delegate to other handler though event\n String commentName = comment.getMetadata().getName();\n eventPublisher.publishEvent(new CommentUnreadReplyCountChangedEvent(this, commentName));\n // handled flag\n if (lastReadTime != null) {\n annotations.put(Constant.LAST_READ_TIME_ANNO, lastReadTime.toString());\n } else {\n annotations.remove(Constant.LAST_READ_TIME_ANNO);\n }\n }\n\n private void updateSameSubjectRefCommentCounter(Comment comment) {\n var commentSubjectRef = comment.getSpec().getSubjectRef();\n var totalCount = countTotalComments(commentSubjectRef);\n var approvedTotalCount = countApprovedComments(commentSubjectRef);\n var findScheme = schemeManager.schemes().stream()\n .filter(scheme -> {\n var gvk = scheme.groupVersionKind();\n return Objects.equals(gvk.group(), commentSubjectRef.getGroup())\n && Objects.equals(gvk.kind(), commentSubjectRef.getKind());\n })\n .findFirst();\n findScheme.ifPresent(scheme -> {\n String counterName =\n MeterUtils.nameOf(commentSubjectRef.getGroup(), scheme.plural(),\n commentSubjectRef.getName());\n client.fetch(Counter.class, counterName).ifPresentOrElse(counter -> {\n counter.setTotalComment(totalCount);\n counter.setApprovedComment(approvedTotalCount);\n client.update(counter);\n }, () -> {\n Counter counter = Counter.emptyCounter(counterName);\n counter.setTotalComment(totalCount);\n counter.setApprovedComment(approvedTotalCount);\n client.create(counter);\n });\n });\n }\n\n int countTotalComments(Ref commentSubjectRef) {\n var totalListOptions = new ListOptions();\n totalListOptions.setFieldSelector(FieldSelector.of(getBaseQuery(commentSubjectRef)));\n return (int) client.listBy(Comment.class, totalListOptions, PageRequestImpl.ofSize(1))\n .getTotal();\n }\n\n int countApprovedComments(Ref commentSubjectRef) {\n var approvedListOptions = new ListOptions();\n approvedListOptions.setFieldSelector(FieldSelector.of(and(\n getBaseQuery(commentSubjectRef),\n equal(\"spec.approved\", BooleanUtils.TRUE)\n )));\n return (int) client.listBy(Comment.class, approvedListOptions, PageRequestImpl.ofSize(1))\n .getTotal();\n }\n\n private static Condition getBaseQuery(Ref commentSubjectRef) {\n return and(equal(\"spec.subjectRef\", Comment.toSubjectRefKey(commentSubjectRef)),\n isNull(\"metadata.deletionTimestamp\"));\n }\n\n private void cleanUpResources(Comment comment) {\n // delete all replies under current comment\n replyService.removeAllByComment(comment.getMetadata().getName()).block(BLOCKING_TIMEOUT);\n\n // decrement total comment count\n updateSameSubjectRefCommentCounter(comment);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/MenuItemReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport java.time.Duration;\nimport java.util.Objects;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.core.extension.MenuItem.MenuItemSpec;\nimport run.halo.app.core.extension.MenuItem.MenuItemStatus;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\n\n@Slf4j\n@Component\npublic class MenuItemReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n public MenuItemReconciler(ExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public Result reconcile(Request request) {\n return client.fetch(MenuItem.class, request.name())\n .map(menuItem -> {\n final var spec = menuItem.getSpec();\n\n if (menuItem.getStatus() == null) {\n menuItem.setStatus(new MenuItemStatus());\n }\n var status = menuItem.getStatus();\n var targetRef = spec.getTargetRef();\n if (targetRef != null) {\n if (Ref.groupKindEquals(targetRef, Category.GVK)) {\n return handleCategoryRef(request.name(), status, targetRef);\n }\n if (Ref.groupKindEquals(targetRef, Tag.GVK)) {\n return handleTagRef(request.name(), status, targetRef);\n }\n if (Ref.groupKindEquals(targetRef, SinglePage.GVK)) {\n return handleSinglePageSpec(request.name(), status, targetRef);\n }\n if (Ref.groupKindEquals(targetRef, Post.GVK)) {\n return handlePostRef(request.name(), status, targetRef);\n }\n // unsupported ref\n log.error(\"Unsupported MenuItem targetRef \" + targetRef);\n return Result.doNotRetry();\n } else {\n return handleMenuSpec(request.name(), status, spec);\n }\n }).orElseGet(() -> new Result(false, null));\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new MenuItem())\n .build();\n }\n\n private Result handleCategoryRef(String menuItemName, MenuItemStatus status, Ref categoryRef) {\n client.fetch(Category.class, categoryRef.getName())\n .filter(category -> category.getStatus() != null)\n .filter(category -> StringUtils.hasText(category.getStatus().getPermalink()))\n .ifPresent(category -> {\n status.setHref(category.getStatus().getPermalink());\n status.setDisplayName(category.getSpec().getDisplayName());\n updateStatus(menuItemName, status);\n });\n return new Result(true, Duration.ofMinutes(1));\n }\n\n private Result handleTagRef(String menuItemName, MenuItemStatus status, Ref tagRef) {\n client.fetch(Tag.class, tagRef.getName()).filter(tag -> tag.getStatus() != null)\n .filter(tag -> StringUtils.hasText(tag.getStatus().getPermalink())).ifPresent(tag -> {\n status.setHref(tag.getStatus().getPermalink());\n status.setDisplayName(tag.getSpec().getDisplayName());\n updateStatus(menuItemName, status);\n });\n return new Result(true, Duration.ofMinutes(1));\n }\n\n private Result handlePostRef(String menuItemName, MenuItemStatus status, Ref postRef) {\n client.fetch(Post.class, postRef.getName()).filter(post -> post.getStatus() != null)\n .filter(post -> StringUtils.hasText(post.getStatus().getPermalink()))\n .ifPresent(post -> {\n status.setHref(post.getStatus().getPermalink());\n status.setDisplayName(post.getSpec().getTitle());\n updateStatus(menuItemName, status);\n });\n return new Result(true, Duration.ofMinutes(1));\n }\n\n private Result handleSinglePageSpec(String menuItemName, MenuItemStatus status, Ref pageRef) {\n client.fetch(SinglePage.class, pageRef.getName())\n .filter(page -> page.getStatus() != null)\n .filter(page -> StringUtils.hasText(page.getStatus().getPermalink()))\n .ifPresent(page -> {\n status.setHref(page.getStatus().getPermalink());\n status.setDisplayName(page.getSpec().getTitle());\n updateStatus(menuItemName, status);\n });\n return new Result(true, Duration.ofMinutes(1));\n }\n\n private Result handleMenuSpec(String menuItemName, MenuItemStatus status, MenuItemSpec spec) {\n if (spec.getHref() != null && StringUtils.hasText(spec.getDisplayName())) {\n status.setHref(spec.getHref());\n status.setDisplayName(spec.getDisplayName());\n updateStatus(menuItemName, status);\n }\n return new Result(false, null);\n }\n\n private void updateStatus(String menuItemName, MenuItemStatus status) {\n client.fetch(MenuItem.class, menuItemName)\n .filter(menuItem -> !Objects.deepEquals(menuItem.getStatus(), status))\n .ifPresent(menuItem -> {\n menuItem.setStatus(status);\n client.update(menuItem);\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/PluginReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static run.halo.app.core.extension.Plugin.PluginStatus.nullSafeConditions;\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.MetadataUtil.nullSafeAnnotations;\nimport static run.halo.app.plugin.PluginConst.PLUGIN_PATH;\nimport static run.halo.app.plugin.PluginConst.RELOAD_ANNO;\nimport static run.halo.app.plugin.PluginConst.REQUEST_TO_UNLOAD_LABEL;\nimport static run.halo.app.plugin.PluginExtensionLoaderUtils.isSetting;\nimport static run.halo.app.plugin.PluginExtensionLoaderUtils.lookupExtensions;\nimport static run.halo.app.plugin.PluginUtils.generateFileName;\nimport static run.halo.app.plugin.PluginUtils.isDevelopmentMode;\n\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.io.PrintWriter;\nimport java.io.StringWriter;\nimport java.net.MalformedURLException;\nimport java.net.URISyntaxException;\nimport java.net.URL;\nimport java.nio.file.FileSystemNotFoundException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport java.util.function.Predicate;\nimport java.util.function.Supplier;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginWrapper;\nimport org.pf4j.RuntimeMode;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.ResourceUtils;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.Disposable;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.controller.RequeueException;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionList;\nimport run.halo.app.infra.ConditionStatus;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.infra.utils.SettingUtils;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\nimport run.halo.app.plugin.OptionalDependentResolver;\nimport run.halo.app.plugin.PluginConst;\nimport run.halo.app.plugin.PluginProperties;\nimport run.halo.app.plugin.PluginService;\nimport run.halo.app.plugin.SpringPluginManager;\n\n/**\n * Plugin reconciler.\n *\n * @author guqing\n * @author johnniang\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass PluginReconciler implements Reconciler, DisposableBean {\n private static final String FINALIZER_NAME = \"plugin-protection\";\n\n private static final Set UNUSED_ANNOTATIONS =\n Set.of(\"plugin.halo.run/dependents-snapshot\");\n\n private final ExtensionClient client;\n\n private final SpringPluginManager pluginManager;\n\n private final PluginProperties pluginProperties;\n\n private final PluginService pluginService;\n\n private final ConcurrentMap pluginStartTasks = new ConcurrentHashMap<>();\n\n private Scheduler scheduler = Schedulers.newBoundedElastic(\n 1, Schedulers.DEFAULT_BOUNDED_ELASTIC_QUEUESIZE, \"plugin-starter\"\n );\n\n private Clock clock = Clock.systemUTC();\n\n @Override\n public void destroy() throws Exception {\n pluginStartTasks.clear();\n this.scheduler.dispose();\n }\n\n /**\n * Only for testing.\n *\n * @param clock new clock.\n */\n void setClock(Clock clock) {\n Assert.notNull(clock, \"clock must not be null\");\n this.clock = clock;\n }\n\n /**\n * Only for testing.\n *\n * @param scheduler new scheduler.\n */\n void setScheduler(Scheduler scheduler) {\n Assert.notNull(scheduler, \"scheduler must not be null\");\n this.scheduler = scheduler;\n }\n\n @Override\n public Result reconcile(Request request) {\n return client.fetch(Plugin.class, request.name())\n .map(plugin -> {\n if (ExtensionUtil.isDeleted(plugin)) {\n if (!checkDependents(plugin)) {\n client.update(plugin);\n // Check dependents every 10 seconds\n return Result.requeue(Duration.ofSeconds(10));\n }\n // CleanUp resources and remove finalizer.\n if (removeFinalizers(plugin.getMetadata(), Set.of(FINALIZER_NAME))) {\n cleanupResources(plugin);\n syncPluginState(plugin);\n client.update(plugin);\n }\n return Result.doNotRetry();\n }\n addFinalizers(plugin.getMetadata(), Set.of(FINALIZER_NAME));\n removeUnusedAnnotations(plugin);\n\n var status = plugin.getStatus();\n if (status == null) {\n status = new Plugin.PluginStatus();\n plugin.setStatus(status);\n }\n if (status.getPhase() == null) {\n // reset phase to pending\n status.setPhase(Plugin.Phase.PENDING);\n }\n // init condition list if not exists\n if (status.getConditions() == null) {\n status.setConditions(new ConditionList());\n }\n\n var steps = new LinkedList>();\n steps.add(() -> resolveLoadLocation(plugin));\n steps.add(() -> loadOrReload(plugin));\n steps.add(() -> createOrUpdateSetting(plugin));\n steps.add(() -> createOrUpdateReverseProxy(plugin));\n steps.add(() -> resolveStaticResources(plugin));\n if (requestToEnable(plugin)) {\n steps.add(() -> enablePlugin(plugin));\n } else {\n steps.add(() -> disablePlugin(plugin));\n }\n\n Result result = null;\n try {\n for (var step : steps) {\n result = step.get();\n if (result != null) {\n break;\n }\n }\n return result;\n } catch (Throwable e) {\n status.getConditions().addAndEvictFIFO(Condition.builder()\n .type(ConditionType.READY)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.SYSTEM_ERROR)\n .message(e.getMessage())\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.UNKNOWN);\n throw e;\n } finally {\n var pw = pluginManager.getPlugin(plugin.getMetadata().getName());\n if (pw != null) {\n status.setLastProbeState(pw.getPluginState());\n }\n client.update(plugin);\n }\n })\n .orElseGet(Result::doNotRetry);\n }\n\n private void removeUnusedAnnotations(Plugin plugin) {\n var annotations = plugin.getMetadata().getAnnotations();\n if (annotations != null) {\n UNUSED_ANNOTATIONS.forEach(annotations::remove);\n }\n }\n\n private boolean checkDependents(Plugin plugin) {\n var pluginId = plugin.getMetadata().getName();\n var dependents = pluginManager.getDependents(pluginId);\n if (CollectionUtils.isEmpty(dependents)) {\n return true;\n }\n var status = plugin.statusNonNull();\n var condition = Condition.builder()\n .type(ConditionType.PROGRESSING)\n .status(ConditionStatus.UNKNOWN)\n .reason(ConditionReason.WAIT_FOR_DEPENDENTS_DELETED)\n .message(\n \"The plugin has dependents %s, please delete them first.\"\n .formatted(dependents.stream().map(PluginWrapper::getPluginId).toList())\n )\n .lastTransitionTime(clock.instant())\n .build();\n var conditions = nullSafeConditions(status);\n removeConditionBy(conditions, ConditionType.INITIALIZED);\n removeConditionBy(conditions, ConditionType.READY);\n conditions.addAndEvictFIFO(condition);\n status.setPhase(Plugin.Phase.UNKNOWN);\n return false;\n }\n\n private void syncPluginState(Plugin plugin) {\n var pluginName = plugin.getMetadata().getName();\n var p = pluginManager.getPlugin(pluginName);\n if (p != null) {\n plugin.statusNonNull().setLastProbeState(p.getPluginState());\n } else {\n plugin.statusNonNull().setLastProbeState(null);\n }\n }\n\n private static String requestToUnload(Plugin plugin) {\n var labels = plugin.getMetadata().getLabels();\n if (labels == null) {\n return null;\n }\n return labels.get(REQUEST_TO_UNLOAD_LABEL);\n }\n\n private static boolean requestToReload(Plugin plugin) {\n var annotations = plugin.getMetadata().getAnnotations();\n return annotations != null && annotations.get(RELOAD_ANNO) != null;\n }\n\n private static void removeRequestToReload(Plugin plugin) {\n var annotations = plugin.getMetadata().getAnnotations();\n if (annotations != null) {\n annotations.remove(RELOAD_ANNO);\n }\n }\n\n private void cleanupResources(Plugin plugin) {\n var pluginName = plugin.getMetadata().getName();\n var reverseProxyName = buildReverseProxyName(pluginName);\n log.info(\"Deleting reverse proxy {} for plugin {}\", reverseProxyName, pluginName);\n client.fetch(ReverseProxy.class, reverseProxyName)\n .ifPresent(reverseProxy -> {\n client.delete(reverseProxy);\n throw new RequeueException(Result.requeue(null),\n String.format(\"\"\"\n Waiting for reverse proxy %s to be deleted.\"\"\", reverseProxyName)\n );\n });\n var settingName = plugin.getSpec().getSettingName();\n if (StringUtils.isNotBlank(settingName)) {\n log.info(\"Deleting settings {} for plugin {}\", settingName, pluginName);\n client.fetch(Setting.class, settingName)\n .ifPresent(setting -> {\n client.delete(setting);\n throw new RequeueException(Result.requeue(null), String.format(\"\"\"\n Waiting for setting %s to be deleted.\"\"\", settingName));\n });\n }\n if (pluginManager.getPlugin(pluginName) != null) {\n log.info(\"Deleting plugin {} in plugin manager.\", pluginName);\n var deleted = pluginManager.deletePlugin(pluginName);\n if (!deleted) {\n log.warn(\"Failed to delete plugin {}\", pluginName);\n }\n }\n }\n\n private Result enablePlugin(Plugin plugin) {\n // start the plugin\n var pluginName = plugin.getMetadata().getName();\n log.info(\"Starting plugin {}\", pluginName);\n var status = plugin.getStatus();\n\n // check if the parent plugin is started\n var unstartedDependencies = pluginService.getRequiredDependencies(plugin, pw ->\n pw == null || !PluginState.STARTED.equals(pw.getPluginState())\n );\n var conditions = status.getConditions();\n if (!CollectionUtils.isEmpty(unstartedDependencies)) {\n removeConditionBy(conditions, ConditionType.READY);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.PROGRESSING)\n .status(ConditionStatus.UNKNOWN)\n .reason(ConditionReason.WAIT_FOR_DEPENDENCIES_STARTED)\n .message(\"Wait for parent plugins \" + unstartedDependencies + \" to be started\")\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.UNKNOWN);\n return Result.requeue(Duration.ofSeconds(5));\n }\n\n var current = pluginManager.getPlugin(pluginName);\n if (current == null) {\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.READY)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.START_ERROR)\n .message(\"Plugin \" + pluginName + \" is not loaded.\")\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.FAILED);\n removeStartTaskIfPresent(pluginName);\n return Result.doNotRetry();\n }\n var pluginState = current.getPluginState();\n if (pluginState.isStarted()) {\n removeConditionBy(conditions, ConditionType.PROGRESSING);\n status.setLastStartTime(clock.instant());\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.READY)\n .status(ConditionStatus.TRUE)\n .reason(ConditionReason.STARTED)\n .message(\"Started successfully\")\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.STARTED);\n removeStartTaskIfPresent(pluginName);\n requestToReloadPluginsOptionallyDependentOn(pluginName);\n return Result.doNotRetry();\n }\n if (pluginState.isFailed()) {\n var t = current.getFailedException();\n log.debug(\"Error occurred when starting plugin {}\", pluginName, t);\n var writer = new StringWriter();\n t.printStackTrace(new PrintWriter(writer));\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.READY)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.START_ERROR)\n .message(writer.toString())\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.FAILED);\n removeStartTaskIfPresent(pluginName);\n return Result.doNotRetry();\n }\n if (!Plugin.Phase.STARTING.equals(status.getPhase())) {\n pluginStartTasks.compute(pluginName, (name, old) -> {\n if (old != null && !old.isDisposed()) {\n log.info(\"Cancelling old starting task for plugin {}.\", name);\n old.dispose();\n log.info(\"Cancelled old starting task for plugin {}.\", name);\n }\n return scheduler.schedule(() -> {\n log.info(\"Starting plugin {} in background thread.\", name);\n try {\n var state = pluginManager.startPlugin(name);\n log.info(\"Plugin {} started with state {}.\", name, state);\n } catch (Throwable t) {\n var pluginWrapper = pluginManager.getPlugin(name);\n if (pluginWrapper != null) {\n pluginWrapper.setPluginState(PluginState.FAILED);\n pluginWrapper.setFailedException(t);\n }\n }\n });\n });\n status.setPhase(Plugin.Phase.STARTING);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.PROGRESSING)\n .status(ConditionStatus.TRUE)\n .reason(ConditionReason.STARTING)\n .message(\"Starting plugin \" + pluginName)\n .lastTransitionTime(clock.instant())\n .build());\n } else {\n log.debug(\"Plugin {} is starting...\", pluginName);\n }\n return Result.requeue(Duration.ofSeconds(2));\n }\n\n void requestToReloadPluginsOptionallyDependentOn(String pluginName) {\n var startedPlugins = pluginManager.startedPlugins()\n .stream()\n .map(PluginWrapper::getDescriptor)\n .toList();\n var resolver = new OptionalDependentResolver(startedPlugins);\n var dependents = resolver.getOptionalDependents(pluginName);\n for (String dependentName : dependents) {\n client.fetch(Plugin.class, dependentName)\n .ifPresent(childPlugin -> {\n var annotations = MetadataUtil.nullSafeAnnotations(childPlugin);\n // loadLocation never be null for started plugins\n annotations.put(RELOAD_ANNO,\n childPlugin.getStatus().getLoadLocation().toString());\n client.update(childPlugin);\n });\n }\n }\n\n private Result disablePlugin(Plugin plugin) {\n var pluginName = plugin.getMetadata().getName();\n var status = plugin.getStatus();\n if (pluginManager.getPlugin(pluginName) != null) {\n // check if the plugin has children\n var dependents = pluginManager.getDependents(pluginName)\n .stream()\n .filter(pw -> PluginState.STARTED.equals(pw.getPluginState()))\n .map(PluginWrapper::getPluginId)\n .toList();\n var conditions = status.getConditions();\n if (!CollectionUtils.isEmpty(dependents)) {\n removeConditionBy(conditions, ConditionType.READY);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.PROGRESSING)\n .status(ConditionStatus.UNKNOWN)\n .reason(ConditionReason.WAIT_FOR_DEPENDENTS_DISABLED)\n .message(\"Wait for children plugins \" + dependents + \" to be disabled\")\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.DISABLING);\n return Result.requeue(Duration.ofSeconds(1));\n }\n try {\n // First, stop starting task if exists\n removeStartTaskIfPresent(pluginName);\n pluginManager.disablePlugin(pluginName);\n } catch (Throwable e) {\n log.error(\"Error occurred when disabling plugin {}\", pluginName, e);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.READY)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.DISABLE_ERROR)\n .message(e.getMessage())\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.FAILED);\n return Result.doNotRetry();\n }\n }\n var conditions = plugin.getStatus().getConditions();\n removeConditionBy(conditions, ConditionType.PROGRESSING);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.READY)\n .status(ConditionStatus.TRUE)\n .reason(ConditionReason.DISABLED)\n .lastTransitionTime(clock.instant())\n .build());\n plugin.statusNonNull().setPhase(Plugin.Phase.DISABLED);\n return null;\n }\n\n private static boolean requestToEnable(Plugin plugin) {\n var enabled = plugin.getSpec().getEnabled();\n return enabled != null && enabled;\n }\n\n private Result resolveStaticResources(Plugin plugin) {\n var pluginName = plugin.getMetadata().getName();\n var pluginVersion = plugin.getSpec().getVersion();\n if (isDevelopmentMode(plugin)) {\n // when we are in dev mode, the plugin version is not always changed.\n pluginVersion = String.valueOf(clock.instant().toEpochMilli());\n }\n var status = plugin.statusNonNull();\n var specLogo = plugin.getSpec().getLogo();\n if (StringUtils.isNotBlank(specLogo)) {\n log.info(\"Resolving logo resource for plugin {}\", pluginName);\n // the logo might be:\n // 1. URL\n // 2. relative path to \"resources\" folder\n // 3. base64 format data image\n var logo = specLogo;\n if (!specLogo.startsWith(\"data:image\")) {\n try {\n logo = new URL(specLogo).toString();\n } catch (MalformedURLException ignored) {\n // indicate the logo is a path\n logo = UriComponentsBuilder.newInstance()\n .pathSegment(\"plugins\", pluginName, \"assets\")\n .path(specLogo)\n .queryParam(\"version\", pluginVersion)\n .build(true)\n .toString();\n }\n }\n status.setLogo(logo);\n }\n\n log.info(\"Resolving main.js and style.css for plugin {}\", pluginName);\n var p = pluginManager.getPlugin(pluginName);\n var classLoader = p.getPluginClassLoader();\n var resLoader = new DefaultResourceLoader(classLoader);\n var entryRes = resLoader.getResource(\"classpath:console/main.js\");\n var cssRes = resLoader.getResource(\"classpath:console/style.css\");\n if (entryRes.exists()) {\n var entry = UriComponentsBuilder.newInstance()\n .pathSegment(\"plugins\", pluginName, \"assets\", \"console\", \"main.js\")\n .queryParam(\"version\", pluginVersion)\n .build(true)\n .toString();\n status.setEntry(entry);\n }\n if (cssRes.exists()) {\n var stylesheet = UriComponentsBuilder.newInstance()\n .pathSegment(\"plugins\", pluginName, \"assets\", \"console\", \"style.css\")\n .queryParam(\"version\", pluginVersion)\n .build(true)\n .toString();\n status.setStylesheet(stylesheet);\n }\n return null;\n }\n\n private Result loadOrReload(Plugin plugin) {\n var pluginName = plugin.getMetadata().getName();\n var p = pluginManager.getPlugin(pluginName);\n var conditions = plugin.getStatus().getConditions();\n\n var requestToUnloadBy = requestToUnload(plugin);\n var requestToUnload = requestToUnloadBy != null;\n var notFullyLoaded = p != null && pluginManager.getUnresolvedPlugins().contains(p);\n var alreadyLoaded = p != null && pluginManager.getResolvedPlugins().contains(p);\n\n var requestToReload = requestToReload(plugin);\n // TODO Check load location\n var shouldUnload = requestToUnload || requestToReload || notFullyLoaded;\n if (shouldUnload) {\n // check if the plugin is already loaded or not fully loaded.\n if (alreadyLoaded || notFullyLoaded) {\n // get all dependencies\n var dependents = requestToUnloadChildren(pluginName);\n if (!CollectionUtils.isEmpty(dependents)) {\n removeConditionBy(conditions, ConditionType.READY);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.PROGRESSING)\n .status(ConditionStatus.UNKNOWN)\n .reason(ConditionReason.WAIT_FOR_DEPENDENTS_UNLOADED)\n .message(\"Wait for children plugins \" + dependents + \"to be unloaded\")\n .lastTransitionTime(clock.instant())\n .build());\n plugin.getStatus().setPhase(Plugin.Phase.UNKNOWN);\n // wait for children plugins unloaded\n // retry after 1 second\n return Result.requeue(Duration.ofSeconds(1));\n }\n\n // unload the plugin exactly\n pluginManager.unloadPlugin(pluginName);\n\n removeConditionBy(conditions, ConditionType.INITIALIZED);\n removeConditionBy(conditions, ConditionType.PROGRESSING);\n removeConditionBy(conditions, ConditionType.READY);\n\n cancelUnloadRequest(pluginName);\n p = null;\n }\n\n // ensure removing the reload annotation after the plugin is unloaded\n if (requestToUnload) {\n // skip loading and wait for removing the annotation by other plugins.\n var status = plugin.getStatus();\n status.getConditions().addAndEvictFIFO(Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.REQUEST_TO_UNLOAD)\n .message(\"Request to unload by \" + requestToUnloadBy)\n .lastTransitionTime(clock.instant())\n .build());\n return Result.doNotRetry();\n }\n\n if (requestToReload) {\n removeRequestToReload(plugin);\n }\n }\n\n // check dependencies before loading\n var unresolvedParentPlugins = pluginService.getRequiredDependencies(plugin,\n pw -> pw == null || pluginManager.getUnresolvedPlugins().contains(pw)\n );\n if (!unresolvedParentPlugins.isEmpty()) {\n // requeue if the parent plugin is not loaded yet.\n removeConditionBy(conditions, ConditionType.INITIALIZED);\n removeConditionBy(conditions, ConditionType.READY);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.PROGRESSING)\n .status(ConditionStatus.UNKNOWN)\n .reason(ConditionReason.WAIT_FOR_DEPENDENCIES_LOADED)\n .message(\"Wait for parent plugins \" + unresolvedParentPlugins + \" to be loaded\")\n .lastTransitionTime(clock.instant())\n .build());\n plugin.getStatus().setPhase(Plugin.Phase.UNKNOWN);\n return Result.requeue(Duration.ofSeconds(1));\n }\n\n if (p == null) {\n var loadLocation = plugin.getStatus().getLoadLocation();\n log.info(\"Loading plugin {} from {}\", pluginName, loadLocation);\n pluginManager.loadPlugin(Paths.get(loadLocation));\n plugin.getStatus().setPhase(Plugin.Phase.RESOLVED);\n log.info(\"Loaded plugin {} from {}\", pluginName, loadLocation);\n conditions.addAndEvictFIFO(Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.TRUE)\n .reason(ConditionReason.LOADED)\n .lastTransitionTime(clock.instant())\n .build());\n }\n\n return null;\n }\n\n private Result createOrUpdateSetting(Plugin plugin) {\n log.info(\"Initializing setting and config map for plugin {}\",\n plugin.getMetadata().getName());\n var settingName = plugin.getSpec().getSettingName();\n if (StringUtils.isBlank(settingName)) {\n // do nothing if no setting name provided.\n return null;\n }\n\n var pluginName = plugin.getMetadata().getName();\n var p = pluginManager.getPlugin(pluginName);\n var resources = lookupExtensions(p.getPluginClassLoader());\n var loader = new YamlUnstructuredLoader(resources);\n var setting = loader.load().stream()\n .filter(isSetting(settingName))\n .findFirst()\n .map(u -> Unstructured.OBJECT_MAPPER.convertValue(u, Setting.class))\n .orElseThrow(() -> new IllegalStateException(String.format(\"\"\"\n Setting name %s was provided but setting extension \\\n was not found in plugin %s.\"\"\",\n settingName, pluginName)));\n\n client.fetch(Setting.class, settingName)\n .ifPresentOrElse(oldSetting -> {\n // overwrite the setting\n var version = oldSetting.getMetadata().getVersion();\n setting.getMetadata().setVersion(version);\n // TODO Remove this line in the future\n removeFinalizers(setting.getMetadata(), Set.of(\"plugin-protector\"));\n client.update(setting);\n }, () -> client.create(setting));\n\n log.info(\"Initialized setting {} for plugin {}\", settingName, pluginName);\n\n // create default config map\n var configMapName = plugin.getSpec().getConfigMapName();\n if (StringUtils.isBlank(configMapName)) {\n return null;\n }\n\n var defaultConfigMap = SettingUtils.populateDefaultConfig(setting, configMapName);\n\n client.fetch(ConfigMap.class, configMapName)\n .ifPresentOrElse(configMap -> {\n // merge data\n var oldData = configMap.getData();\n var defaultData = defaultConfigMap.getData();\n var mergedData = SettingUtils.mergePatch(oldData, defaultData);\n configMap.setData(mergedData);\n client.update(configMap);\n }, () -> client.create(defaultConfigMap));\n log.info(\"Initialized config map {} for plugin {}\", configMapName, pluginName);\n return null;\n }\n\n private Result resolveLoadLocation(Plugin plugin) {\n log.debug(\"Resolving load location for plugin {}\", plugin.getMetadata().getName());\n\n // populate load location from annotations\n var pluginName = plugin.getMetadata().getName();\n var annotations = nullSafeAnnotations(plugin);\n var pluginPathAnno = annotations.get(PLUGIN_PATH);\n var status = plugin.statusNonNull();\n if (isDevelopmentMode(plugin)) {\n if (!isInDevEnvironment()) {\n status.getConditions().addAndEvictFIFO(Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.INVALID_RUNTIME_MODE)\n .message(\"\"\"\n Cannot run the plugin with development mode in non-development environment.\\\n \"\"\")\n .lastTransitionTime(clock.instant())\n .build());\n status.setPhase(Plugin.Phase.UNKNOWN);\n return Result.doNotRetry();\n }\n log.debug(\"Plugin {} is in development mode\", pluginName);\n if (StringUtils.isBlank(pluginPathAnno)) {\n status.getConditions().addAndEvictFIFO(Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.PLUGIN_PATH_NOT_SET)\n .message(\"\"\"\n Plugin path annotation is not set. \\\n Please set plugin path annotation \"%s\" in development mode.\\\n \"\"\".formatted(PLUGIN_PATH))\n .build());\n return Result.doNotRetry();\n }\n try {\n var loadLocation = ResourceUtils.getURL(pluginPathAnno).toURI();\n if (!Objects.equals(status.getLoadLocation(), loadLocation)) {\n log.debug(\"Populated load location {} for plugin {} from annotation {}\",\n loadLocation, pluginName, pluginPathAnno);\n status.setLoadLocation(loadLocation);\n status.setPhase(Plugin.Phase.RESOLVED);\n status.getConditions().addAndEvictFIFO(Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.TRUE)\n .reason(ConditionReason.LOAD_LOCATION_RESOLVED)\n .lastTransitionTime(clock.instant())\n .build());\n log.debug(\"Populated load location {} for plugin {}\",\n status.getLoadLocation(), pluginName\n );\n }\n } catch (URISyntaxException | FileNotFoundException e) {\n // TODO Refactor this using event in the future.\n var condition = Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.INVALID_PLUGIN_PATH)\n .message(\"Invalid plugin path \" + pluginPathAnno + \" configured.\")\n .lastTransitionTime(clock.instant())\n .build();\n status.getConditions().addAndEvictFIFO(condition);\n status.setPhase(Plugin.Phase.UNKNOWN);\n return Result.doNotRetry();\n }\n } else {\n // reset annotation PLUGIN_PATH in non-dev mode\n var pluginFilename = generateFileName(plugin);\n var pluginRoot = pluginManager.getPluginsRoots().stream()\n .filter(root -> Files.exists(root.resolve(pluginFilename)))\n .findFirst()\n .orElse(null);\n if (pluginRoot == null) {\n var condition = Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.FALSE)\n .reason(ConditionReason.INVALID_PLUGIN_PATH)\n .message(\"Cannot find plugin file \" + pluginFilename + \" in plugins roots.\")\n .lastTransitionTime(clock.instant())\n .build();\n status.getConditions().addAndEvictFIFO(condition);\n status.setPhase(Plugin.Phase.UNKNOWN);\n return Result.doNotRetry();\n }\n var pluginPath = pluginRoot.resolve(pluginFilename);\n annotations.put(PLUGIN_PATH, pluginRoot.relativize(pluginPath).toString());\n\n // delete old load location if changed.\n var oldLoadLocation = status.getLoadLocation();\n var newLoadLocation = pluginPath.toUri();\n if (oldLoadLocation != null && !Objects.equals(oldLoadLocation, newLoadLocation)) {\n // delete the old load location\n log.info(\"Deleting old plugin file {} for plugin {}, and new load location is {}.\",\n oldLoadLocation, pluginName, newLoadLocation);\n try {\n var deleted = Files.deleteIfExists(Path.of(oldLoadLocation));\n if (deleted) {\n log.info(\"Deleted old plugin file {} for plugin {}.\",\n oldLoadLocation, pluginName);\n }\n } catch (IOException e) {\n log.warn(\"Failed to delete old plugin file {} for plugin {}\",\n oldLoadLocation, pluginName, e);\n } catch (FileSystemNotFoundException e) {\n log.warn(\n \"Failed to delete old plugin file {} for plugin {}: File system not found.\",\n oldLoadLocation, pluginName, e);\n }\n status.setPhase(Plugin.Phase.RESOLVED);\n status.getConditions().addAndEvictFIFO(Condition.builder()\n .type(ConditionType.INITIALIZED)\n .status(ConditionStatus.TRUE)\n .reason(ConditionReason.LOAD_LOCATION_RESOLVED)\n .lastTransitionTime(clock.instant())\n .build());\n log.debug(\"Populated load location {} for plugin {}\",\n status.getLoadLocation(), pluginName\n );\n }\n status.setLoadLocation(newLoadLocation);\n }\n return null;\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Plugin())\n .syncAllOnStart(true)\n .build();\n }\n\n private void removeStartTaskIfPresent(String pluginName) {\n pluginStartTasks.computeIfPresent(pluginName, (name, disposable) -> {\n if (!disposable.isDisposed()) {\n log.info(\"Cancelling starting task for plugin {}.\", name);\n disposable.dispose();\n log.info(\"Cancelled starting task for plugin {}.\", name);\n }\n return null;\n });\n }\n\n private Result createOrUpdateReverseProxy(Plugin plugin) {\n String pluginName = plugin.getMetadata().getName();\n String reverseProxyName = buildReverseProxyName(pluginName);\n ReverseProxy reverseProxy = new ReverseProxy();\n reverseProxy.setMetadata(new Metadata());\n reverseProxy.getMetadata().setName(reverseProxyName);\n // put label to identify this reverse\n reverseProxy.getMetadata().setLabels(new HashMap<>());\n reverseProxy.getMetadata().getLabels().put(PluginConst.PLUGIN_NAME_LABEL_NAME, pluginName);\n\n reverseProxy.setRules(new ArrayList<>());\n\n String logo = plugin.getSpec().getLogo();\n if (StringUtils.isNotBlank(logo) && !PathUtils.isAbsoluteUri(logo)) {\n ReverseProxy.ReverseProxyRule logoRule = new ReverseProxy.ReverseProxyRule(logo,\n new ReverseProxy.FileReverseProxyProvider(null, logo));\n reverseProxy.getRules().add(logoRule);\n }\n\n client.fetch(ReverseProxy.class, reverseProxyName)\n .ifPresentOrElse(persisted -> {\n reverseProxy.getMetadata()\n .setVersion(persisted.getMetadata().getVersion());\n client.update(reverseProxy);\n }, () -> client.create(reverseProxy));\n return null;\n }\n\n private boolean isInDevEnvironment() {\n return RuntimeMode.DEVELOPMENT.equals(pluginProperties.getRuntimeMode());\n }\n\n static String buildReverseProxyName(String pluginName) {\n return pluginName + \"-system-generated-reverse-proxy\";\n }\n\n private List requestToUnloadChildren(String pluginName) {\n // get all dependencies\n var dependents = pluginManager.getDependents(pluginName)\n .stream()\n .map(PluginWrapper::getPluginId)\n .toList();\n // request all dependents to reload.\n dependents.forEach(dependent -> client.fetch(Plugin.class, dependent)\n .ifPresent(childPlugin -> {\n var labels = childPlugin.getMetadata().getLabels();\n if (labels == null) {\n labels = new HashMap<>();\n childPlugin.getMetadata().setLabels(labels);\n }\n var label = labels.get(REQUEST_TO_UNLOAD_LABEL);\n if (!pluginName.equals(label)) {\n labels.put(REQUEST_TO_UNLOAD_LABEL, pluginName);\n client.update(childPlugin);\n }\n }));\n return dependents;\n }\n\n private void cancelUnloadRequest(String pluginName) {\n // remove label REQUEST_TO_UNLOAD_LABEL\n // TODO Use index mechanism\n Predicate filter = aplugin -> {\n var labels = aplugin.getMetadata().getLabels();\n return labels != null && pluginName.equals(labels.get(REQUEST_TO_UNLOAD_LABEL));\n };\n\n client.list(Plugin.class, filter, null)\n .forEach(aplugin -> {\n var labels = aplugin.getMetadata().getLabels();\n if (labels != null && labels.remove(REQUEST_TO_UNLOAD_LABEL) != null) {\n client.update(aplugin);\n }\n });\n\n }\n\n private static void removeConditionBy(ConditionList conditions, String type) {\n conditions.removeIf(condition -> Objects.equals(type, condition.getType()));\n }\n\n public static class ConditionType {\n /**\n * Indicates whether the plugin is initialized.\n */\n public static final String INITIALIZED = \"Initialized\";\n\n /**\n * Indicates whether the plugin is starting, disabling or deleting.\n */\n public static final String PROGRESSING = \"Progressing\";\n\n /**\n * Indicates whether the plugin is ready.\n */\n public static final String READY = \"Ready\";\n }\n\n public static class ConditionReason {\n public static final String LOAD_LOCATION_RESOLVED = \"LoadLocationResolved\";\n public static final String INVALID_PLUGIN_PATH = \"InvalidPluginPath\";\n\n public static final String WAIT_FOR_DEPENDENCIES_STARTED = \"WaitForDependenciesStarted\";\n public static final String WAIT_FOR_DEPENDENCIES_LOADED = \"WaitForDependenciesLoaded\";\n\n public static final String WAIT_FOR_DEPENDENTS_DELETED = \"WaitForDependentsDeleted\";\n public static final String WAIT_FOR_DEPENDENTS_DISABLED = \"WaitForDependentsDisabled\";\n public static final String WAIT_FOR_DEPENDENTS_UNLOADED = \"WaitForDependentsUnloaded\";\n\n public static final String STARTING = \"Starting\";\n public static final String STARTED = \"Started\";\n public static final String DISABLED = \"Disabled\";\n public static final String SYSTEM_ERROR = \"SystemError\";\n public static final String REQUEST_TO_UNLOAD = \"RequestToUnload\";\n public static final String LOADED = \"Loaded\";\n public static final String START_ERROR = \"StartError\";\n public static final String DISABLE_ERROR = \"DisableError\";\n public static final String INVALID_RUNTIME_MODE = \"InvalidRuntimeMode\";\n public static final String PLUGIN_PATH_NOT_SET = \"PluginPathNotSet\";\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/PostCounterReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static run.halo.app.extension.index.query.Queries.startsWith;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.PostStatsChangedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n@Component\n@RequiredArgsConstructor\npublic class PostCounterReconciler implements Reconciler {\n\n private final ApplicationEventPublisher eventPublisher;\n private final ExtensionClient client;\n\n @Override\n public Result reconcile(Request request) {\n if (!isSameAsPost(request.name())) {\n return Result.doNotRetry();\n }\n client.fetch(Counter.class, request.name()).ifPresent(counter -> {\n eventPublisher.publishEvent(new PostStatsChangedEvent(this, counter));\n });\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n var extension = new Counter();\n return builder\n .extension(extension)\n .syncAllListOptions(ListOptions.builder()\n .andQuery(startsWith(\"metadata.name\", MeterUtils.nameOf(Post.class, \"\")))\n .build())\n .build();\n }\n\n static boolean isSameAsPost(String name) {\n return name.startsWith(MeterUtils.nameOf(Post.class, \"\"));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/PostReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.apache.commons.lang3.BooleanUtils.TRUE;\nimport static org.apache.commons.lang3.BooleanUtils.isFalse;\nimport static org.apache.commons.lang3.BooleanUtils.isTrue;\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.MetadataUtil.nullSafeAnnotations;\nimport static run.halo.app.extension.MetadataUtil.nullSafeLabels;\nimport static run.halo.app.extension.index.query.Queries.in;\n\nimport com.google.common.hash.Hashing;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.HashSet;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.jsoup.Jsoup;\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.ExcerptGenerator;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.comment.CommentService;\nimport run.halo.app.content.permalinks.PostPermalinkPolicy;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Post.PostPhase;\nimport run.halo.app.core.extension.content.Post.VisibleEnum;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.event.post.PostDeletedEvent;\nimport run.halo.app.event.post.PostPublishedEvent;\nimport run.halo.app.event.post.PostUnpublishedEvent;\nimport run.halo.app.event.post.PostUpdatedEvent;\nimport run.halo.app.event.post.PostVisibleChangedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionOperator;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequeueException;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionStatus;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n *

Reconciler for {@link Post}.

\n *\n *

things to do:

\n *
    \n * 1. generate permalink\n * 2. generate excerpt if auto generate is enabled\n *
\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@AllArgsConstructor\n@Component\npublic class PostReconciler implements Reconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private static final String FINALIZER_NAME = \"post-protection\";\n private final ExtensionClient client;\n private final PostService postService;\n private final PostPermalinkPolicy postPermalinkPolicy;\n private final CounterService counterService;\n private final CommentService commentService;\n private final CategoryService categoryService;\n private final ExtensionGetter extensionGetter;\n\n private final ApplicationEventPublisher eventPublisher;\n private final NotificationCenter notificationCenter;\n\n @Override\n public Result reconcile(Request request) {\n var events = new LinkedHashSet();\n client.fetch(Post.class, request.name())\n .ifPresent(post -> {\n if (ExtensionOperator.isDeleted(post)) {\n removeFinalizers(post.getMetadata(), Set.of(FINALIZER_NAME));\n unPublishPost(post, events);\n events.add(new PostDeletedEvent(this, post));\n cleanUpResources(post);\n // update post to be able to be collected by gc collector.\n client.update(post);\n // fire event after updating post\n events.forEach(eventPublisher::publishEvent);\n return;\n }\n addFinalizers(post.getMetadata(), Set.of(FINALIZER_NAME));\n\n populateLabels(post, events);\n\n schedulePublishIfNecessary(post);\n\n subscribeNewCommentNotification(post);\n\n var status = post.getStatus();\n if (status == null) {\n status = new Post.PostStatus();\n post.setStatus(status);\n }\n\n if (post.isPublished() && post.getSpec().getPublishTime() == null) {\n post.getSpec().setPublishTime(Instant.now());\n }\n\n // calculate the sha256sum\n var configSha256sum = Hashing.sha256().hashString(post.getSpec().toString(), UTF_8)\n .toString();\n\n var annotations = nullSafeAnnotations(post);\n var oldConfigChecksum = annotations.get(Constant.CHECKSUM_CONFIG_ANNO);\n if (!Objects.equals(oldConfigChecksum, configSha256sum)) {\n // if the checksum doesn't match\n events.add(new PostUpdatedEvent(this, post.getMetadata().getName()));\n annotations.put(Constant.CHECKSUM_CONFIG_ANNO, configSha256sum);\n }\n\n if (shouldUnPublish(post)) {\n unPublishPost(post, events);\n } else {\n publishPost(post, events);\n }\n\n if (!annotations.containsKey(Constant.PERMALINK_PATTERN_ANNO)) {\n // only set the permalink pattern if not present\n var permalinkPattern = postPermalinkPolicy.pattern();\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, permalinkPattern);\n }\n status.setPermalink(postPermalinkPolicy.permalink(post));\n if (status.getPhase() == null) {\n status.setPhase(PostPhase.DRAFT.toString());\n }\n\n var excerpt = post.getSpec().getExcerpt();\n if (excerpt == null) {\n excerpt = new Post.Excerpt();\n }\n var isAutoGenerate = defaultIfNull(excerpt.getAutoGenerate(), true);\n if (isAutoGenerate) {\n status.setExcerpt(getExcerpt(post));\n } else {\n status.setExcerpt(excerpt.getRaw());\n }\n\n var ref = Ref.of(post);\n // handle contributors\n var headSnapshot = post.getSpec().getHeadSnapshot();\n var contributors = listSnapshots(ref)\n .stream()\n .map(snapshot -> {\n Set usernames = snapshot.getSpec().getContributors();\n return Objects.requireNonNullElseGet(usernames,\n () -> new HashSet());\n })\n .flatMap(Set::stream)\n .distinct()\n .sorted()\n .toList();\n status.setContributors(contributors);\n\n // update in progress status\n status.setInProgress(\n !StringUtils.equals(headSnapshot, post.getSpec().getReleaseSnapshot()));\n\n computeHiddenState(post);\n\n // version + 1 is required to truly equal version\n // as a version will be incremented after the update\n status.setObservedVersion(post.getMetadata().getVersion() + 1);\n client.update(post);\n\n // fire event after updating post\n events.forEach(eventPublisher::publishEvent);\n });\n return Result.doNotRetry();\n }\n\n private void computeHiddenState(Post post) {\n var categories = post.getSpec().getCategories();\n if (categories == null) {\n post.getStatusOrDefault().setHideFromList(false);\n return;\n }\n var hidden = categories.stream()\n .anyMatch(categoryName -> categoryService.isCategoryHidden(categoryName)\n .blockOptional(BLOCKING_TIMEOUT).orElse(false)\n );\n post.getStatusOrDefault().setHideFromList(hidden);\n }\n\n private void populateLabels(Post post, Set events) {\n var labels = nullSafeLabels(post);\n labels.put(Post.DELETED_LABEL, String.valueOf(isTrue(post.getSpec().getDeleted())));\n\n var expectVisible = defaultIfNull(post.getSpec().getVisible(), VisibleEnum.PUBLIC);\n var oldVisible = VisibleEnum.from(labels.get(Post.VISIBLE_LABEL));\n if (!Objects.equals(oldVisible, expectVisible)) {\n var postName = post.getMetadata().getName();\n events.add(new PostVisibleChangedEvent(this, postName, oldVisible, expectVisible));\n }\n labels.put(Post.VISIBLE_LABEL, expectVisible.toString());\n\n var ownerName = post.getSpec().getOwner();\n if (StringUtils.isNotBlank(ownerName)) {\n labels.put(Post.OWNER_LABEL, ownerName);\n }\n\n var publishTime = post.getSpec().getPublishTime();\n if (publishTime != null) {\n labels.put(Post.ARCHIVE_YEAR_LABEL, HaloUtils.getYearText(publishTime));\n labels.put(Post.ARCHIVE_MONTH_LABEL, HaloUtils.getMonthText(publishTime));\n labels.put(Post.ARCHIVE_DAY_LABEL, HaloUtils.getDayText(publishTime));\n }\n\n if (!labels.containsKey(Post.PUBLISHED_LABEL)) {\n labels.put(Post.PUBLISHED_LABEL, BooleanUtils.FALSE);\n }\n }\n\n private static boolean shouldUnPublish(Post post) {\n return isTrue(post.getSpec().getDeleted()) || isFalse(post.getSpec().getPublish());\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Post())\n .syncAllListOptions(ListOptions.builder()\n .andQuery(Queries.equal(Post.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, true))\n .build())\n .build();\n }\n\n void schedulePublishIfNecessary(Post post) {\n var labels = nullSafeLabels(post);\n // ensure the label is removed\n labels.remove(Post.SCHEDULING_PUBLISH_LABEL);\n\n final var now = Instant.now();\n var publishTime = post.getSpec().getPublishTime();\n if (post.isPublished() || publishTime == null) {\n return;\n }\n\n // expect to publish in the future\n if (isTrue(post.getSpec().getPublish()) && publishTime.isAfter(now)) {\n labels.put(Post.SCHEDULING_PUBLISH_LABEL, TRUE);\n // update post changes before requeue\n client.update(post);\n\n throw new RequeueException(Result.requeue(Duration.between(now, publishTime)),\n \"Requeue for scheduled publish.\");\n }\n }\n\n void subscribeNewCommentNotification(Post post) {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(post.getSpec().getOwner());\n\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(NotificationReasonConst.NEW_COMMENT_ON_POST);\n interestReason.setExpression(\n \"props.postOwner == '%s'\".formatted(post.getSpec().getOwner()));\n notificationCenter.subscribe(subscriber, interestReason).block(BLOCKING_TIMEOUT);\n }\n\n private void publishPost(Post post, Set events) {\n var expectReleaseSnapshot = post.getSpec().getReleaseSnapshot();\n if (StringUtils.isBlank(expectReleaseSnapshot)) {\n // Do nothing if release snapshot is not set\n return;\n }\n var annotations = post.getMetadata().getAnnotations();\n var lastReleaseSnapshot = annotations.get(Post.LAST_RELEASED_SNAPSHOT_ANNO);\n if (post.isPublished()\n && Objects.equals(expectReleaseSnapshot, lastReleaseSnapshot)) {\n // If the release snapshot is not change\n return;\n }\n var status = post.getStatus();\n // validate the release snapshot\n var snapshot = client.fetch(Snapshot.class, expectReleaseSnapshot);\n if (snapshot.isEmpty()) {\n Condition condition = Condition.builder()\n .type(PostPhase.FAILED.name())\n .reason(\"SnapshotNotFound\")\n .message(\n String.format(\"Snapshot [%s] not found for publish\", expectReleaseSnapshot))\n .status(ConditionStatus.FALSE)\n .lastTransitionTime(Instant.now())\n .build();\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n status.setPhase(PostPhase.FAILED.name());\n return;\n }\n annotations.put(Post.LAST_RELEASED_SNAPSHOT_ANNO, expectReleaseSnapshot);\n status.setPhase(PostPhase.PUBLISHED.toString());\n var condition = Condition.builder()\n .type(PostPhase.PUBLISHED.name())\n .reason(\"Published\")\n .message(\"Post published successfully.\")\n .lastTransitionTime(Instant.now())\n .status(ConditionStatus.TRUE)\n .build();\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n var labels = post.getMetadata().getLabels();\n labels.put(Post.PUBLISHED_LABEL, Boolean.TRUE.toString());\n if (post.getSpec().getPublishTime() == null) {\n // TODO Set the field in creation hook in the future.\n post.getSpec().setPublishTime(Instant.now());\n }\n status.setLastModifyTime(snapshot.get().getSpec().getLastModifyTime());\n events.add(new PostPublishedEvent(this, post.getMetadata().getName()));\n }\n\n void unPublishPost(Post post, Set events) {\n if (!post.isPublished()) {\n return;\n }\n var labels = post.getMetadata().getLabels();\n labels.put(Post.PUBLISHED_LABEL, Boolean.FALSE.toString());\n final var status = post.getStatus();\n\n var condition = new Condition();\n condition.setType(\"CancelledPublish\");\n condition.setStatus(ConditionStatus.TRUE);\n condition.setReason(condition.getType());\n condition.setMessage(\"CancelledPublish\");\n condition.setLastTransitionTime(Instant.now());\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n\n status.setPhase(PostPhase.DRAFT.toString());\n\n events.add(new PostUnpublishedEvent(this, post.getMetadata().getName()));\n }\n\n private void cleanUpResources(Post post) {\n // clean up snapshots\n final Ref ref = Ref.of(post);\n listSnapshots(ref).forEach(client::delete);\n\n // clean up comments\n commentService.removeBySubject(ref).block(BLOCKING_TIMEOUT);\n\n // delete counter\n counterService.deleteByName(MeterUtils.nameOf(Post.class, post.getMetadata().getName()))\n .block(BLOCKING_TIMEOUT);\n }\n\n private String getExcerpt(Post post) {\n Optional contentWrapper =\n postService.getContent(post.getSpec().getReleaseSnapshot(),\n post.getSpec().getBaseSnapshot())\n .blockOptional(BLOCKING_TIMEOUT);\n if (contentWrapper.isEmpty()) {\n return StringUtils.EMPTY;\n }\n var content = contentWrapper.get();\n\n if (StringUtils.isAnyBlank(content.getContent(), content.getRaw())) {\n return StringUtils.EMPTY;\n }\n\n var contentChecksum = Hashing.sha256().hashString(content.getContent(), UTF_8).toString();\n var annotations = MetadataUtil.nullSafeAnnotations(post);\n var oldChecksum = annotations.get(Constant.CONTENT_CHECKSUM_ANNO);\n if (Objects.equals(oldChecksum, contentChecksum)) {\n return post.getStatusOrDefault().getExcerpt();\n }\n // update the checksum and generate new excerpt\n annotations.put(Constant.CONTENT_CHECKSUM_ANNO, contentChecksum);\n\n var tags = listTagDisplayNames(post);\n\n var keywords = new HashSet<>(tags);\n keywords.add(post.getSpec().getTitle());\n\n var context = new ExcerptGenerator.Context()\n .setRaw(content.getRaw())\n .setContent(content.getContent())\n .setRawType(content.getRawType())\n .setKeywords(keywords)\n .setMaxLength(160);\n return extensionGetter.getEnabledExtension(ExcerptGenerator.class)\n .defaultIfEmpty(new DefaultExcerptGenerator())\n .flatMap(generator -> generator.generate(context))\n .onErrorResume(Throwable.class, e -> {\n log.error(\"Failed to generate excerpt for post [{}]\",\n post.getMetadata().getName(), e);\n return Mono.empty();\n })\n .blockOptional(BLOCKING_TIMEOUT)\n .orElse(StringUtils.EMPTY);\n }\n\n private Set listTagDisplayNames(Post post) {\n return Optional.ofNullable(post.getSpec().getTags())\n .map(tags -> client.listAll(Tag.class, ListOptions.builder()\n .fieldQuery(in(\"metadata.name\", tags))\n .build(), Sort.unsorted())\n )\n .stream()\n .flatMap(List::stream)\n .map(tag -> tag.getSpec().getDisplayName())\n .collect(Collectors.toSet());\n }\n\n static class DefaultExcerptGenerator implements ExcerptGenerator {\n @Override\n public Mono generate(Context context) {\n String shortHtmlContent = StringUtils.substring(context.getContent(), 0, 500);\n String text = Jsoup.parse(shortHtmlContent).text();\n return Mono.just(StringUtils.substring(text, 0, 150));\n }\n }\n\n List listSnapshots(Ref ref) {\n var snapshotListOptions = new ListOptions();\n snapshotListOptions.setFieldSelector(FieldSelector.of(\n Queries.equal(\"spec.subjectRef\", Snapshot.toSubjectRefKey(ref))));\n return client.listAll(Snapshot.class, snapshotListOptions, Sort.unsorted());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/ReplyReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.util.Set;\nimport lombok.AllArgsConstructor;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.comment.ReplyNotificationSubscriptionHelper;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.event.post.ReplyChangedEvent;\nimport run.halo.app.event.post.ReplyCreatedEvent;\nimport run.halo.app.event.post.ReplyDeletedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n * Reconciler for {@link Reply}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class ReplyReconciler implements Reconciler {\n protected static final String FINALIZER_NAME = \"reply-protection\";\n\n private final ExtensionClient client;\n private final ApplicationEventPublisher eventPublisher;\n\n private final ReplyNotificationSubscriptionHelper replyNotificationSubscriptionHelper;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Reply.class, request.name())\n .ifPresent(reply -> {\n if (reply.getMetadata().getDeletionTimestamp() != null) {\n cleanUpResourcesAndRemoveFinalizer(request.name());\n return;\n }\n if (addFinalizers(reply.getMetadata(), Set.of(FINALIZER_NAME))) {\n replyNotificationSubscriptionHelper.subscribeNewReplyReasonForReply(reply);\n client.update(reply);\n eventPublisher.publishEvent(new ReplyCreatedEvent(this, reply));\n }\n\n if (reply.getSpec().getCreationTime() == null) {\n reply.getSpec().setCreationTime(\n defaultIfNull(reply.getSpec().getApprovedTime(),\n reply.getMetadata().getCreationTimestamp()\n )\n );\n }\n\n // version + 1 is required to truly equal version\n // as a version will be incremented after the update\n reply.getStatus().setObservedVersion(reply.getMetadata().getVersion() + 1);\n\n client.update(reply);\n\n eventPublisher.publishEvent(new ReplyChangedEvent(this, reply));\n });\n return new Result(false, null);\n }\n\n private void cleanUpResourcesAndRemoveFinalizer(String replyName) {\n client.fetch(Reply.class, replyName).ifPresent(reply -> {\n if (reply.getMetadata().getFinalizers() != null) {\n reply.getMetadata().getFinalizers().remove(FINALIZER_NAME);\n }\n client.update(reply);\n\n // on reply removing\n eventPublisher.publishEvent(new ReplyDeletedEvent(this, reply));\n });\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n var extension = new Reply();\n return builder\n .extension(extension)\n .syncAllListOptions(ListOptions.builder()\n .andQuery(equal(Reply.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, true))\n .build())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/ReverseProxyReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport java.util.HashSet;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.plugin.PluginConst;\nimport run.halo.app.plugin.resources.ReverseProxyRouterFunctionRegistry;\n\n/**\n * Reconciler for {@link ReverseProxy}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class ReverseProxyReconciler implements Reconciler {\n private static final String FINALIZER_NAME = \"reverse-proxy-protection\";\n private final ExtensionClient client;\n private final ReverseProxyRouterFunctionRegistry routerFunctionRegistry;\n\n public ReverseProxyReconciler(ExtensionClient client,\n ReverseProxyRouterFunctionRegistry routerFunctionRegistry) {\n this.client = client;\n this.routerFunctionRegistry = routerFunctionRegistry;\n }\n\n @Override\n public Result reconcile(Request request) {\n return client.fetch(ReverseProxy.class, request.name())\n .map(reverseProxy -> {\n if (isDeleted(reverseProxy)) {\n cleanUpResourcesAndRemoveFinalizer(request.name());\n return new Result(false, null);\n }\n addFinalizerIfNecessary(reverseProxy);\n registerReverseProxy(reverseProxy);\n return new Result(false, null);\n })\n .orElse(new Result(false, null));\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new ReverseProxy())\n .build();\n }\n\n private void registerReverseProxy(ReverseProxy reverseProxy) {\n String pluginId = getPluginId(reverseProxy);\n routerFunctionRegistry.register(pluginId, reverseProxy);\n }\n\n private void cleanUpResources(ReverseProxy reverseProxy) {\n String pluginId = getPluginId(reverseProxy);\n routerFunctionRegistry.remove(pluginId, reverseProxy.getMetadata().getName());\n }\n\n private void addFinalizerIfNecessary(ReverseProxy oldReverseProxy) {\n Set finalizers = oldReverseProxy.getMetadata().getFinalizers();\n if (finalizers != null && finalizers.contains(FINALIZER_NAME)) {\n return;\n }\n client.fetch(ReverseProxy.class, oldReverseProxy.getMetadata().getName())\n .ifPresent(reverseProxy -> {\n Set newFinalizers = reverseProxy.getMetadata().getFinalizers();\n if (newFinalizers == null) {\n newFinalizers = new HashSet<>();\n reverseProxy.getMetadata().setFinalizers(newFinalizers);\n }\n newFinalizers.add(FINALIZER_NAME);\n client.update(reverseProxy);\n });\n }\n\n private void cleanUpResourcesAndRemoveFinalizer(String name) {\n client.fetch(ReverseProxy.class, name).ifPresent(reverseProxy -> {\n cleanUpResources(reverseProxy);\n if (reverseProxy.getMetadata().getFinalizers() != null) {\n reverseProxy.getMetadata().getFinalizers().remove(FINALIZER_NAME);\n }\n client.update(reverseProxy);\n });\n }\n\n private boolean isDeleted(ReverseProxy reverseProxy) {\n return reverseProxy.getMetadata().getDeletionTimestamp() != null;\n }\n\n private String getPluginId(ReverseProxy reverseProxy) {\n Map labels = reverseProxy.getMetadata().getLabels();\n if (labels == null) {\n return PluginConst.SYSTEM_PLUGIN_NAME;\n }\n return Objects.toString(labels.get(PluginConst.PLUGIN_NAME_LABEL_NAME),\n PluginConst.SYSTEM_PLUGIN_NAME);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/RoleReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static java.util.Objects.deepEquals;\n\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\n\n/**\n * Role reconcile.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class RoleReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n public RoleReconciler(ExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Role.class, request.name())\n .ifPresent(role -> {\n Map annotations = MetadataUtil.nullSafeAnnotations(role);\n // override dependency rules to annotations\n annotations.put(Role.ROLE_DEPENDENCY_RULES, \"[]\");\n annotations.put(Role.UI_PERMISSIONS_AGGREGATED_ANNO, \"[]\");\n\n updateLabelsAndAnnotations(role);\n });\n return new Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Role())\n .build();\n }\n\n private void updateLabelsAndAnnotations(Role role) {\n var annotations = role.getMetadata().getAnnotations();\n var labels = role.getMetadata().getLabels();\n client.fetch(Role.class, role.getMetadata().getName())\n .filter(freshRole -> !deepEquals(annotations, freshRole.getMetadata().getAnnotations())\n || deepEquals(labels, freshRole.getMetadata().getLabels()))\n .ifPresent(freshRole -> {\n freshRole.getMetadata().setAnnotations(annotations);\n freshRole.getMetadata().setLabels(labels);\n client.update(freshRole);\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/SinglePageReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.springframework.web.util.UriUtils.encodePath;\n\nimport com.google.common.hash.Hashing;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.jsoup.Jsoup;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.ExcerptGenerator;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.content.SinglePageService;\nimport run.halo.app.content.comment.CommentService;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionOperator;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionList;\nimport run.halo.app.infra.ConditionStatus;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n *

Reconciler for {@link SinglePage}.

\n *\n *

things to do:

\n *
    \n * 1. generate permalink\n * 2. generate excerpt if auto generate is enabled\n *
\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@AllArgsConstructor\n@Component\npublic class SinglePageReconciler implements Reconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private static final String FINALIZER_NAME = \"single-page-protection\";\n private final ExtensionClient client;\n private final SinglePageService singlePageService;\n private final CounterService counterService;\n private final CommentService commentService;\n private final ExtensionGetter extensionGetter;\n\n private final ExternalUrlSupplier externalUrlSupplier;\n\n private final NotificationCenter notificationCenter;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(SinglePage.class, request.name())\n .ifPresent(singlePage -> {\n if (ExtensionOperator.isDeleted(singlePage)) {\n cleanUpResourcesAndRemoveFinalizer(request.name());\n return;\n }\n\n if (ExtensionUtil.addFinalizers(singlePage.getMetadata(), Set.of(FINALIZER_NAME))) {\n client.update(singlePage);\n }\n\n subscribeNewCommentNotification(singlePage);\n\n // reconcile spec first\n reconcileSpec(request.name());\n // then\n reconcileMetadata(request.name());\n reconcileStatus(request.name());\n });\n return new Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new SinglePage())\n .build();\n }\n\n void subscribeNewCommentNotification(SinglePage page) {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(page.getSpec().getOwner());\n\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(NotificationReasonConst.NEW_COMMENT_ON_PAGE);\n interestReason.setExpression(\n \"props.pageOwner == '%s'\".formatted(page.getSpec().getOwner()));\n notificationCenter.subscribe(subscriber, interestReason).block(BLOCKING_TIMEOUT);\n }\n\n private void reconcileSpec(String name) {\n client.fetch(SinglePage.class, name).ifPresent(page -> {\n if (page.isPublished() && page.getSpec().getPublishTime() == null) {\n page.getSpec().setPublishTime(Instant.now());\n }\n\n // un-publish if necessary\n if (page.isPublished() && Objects.equals(false, page.getSpec().getPublish())) {\n unPublish(name);\n return;\n }\n\n try {\n publishPage(name);\n } catch (Throwable e) {\n publishFailed(name, e);\n throw e;\n }\n });\n }\n\n private void publishPage(String name) {\n client.fetch(SinglePage.class, name)\n .filter(page -> Objects.equals(true, page.getSpec().getPublish()))\n .ifPresent(page -> {\n Map annotations = MetadataUtil.nullSafeAnnotations(page);\n String lastReleasedSnapshot = annotations.get(Post.LAST_RELEASED_SNAPSHOT_ANNO);\n String releaseSnapshot = page.getSpec().getReleaseSnapshot();\n if (StringUtils.isBlank(releaseSnapshot)) {\n return;\n }\n // do nothing if release snapshot is not changed and page is published\n if (page.isPublished()\n && StringUtils.equals(lastReleasedSnapshot, releaseSnapshot)) {\n return;\n }\n SinglePage.SinglePageStatus status = page.getStatusOrDefault();\n\n // validate release snapshot\n Optional releasedSnapshotOpt =\n client.fetch(Snapshot.class, releaseSnapshot);\n if (releasedSnapshotOpt.isEmpty()) {\n Condition condition = Condition.builder()\n .type(Post.PostPhase.FAILED.name())\n .reason(\"SnapshotNotFound\")\n .message(\n String.format(\"Snapshot [%s] not found for publish\", releaseSnapshot))\n .status(ConditionStatus.FALSE)\n .lastTransitionTime(Instant.now())\n .build();\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n status.setPhase(Post.PostPhase.FAILED.name());\n client.update(page);\n return;\n }\n\n // do publish\n annotations.put(SinglePage.LAST_RELEASED_SNAPSHOT_ANNO, releaseSnapshot);\n status.setPhase(Post.PostPhase.PUBLISHED.name());\n Condition condition = Condition.builder()\n .type(Post.PostPhase.PUBLISHED.name())\n .reason(\"Published\")\n .message(\"SinglePage published successfully.\")\n .lastTransitionTime(Instant.now())\n .status(ConditionStatus.TRUE)\n .build();\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n\n SinglePage.changePublishedState(page, true);\n if (page.getSpec().getPublishTime() == null) {\n page.getSpec().setPublishTime(Instant.now());\n }\n\n // populate lastModifyTime\n status.setLastModifyTime(releasedSnapshotOpt.get().getSpec().getLastModifyTime());\n\n client.update(page);\n });\n }\n\n private void unPublish(String name) {\n client.fetch(SinglePage.class, name).ifPresent(page -> {\n final SinglePage oldPage = JsonUtils.deepCopy(page);\n\n SinglePage.changePublishedState(page, false);\n final SinglePage.SinglePageStatus status = page.getStatusOrDefault();\n\n Condition condition = new Condition();\n condition.setType(\"CancelledPublish\");\n condition.setStatus(ConditionStatus.TRUE);\n condition.setReason(condition.getType());\n condition.setMessage(\"CancelledPublish\");\n condition.setLastTransitionTime(Instant.now());\n status.getConditionsOrDefault().addAndEvictFIFO(condition);\n\n status.setPhase(Post.PostPhase.DRAFT.name());\n if (!oldPage.equals(page)) {\n client.update(page);\n }\n });\n }\n\n private void publishFailed(String name, Throwable error) {\n Assert.notNull(name, \"Name must not be null\");\n Assert.notNull(error, \"Error must not be null\");\n client.fetch(SinglePage.class, name).ifPresent(page -> {\n final SinglePage oldPage = JsonUtils.deepCopy(page);\n\n SinglePage.SinglePageStatus status = page.getStatusOrDefault();\n Post.PostPhase phase = Post.PostPhase.FAILED;\n status.setPhase(phase.name());\n\n final ConditionList conditions = status.getConditionsOrDefault();\n\n Condition condition = Condition.builder()\n .type(phase.name())\n .reason(\"PublishFailed\")\n .message(error.getMessage())\n .lastTransitionTime(Instant.now())\n .status(ConditionStatus.FALSE)\n .build();\n conditions.addAndEvictFIFO(condition);\n page.setStatus(status);\n\n if (!oldPage.equals(page)) {\n client.update(page);\n }\n });\n }\n\n private void cleanUpResources(SinglePage singlePage) {\n // clean up snapshot\n Ref ref = Ref.of(singlePage);\n listSnapshots(ref).forEach(client::delete);\n\n // clean up comments\n commentService.removeBySubject(ref).block(BLOCKING_TIMEOUT);\n\n // delete counter for single page\n counterService.deleteByName(\n MeterUtils.nameOf(SinglePage.class, singlePage.getMetadata().getName()))\n .block(BLOCKING_TIMEOUT);\n }\n\n private void cleanUpResourcesAndRemoveFinalizer(String pageName) {\n client.fetch(SinglePage.class, pageName).ifPresent(singlePage -> {\n cleanUpResources(singlePage);\n if (singlePage.getMetadata().getFinalizers() != null) {\n singlePage.getMetadata().getFinalizers().remove(FINALIZER_NAME);\n }\n client.update(singlePage);\n });\n }\n\n private void reconcileMetadata(String name) {\n client.fetch(SinglePage.class, name).ifPresent(singlePage -> {\n final SinglePage oldPage = JsonUtils.deepCopy(singlePage);\n\n SinglePage.SinglePageSpec spec = singlePage.getSpec();\n // handle logic delete\n Map labels = MetadataUtil.nullSafeLabels(singlePage);\n if (isDeleted(singlePage)) {\n labels.put(SinglePage.DELETED_LABEL, Boolean.TRUE.toString());\n } else {\n labels.put(SinglePage.DELETED_LABEL, Boolean.FALSE.toString());\n }\n labels.put(SinglePage.VISIBLE_LABEL,\n Objects.requireNonNullElse(spec.getVisible(), Post.VisibleEnum.PUBLIC).name());\n labels.put(SinglePage.OWNER_LABEL, spec.getOwner());\n if (!labels.containsKey(SinglePage.PUBLISHED_LABEL)) {\n labels.put(Post.PUBLISHED_LABEL, Boolean.FALSE.toString());\n }\n if (!oldPage.equals(singlePage)) {\n client.update(singlePage);\n }\n });\n }\n\n String createPermalink(SinglePage page) {\n var permalink = encodePath(page.getSpec().getSlug(), UTF_8);\n permalink = StringUtils.prependIfMissing(permalink, \"/\");\n return externalUrlSupplier.get().resolve(permalink).normalize().toString();\n }\n\n private void reconcileStatus(String name) {\n client.fetch(SinglePage.class, name).ifPresent(singlePage -> {\n final SinglePage oldPage = JsonUtils.deepCopy(singlePage);\n\n singlePage.getStatusOrDefault()\n .setPermalink(createPermalink(singlePage));\n\n SinglePage.SinglePageSpec spec = singlePage.getSpec();\n SinglePage.SinglePageStatus status = singlePage.getStatusOrDefault();\n if (status.getPhase() == null) {\n status.setPhase(Post.PostPhase.DRAFT.name());\n }\n\n // handle excerpt\n Post.Excerpt excerpt = spec.getExcerpt();\n if (excerpt == null) {\n excerpt = new Post.Excerpt();\n excerpt.setAutoGenerate(true);\n spec.setExcerpt(excerpt);\n }\n\n if (excerpt.getAutoGenerate()) {\n status.setExcerpt(getExcerpt(singlePage));\n } else {\n status.setExcerpt(excerpt.getRaw());\n }\n\n // handle contributors\n String headSnapshot = singlePage.getSpec().getHeadSnapshot();\n List contributors = listSnapshots(Ref.of(singlePage))\n .stream()\n .peek(snapshot -> {\n snapshot.getSpec().setContentPatch(StringUtils.EMPTY);\n snapshot.getSpec().setRawPatch(StringUtils.EMPTY);\n })\n .map(snapshot -> {\n Set usernames = snapshot.getSpec().getContributors();\n return Objects.requireNonNullElseGet(usernames,\n () -> new HashSet());\n })\n .flatMap(Set::stream)\n .distinct()\n .sorted()\n .toList();\n status.setContributors(contributors);\n\n // update in progress status\n String releaseSnapshot = singlePage.getSpec().getReleaseSnapshot();\n status.setInProgress(!StringUtils.equals(releaseSnapshot, headSnapshot));\n\n if (singlePage.isPublished() && status.getLastModifyTime() == null) {\n client.fetch(Snapshot.class, singlePage.getSpec().getReleaseSnapshot())\n .ifPresent(releasedSnapshot ->\n status.setLastModifyTime(releasedSnapshot.getSpec().getLastModifyTime()));\n }\n\n if (!oldPage.equals(singlePage)) {\n client.update(singlePage);\n }\n });\n }\n\n private String getExcerpt(SinglePage singlePage) {\n Optional contentWrapper =\n singlePageService.getContent(singlePage.getSpec().getReleaseSnapshot(),\n singlePage.getSpec().getBaseSnapshot())\n .blockOptional(BLOCKING_TIMEOUT);\n if (contentWrapper.isEmpty()) {\n return StringUtils.EMPTY;\n }\n var content = contentWrapper.get();\n\n var contentChecksum = Hashing.sha256().hashString(content.getContent(), UTF_8).toString();\n var annotations = MetadataUtil.nullSafeAnnotations(singlePage);\n var oldChecksum = annotations.get(Constant.CONTENT_CHECKSUM_ANNO);\n if (Objects.equals(oldChecksum, contentChecksum)) {\n return singlePage.getStatusOrDefault().getExcerpt();\n }\n // update the checksum and generate new excerpt\n annotations.put(Constant.CONTENT_CHECKSUM_ANNO, contentChecksum);\n\n var context = new ExcerptGenerator.Context()\n .setRaw(content.getRaw())\n .setContent(content.getContent())\n .setRaw(content.getRawType())\n .setKeywords(Set.of())\n .setMaxLength(160);\n return extensionGetter.getEnabledExtension(ExcerptGenerator.class)\n .defaultIfEmpty(new DefaultExcerptGenerator())\n .flatMap(generator -> generator.generate(context))\n .onErrorResume(Throwable.class, e -> {\n log.error(\"Failed to generate excerpt for single page [{}]\",\n singlePage.getMetadata().getName(), e);\n return Mono.empty();\n })\n .blockOptional(BLOCKING_TIMEOUT)\n .orElse(StringUtils.EMPTY);\n }\n\n static class DefaultExcerptGenerator implements ExcerptGenerator {\n @Override\n public Mono generate(Context context) {\n String shortHtmlContent = StringUtils.substring(context.getContent(), 0, 500);\n String text = Jsoup.parse(shortHtmlContent).text();\n return Mono.just(StringUtils.substring(text, 0, 150));\n }\n }\n\n private boolean isDeleted(SinglePage singlePage) {\n return Objects.equals(true, singlePage.getSpec().getDeleted())\n || singlePage.getMetadata().getDeletionTimestamp() != null;\n }\n\n List listSnapshots(Ref ref) {\n var snapshotListOptions = new ListOptions();\n snapshotListOptions.setFieldSelector(FieldSelector.of(\n Queries.equal(\"spec.subjectRef\", Snapshot.toSubjectRefKey(ref))));\n return client.listAll(Snapshot.class, snapshotListOptions, Sort.unsorted());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/SystemConfigReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static java.util.Objects.requireNonNullElse;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.infra.utils.SystemConfigUtils.mergeMap;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport java.util.Map;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionMatcher;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.SystemConfigChangedEvent;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.SystemConfigUtils;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass SystemConfigReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n private final ApplicationEventPublisher eventPublisher;\n\n @Override\n public Result reconcile(Request request) {\n Assert.state(\n Objects.equals(SystemSetting.SYSTEM_CONFIG, request.name()),\n \"Only system config reconciler is supported to reconcile system config.\"\n );\n client.fetch(ConfigMap.class, request.name())\n .ifPresent(configMap -> {\n if (ExtensionUtil.isDeleted(configMap)) {\n log.warn(\"System config was attempted to be deleted\");\n return;\n }\n // calculate if the configMap has changed\n // and publish event if changed\n var dataSnapshot = SystemConfigUtils.getDataSnapshot(configMap);\n if (SystemConfigUtils.populateChecksum(configMap)) {\n SystemConfigUtils.updateDataSnapshot(configMap);\n client.update(configMap);\n log.info(\"System config has been detected as changed\");\n eventPublisher.publishEvent(\n computeChangedEvent(configMap, dataSnapshot)\n );\n }\n // do nothing if not changed\n });\n return null;\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n ExtensionMatcher matcher = extension ->\n Objects.equals(extension.getMetadata().getName(), SystemSetting.SYSTEM_CONFIG);\n return builder.extension(new ConfigMap())\n .syncAllOnStart(true)\n .syncAllListOptions(ListOptions.builder()\n .fieldQuery(equal(\"metadata.name\", SystemSetting.SYSTEM_CONFIG))\n .build()\n )\n .onAddMatcher(matcher)\n .onUpdateMatcher(matcher)\n .onDeleteMatcher(matcher)\n .build();\n }\n\n private SystemConfigChangedEvent computeChangedEvent(ConfigMap configMap,\n @Nullable Map oldData) {\n return client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT)\n .map(defaultConfigMap -> {\n var defaultData =\n requireNonNullElse(defaultConfigMap.getData(), Map.of());\n try {\n var mergedOldData = mergeMap(\n defaultData, requireNonNullElse(oldData, Map.of())\n );\n var mergedNewData = mergeMap(\n defaultData, requireNonNullElse(configMap.getData(), Map.of())\n );\n return new SystemConfigChangedEvent(this, mergedOldData, mergedNewData);\n } catch (JsonProcessingException e) {\n throw new RuntimeException(e);\n }\n })\n .orElseGet(() -> new SystemConfigChangedEvent(\n this, oldData, requireNonNullElse(configMap.getData(), Map.of())\n ));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/TagReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.util.Map;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.permalinks.TagPermalinkPolicy;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n * Reconciler for {@link Tag}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class TagReconciler implements Reconciler {\n static final String FINALIZER_NAME = \"tag-protection\";\n private final ExtensionClient client;\n private final TagPermalinkPolicy tagPermalinkPolicy;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Tag.class, request.name())\n .ifPresent(tag -> {\n if (ExtensionUtil.isDeleted(tag)) {\n if (removeFinalizers(tag.getMetadata(), Set.of(FINALIZER_NAME))) {\n client.update(tag);\n }\n return;\n }\n\n addFinalizers(tag.getMetadata(), Set.of(FINALIZER_NAME));\n\n Map annotations = MetadataUtil.nullSafeAnnotations(tag);\n\n if (!annotations.containsKey(Constant.PERMALINK_PATTERN_ANNO)) {\n var newPattern = tagPermalinkPolicy.pattern();\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, newPattern);\n }\n\n var status = tag.getStatusOrDefault();\n String permalink = tagPermalinkPolicy.permalink(tag);\n status.setPermalink(permalink);\n\n if (status.getPostCount() == null) {\n status.setPostCount(0);\n }\n if (status.getVisiblePostCount() == null) {\n status.setVisiblePostCount(0);\n }\n\n // Update the observed version.\n status.setObservedVersion(tag.getMetadata().getVersion() + 1);\n\n client.update(tag);\n });\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Tag())\n .syncAllListOptions(ListOptions.builder()\n .andQuery(equal(Tag.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, true))\n .build())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/ThemeReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.isDeleted;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\n\nimport java.io.IOException;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.UUID;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.core.retry.RetryException;\nimport org.springframework.core.retry.RetryPolicy;\nimport org.springframework.core.retry.RetryTemplate;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.util.backoff.FixedBackOff;\nimport reactor.core.Exceptions;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionStatus;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.infra.exception.ThemeUninstallException;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.infra.utils.SettingUtils;\nimport run.halo.app.infra.utils.VersionUtils;\nimport run.halo.app.theme.TemplateEngineManager;\n\n/**\n * Reconciler for theme.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class ThemeReconciler implements Reconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private static final String FINALIZER_NAME = \"theme-protection\";\n\n private final ExtensionClient client;\n\n private final ThemeRootGetter themeRoot;\n private final SystemVersionSupplier systemVersionSupplier;\n private final TemplateEngineManager templateEngineManager;\n\n private RetryTemplate retryTemplate = new RetryTemplate(RetryPolicy.builder()\n .backOff(new FixedBackOff(300, 20))\n .predicate(IllegalStateException.class::isInstance)\n .build());\n\n /**\n * Set retry template. Only for testing purpose.\n *\n * @param retryTemplate the retry template\n */\n void setRetryTemplate(RetryTemplate retryTemplate) {\n this.retryTemplate = retryTemplate;\n }\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Theme.class, request.name())\n .ifPresent(theme -> {\n if (isDeleted(theme)) {\n if (removeFinalizers(theme.getMetadata(), Set.of(FINALIZER_NAME))) {\n cleanUpResources(theme);\n client.update(theme);\n }\n return;\n }\n addFinalizers(theme.getMetadata(), Set.of(FINALIZER_NAME));\n\n themeSettingDefaultConfig(theme);\n reconcileStatus(theme);\n client.update(theme);\n });\n return new Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Theme())\n .build();\n }\n\n void reconcileStatus(Theme theme) {\n var status = theme.getStatus();\n if (status == null) {\n status = new Theme.ThemeStatus();\n theme.setStatus(status);\n }\n var name = theme.getMetadata().getName();\n var themePath = themeRoot.get().resolve(name);\n status.setLocation(themePath.toAbsolutePath().toString());\n\n status.setPhase(Theme.ThemePhase.READY);\n var conditionBuilder = Condition.builder()\n .type(Theme.ThemePhase.READY.name())\n .status(ConditionStatus.TRUE)\n .reason(Theme.ThemePhase.READY.name())\n .message(StringUtils.EMPTY)\n .lastTransitionTime(Instant.now());\n\n // Check if this theme version is match requires param.\n var normalVersion = systemVersionSupplier.get().toStableVersion().toString();\n var requires = theme.getSpec().getRequires();\n if (!VersionUtils.satisfiesRequires(normalVersion, requires)) {\n status.setPhase(Theme.ThemePhase.FAILED);\n conditionBuilder\n .type(Theme.ThemePhase.FAILED.name())\n .status(ConditionStatus.FALSE)\n .reason(\"UnsatisfiedRequiresVersion\")\n .message(String.format(\n \"Theme requires a minimum system version of [%s], and you have [%s].\",\n requires, normalVersion));\n }\n Theme.nullSafeConditionList(theme).addAndEvictFIFO(conditionBuilder.build());\n }\n\n private void themeSettingDefaultConfig(Theme theme) {\n var spec = theme.getSpec();\n var settingName = spec.getSettingName();\n if (StringUtils.isBlank(settingName)) {\n return;\n }\n var configMapName = spec.getConfigMapName();\n if (StringUtils.isBlank(configMapName)) {\n configMapName = UUID.randomUUID().toString();\n }\n spec.setConfigMapName(configMapName);\n SettingUtils.createOrUpdateConfigMap(client, settingName, configMapName);\n }\n\n private void cleanUpResources(Theme theme) {\n reconcileThemeDeletion(theme);\n }\n\n private void reconcileThemeDeletion(Theme theme) {\n templateEngineManager.clearCache(theme.getMetadata().getName()).block(BLOCKING_TIMEOUT);\n // delete theme setting form\n var settingName = theme.getSpec().getSettingName();\n if (StringUtils.isNotBlank(settingName)) {\n client.fetch(Setting.class, settingName).ifPresent(client::delete);\n try {\n retryTemplate.execute(() -> {\n client.fetch(Setting.class, settingName).ifPresent(setting -> {\n throw new IllegalStateException(\"Waiting for setting to be deleted.\");\n });\n return null;\n });\n } catch (RetryException e) {\n throw Exceptions.propagate(e);\n }\n }\n // delete annotation setting\n deleteAnnotationSettings(theme.getMetadata().getName());\n deleteThemeFiles(theme);\n }\n\n private void deleteAnnotationSettings(String themeName) {\n var result = listAnnotationSettingsByThemeName(themeName);\n\n for (AnnotationSetting annotationSetting : result) {\n client.delete(annotationSetting);\n }\n\n try {\n retryTemplate.execute(() -> {\n var annotationSettings = listAnnotationSettingsByThemeName(themeName);\n if (annotationSettings.isEmpty()) {\n return null;\n }\n throw new IllegalStateException(\"Waiting for annotation settings to be deleted.\");\n });\n } catch (RetryException e) {\n throw Exceptions.propagate(e);\n }\n }\n\n private List listAnnotationSettingsByThemeName(String themeName) {\n return client.list(AnnotationSetting.class, annotationSetting -> {\n Map labels = MetadataUtil.nullSafeLabels(annotationSetting);\n return themeName.equals(labels.get(Theme.THEME_NAME_LABEL));\n }, null);\n }\n\n private void deleteThemeFiles(Theme theme) {\n var themeDir = themeRoot.get().resolve(theme.getMetadata().getName());\n try {\n FileSystemUtils.deleteRecursively(themeDir);\n } catch (IOException e) {\n throw new ThemeUninstallException(\"Failed to delete theme files.\", e);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/reconciler/UserReconciler.java", "content": "package run.halo.app.core.reconciler;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\nimport static run.halo.app.extension.ExtensionUtil.isDeleted;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.net.URI;\nimport java.time.Duration;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.controller.RequeueException;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class UserReconciler implements Reconciler {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private static final String FINALIZER_NAME = \"user-protection\";\n private final ExtensionClient client;\n private final ExternalUrlSupplier externalUrlSupplier;\n private final RoleService roleService;\n private final AttachmentService attachmentService;\n private final UserService userService;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(User.class, request.name()).ifPresent(user -> {\n if (isDeleted(user)) {\n deleteUserConnections(request.name());\n removeFinalizers(user.getMetadata(), Set.of(FINALIZER_NAME));\n client.update(user);\n return;\n }\n addFinalizers(user.getMetadata(), Set.of(FINALIZER_NAME));\n ensureRoleNamesAnno(user);\n updatePermalink(user);\n handleAvatar(user);\n checkVerifiedEmail(user);\n client.update(user);\n });\n return new Result(false, null);\n }\n\n private void checkVerifiedEmail(User user) {\n var username = user.getMetadata().getName();\n if (!user.getSpec().isEmailVerified()) {\n return;\n }\n var email = user.getSpec().getEmail();\n if (StringUtils.isBlank(email)) {\n return;\n }\n if (checkEmailInUse(username, email)) {\n user.getSpec().setEmailVerified(false);\n }\n }\n\n private Boolean checkEmailInUse(String username, String email) {\n return userService.listByEmail(email)\n .filter(existUser -> existUser.getSpec().isEmailVerified())\n .filter(existUser -> !existUser.getMetadata().getName().equals(username))\n .hasElements()\n .blockOptional(BLOCKING_TIMEOUT)\n .orElse(false);\n }\n\n private void handleAvatar(User user) {\n var annotations = Optional.ofNullable(user.getMetadata().getAnnotations())\n .orElseGet(HashMap::new);\n user.getMetadata().setAnnotations(annotations);\n\n var avatarAttachmentName = annotations.get(User.AVATAR_ATTACHMENT_NAME_ANNO);\n var oldAvatarAttachmentName =\n annotations.get(User.LAST_AVATAR_ATTACHMENT_NAME_ANNO);\n // remove old avatar if needed\n if (StringUtils.isNotBlank(oldAvatarAttachmentName)\n && !StringUtils.equals(avatarAttachmentName, oldAvatarAttachmentName)) {\n client.fetch(Attachment.class, oldAvatarAttachmentName)\n .ifPresent(client::delete);\n annotations.remove(User.LAST_AVATAR_ATTACHMENT_NAME_ANNO);\n }\n\n var spec = user.getSpec();\n if (StringUtils.isBlank(avatarAttachmentName)) {\n if (StringUtils.isNotBlank(spec.getAvatar())) {\n log.info(\"Remove avatar for user({})\", user.getMetadata().getName());\n }\n spec.setAvatar(null);\n return;\n }\n client.fetch(Attachment.class, avatarAttachmentName)\n .flatMap(attachment -> attachmentService.getPermalink(attachment)\n .blockOptional(BLOCKING_TIMEOUT)\n )\n .map(URI::toString)\n .ifPresentOrElse(avatar -> {\n if (!Objects.equals(avatar, spec.getAvatar())) {\n log.info(\n \"Update avatar for user({}) to {}\",\n user.getMetadata().getName(), avatar\n );\n }\n spec.setAvatar(avatar);\n // reset last avatar\n annotations.put(\n User.LAST_AVATAR_ATTACHMENT_NAME_ANNO,\n avatarAttachmentName\n );\n }, () -> {\n throw new RequeueException(\n new Result(true, null),\n \"Avatar permalink(%s) is not available yet.\"\n .formatted(avatarAttachmentName)\n );\n });\n }\n\n private void ensureRoleNamesAnno(User user) {\n roleService.getRolesByUsername(user.getMetadata().getName())\n .collectList()\n .map(JsonUtils::objectToJson)\n .doOnNext(roleNamesJson -> {\n var annotations = Optional.ofNullable(user.getMetadata().getAnnotations())\n .orElseGet(HashMap::new);\n user.getMetadata().setAnnotations(annotations);\n annotations.put(User.ROLE_NAMES_ANNO, roleNamesJson);\n })\n .block(BLOCKING_TIMEOUT);\n }\n\n private void updatePermalink(User user) {\n var name = user.getMetadata().getName();\n if (AnonymousUserConst.isAnonymousUser(name)) {\n // anonymous user is not allowed to have permalink\n return;\n }\n var status = Optional.ofNullable(user.getStatus())\n .orElseGet(User.UserStatus::new);\n user.setStatus(status);\n status.setPermalink(getUserPermalink(user));\n }\n\n private String getUserPermalink(User user) {\n return UriComponentsBuilder.fromUri(externalUrlSupplier.get())\n .pathSegment(\"authors\", user.getMetadata().getName())\n .toUriString();\n }\n\n void deleteUserConnections(String username) {\n var userConnections = listConnectionsByUsername(username);\n if (CollectionUtils.isEmpty(userConnections)) {\n return;\n }\n userConnections.forEach(client::delete);\n throw new RequeueException(new Result(true, null), \"User connections are not deleted yet\");\n }\n\n List listConnectionsByUsername(String username) {\n var listOptions = ListOptions.builder()\n .andQuery(equal(\"spec.username\", username))\n .build();\n return client.listAll(UserConnection.class, listOptions, defaultSort());\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new User())\n .build();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/DefaultRoleService.java", "content": "package run.halo.app.core.user.service;\n\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\nimport static run.halo.app.extension.ExtensionUtil.notDeleting;\nimport static run.halo.app.security.authorization.AuthorityUtils.containsSuperRole;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport java.util.Collection;\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Predicate;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.extension.RoleBinding.RoleRef;\nimport run.halo.app.core.extension.RoleBinding.Subject;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.security.SuperAdminInitializer;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Service\npublic class DefaultRoleService implements RoleService {\n\n private final ReactiveExtensionClient client;\n\n public DefaultRoleService(ReactiveExtensionClient client) {\n this.client = client;\n }\n\n private Flux listRoleRefs(Subject subject) {\n return listRoleBindings(subject).map(RoleBinding::getRoleRef);\n }\n\n @Override\n public Flux listRoleBindings(Subject subject) {\n var listOptions = ListOptions.builder()\n .andQuery(notDeleting())\n .andQuery(Queries.in(\"subjects\", subject.toString()))\n .build();\n return client.listAll(RoleBinding.class, listOptions, defaultSort());\n }\n\n @Override\n public Flux getRolesByUsername(String username) {\n return listRoleRefs(toUserSubject(username))\n .filter(DefaultRoleService::isRoleKind)\n .map(RoleRef::getName);\n }\n\n @Override\n public Mono>> getRolesByUsernames(Collection usernames) {\n if (CollectionUtils.isEmpty(usernames)) {\n return Mono.just(Map.of());\n }\n var subjects = usernames.stream().map(DefaultRoleService::toUserSubject)\n .map(Object::toString)\n .collect(Collectors.toSet());\n var listOptions = ListOptions.builder()\n .andQuery(notDeleting())\n .andQuery(Queries.in(\"subjects\", subjects))\n .build();\n\n return client.listAll(RoleBinding.class, listOptions, defaultSort())\n .collect(HashMap::new, (map, roleBinding) -> {\n for (Subject subject : roleBinding.getSubjects()) {\n if (subjects.contains(subject.toString())) {\n var username = subject.getName();\n var roleRef = roleBinding.getRoleRef();\n if (isRoleKind(roleRef)) {\n var roleName = roleRef.getName();\n map.computeIfAbsent(username, k -> new HashSet<>()).add(roleName);\n }\n }\n }\n });\n }\n\n @Override\n public Mono contains(Collection source, Collection candidates) {\n if (source.contains(SuperAdminInitializer.SUPER_ROLE_NAME)) {\n return Mono.just(true);\n }\n return listWithDependencies(new HashSet<>(source), shouldExcludeHidden(false))\n .map(role -> role.getMetadata().getName())\n .collect(Collectors.toSet())\n .map(roleNames -> roleNames.containsAll(candidates));\n }\n\n @Override\n public Flux listPermissions(Set names) {\n if (containsSuperRole(names)) {\n // search all permissions\n return client.listAll(Role.class,\n shouldExcludeHidden(true),\n ExtensionUtil.defaultSort());\n }\n return listWithDependencies(names, shouldExcludeHidden(true));\n }\n\n @Override\n public Flux listDependenciesFlux(Set names) {\n return listWithDependencies(names, shouldExcludeHidden(false));\n }\n\n private static boolean isRoleKind(RoleRef roleRef) {\n return Role.GROUP.equals(roleRef.getApiGroup()) && Role.KIND.equals(roleRef.getKind());\n }\n\n private static Subject toUserSubject(String username) {\n var subject = new Subject();\n subject.setApiGroup(User.GROUP);\n subject.setKind(User.KIND);\n subject.setName(username);\n return subject;\n }\n\n private Flux listRoles(Set names, ListOptions additionalListOptions) {\n if (CollectionUtils.isEmpty(names)) {\n return Flux.empty();\n }\n\n var listOptions = Optional.ofNullable(additionalListOptions)\n .map(ListOptions::builder)\n .orElseGet(ListOptions::builder)\n .andQuery(notDeleting())\n .andQuery(Queries.in(\"metadata.name\", names))\n .build();\n\n return client.listAll(Role.class, listOptions, ExtensionUtil.defaultSort());\n }\n\n private static ListOptions shouldExcludeHidden(boolean excludeHidden) {\n if (!excludeHidden) {\n return null;\n }\n return ListOptions.builder().labelSelector()\n .notEq(Role.HIDDEN_LABEL_NAME, Boolean.TRUE.toString())\n .end()\n .build();\n }\n\n private Flux listWithDependencies(Set names, ListOptions additionalListOptions) {\n var visited = new HashSet();\n return listRoles(names, additionalListOptions)\n .expand(role -> {\n var name = role.getMetadata().getName();\n if (visited.contains(name)) {\n return Flux.empty();\n }\n if (log.isTraceEnabled()) {\n log.trace(\"Expand role: {}\", role.getMetadata().getName());\n }\n visited.add(name);\n var annotations = MetadataUtil.nullSafeAnnotations(role);\n var dependenciesJson = annotations.get(Role.ROLE_DEPENDENCIES_ANNO);\n var dependencies = stringToList(dependenciesJson);\n\n return Flux.fromIterable(dependencies)\n .filter(dep -> !visited.contains(dep))\n .collect(Collectors.toSet())\n .flatMapMany(deps -> listRoles(deps, additionalListOptions));\n })\n .concatWith(Flux.defer(() -> listAggregatedRoles(visited, additionalListOptions)));\n }\n\n private Flux listAggregatedRoles(Set roleNames,\n ListOptions additionalListOptions) {\n if (CollectionUtils.isEmpty(roleNames)) {\n return Flux.empty();\n }\n var listOptions = Optional.ofNullable(additionalListOptions)\n .map(ListOptions::builder)\n .orElseGet(ListOptions::builder)\n .andQuery(Queries.in(\"labels.aggregateToRoles\", roleNames))\n .build();\n return client.listAll(Role.class, listOptions, ExtensionUtil.defaultSort());\n }\n\n Predicate getRoleBindingPredicate(Subject targetSubject) {\n return roleBinding -> {\n List subjects = roleBinding.getSubjects();\n for (Subject subject : subjects) {\n return matchSubject(targetSubject, subject);\n }\n return false;\n };\n }\n\n private static boolean matchSubject(Subject targetSubject, Subject subject) {\n if (targetSubject == null || subject == null) {\n return false;\n }\n return StringUtils.equals(targetSubject.getKind(), subject.getKind())\n && StringUtils.equals(targetSubject.getName(), subject.getName())\n && StringUtils.defaultString(targetSubject.getApiGroup())\n .equals(StringUtils.defaultString(subject.getApiGroup()));\n }\n\n @Override\n public Flux list(Set roleNames) {\n return list(roleNames, false);\n }\n\n @Override\n public Flux list(Set roleNames, boolean excludeHidden) {\n if (CollectionUtils.isEmpty(roleNames)) {\n return Flux.empty();\n }\n var builder = ListOptions.builder()\n .andQuery(notDeleting())\n .andQuery(Queries.in(\"metadata.name\", roleNames));\n if (excludeHidden) {\n builder.labelSelector().notEq(Role.HIDDEN_LABEL_NAME, Boolean.TRUE.toString());\n }\n return client.listAll(Role.class, builder.build(), defaultSort());\n }\n\n @NonNull\n private List stringToList(String str) {\n if (StringUtils.isBlank(str)) {\n return Collections.emptyList();\n }\n return JsonUtils.jsonToObject(str,\n new TypeReference<>() {\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/EmailPasswordRecoveryService.java", "content": "package run.halo.app.core.user.service;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.exception.AccessDeniedException;\n\n/**\n * An interface for email password recovery.\n *\n * @author guqing\n * @since 2.11.0\n */\npublic interface EmailPasswordRecoveryService {\n\n /**\n *

Send password reset email.

\n * if the user does not exist, it will return {@link Mono#empty()}\n * if the user exists, but the email is not the same, it will return {@link Mono#empty()}\n *\n * @param username username to request password reset\n * @param email email to match the user with the username\n * @return {@link Mono#empty()} if the user does not exist, or the email is not the same.\n */\n Mono sendPasswordResetEmail(String username, String email);\n\n Mono sendPasswordResetEmail(String email);\n\n /**\n *

Reset password by token.

\n * if the token is invalid, it will return {@link Mono#error(Throwable)}}\n * if the token is valid, but the username is not the same, it will return\n * {@link Mono#error(Throwable)}\n *\n * @param newPassword new password\n * @param token token to validate the user\n * @return {@link Mono#empty()} if the token is invalid or the username is not the same.\n * @throws AccessDeniedException if the token is invalid\n */\n Mono changePassword(String newPassword, String token);\n\n Mono getValidResetToken(String token);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/EmailVerificationService.java", "content": "package run.halo.app.core.user.service;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.exception.EmailVerificationFailed;\n\n/**\n * Email verification service to handle email verification.\n *\n * @author guqing\n * @since 2.11.0\n */\npublic interface EmailVerificationService {\n\n /**\n * Send verification code by given username.\n *\n * @param username username to verify email must not be blank\n * @param email email to send must not be blank\n */\n Mono sendVerificationCode(String username, String email);\n\n /**\n * Verify email by given username and code.\n *\n * @param username username to verify email must not be blank\n * @param code code to verify email must not be blank\n * @throws EmailVerificationFailed if send failed\n */\n Mono verify(String username, String code);\n\n /**\n * Send verification code.\n * The only difference is use email as username.\n *\n * @param email email to send must not be blank\n */\n Mono sendRegisterVerificationCode(String email);\n\n /**\n * Verify email by given code.\n *\n * @param email email as username to verify email must not be blank\n * @param code code to verify email must not be blank\n * @throws EmailVerificationFailed if send failed\n */\n Mono verifyRegisterVerificationCode(String email, String code);\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/InMemoryResetTokenRepository.java", "content": "package run.halo.app.core.user.service;\n\nimport com.github.benmanes.caffeine.cache.Cache;\nimport com.github.benmanes.caffeine.cache.Caffeine;\nimport java.time.Duration;\nimport java.util.Objects;\nimport org.springframework.dao.DuplicateKeyException;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\n\n/**\n * In-memory reset token repository.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\npublic class InMemoryResetTokenRepository implements ResetTokenRepository {\n\n /**\n * Key: Token Hash.\n */\n private final Cache tokens;\n\n public InMemoryResetTokenRepository() {\n this.tokens = Caffeine.newBuilder()\n .expireAfterWrite(Duration.ofDays(1))\n .maximumSize(10000)\n .build();\n }\n\n @Override\n public Mono save(ResetToken resetToken) {\n return Mono.defer(() -> {\n var savedResetToken = tokens.get(resetToken.tokenHash(), k -> resetToken);\n if (Objects.equals(savedResetToken, resetToken)) {\n return Mono.empty();\n }\n // should never happen\n return Mono.error(new DuplicateKeyException(\"Reset token already exists\"));\n });\n }\n\n @Override\n public Mono findByTokenHash(String tokenHash) {\n return Mono.fromSupplier(() -> tokens.getIfPresent(tokenHash));\n }\n\n @Override\n public Mono removeByTokenHash(String tokenHash) {\n return Mono.fromRunnable(() -> tokens.invalidate(tokenHash));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/InvalidResetTokenException.java", "content": "package run.halo.app.core.user.service;\n\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Invalid reset token exception.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class InvalidResetTokenException extends ServerWebInputException {\n\n public InvalidResetTokenException() {\n super(\"Invalid reset token\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/PatService.java", "content": "package run.halo.app.core.user.service;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.PersonalAccessToken;\n\n/**\n * Service for personal access token.\n *\n * @author johnniang\n */\npublic interface PatService {\n\n /**\n * Create a new personal access token. We will automatically use the current user as the\n * owner of the token from the security context.\n *\n * @param patRequest the personal access token request\n * @return the created personal access token\n */\n Mono create(PersonalAccessToken patRequest);\n\n /**\n * Create a new personal access token for the specified user.\n *\n * @param patRequest the personal access token request\n * @param username the username of the user\n * @return the created personal access token\n */\n Mono create(PersonalAccessToken patRequest, String username);\n\n /**\n * Revoke a personal access token.\n *\n * @param patName the name of the personal access token\n * @param username the username of the user\n * @return the revoked personal access token\n */\n Mono revoke(String patName, String username);\n\n /**\n * Restore a personal access token.\n *\n * @param patName the name of the personal access token\n * @param username the username of the user\n * @return the restored personal access token\n */\n Mono restore(String patName, String username);\n\n /**\n * Delete a personal access token.\n *\n * @param patName the name of the personal access token\n * @param username the username of the user\n * @return the deleted personal access token\n */\n Mono delete(String patName, String username);\n\n /**\n * Get a personal access token by name.\n *\n * @param patName the name of the personal access token\n * @param username the username of the user\n * @return the personal access token\n */\n Mono get(String patName, String username);\n\n /**\n * Generate a personal access token.\n *\n * @param pat the personal access token\n * @return the generated token\n */\n Mono generateToken(PersonalAccessToken pat);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/ResetToken.java", "content": "package run.halo.app.core.user.service;\n\nimport java.time.Instant;\n\n/**\n * Reset token data.\n *\n * @param tokenHash The token hash\n * @param username The username\n * @param expiresAt The expires at\n * @author johnniang\n * @since 2.20.0\n */\npublic record ResetToken(String tokenHash, String username, Instant expiresAt) {\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/ResetTokenRepository.java", "content": "package run.halo.app.core.user.service;\n\nimport reactor.core.publisher.Mono;\n\n/**\n * Reset token repository.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface ResetTokenRepository {\n\n /**\n * Save reset token.\n *\n * @param resetToken reset token\n * @return empty mono if saved successfully.\n * @throws org.springframework.dao.DuplicateKeyException if token already exists.\n */\n Mono save(ResetToken resetToken);\n\n /**\n * Find reset token by token hash.\n *\n * @param tokenHash token hash\n * @return reset token if found, or empty mono.\n */\n Mono findByTokenHash(String tokenHash);\n\n /**\n * Remove reset token by token hash.\n *\n * @param tokenHash token hash\n * @return empty mono if removed successfully.\n */\n Mono removeByTokenHash(String tokenHash);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/SettingConfigService.java", "content": "package run.halo.app.core.user.service;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.extension.ConfigMap;\nimport tools.jackson.databind.node.ObjectNode;\n\n/**\n * {@link Setting} related {@link ConfigMap} service.\n *\n * @author guqing\n * @since 2.20.0\n */\npublic interface SettingConfigService {\n\n Mono upsertConfig(String configMapName, ObjectNode configJsonData);\n\n Mono fetchConfig(String configMapName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/UserConnectionService.java", "content": "package run.halo.app.core.user.service;\n\nimport org.springframework.security.oauth2.core.user.OAuth2User;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.UserConnection;\n\npublic interface UserConnectionService {\n\n /**\n * Create user connection.\n *\n * @param username Username\n * @param registrationId Registration id\n * @param oauth2User OAuth2 user\n * @return Created user connection\n */\n Mono createUserConnection(\n String username,\n String registrationId,\n OAuth2User oauth2User\n );\n\n /**\n * Update the user connection if present.\n * If found, update updatedAt timestamp of the user connection.\n *\n * @param registrationId Registration id\n * @param oauth2User OAuth2 user\n * @return Updated user connection or empty\n */\n Mono updateUserConnectionIfPresent(\n String registrationId, OAuth2User oauth2User\n );\n\n /**\n * Remove user connection.\n *\n * @param registrationId Registration ID\n * @param username Username\n * @return A list of user connections\n */\n Flux removeUserConnection(String registrationId, String username);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/UserLoginOrLogoutProcessing.java", "content": "package run.halo.app.core.user.service;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.event.user.UserLoginEvent;\nimport run.halo.app.event.user.UserLogoutEvent;\n\n/**\n * User login or logout processing service.\n *\n * @author lywq\n **/\n@Component\n@RequiredArgsConstructor\npublic class UserLoginOrLogoutProcessing {\n\n private final UserService userService;\n private final ApplicationEventPublisher eventPublisher;\n\n public Mono loginProcessing(String username) {\n return userService.getUser(username)\n .doOnNext(user -> {\n eventPublisher.publishEvent(new UserLoginEvent(this, user));\n })\n .then();\n }\n\n public Mono logoutProcessing(String username) {\n return userService.getUser(username)\n .doOnNext(user -> {\n eventPublisher.publishEvent(new UserLogoutEvent(this, user));\n })\n .then();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/DefaultAttachmentService.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport java.net.URI;\nimport java.net.URL;\nimport java.nio.file.Paths;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.concurrent.atomic.AtomicReference;\nimport java.util.function.Consumer;\nimport java.util.function.Function;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.server.ResponseStatusException;\nimport org.springframework.web.server.ServerErrorException;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Group;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.core.extension.attachment.endpoint.AttachmentHandler;\nimport run.halo.app.core.extension.attachment.endpoint.DeleteOption;\nimport run.halo.app.core.extension.attachment.endpoint.SimpleFilePart;\nimport run.halo.app.core.extension.attachment.endpoint.UploadOption;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ReactiveUrlDataBufferFetcher;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@Component\npublic class DefaultAttachmentService implements AttachmentService {\n\n private final ReactiveExtensionClient client;\n\n private final ExtensionGetter extensionGetter;\n\n private final ReactiveUrlDataBufferFetcher dataBufferFetcher;\n\n public DefaultAttachmentService(ReactiveExtensionClient client,\n ExtensionGetter extensionGetter,\n ReactiveUrlDataBufferFetcher dataBufferFetcher) {\n this.client = client;\n this.extensionGetter = extensionGetter;\n this.dataBufferFetcher = dataBufferFetcher;\n }\n\n @Override\n public Mono upload(\n @NonNull String username,\n @NonNull String policyName,\n @Nullable String groupName,\n @NonNull FilePart filePart,\n @Nullable Consumer beforeCreating) {\n var builder = UploadOption.builder();\n builder.file(filePart);\n var getPolicyAndConfigMap = client.get(Policy.class, policyName)\n .doOnNext(builder::policy)\n .mapNotNull(p -> p.getSpec().getConfigMapName())\n .filter(StringUtils::hasText)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"ConfigMap name not found in Policy \" + policyName\n )))\n .flatMap(configMapName -> client.get(ConfigMap.class, configMapName))\n .doOnNext(builder::configMap)\n .then();\n\n var getGroup = Mono.justOrEmpty(groupName)\n .filter(StringUtils::hasText)\n .flatMap(name -> client.get(Group.class, name))\n .doOnNext(builder::group)\n .then();\n return Mono.when(getPolicyAndConfigMap, getGroup).then(Mono.fromSupplier(builder::build))\n .flatMap(uploadContext -> extensionGetter.getExtensions(AttachmentHandler.class)\n .concatMap(handler -> handler.upload(uploadContext))\n .next())\n .switchIfEmpty(Mono.error(() -> new ServerErrorException(\n \"No suitable handler found for uploading the attachment.\", null)))\n .doOnNext(attachment -> {\n var spec = attachment.getSpec();\n if (spec == null) {\n spec = new Attachment.AttachmentSpec();\n attachment.setSpec(spec);\n }\n spec.setOwnerName(username);\n if (StringUtils.hasText(groupName)) {\n spec.setGroupName(groupName);\n }\n spec.setPolicyName(policyName);\n })\n .doOnNext(attachment -> {\n if (beforeCreating != null) {\n beforeCreating.accept(attachment);\n }\n })\n .flatMap(client::create);\n }\n\n @Override\n public Mono upload(@NonNull String policyName,\n @Nullable String groupName,\n @NonNull String filename,\n @NonNull Flux content,\n @Nullable MediaType mediaType) {\n var file = new SimpleFilePart(filename, content, mediaType);\n return authenticationConsumer(\n authentication -> upload(authentication.getName(), policyName, groupName, file, null));\n }\n\n @Override\n public Mono delete(Attachment attachment) {\n var spec = attachment.getSpec();\n return client.get(Policy.class, spec.getPolicyName())\n .flatMap(policy -> client.get(ConfigMap.class, policy.getSpec().getConfigMapName())\n .map(configMap -> new DeleteOption(attachment, policy, configMap)))\n .flatMap(deleteOption -> extensionGetter.getExtensions(AttachmentHandler.class)\n .concatMap(handler -> handler.delete(deleteOption))\n .next());\n }\n\n @Override\n public Mono getPermalink(Attachment attachment) {\n return client.get(Policy.class, attachment.getSpec().getPolicyName())\n .flatMap(policy -> client.get(ConfigMap.class, policy.getSpec().getConfigMapName())\n .flatMap(configMap -> extensionGetter.getExtensions(AttachmentHandler.class)\n .concatMap(handler -> handler.getPermalink(attachment, policy, configMap))\n .next()\n )\n );\n }\n\n @Override\n public Mono getSharedURL(Attachment attachment, Duration ttl) {\n return client.get(Policy.class, attachment.getSpec().getPolicyName())\n .flatMap(policy -> client.get(ConfigMap.class, policy.getSpec().getConfigMapName())\n .flatMap(configMap -> extensionGetter.getExtensions(AttachmentHandler.class)\n .concatMap(handler -> handler.getSharedURL(attachment, policy, configMap, ttl))\n .next()\n )\n );\n }\n\n @Override\n public Mono> getThumbnailLinks(Attachment attachment) {\n\n return client.get(Policy.class, attachment.getSpec().getPolicyName())\n .zipWhen(policy -> client.get(ConfigMap.class, policy.getSpec().getConfigMapName()))\n .flatMap(tuple2 -> {\n var policy = tuple2.getT1();\n var configMap = tuple2.getT2();\n return extensionGetter.getExtensions(AttachmentHandler.class)\n .concatMap(handler -> handler.getThumbnailLinks(attachment, policy, configMap))\n .next();\n });\n }\n\n @Override\n public Mono uploadFromUrl(@NonNull URL url, @NonNull String policyName,\n String groupName, String filename) {\n var uri = URI.create(url.toString());\n AtomicReference mediaTypeRef = new AtomicReference<>();\n AtomicReference fileNameRef = new AtomicReference<>(filename);\n\n Mono> contentMono = dataBufferFetcher.head(uri)\n .map(httpHeaders -> {\n if (!StringUtils.hasText(fileNameRef.get())) {\n fileNameRef.set(getExternalUrlFilename(uri, httpHeaders));\n }\n MediaType contentType = httpHeaders.getContentType();\n mediaTypeRef.set(contentType);\n return httpHeaders;\n })\n .map(response -> dataBufferFetcher.fetch(uri));\n\n return contentMono.flatMap(\n (content) -> upload(policyName, groupName, fileNameRef.get(), content,\n mediaTypeRef.get())\n )\n .onErrorResume(throwable -> Mono.error(\n new ServerWebInputException(\n \"Failed to transfer the attachment from the external URL.\"))\n );\n }\n\n private static String getExternalUrlFilename(URI externalUrl, HttpHeaders httpHeaders) {\n String fileName = httpHeaders.getContentDisposition().getFilename();\n if (!StringUtils.hasText(fileName)) {\n var path = externalUrl.getPath();\n fileName = Paths.get(path).getFileName().toString();\n }\n // TODO get file extension from media type\n return fileName;\n }\n\n private Mono authenticationConsumer(Function> func) {\n return ReactiveSecurityContextHolder.getContext()\n .switchIfEmpty(Mono.error(() -> new ResponseStatusException(HttpStatus.UNAUTHORIZED,\n \"Authentication required.\")))\n .map(SecurityContext::getAuthentication)\n .flatMap(func);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/EmailPasswordRecoveryServiceImpl.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport java.time.Clock;\nimport java.time.Duration;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.RandomStringUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.security.core.token.Sha512DigestUtils;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.core.user.service.EmailPasswordRecoveryService;\nimport run.halo.app.core.user.service.InvalidResetTokenException;\nimport run.halo.app.core.user.service.ResetToken;\nimport run.halo.app.core.user.service.ResetTokenRepository;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ExternalLinkProcessor;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.notification.NotificationReasonEmitter;\nimport run.halo.app.notification.UserIdentity;\n\n/**\n * A default implementation for {@link EmailPasswordRecoveryService}.\n *\n * @author guqing\n * @since 2.11.0\n */\n@Component\n@RequiredArgsConstructor\npublic class EmailPasswordRecoveryServiceImpl implements EmailPasswordRecoveryService {\n\n public static final int MAX_ATTEMPTS = 5;\n public static final long LINK_EXPIRATION_MINUTES = 30;\n private static final Duration RESET_TOKEN_LIFE_TIME =\n Duration.ofMinutes(LINK_EXPIRATION_MINUTES);\n static final String RESET_PASSWORD_BY_EMAIL_REASON_TYPE = \"reset-password-by-email\";\n\n private final ExternalLinkProcessor externalLinkProcessor;\n private final ReactiveExtensionClient client;\n private final NotificationReasonEmitter reasonEmitter;\n private final NotificationCenter notificationCenter;\n private final UserService userService;\n private final ResetTokenRepository resetTokenRepository;\n\n private Clock clock = Clock.systemDefaultZone();\n\n @Override\n public Mono sendPasswordResetEmail(String username, String email) {\n return client.fetch(User.class, username)\n .flatMap(user -> {\n var userEmail = user.getSpec().getEmail();\n if (!StringUtils.equals(userEmail, email)) {\n return Mono.empty();\n }\n if (!user.getSpec().isEmailVerified()) {\n return Mono.empty();\n }\n return sendResetPasswordNotification(username, email);\n });\n }\n\n @Override\n public Mono sendPasswordResetEmail(String email) {\n if (StringUtils.isBlank(email)) {\n return Mono.empty();\n }\n return userService.listByEmail(email)\n .filter(user -> user.getSpec().isEmailVerified())\n .next()\n .flatMap(user -> sendResetPasswordNotification(user.getMetadata().getName(), email));\n }\n\n @Override\n public Mono changePassword(String newPassword, String token) {\n Assert.state(StringUtils.isNotBlank(newPassword), \"NewPassword must not be blank\");\n Assert.state(StringUtils.isNotBlank(token), \"Token for reset password must not be blank\");\n var tokenHash = hashToken(token);\n return getValidResetToken(token).flatMap(resetToken ->\n userService.updateWithRawPassword(resetToken.username(), newPassword)\n .flatMap(user -> unSubscribeResetPasswordEmailNotification(\n user.getSpec().getEmail())\n )\n .then(resetTokenRepository.removeByTokenHash(tokenHash))\n );\n }\n\n @Override\n public Mono getValidResetToken(String token) {\n return resetTokenRepository.findByTokenHash(hashToken(token))\n .filter(resetToken -> clock.instant().isBefore(resetToken.expiresAt()))\n .switchIfEmpty(Mono.error(InvalidResetTokenException::new));\n }\n\n Mono unSubscribeResetPasswordEmailNotification(String email) {\n if (StringUtils.isBlank(email)) {\n return Mono.empty();\n }\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(UserIdentity.anonymousWithEmail(email).name());\n return notificationCenter.unsubscribe(subscriber, createInterestReason(email))\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono sendResetPasswordNotification(String username, String email) {\n var token = generateToken();\n var tokenHash = hashToken(token);\n var expiresAt = clock.instant().plus(RESET_TOKEN_LIFE_TIME);\n var uri = UriComponentsBuilder.fromUriString(\"/\")\n .pathSegment(\"password-reset\", \"email\", token)\n .build(true)\n .toUri();\n var resetToken = new ResetToken(tokenHash, username, expiresAt);\n return resetTokenRepository.save(resetToken)\n .then(externalLinkProcessor.processLink(uri).flatMap(link -> {\n var interestReasonSubject = createInterestReason(email).getSubject();\n var emitReasonMono = reasonEmitter.emit(RESET_PASSWORD_BY_EMAIL_REASON_TYPE,\n builder -> builder.attribute(\"expirationAtMinutes\", LINK_EXPIRATION_MINUTES)\n .attribute(\"username\", username)\n .attribute(\"link\", link)\n .author(UserIdentity.of(username))\n .subject(Reason.Subject.builder()\n .apiVersion(interestReasonSubject.getApiVersion())\n .kind(interestReasonSubject.getKind())\n .name(interestReasonSubject.getName())\n .title(\"使用邮箱地址重置密码：\" + email)\n .build()\n )\n );\n return autoSubscribeResetPasswordEmailNotification(email).then(emitReasonMono);\n }));\n }\n\n Mono autoSubscribeResetPasswordEmailNotification(String email) {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(UserIdentity.anonymousWithEmail(email).name());\n var interestReason = createInterestReason(email);\n return notificationCenter.subscribe(subscriber, interestReason)\n .then();\n }\n\n Subscription.InterestReason createInterestReason(String email) {\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(RESET_PASSWORD_BY_EMAIL_REASON_TYPE);\n interestReason.setSubject(Subscription.ReasonSubject.builder()\n .apiVersion(new GroupVersion(User.GROUP, User.KIND).toString())\n .kind(User.KIND)\n .name(UserIdentity.anonymousWithEmail(email).name())\n .build());\n return interestReason;\n }\n\n private static String hashToken(String token) {\n return Sha512DigestUtils.shaHex(token);\n }\n\n private static String generateToken() {\n return RandomStringUtils.secure().nextAlphanumeric(64);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/EmailVerificationServiceImpl.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport com.google.common.cache.Cache;\nimport com.google.common.cache.CacheBuilder;\nimport java.time.Duration;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicInteger;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport lombok.experimental.Accessors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.RandomStringUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.core.user.service.EmailVerificationService;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.infra.exception.EmailVerificationFailed;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.notification.NotificationReasonEmitter;\nimport run.halo.app.notification.UserIdentity;\n\n/**\n * A default implementation of {@link EmailVerificationService}.\n *\n * @author guqing\n * @since 2.11.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class EmailVerificationServiceImpl implements EmailVerificationService {\n public static final int MAX_ATTEMPTS = 5;\n public static final long CODE_EXPIRATION_MINUTES = 10;\n static final String EMAIL_VERIFICATION_REASON_TYPE = \"email-verification\";\n\n private final EmailVerificationManager emailVerificationManager =\n new EmailVerificationManager();\n private final ReactiveExtensionClient client;\n private final NotificationReasonEmitter reasonEmitter;\n private final NotificationCenter notificationCenter;\n\n @Override\n public Mono sendVerificationCode(String username, String email) {\n Assert.state(StringUtils.isNotBlank(username), \"Username must not be blank\");\n Assert.state(StringUtils.isNotBlank(email), \"Email must not be blank\");\n return Mono.defer(() -> client.get(User.class, username)\n .flatMap(user -> {\n var userEmail = user.getSpec().getEmail();\n var isVerified = user.getSpec().isEmailVerified();\n if (StringUtils.equalsIgnoreCase(userEmail, email) && isVerified) {\n return Mono.error(\n () -> new ServerWebInputException(\"Email already verified.\"));\n }\n var annotations = MetadataUtil.nullSafeAnnotations(user);\n var oldEmailToVerify = annotations.get(User.EMAIL_TO_VERIFY);\n var unsubMono = unSubscribeVerificationEmailNotification(oldEmailToVerify);\n var updateUserAnnoMono = Mono.defer(() -> {\n annotations.put(User.EMAIL_TO_VERIFY, email);\n return client.update(user);\n });\n emailVerificationManager.removeCode(username, oldEmailToVerify);\n return Mono.when(unsubMono, updateUserAnnoMono).thenReturn(user);\n })\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n .flatMap(user -> sendVerificationNotification(username, email));\n }\n\n @Override\n public Mono verify(String username, String code) {\n Assert.state(StringUtils.isNotBlank(username), \"Username must not be blank\");\n Assert.state(StringUtils.isNotBlank(code), \"Code must not be blank\");\n return Mono.defer(() -> client.get(User.class, username)\n .flatMap(user -> verifyUserEmail(user, code))\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono verifyUserEmail(User user, String code) {\n var username = user.getMetadata().getName();\n var annotations = MetadataUtil.nullSafeAnnotations(user);\n var emailToVerify = annotations.get(User.EMAIL_TO_VERIFY);\n\n if (StringUtils.isBlank(emailToVerify)) {\n return Mono.error(EmailVerificationFailed::new);\n }\n\n var verified = emailVerificationManager.verifyCode(username, emailToVerify, code);\n if (!verified) {\n return Mono.error(EmailVerificationFailed::new);\n }\n\n return isEmailInUse(username, emailToVerify)\n .flatMap(inUse -> {\n if (inUse) {\n return Mono.error(new EmailVerificationFailed(\"Email already in use.\",\n null,\n \"problemDetail.user.email.verify.emailInUse\",\n null)\n );\n }\n // remove code when verified\n emailVerificationManager.removeCode(username, emailToVerify);\n user.getSpec().setEmailVerified(true);\n user.getSpec().setEmail(emailToVerify);\n return client.update(user);\n })\n .then();\n }\n\n Mono isEmailInUse(String username, String emailToVerify) {\n var listOptions = ListOptions.builder()\n .andQuery(Queries.equal(\"spec.email\", emailToVerify.toLowerCase()))\n .build();\n return client.listAll(User.class, listOptions, ExtensionUtil.defaultSort())\n .filter(user -> user.getSpec().isEmailVerified())\n .filter(user -> !user.getMetadata().getName().equals(username))\n .hasElements();\n }\n\n @Override\n public Mono sendRegisterVerificationCode(String email) {\n Assert.state(StringUtils.isNotBlank(email), \"Email must not be blank\");\n return sendVerificationNotification(email.toLowerCase(), email);\n }\n\n @Override\n public Mono verifyRegisterVerificationCode(String email, String code) {\n Assert.state(StringUtils.isNotBlank(email), \"Username must not be blank\");\n Assert.state(StringUtils.isNotBlank(code), \"Code must not be blank\");\n return Mono.fromSupplier(() -> emailVerificationManager.verifyCode(email, email, code))\n // Why use boundedElastic? Because the verification uses synchronized block.\n .subscribeOn(Schedulers.boundedElastic());\n }\n\n Mono sendVerificationNotification(String username, String email) {\n var code = emailVerificationManager.generateCode(username, email);\n if (log.isDebugEnabled()) {\n log.debug(\"Generated verification code for user '{}' and email '{}': {}\",\n username, email, code);\n }\n var subscribeNotification = autoSubscribeVerificationEmailNotification(email);\n var interestReasonSubject = createInterestReason(email).getSubject();\n var emitReasonMono = reasonEmitter.emit(EMAIL_VERIFICATION_REASON_TYPE,\n builder -> builder.attribute(\"code\", code)\n .attribute(\"expirationAtMinutes\", CODE_EXPIRATION_MINUTES)\n .attribute(\"username\", username)\n .author(UserIdentity.of(username))\n .subject(Reason.Subject.builder()\n .apiVersion(interestReasonSubject.getApiVersion())\n .kind(interestReasonSubject.getKind())\n .name(interestReasonSubject.getName())\n .title(\"验证邮箱：\" + email)\n .build()\n )\n );\n return Mono.when(subscribeNotification).then(emitReasonMono);\n }\n\n Mono autoSubscribeVerificationEmailNotification(String email) {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(UserIdentity.anonymousWithEmail(email).name());\n var interestReason = createInterestReason(email);\n return notificationCenter.subscribe(subscriber, interestReason)\n .then();\n }\n\n Mono unSubscribeVerificationEmailNotification(String oldEmail) {\n if (StringUtils.isBlank(oldEmail)) {\n return Mono.empty();\n }\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(UserIdentity.anonymousWithEmail(oldEmail).name());\n return notificationCenter.unsubscribe(subscriber,\n createInterestReason(oldEmail));\n }\n\n Subscription.InterestReason createInterestReason(String email) {\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(EMAIL_VERIFICATION_REASON_TYPE);\n interestReason.setSubject(Subscription.ReasonSubject.builder()\n .apiVersion(new GroupVersion(User.GROUP, User.KIND).toString())\n .kind(User.KIND)\n .name(UserIdentity.anonymousWithEmail(email).name())\n .build());\n return interestReason;\n }\n\n /**\n * A simple email verification manager that stores the verification code in memory.\n * It is a thread-safe class.\n *\n * @author guqing\n * @since 2.11.0\n */\n static class EmailVerificationManager {\n private final Cache emailVerificationCodeCache =\n CacheBuilder.newBuilder()\n .expireAfterWrite(CODE_EXPIRATION_MINUTES, TimeUnit.MINUTES)\n .maximumSize(10000)\n .build();\n\n private final Cache blackListCache = CacheBuilder.newBuilder()\n .expireAfterWrite(Duration.ofHours(1))\n .maximumSize(1000)\n .build();\n\n public boolean verifyCode(String username, String email, String code) {\n var key = new UsernameEmail(username, email);\n var verification = emailVerificationCodeCache.getIfPresent(key);\n if (verification == null) {\n // expired or not generated\n return false;\n }\n if (blackListCache.getIfPresent(key) != null) {\n // in blacklist\n throw new EmailVerificationFailed(\"Too many attempts. Please try again later.\",\n null,\n \"problemDetail.user.email.verify.maxAttempts\",\n null);\n }\n synchronized (verification) {\n if (verification.getAttempts().get() >= MAX_ATTEMPTS) {\n // add to blacklist to prevent brute force attack\n blackListCache.put(key, true);\n return false;\n }\n if (!verification.getCode().equals(code)) {\n verification.getAttempts().incrementAndGet();\n return false;\n }\n }\n return true;\n }\n\n public void removeCode(String username, String email) {\n var key = new UsernameEmail(username, email);\n emailVerificationCodeCache.invalidate(key);\n }\n\n public String generateCode(String username, String email) {\n Assert.state(StringUtils.isNotBlank(username), \"Username must not be blank\");\n Assert.state(StringUtils.isNotBlank(email), \"Email must not be blank\");\n var key = new UsernameEmail(username, email);\n var verification = new Verification();\n verification.setCode(RandomStringUtils.randomNumeric(6));\n verification.setAttempts(new AtomicInteger(0));\n emailVerificationCodeCache.put(key, verification);\n return verification.getCode();\n }\n\n /**\n * Only for test.\n */\n boolean contains(String username, String email) {\n return emailVerificationCodeCache\n .getIfPresent(new UsernameEmail(username, email)) != null;\n }\n\n record UsernameEmail(String username, String email) {\n public UsernameEmail {\n // convert to lower case to make it case-insensitive\n email = StringUtils.lowerCase(email);\n }\n }\n\n @Data\n @Accessors(chain = true)\n static class Verification {\n private String code;\n private AtomicInteger attempts;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/PatServiceImpl.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport com.nimbusds.jose.jwk.JWKSet;\nimport com.nimbusds.jose.jwk.source.ImmutableJWKSet;\nimport java.time.Clock;\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Objects;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.GrantedAuthority;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.oauth2.jose.jws.SignatureAlgorithm;\nimport org.springframework.security.oauth2.jwt.JwsHeader;\nimport org.springframework.security.oauth2.jwt.JwtClaimsSet;\nimport org.springframework.security.oauth2.jwt.JwtEncoder;\nimport org.springframework.security.oauth2.jwt.JwtEncoderParameters;\nimport org.springframework.security.oauth2.jwt.NimbusJwtEncoder;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.AlternativeJdkIdGenerator;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.IdGenerator;\nimport org.springframework.web.filter.reactive.ServerWebExchangeContextFilter;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.PatService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.security.PersonalAccessToken;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n/**\n * Service for managing personal access tokens (PATs).\n *\n * @author johnniang\n */\n@Service\nclass PatServiceImpl implements PatService {\n\n private final RoleService roleService;\n\n private final IdGenerator idGenerator;\n\n private final ReactiveExtensionClient client;\n\n private final AuthenticationTrustResolver authTrustResolver =\n new AuthenticationTrustResolverImpl();\n\n private final JwtEncoder jwtEncoder;\n\n private final ExternalUrlSupplier externalUrl;\n\n private final ReactiveUserDetailsService userDetailsService;\n\n private final String keyId;\n\n private Clock clock;\n\n public PatServiceImpl(RoleService roleService,\n ReactiveExtensionClient client,\n ExternalUrlSupplier externalUrl,\n CryptoService cryptoService, ReactiveUserDetailsService userDetailsService) {\n this.roleService = roleService;\n this.client = client;\n this.externalUrl = externalUrl;\n this.userDetailsService = userDetailsService;\n this.clock = Clock.systemUTC();\n idGenerator = new AlternativeJdkIdGenerator();\n var jwk = cryptoService.getJwk();\n this.jwtEncoder = new NimbusJwtEncoder(new ImmutableJWKSet<>(new JWKSet(jwk)));\n this.keyId = jwk.getKeyID();\n }\n\n /**\n * Set clock for testing.\n *\n * @param clock the clock to set\n */\n void setClock(Clock clock) {\n this.clock = clock;\n }\n\n @Override\n public Mono create(PersonalAccessToken patRequest) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n // TODO We only allow authenticated users to create PATs.\n .filter(authTrustResolver::isAuthenticated)\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Authentication required.\"))\n )\n .flatMap(auth ->\n create(patRequest, auth.getName(), auth.getAuthorities())\n );\n }\n\n @Override\n public Mono create(PersonalAccessToken patRequest, String username) {\n return userDetailsService.findByUsername(username)\n .flatMap(userDetails ->\n create(patRequest, username, userDetails.getAuthorities())\n );\n }\n\n private Mono create(PersonalAccessToken patRequest, String username,\n Collection authorities) {\n var patSpec = patRequest.getSpec();\n // preflight check\n var expiresAt = patSpec.getExpiresAt();\n if (expiresAt != null && expiresAt.isBefore(clock.instant())) {\n return Mono.error(new ServerWebInputException(\"Invalid expiresAt.\"));\n }\n var roles = patSpec.getRoles();\n return hasSufficientRoles(authorities, roles)\n .filter(has -> has)\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Insufficient roles.\"))\n )\n .map(has -> {\n var pat = new PersonalAccessToken();\n pat.setMetadata(new Metadata());\n if (patRequest.getMetadata() != null) {\n var metadata = patRequest.getMetadata();\n if (metadata.getName() != null) {\n pat.getMetadata().setName(metadata.getName());\n }\n if (metadata.getGenerateName() != null) {\n pat.getMetadata().setGenerateName(metadata.getGenerateName());\n }\n if (metadata.getLabels() != null) {\n pat.getMetadata().setLabels(new HashMap<>());\n pat.getMetadata().getLabels().putAll(metadata.getLabels());\n }\n if (metadata.getAnnotations() != null) {\n pat.getMetadata().setAnnotations(new HashMap<>());\n pat.getMetadata().getAnnotations()\n .putAll(metadata.getAnnotations());\n }\n if (metadata.getFinalizers() != null) {\n pat.getMetadata().setFinalizers(new HashSet<>());\n pat.getMetadata().getFinalizers().addAll(metadata.getFinalizers());\n }\n }\n if (pat.getMetadata().getGenerateName() == null) {\n pat.getMetadata().setGenerateName(\"pat-\" + username + \"-\");\n }\n pat.getSpec().setUsername(username);\n pat.getSpec().setName(patSpec.getName());\n pat.getSpec().setDescription(patSpec.getDescription());\n if (patSpec.getRoles() != null) {\n pat.getSpec().setRoles(new ArrayList<>());\n pat.getSpec().getRoles().addAll(patSpec.getRoles());\n }\n if (patSpec.getScopes() != null) {\n pat.getSpec().setScopes(new ArrayList<>());\n pat.getSpec().getScopes().addAll(patSpec.getScopes());\n }\n pat.getSpec().setExpiresAt(patSpec.getExpiresAt());\n pat.getSpec().setTokenId(idGenerator.generateId().toString());\n return pat;\n })\n .flatMap(client::create);\n }\n\n @Override\n public Mono revoke(String patName, String username) {\n return get(patName, username)\n .filter(pat -> !pat.getSpec().isRevoked())\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"The token has been revoked before.\"))\n )\n .doOnNext(pat -> {\n pat.getSpec().setRevoked(true);\n pat.getSpec().setRevokesAt(clock.instant());\n })\n .flatMap(client::update);\n }\n\n @Override\n public Mono restore(String patName, String username) {\n return get(patName, username)\n .filter(pat -> pat.getSpec().isRevoked())\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"The token has not been revoked before.\"))\n )\n .doOnNext(pat -> {\n pat.getSpec().setRevoked(false);\n pat.getSpec().setRevokesAt(null);\n })\n .flatMap(client::update);\n }\n\n @Override\n public Mono delete(String patName, String username) {\n return get(patName, username)\n .flatMap(client::delete);\n }\n\n @Override\n public Mono get(String patName, String username) {\n return client.fetch(PersonalAccessToken.class, patName)\n .filter(pat -> Objects.equals(pat.getSpec().getUsername(), username))\n .switchIfEmpty(Mono.error(() -> new NotFoundException(\n \"The personal access token was not found or deleted.\"\n )));\n }\n\n @Override\n public Mono generateToken(PersonalAccessToken pat) {\n return Mono.deferContextual(\n contextView -> {\n var externalUrl = ServerWebExchangeContextFilter.getExchange(contextView)\n .map(exchange -> this.externalUrl.getURL(exchange.getRequest()))\n .orElse(null);\n if (externalUrl == null) {\n return Mono.error(new ServerWebInputException(\"Server web exchange is \"\n + \"required\"));\n }\n var claimsBuilder = JwtClaimsSet.builder()\n .issuer(externalUrl.toString())\n .id(pat.getSpec().getTokenId())\n .subject(pat.getSpec().getUsername())\n .issuedAt(clock.instant())\n .claim(\"pat_name\", pat.getMetadata().getName());\n var expiresAt = pat.getSpec().getExpiresAt();\n if (expiresAt != null) {\n claimsBuilder.expiresAt(expiresAt);\n }\n var headerBuilder = JwsHeader.with(SignatureAlgorithm.RS256)\n .keyId(this.keyId);\n var jwt = jwtEncoder.encode(JwtEncoderParameters.from(\n headerBuilder.build(),\n claimsBuilder.build()));\n return Mono.just(jwt);\n }\n )\n .map(jwt -> PersonalAccessToken.PAT_TOKEN_PREFIX + jwt.getTokenValue());\n }\n\n private Mono hasSufficientRoles(\n Collection grantedAuthorities, List requestRoles) {\n if (CollectionUtils.isEmpty(requestRoles)) {\n return Mono.just(true);\n }\n var grantedRoles = AuthorityUtils.authoritiesToRoles(grantedAuthorities);\n return roleService.contains(grantedRoles, requestRoles);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/SettingConfigServiceImpl.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport java.time.Duration;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.user.service.SettingConfigService;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.SettingUtils;\nimport tools.jackson.databind.node.ObjectNode;\n\n/**\n * {@link Setting} related {@link ConfigMap} service implementation.\n *\n * @author guqing\n * @since 2.20.0\n */\n@Component\n@RequiredArgsConstructor\nclass SettingConfigServiceImpl implements SettingConfigService {\n\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono upsertConfig(String configMapName, ObjectNode configJsonData) {\n Assert.notNull(configMapName, \"Config map name must not be null\");\n Assert.notNull(configJsonData, \"Config json data must not be null\");\n var data = SettingUtils.settingConfigJsonToMap(configJsonData);\n return Mono.defer(() -> client.fetch(ConfigMap.class, configMapName)\n .flatMap(persisted -> {\n persisted.setData(data);\n return client.update(persisted);\n }))\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance)\n )\n .switchIfEmpty(Mono.defer(() -> {\n var configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(configMapName);\n configMap.setData(data);\n return client.create(configMap);\n }))\n .then();\n }\n\n @Override\n public Mono fetchConfig(String configMapName) {\n return client.fetch(ConfigMap.class, configMapName)\n .map(SettingUtils::settingConfigToJson);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/UserConnectionServiceImpl.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.time.Clock;\nimport java.util.HashMap;\nimport java.util.Optional;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.security.oauth2.core.user.OAuth2User;\nimport org.springframework.stereotype.Service;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.core.extension.UserConnection.UserConnectionSpec;\nimport run.halo.app.core.user.service.UserConnectionService;\nimport run.halo.app.event.user.UserConnectionDisconnectedEvent;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.exception.OAuth2UserAlreadyBoundException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@Service\npublic class UserConnectionServiceImpl implements UserConnectionService {\n\n private final ReactiveExtensionClient client;\n\n private final ApplicationEventPublisher eventPublisher;\n\n private Clock clock = Clock.systemDefaultZone();\n\n public UserConnectionServiceImpl(ReactiveExtensionClient client,\n ApplicationEventPublisher eventPublisher) {\n this.client = client;\n this.eventPublisher = eventPublisher;\n }\n\n void setClock(Clock clock) {\n this.clock = clock;\n }\n\n @Override\n public Mono createUserConnection(\n String username,\n String registrationId,\n OAuth2User oauth2User\n ) {\n return getUserConnection(registrationId, username)\n .flatMap(connection -> Mono.error(\n () -> new OAuth2UserAlreadyBoundException(connection))\n )\n .switchIfEmpty(Mono.defer(() -> {\n var connection = new UserConnection();\n connection.setMetadata(new Metadata());\n var metadata = connection.getMetadata();\n updateUserInfo(metadata, oauth2User);\n metadata.setGenerateName(username + \"-\");\n connection.setSpec(new UserConnectionSpec());\n var spec = connection.getSpec();\n spec.setUsername(username);\n spec.setProviderUserId(oauth2User.getName());\n spec.setRegistrationId(registrationId);\n spec.setUpdatedAt(clock.instant());\n return client.create(connection);\n }));\n }\n\n private Mono updateUserConnection(UserConnection connection,\n OAuth2User oauth2User) {\n connection.getSpec().setUpdatedAt(clock.instant());\n updateUserInfo(connection.getMetadata(), oauth2User);\n return client.update(connection);\n }\n\n private Mono getUserConnection(String registrationId, String username) {\n var listOptions = ListOptions.builder()\n .fieldQuery(and(\n equal(\"spec.registrationId\", registrationId),\n equal(\"spec.username\", username)\n ))\n .build();\n return client.listAll(UserConnection.class, listOptions, defaultSort()).next();\n }\n\n @Override\n public Mono updateUserConnectionIfPresent(String registrationId,\n OAuth2User oauth2User) {\n var listOptions = ListOptions.builder()\n .fieldQuery(and(\n equal(\"spec.registrationId\", registrationId),\n equal(\"spec.providerUserId\", oauth2User.getName())\n ))\n .build();\n return client.listAll(UserConnection.class, listOptions, defaultSort()).next()\n .flatMap(connection -> updateUserConnection(connection, oauth2User));\n }\n\n @Override\n public Flux removeUserConnection(String registrationId, String username) {\n var listOptions = ListOptions.builder()\n .fieldQuery(and(\n equal(\"spec.registrationId\", registrationId),\n equal(\"spec.username\", username)\n ))\n .build();\n return client.listAll(UserConnection.class, listOptions, defaultSort())\n .flatMap(client::delete)\n .doOnNext(deleted ->\n eventPublisher.publishEvent(new UserConnectionDisconnectedEvent(this, deleted))\n );\n }\n\n private void updateUserInfo(MetadataOperator metadata, OAuth2User oauth2User) {\n var annotations = Optional.ofNullable(metadata.getAnnotations())\n .orElseGet(HashMap::new);\n metadata.setAnnotations(annotations);\n annotations.put(\n \"auth.halo.run/oauth2-user-info\",\n JsonUtils.objectToJson(oauth2User.getAttributes())\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/core/user/service/impl/UserServiceImpl.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.util.Arrays;\nimport java.util.Collection;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.core.session.ReactiveSessionRegistry;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.stereotype.Service;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.transaction.reactive.TransactionalOperator;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.user.service.EmailVerificationService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.SignUpData;\nimport run.halo.app.core.user.service.UserPostCreatingHandler;\nimport run.halo.app.core.user.service.UserPreCreatingHandler;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.event.user.PasswordChangedEvent;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.ValidationUtils;\nimport run.halo.app.infra.exception.DuplicateNameException;\nimport run.halo.app.infra.exception.EmailAlreadyTakenException;\nimport run.halo.app.infra.exception.EmailVerificationFailed;\nimport run.halo.app.infra.exception.RestrictedNameException;\nimport run.halo.app.infra.exception.UnsatisfiedAttributeValueException;\nimport run.halo.app.infra.exception.UserNotFoundException;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.security.authorization.AuthorityUtils;\nimport run.halo.app.security.device.DeviceService;\n\n@Slf4j\n@Service\n@RequiredArgsConstructor\npublic class UserServiceImpl implements UserService {\n\n private final ReactiveExtensionClient client;\n\n private final PasswordEncoder passwordEncoder;\n\n private final SystemConfigFetcher environmentFetcher;\n\n private final ApplicationEventPublisher eventPublisher;\n\n private final RoleService roleService;\n\n private final EmailVerificationService emailVerificationService;\n\n private final ExtensionGetter extensionGetter;\n\n private final DeviceService deviceService;\n\n private final ReactiveTransactionManager transactionManager;\n\n private final ReactiveSessionRegistry sessionRegistry;\n\n private Clock clock = Clock.systemUTC();\n\n void setClock(Clock clock) {\n this.clock = clock;\n }\n\n @Override\n public Mono getUser(String username) {\n return client.get(User.class, username)\n .onErrorMap(ExtensionNotFoundException.class, e -> new UserNotFoundException(username));\n }\n\n @Override\n public Mono findUserByVerifiedEmail(String email) {\n var listOptions = ListOptions.builder()\n .andQuery(equal(\"spec.emailVerified\", true))\n .andQuery(equal(\"spec.email\", email.toLowerCase()))\n .build();\n return client.listAll(User.class, listOptions, defaultSort()).next();\n }\n\n @Override\n public Mono getUserOrGhost(String username) {\n return client.fetch(User.class, username)\n .switchIfEmpty(Mono.defer(() -> client.get(User.class, GHOST_USER_NAME)));\n }\n\n @Override\n public Flux getUsersOrGhosts(Collection names) {\n if (CollectionUtils.isEmpty(names)) {\n return Flux.empty();\n }\n var nameSet = new HashSet<>(names);\n nameSet.add(GHOST_USER_NAME);\n var options = ListOptions.builder()\n .andQuery(Queries.in(\"metadata.name\", nameSet))\n .build();\n return client.listAll(User.class, options, defaultSort())\n .collectMap(u -> u.getMetadata().getName())\n .map(map -> {\n var ghost = map.get(GHOST_USER_NAME);\n return names.stream()\n .map(name -> map.getOrDefault(name, ghost))\n .toList();\n })\n .flatMapMany(Flux::fromIterable);\n }\n\n @Override\n public Mono updatePassword(String username, String newPassword) {\n return getUser(username)\n .filter(user -> !Objects.equals(user.getSpec().getPassword(), newPassword))\n .flatMap(user -> {\n user.getSpec().setPassword(newPassword);\n return client.update(user);\n })\n .doOnNext(user -> publishPasswordChangedEvent(username));\n }\n\n @Override\n public Mono updateWithRawPassword(String username, String rawPassword) {\n if (!ValidationUtils.PASSWORD_PATTERN.matcher(rawPassword).matches()) {\n return Mono.error(\n new UnsatisfiedAttributeValueException(\"validation.error.password.pattern\"));\n }\n return getUser(username)\n .filter(user -> {\n if (!StringUtils.hasText(user.getSpec().getPassword())) {\n // Check if the old password is set before, or the passwordEncoder#matches\n // will complain an error due to null password.\n return true;\n }\n return !passwordEncoder.matches(rawPassword, user.getSpec().getPassword());\n })\n .flatMap(user -> {\n user.getSpec().setPassword(passwordEncoder.encode(rawPassword));\n return client.update(user);\n })\n .doOnNext(user -> publishPasswordChangedEvent(username));\n }\n\n @Override\n public Mono grantRoles(String username, Set roles) {\n var bindingsToUpdate = new HashSet();\n var bindingsToDelete = new HashSet();\n var existingRoles = new HashSet();\n var subject = new RoleBinding.Subject();\n subject.setKind(User.KIND);\n subject.setApiGroup(User.GROUP);\n subject.setName(username);\n var tx = TransactionalOperator.create(transactionManager);\n return roleService.listRoleBindings(subject)\n .doOnNext(binding -> {\n var roleName = binding.getRoleRef().getName();\n existingRoles.add(roleName);\n if (roles.contains(roleName)) {\n return;\n }\n binding.getSubjects().removeIf(RoleBinding.Subject.isUser(username));\n if (CollectionUtils.isEmpty(binding.getSubjects())) {\n // remove it if subjects is empty\n bindingsToDelete.add(binding);\n } else {\n bindingsToUpdate.add(binding);\n }\n })\n .then(Mono.defer(() -> {\n if (log.isDebugEnabled()) {\n log.debug(\"\"\"\n Updating roles for user {}: existingRoles={}, roles={}, \\\n bindingsToUpdate={}, bindingsToDelete={}\"\"\",\n username, existingRoles, roles, bindingsToUpdate, bindingsToDelete\n );\n }\n var updateBindings = Flux.fromIterable(bindingsToUpdate)\n .flatMap(client::update)\n .then();\n var deleteBindings = Flux.fromIterable(bindingsToDelete)\n .flatMap(client::delete)\n .then();\n var createBindings = Flux.fromIterable(roles)\n .filter(role -> !existingRoles.contains(role))\n .filter(StringUtils::hasText)\n .map(role -> RoleBinding.create(username, role))\n .flatMap(client::create);\n return Mono.when(updateBindings, deleteBindings, createBindings);\n }))\n .as(tx::transactional)\n .then(Mono.defer(() -> {\n if (Objects.equals(roles, existingRoles)) {\n // No need to update the user if roles are not changed\n log.debug(\"No role changes for user {}, skip updating user annotations.\",\n username);\n return Mono.empty();\n }\n log.info(\"Updated roles for user {}: existingRoles={}, roles={}\",\n username, existingRoles, roles\n );\n var invalidateSessions = sessionRegistry.getAllSessions(username)\n .flatMap(reactiveSessionInformation -> {\n log.info(\"Invalidating session {} for user {}\",\n reactiveSessionInformation.getSessionId(), username\n );\n return reactiveSessionInformation.invalidate();\n })\n .then();\n var updateUser = client.get(User.class, username)\n .doOnNext(u -> {\n var annotations = u.getMetadata().getAnnotations();\n if (annotations == null) {\n annotations = new HashMap<>();\n u.getMetadata().setAnnotations(annotations);\n }\n annotations.put(User.REQUEST_TO_UPDATE, clock.instant().toString());\n })\n .flatMap(client::update)\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance)\n );\n return invalidateSessions.then(updateUser);\n }));\n }\n\n @Override\n public Mono hasSufficientRoles(Collection roles) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(a -> AuthorityUtils.authoritiesToRoles(a.getAuthorities()))\n .flatMap(userRoles -> roleService.contains(userRoles, roles))\n .defaultIfEmpty(false);\n }\n\n @Override\n public Mono signUp(SignUpData signUpData) {\n return environmentFetcher.fetch(SystemSetting.User.GROUP, SystemSetting.User.class)\n .filter(SystemSetting.User::isAllowRegistration)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"The registration is not allowed by the administrator.\"\n )))\n .filter(setting -> isUsernameAllowed(setting, signUpData.getUsername()))\n .switchIfEmpty(Mono.error(() -> new RestrictedNameException(\n \"The username is restricted.\",\n \"problemDetail.user.username.restricted\",\n new Object[] {signUpData.getUsername()}\n )))\n .filter(setting -> isDisplayNameAllowed(setting, signUpData.getDisplayName()))\n .switchIfEmpty(Mono.error(() -> new RestrictedNameException(\n \"The display name is restricted.\",\n \"problemDetail.user.displayName.restricted\",\n new Object[] {signUpData.getDisplayName()}\n )))\n .filter(setting -> StringUtils.hasText(setting.getDefaultRole()))\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"The default role is not configured by the administrator.\"\n )))\n .flatMap(setting -> {\n var email = Optional.ofNullable(signUpData.getEmail())\n .map(String::toLowerCase)\n .orElse(null);\n var user = new User();\n user.setMetadata(new Metadata());\n var metadata = user.getMetadata();\n metadata.setName(signUpData.getUsername());\n user.setSpec(new User.UserSpec());\n var spec = user.getSpec();\n spec.setPassword(passwordEncoder.encode(signUpData.getPassword()));\n spec.setEmailVerified(false);\n spec.setRegisteredAt(clock.instant());\n spec.setEmail(email);\n spec.setDisplayName(signUpData.getDisplayName());\n Mono verifyEmail = Mono.empty();\n if (setting.isMustVerifyEmailOnRegistration()) {\n if (!StringUtils.hasText(email)) {\n return Mono.error(\n new EmailVerificationFailed(\"Email captcha is required\", null)\n );\n }\n verifyEmail = emailVerificationService.verifyRegisterVerificationCode(\n email, signUpData.getEmailCode()\n )\n .filter(Boolean::booleanValue)\n .switchIfEmpty(Mono.error(() ->\n new EmailVerificationFailed(\"Invalid email captcha.\", null)\n ))\n .then(this.checkEmailAlreadyVerified(email))\n .filter(has -> !has)\n .switchIfEmpty(Mono.error(\n () -> new EmailAlreadyTakenException(\"Email is already taken\")\n ))\n .doOnNext(v -> spec.setEmailVerified(true))\n .then();\n }\n return verifyEmail.then(Mono.defer(() -> {\n var defaultRole = setting.getDefaultRole();\n return createUser(user, Set.of(defaultRole));\n }));\n });\n }\n\n @Override\n public Mono createUser(User user, Set roleNames) {\n Assert.notNull(user, \"User must not be null\");\n Assert.notNull(roleNames, \"Roles must not be null\");\n return client.fetch(User.class, user.getMetadata().getName())\n .hasElement()\n .flatMap(hasUser -> {\n if (hasUser) {\n return Mono.error(\n new DuplicateNameException(\"User name is already in use\", null,\n \"problemDetail.user.duplicateName\",\n new Object[] {user.getMetadata().getName()}));\n }\n // Check if all roles exist\n return Flux.fromIterable(roleNames)\n .flatMap(roleName -> client.fetch(Role.class, roleName)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Role [\" + roleName + \"] is not found.\"))\n )\n )\n .then();\n })\n .then(extensionGetter.getExtensions(UserPreCreatingHandler.class)\n .concatMap(handler -> handler.preCreating(user))\n .then(Mono.defer(() -> client.create(user)\n .flatMap(newUser -> grantRoles(user.getMetadata().getName(), roleNames))\n ))\n .flatMap(createdUser -> extensionGetter.getExtensions(UserPostCreatingHandler.class)\n .concatMap(handler -> handler.postCreating(createdUser))\n .then()\n .thenReturn(createdUser)\n )\n );\n }\n\n @Override\n public Mono confirmPassword(String username, String rawPassword) {\n return getUser(username)\n .filter(user -> {\n if (!StringUtils.hasText(user.getSpec().getPassword())) {\n // If the password is not set, return true directly.\n return true;\n }\n if (!StringUtils.hasText(rawPassword)) {\n return false;\n }\n return passwordEncoder.matches(rawPassword, user.getSpec().getPassword());\n })\n .hasElement();\n }\n\n @Override\n public Flux listByEmail(String email) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(equal(\"spec.email\", email.toLowerCase())));\n return client.listAll(User.class, listOptions, defaultSort());\n }\n\n @Override\n public Mono checkEmailAlreadyVerified(String email) {\n return listByEmail(email)\n // TODO Use index query in the future\n .filter(u -> u.getSpec().isEmailVerified())\n .hasElements();\n }\n\n @Override\n public String encryptPassword(String rawPassword) {\n return passwordEncoder.encode(rawPassword);\n }\n\n @Override\n public Mono disable(String username) {\n var tx = TransactionalOperator.create(transactionManager);\n return client.fetch(User.class, username)\n .filter(user -> !Boolean.TRUE.equals(user.getSpec().getDisabled()))\n .flatMap(user -> deviceService.revoke(username).thenReturn(user))\n .doOnNext(user -> user.getSpec().setDisabled(true))\n .flatMap(client::update)\n .as(tx::transactional);\n }\n\n @Override\n public Mono enable(String username) {\n return client.fetch(User.class, username)\n .filter(user -> Boolean.TRUE.equals(user.getSpec().getDisabled()))\n .doOnNext(user -> user.getSpec().setDisabled(false))\n .flatMap(client::update);\n }\n\n void publishPasswordChangedEvent(String username) {\n eventPublisher.publishEvent(new PasswordChangedEvent(this, username));\n }\n\n private Set getProtectedUsernamesSet(SystemSetting.User setting) {\n String protectedUsernamesStr = setting.getProtectedUsernames();\n if (protectedUsernamesStr == null || protectedUsernamesStr.trim().isEmpty()) {\n return Set.of();\n }\n return Arrays.stream(protectedUsernamesStr.split(\",\"))\n .map(String::trim)\n .filter(n -> !n.isEmpty())\n .map(String::toLowerCase)\n .collect(Collectors.toUnmodifiableSet());\n }\n\n private boolean isUsernameAllowed(SystemSetting.User setting, String username) {\n Set protectedLowerSet = getProtectedUsernamesSet(setting);\n return !protectedLowerSet.contains(username.trim().toLowerCase());\n }\n\n private boolean isDisplayNameAllowed(SystemSetting.User setting, String displayName) {\n Set protectedLowerSet = getProtectedUsernamesSet(setting);\n return !protectedLowerSet.contains(displayName.trim().toLowerCase());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/CategoryHiddenStateChangeEvent.java", "content": "package run.halo.app.event.post;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.content.Category;\n\n/**\n * When the category {@link Category.CategorySpec#isHideFromList()} state changes, this event is\n * triggered.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Getter\npublic class CategoryHiddenStateChangeEvent extends ApplicationEvent {\n private final String categoryName;\n private final boolean hidden;\n\n public CategoryHiddenStateChangeEvent(Object source, String categoryName, boolean hidden) {\n super(source);\n this.categoryName = categoryName;\n this.hidden = hidden;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/CommentCreatedEvent.java", "content": "package run.halo.app.event.post;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.content.Comment;\n\n/**\n * Comment created event.\n *\n * @author guqing\n * @since 2.9.0\n */\n@Getter\npublic class CommentCreatedEvent extends ApplicationEvent {\n\n private final Comment comment;\n\n public CommentCreatedEvent(Object source, Comment comment) {\n super(source);\n this.comment = comment;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/CommentUnreadReplyCountChangedEvent.java", "content": "package run.halo.app.event.post;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n *

This event will be triggered when the unread reply count of the comment is changed.

\n *

It is used to update the unread reply count of the comment,such as when the user reads the\n * reply(lastReadTime changed in comment), the unread reply count will be updated.

\n *\n * @author guqing\n * @since 2.14.0\n */\n@Getter\npublic class CommentUnreadReplyCountChangedEvent extends ApplicationEvent {\n private final String commentName;\n\n public CommentUnreadReplyCountChangedEvent(Object source, String commentName) {\n super(source);\n this.commentName = commentName;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/DownvotedEvent.java", "content": "package run.halo.app.event.post;\n\n/**\n * Downvote event.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class DownvotedEvent extends VotedEvent {\n\n public DownvotedEvent(Object source, String group, String name, String plural) {\n super(source, group, name, plural);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/PostStatsChangedEvent.java", "content": "package run.halo.app.event.post;\n\nimport lombok.Getter;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.content.Post;\n\n@Getter\npublic class PostStatsChangedEvent extends ApplicationEvent {\n private final Counter counter;\n\n public PostStatsChangedEvent(Object source, Counter counter) {\n super(source);\n this.counter = counter;\n }\n\n public String getPostName() {\n var counterName = counter.getMetadata().getName();\n return StringUtils.removeStart(counterName, MeterUtils.nameOf(Post.class, \"\"));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/ReplyChangedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.core.extension.content.Reply;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class ReplyChangedEvent extends ReplyEvent {\n\n public ReplyChangedEvent(Object source, Reply reply) {\n super(source, reply);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/ReplyCreatedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.core.extension.content.Reply;\n\n/**\n * Reply created event.\n *\n * @author guqing\n * @since 2.9.0\n */\npublic class ReplyCreatedEvent extends ReplyEvent {\n\n public ReplyCreatedEvent(Object source, Reply reply) {\n super(source, reply);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/ReplyDeletedEvent.java", "content": "package run.halo.app.event.post;\n\nimport run.halo.app.core.extension.content.Reply;\n\npublic class ReplyDeletedEvent extends ReplyEvent {\n\n public ReplyDeletedEvent(Object source, Reply reply) {\n super(source, reply);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/ReplyEvent.java", "content": "package run.halo.app.event.post;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.content.Reply;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic abstract class ReplyEvent extends ApplicationEvent {\n private final Reply reply;\n\n public ReplyEvent(Object source, Reply reply) {\n super(source);\n this.reply = reply;\n }\n\n public Reply getReply() {\n return reply;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/UpvotedEvent.java", "content": "package run.halo.app.event.post;\n\n/**\n * Upvote event.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class UpvotedEvent extends VotedEvent {\n\n public UpvotedEvent(Object source, String group, String name, String plural) {\n super(source, group, name, plural);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/VisitedEvent.java", "content": "package run.halo.app.event.post;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Getter\npublic class VisitedEvent extends ApplicationEvent {\n private final String group;\n private final String name;\n private final String plural;\n\n public VisitedEvent(Object source, String group, String name, String plural) {\n super(source);\n this.group = group;\n this.name = name;\n this.plural = plural;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/post/VotedEvent.java", "content": "package run.halo.app.event.post;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Getter\npublic abstract class VotedEvent extends ApplicationEvent {\n private final String group;\n private final String name;\n private final String plural;\n\n public VotedEvent(Object source, String group, String name, String plural) {\n super(source);\n this.group = group;\n this.name = name;\n this.plural = plural;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/event/user/PasswordChangedEvent.java", "content": "package run.halo.app.event.user;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n@Getter\npublic class PasswordChangedEvent extends ApplicationEvent {\n private final String username;\n\n public PasswordChangedEvent(Object source, String username) {\n super(source);\n this.username = username;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/DefaultSchemeManager.java", "content": "package run.halo.app.extension;\n\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.concurrent.CopyOnWriteArrayList;\nimport java.util.function.Consumer;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.event.SchemeRemovedEvent;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.index.IndexSpecs;\nimport run.halo.app.extension.index.ValueIndexSpec;\n\n@Component\npublic class DefaultSchemeManager implements SchemeManager {\n\n private final List schemes;\n\n private final IndexEngine indexEngine;\n\n private final ApplicationEventPublisher eventPublisher;\n\n public DefaultSchemeManager(IndexEngine indexEngine,\n ApplicationEventPublisher eventPublisher) {\n this.indexEngine = indexEngine;\n this.eventPublisher = eventPublisher;\n // we have to use CopyOnWriteArrayList at here to prevent concurrent modification between\n // registering and listing.\n schemes = new CopyOnWriteArrayList<>();\n }\n\n @Override\n public void register(Class type,\n Consumer> specsConsumer) {\n var scheme = Scheme.buildFromType(type);\n if (schemes.contains(scheme)) {\n return;\n }\n var indexSpecs = new DefaultIndexSpecs();\n if (specsConsumer != null) {\n specsConsumer.accept(indexSpecs);\n }\n indexEngine.getIndicesManager().add(type, indexSpecs.getIndexSpecs());\n schemes.add(scheme);\n eventPublisher.publishEvent(new SchemeAddedEvent(this, scheme));\n }\n\n @Override\n public void unregister(@NonNull Scheme scheme) {\n if (schemes.contains(scheme)) {\n indexEngine.getIndicesManager().remove(scheme.type());\n schemes.remove(scheme);\n eventPublisher.publishEvent(new SchemeRemovedEvent(this, scheme));\n }\n }\n\n @Override\n @NonNull\n public List schemes() {\n return Collections.unmodifiableList(schemes);\n }\n\n private static class DefaultIndexSpecs implements IndexSpecs {\n\n private final Map> specMap;\n\n private DefaultIndexSpecs() {\n this.specMap = new HashMap<>();\n }\n\n @Override\n public > void add(ValueIndexSpec indexSpec) {\n Assert.isTrue(!specMap.containsKey(indexSpec.getName()),\n \"Index spec with name \" + indexSpec.getName() + \" already exists.\");\n this.specMap.put(indexSpec.getName(), indexSpec);\n }\n\n @Override\n public List> getIndexSpecs() {\n return specMap.values().stream().toList();\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/DelegateExtensionClient.java", "content": "package run.halo.app.extension;\n\nimport java.time.Duration;\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.function.Predicate;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.extension.index.IndexedQueryEngine;\n\n/**\n * DelegateExtensionClient fully delegates ReactiveExtensionClient.\n *\n * @author johnniang\n */\n@Component\npublic class DelegateExtensionClient implements ExtensionClient {\n\n private static final Duration TIMEOUT = Duration.ofSeconds(30);\n\n private final ReactiveExtensionClient client;\n\n public DelegateExtensionClient(ReactiveExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public List list(Class type, Predicate predicate,\n Comparator comparator) {\n return client.list(type, predicate, comparator).collectList().block(TIMEOUT);\n }\n\n @Override\n public ListResult list(Class type, Predicate predicate,\n Comparator comparator, int page, int size) {\n return client.list(type, predicate, comparator, page, size).block(TIMEOUT);\n }\n\n @Override\n public List listAll(Class type, ListOptions options, Sort sort) {\n return client.listAll(type, options, sort).collectList().block(TIMEOUT);\n }\n\n @Override\n public List listAllNames(Class type, ListOptions options,\n Sort sort) {\n return client.listAllNames(type, options, sort).collectList().block(TIMEOUT);\n }\n\n @Override\n public List listTopNames(Class type, ListOptions options,\n Sort sort, int topN) {\n return client.listTopNames(type, options, sort, topN).collectList().block(TIMEOUT);\n }\n\n @Override\n public ListResult listBy(Class type, ListOptions options,\n PageRequest page) {\n return client.listBy(type, options, page).block(TIMEOUT);\n }\n\n @Override\n public ListResult listNamesBy(Class type, ListOptions options,\n PageRequest page) {\n return client.listNamesBy(type, options, page).block(TIMEOUT);\n }\n\n @Override\n public long countBy(Class type, ListOptions options) {\n return client.countBy(type, options).blockOptional(TIMEOUT).orElse(0L);\n }\n\n @Override\n public Optional fetch(Class type, String name) {\n return client.fetch(type, name).blockOptional(TIMEOUT);\n }\n\n @Override\n public Optional fetch(GroupVersionKind gvk, String name) {\n return client.fetch(gvk, name).blockOptional(TIMEOUT);\n }\n\n @Override\n public void create(E extension) {\n client.create(extension).block(TIMEOUT);\n }\n\n @Override\n public void update(E extension) {\n client.update(extension).block(TIMEOUT);\n }\n\n @Override\n public void delete(E extension) {\n client.delete(extension).block(TIMEOUT);\n }\n\n @Override\n public IndexedQueryEngine indexedQueryEngine() {\n return client.indexedQueryEngine();\n }\n\n @Override\n public void watch(Watcher watcher) {\n client.watch(watcher);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/ExtensionConverter.java", "content": "package run.halo.app.extension;\n\nimport run.halo.app.extension.store.ExtensionStore;\n\n/**\n * ExtensionConverter contains bidirectional conversions between Extension and ExtensionStore.\n *\n * @author johnniang\n */\npublic interface ExtensionConverter {\n\n /**\n * Converts Extension to ExtensionStore.\n *\n * @param extension is an Extension to be converted.\n * @param is Extension type.\n * @return an ExtensionStore.\n */\n ExtensionStore convertTo(E extension);\n\n /**\n * Converts Extension from ExtensionStore.\n *\n * @param type is Extension type.\n * @param extensionStore is an ExtensionStore\n * @param is Extension type.\n * @return an Extension\n */\n E convertFrom(Class type, ExtensionStore extensionStore);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/ExtensionStoreUtil.java", "content": "package run.halo.app.extension;\n\nimport org.springframework.util.StringUtils;\n\n/**\n * Extension utilities.\n *\n * @author johnniang\n */\npublic final class ExtensionStoreUtil {\n\n private ExtensionStoreUtil() {\n }\n\n /**\n * Builds the name prefix of ExtensionStore.\n *\n * @param scheme is scheme of an Extension.\n * @return name prefix of ExtensionStore.\n */\n public static String buildStoreNamePrefix(Scheme scheme) {\n // rule of key: /registry/[group]/plural-name/extension-name\n StringBuilder builder = new StringBuilder(\"/registry/\");\n if (StringUtils.hasText(scheme.groupVersionKind().group())) {\n builder.append(scheme.groupVersionKind().group()).append('/');\n }\n builder.append(scheme.plural());\n return builder.toString();\n }\n\n /**\n * Builds full name of ExtensionStore.\n *\n * @param scheme is scheme of an Extension.\n * @param name the exact name of Extension.\n * @return full name of ExtensionStore.\n */\n public static String buildStoreName(Scheme scheme, String name) {\n return buildStoreNamePrefix(scheme) + \"/\" + name;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/JSONExtensionConverter.java", "content": "package run.halo.app.extension;\n\nimport static run.halo.app.extension.ExtensionStoreUtil.buildStoreName;\nimport static run.halo.app.extension.Unstructured.OBJECT_MAPPER;\n\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport java.io.IOException;\nimport java.net.MalformedURLException;\nimport java.net.URL;\nimport java.util.Optional;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.openapi4j.core.exception.ResolutionException;\nimport org.openapi4j.core.model.v3.OAI3;\nimport org.openapi4j.core.model.v3.OAI3Context;\nimport org.openapi4j.schema.validator.ValidationContext;\nimport org.openapi4j.schema.validator.ValidationData;\nimport org.openapi4j.schema.validator.v3.SchemaValidator;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.Exceptions;\nimport run.halo.app.extension.event.SchemeRemovedEvent;\nimport run.halo.app.extension.exception.ExtensionConvertException;\nimport run.halo.app.extension.exception.SchemaViolationException;\nimport run.halo.app.extension.store.ExtensionStore;\n\n/**\n * JSON implementation of ExtensionConverter.\n *\n * @author johnniang\n */\n@Slf4j\n@Component\nclass JSONExtensionConverter implements ExtensionConverter {\n\n @Getter\n public ObjectMapper objectMapper;\n\n private final SchemeManager schemeManager;\n\n private final ConcurrentMap validatorMap = new ConcurrentHashMap<>();\n\n public JSONExtensionConverter(SchemeManager schemeManager) {\n this.schemeManager = schemeManager;\n setObjectMapper(OBJECT_MAPPER);\n }\n\n /**\n * Sets ObjectMapper.\n *\n * @param objectMapper the object mapper, must not be null\n */\n void setObjectMapper(ObjectMapper objectMapper) {\n Assert.notNull(objectMapper, \"ObjectMapper must not be null\");\n this.objectMapper = objectMapper;\n }\n\n @Override\n public ExtensionStore convertTo(E extension) {\n var gvk = extension.groupVersionKind();\n var scheme = schemeManager.get(gvk);\n\n try {\n var convertedExtension = Optional.of(extension)\n .map(item -> scheme.type().isAssignableFrom(item.getClass()) ? item\n : objectMapper.convertValue(item, scheme.type())\n )\n .orElseThrow();\n var validation = new ValidationData<>(extension);\n\n var extensionJsonNode = objectMapper.valueToTree(convertedExtension);\n var validator = getValidator(scheme);\n validator.validate(extensionJsonNode, validation);\n if (!validation.isValid()) {\n log.debug(\"Failed to validate Extension: {}, and errors were: {}\",\n extension.getClass(), validation.results());\n throw new SchemaViolationException(extension.groupVersionKind(),\n validation.results());\n }\n\n var version = extension.getMetadata().getVersion();\n var storeName = buildStoreName(scheme, extension.getMetadata().getName());\n var data = objectMapper.writeValueAsBytes(extensionJsonNode);\n return new ExtensionStore(storeName, data, version);\n } catch (IOException e) {\n throw new ExtensionConvertException(\"Failed write Extension as bytes\", e);\n } catch (ResolutionException e) {\n throw new RuntimeException(\"Failed to create schema validator\", e);\n }\n }\n\n @Override\n public E convertFrom(Class type, ExtensionStore extensionStore) {\n try {\n var extension = objectMapper.readValue(extensionStore.getData(), type);\n extension.getMetadata().setVersion(extensionStore.getVersion());\n return extension;\n } catch (IOException e) {\n throw new ExtensionConvertException(\"Failed to read Extension \" + type + \" from bytes\",\n e);\n }\n }\n\n @EventListener\n void onSchemeRemovedEvent(SchemeRemovedEvent event) {\n var removed = validatorMap.remove(event.getScheme());\n if (log.isDebugEnabled()) {\n if (removed == null) {\n log.debug(\"No available validator found while removing validator for scheme: {}\",\n event.getScheme().groupVersionKind()\n );\n } else {\n log.debug(\"Removed schema validator {} for scheme: {}\",\n removed, event.getScheme().groupVersionKind()\n );\n }\n }\n }\n\n private SchemaValidator getValidator(Scheme scheme)\n throws MalformedURLException, ResolutionException {\n return validatorMap.computeIfAbsent(scheme, s -> {\n try {\n var context = new ValidationContext(\n new OAI3Context(new URL(\"file:/\"), scheme.openApiSchema())\n );\n context.setFastFail(false);\n var validator = new SchemaValidator(context, null, scheme.openApiSchema());\n if (log.isDebugEnabled()) {\n log.debug(\"Created schema validator {} for scheme: {}\",\n validator, scheme.groupVersionKind()\n );\n }\n return validator;\n } catch (ResolutionException | MalformedURLException e) {\n throw Exceptions.propagate(e);\n }\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/ReactiveExtensionClientImpl.java", "content": "package run.halo.app.extension;\n\nimport static org.apache.commons.lang3.RandomStringUtils.secure;\nimport static org.springframework.util.StringUtils.hasText;\n\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Comparator;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.function.Predicate;\nimport java.util.stream.StreamSupport;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.dao.DataIntegrityViolationException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.data.util.Predicates;\nimport org.springframework.stereotype.Component;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.transaction.reactive.TransactionalOperator;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.index.IndexedQueryEngine;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\n\n@Slf4j\n@Component\npublic class ReactiveExtensionClientImpl implements ReactiveExtensionClient {\n\n public static final int GENERATE_NAME_RANDOM_LENGTH = 8;\n\n private final ReactiveExtensionStoreClient client;\n\n private final ExtensionConverter converter;\n\n private final SchemeManager schemeManager;\n\n private final Watcher.WatcherComposite watchers = new Watcher.WatcherComposite();\n\n private final ObjectMapper objectMapper;\n\n private final IndexEngine indexEngine;\n\n private Scheduler scheduler;\n\n private TransactionalOperator transactionalOperator;\n\n public ReactiveExtensionClientImpl(ReactiveExtensionStoreClient client,\n ExtensionConverter converter, SchemeManager schemeManager, ObjectMapper objectMapper,\n IndexEngine indexEngine,\n ReactiveTransactionManager reactiveTransactionManager) {\n this.client = client;\n this.converter = converter;\n this.schemeManager = schemeManager;\n this.objectMapper = objectMapper;\n this.indexEngine = indexEngine;\n this.transactionalOperator = TransactionalOperator.create(reactiveTransactionManager);\n this.scheduler = Schedulers.boundedElastic();\n }\n\n /**\n * Only for test.\n *\n * @param scheduler the scheduler to set\n */\n void setScheduler(Scheduler scheduler) {\n this.scheduler = scheduler;\n }\n\n /**\n * Only for test.\n */\n void setTransactionalOperator(TransactionalOperator transactionalOperator) {\n this.transactionalOperator = transactionalOperator;\n }\n\n @Override\n public Flux list(Class type, Predicate predicate,\n Comparator comparator) {\n var scheme = schemeManager.get(type);\n var prefix = ExtensionStoreUtil.buildStoreNamePrefix(scheme);\n\n return client.listByNamePrefix(prefix)\n .map(extensionStore -> converter.convertFrom(type, extensionStore))\n .filter(predicate == null ? Predicates.isTrue() : predicate)\n .sort(comparator == null ? Comparator.naturalOrder() : comparator);\n }\n\n @Override\n public Mono> list(Class type, Predicate predicate,\n Comparator comparator, int page, int size) {\n var extensions = list(type, predicate, comparator);\n var totalMono = extensions.count();\n if (page > 0) {\n extensions = extensions.skip(((long) (page - 1)) * (long) size);\n }\n if (size > 0) {\n extensions = extensions.take(size);\n }\n return extensions.collectList().zipWith(totalMono)\n .map(tuple -> {\n List content = tuple.getT1();\n Long total = tuple.getT2();\n return new ListResult<>(page, size, total, content);\n });\n }\n\n @Override\n public Flux listAll(Class type, ListOptions options, Sort sort) {\n var nullSafeSort = Optional.ofNullable(sort)\n .orElseGet(() -> {\n log.warn(\"The sort parameter is null, it is recommended to use Sort.unsorted() \"\n + \"instead and the compatibility support for null will be removed in the \"\n + \"subsequent version.\");\n return Sort.unsorted();\n });\n var scheme = schemeManager.get(type);\n\n return Mono.fromCallable(\n () -> indexEngine.retrieveAll(scheme.type(), options, nullSafeSort)\n )\n .flatMapMany(objectKeys -> {\n var storeNames = StreamSupport.stream(objectKeys.spliterator(), false)\n .map(objectKey -> ExtensionStoreUtil.buildStoreName(scheme, objectKey))\n .toList();\n if (log.isDebugEnabled()) {\n if (storeNames.size() > 500) {\n log.warn(\"\"\"\n The number of objects retrieved by listAll is too large ({}) \\\n and it is recommended to use paging query.\\\n \"\"\",\n storeNames.size()\n );\n }\n }\n long startTimeMs = System.currentTimeMillis();\n return client.listByNames(storeNames)\n .map(extensionStore -> converter.convertFrom(type, extensionStore))\n .doOnComplete(() -> log.debug(\n \"Successfully retrieved all by names from db for {} in {}ms\",\n scheme.groupVersionKind(), System.currentTimeMillis() - startTimeMs)\n );\n });\n }\n\n @Override\n public Flux listAllNames(\n Class type, ListOptions options, Sort sort\n ) {\n var scheme = schemeManager.get(type);\n return Mono.fromCallable(() -> indexEngine.retrieveAll(scheme.type(), options, sort))\n .flatMapMany(Flux::fromIterable);\n }\n\n @Override\n public Flux listTopNames(\n Class type, ListOptions options, Sort sort, int topN\n ) {\n var scheme = schemeManager.get(type);\n return Mono.fromCallable(() -> indexEngine.retrieveTopN(scheme.type(), options, sort, topN))\n .flatMapMany(Flux::fromIterable);\n }\n\n @Override\n public Mono> listBy(Class type, ListOptions options,\n PageRequest page) {\n var scheme = schemeManager.get(type);\n return Mono.fromCallable(() -> indexEngine.retrieve(scheme.type(), options, page))\n .flatMap(listResult -> {\n var storeNames = listResult.get()\n .map(objectKey -> ExtensionStoreUtil.buildStoreName(scheme, objectKey))\n .toList();\n final long startTimeMs = System.currentTimeMillis();\n return client.listByNames(storeNames)\n .map(extensionStore -> converter.convertFrom(type, extensionStore))\n .doOnComplete(() -> log.debug(\n \"Successfully retrieved by names from db for {} in {}ms\",\n scheme.groupVersionKind(), System.currentTimeMillis() - startTimeMs)\n )\n .collectList()\n .map(items -> new ListResult<>(page.getPageNumber(), page.getPageSize(),\n listResult.getTotal(), items)\n );\n })\n .defaultIfEmpty(ListResult.emptyResult());\n }\n\n @Override\n public Mono> listNamesBy(Class type,\n ListOptions options, PageRequest pageable) {\n var scheme = schemeManager.get(type);\n return Mono.fromCallable(() -> indexEngine.retrieve(scheme.type(), options, pageable));\n }\n\n @Override\n public Mono countBy(Class type, ListOptions options) {\n var scheme = schemeManager.get(type);\n return Mono.fromCallable(() -> indexEngine.count(scheme.type(), options));\n }\n\n @Override\n public Mono fetch(Class type, String name) {\n var storeName = ExtensionStoreUtil.buildStoreName(schemeManager.get(type), name);\n return client.fetchByName(storeName)\n .map(extensionStore -> converter.convertFrom(type, extensionStore));\n }\n\n @Override\n public Mono fetch(GroupVersionKind gvk, String name) {\n var storeName = ExtensionStoreUtil.buildStoreName(schemeManager.get(gvk), name);\n return client.fetchByName(storeName)\n .map(extensionStore -> converter.convertFrom(Unstructured.class, extensionStore));\n }\n\n private Mono fetchJsonExtension(GroupVersionKind gvk, String name) {\n var storeName = ExtensionStoreUtil.buildStoreName(schemeManager.get(gvk), name);\n return client.fetchByName(storeName)\n .map(extensionStore -> converter.convertFrom(JsonExtension.class, extensionStore));\n }\n\n @Override\n public Mono get(Class type, String name) {\n return fetch(type, name)\n .switchIfEmpty(Mono.error(() -> {\n var gvk = GroupVersionKind.fromExtension(type);\n return new ExtensionNotFoundException(gvk, name);\n }));\n }\n\n private Mono get(GroupVersionKind gvk, String name) {\n return fetch(gvk, name)\n .switchIfEmpty(Mono.error(() -> new ExtensionNotFoundException(gvk, name)));\n }\n\n @Override\n public Mono getJsonExtension(GroupVersionKind gvk, String name) {\n return fetchJsonExtension(gvk, name)\n .switchIfEmpty(Mono.error(() -> new ExtensionNotFoundException(gvk, name)));\n }\n\n @Override\n public Mono create(E extension) {\n return Mono.fromCallable(\n () -> {\n var metadata = extension.getMetadata();\n // those fields should be managed by halo.\n metadata.setCreationTimestamp(Instant.now());\n metadata.setDeletionTimestamp(null);\n metadata.setVersion(null);\n\n if (!hasText(metadata.getName())) {\n if (!hasText(metadata.getGenerateName())) {\n throw new IllegalArgumentException(\n \"The metadata.generateName must not be blank when metadata.name is \"\n + \"blank\");\n }\n\n // generate name with random text\n metadata.setName(metadata.getGenerateName() + secure()\n .nextAlphanumeric(GENERATE_NAME_RANDOM_LENGTH)\n // Prevent data conflicts caused by database case sensitivity\n .toLowerCase()\n );\n }\n extension.setMetadata(metadata);\n return converter.convertTo(extension);\n })\n .subscribeOn(this.scheduler)\n // the method secureStrong() may invoke blocking SecureRandom, so we need to subscribe\n // on boundedElastic thread pool.\n .flatMap(extStore -> doCreate(extension, extStore.getName(), extStore.getData()))\n .flatMap(created -> Mono.fromCallable(\n () -> {\n watchers.onAdd(convertToRealExtension(created));\n return created;\n })\n .subscribeOn(this.scheduler)\n )\n .retryWhen(Retry.backoff(3, Duration.ofMillis(100))\n // retry when generateName is set\n .filter(t -> t instanceof DataIntegrityViolationException\n && hasText(extension.getMetadata().getGenerateName()))\n );\n }\n\n @Override\n public Mono update(E extension) {\n // Refactor the atomic reference if we have a better solution.\n return getLatest(extension).flatMap(old -> {\n var oldJsonExt = new JsonExtension(objectMapper, old);\n var newJsonExt = new JsonExtension(objectMapper, extension);\n // reset some mandatory fields\n var oldMetadata = oldJsonExt.getMetadata();\n var newMetadata = newJsonExt.getMetadata();\n newMetadata.setCreationTimestamp(oldMetadata.getCreationTimestamp());\n newMetadata.setGenerateName(oldMetadata.getGenerateName());\n\n // If the extension is an unstructured, the version type may be integer instead of long.\n // reset metadata.version for long type.\n oldMetadata.setVersion(oldMetadata.getVersion());\n newMetadata.setVersion(newMetadata.getVersion());\n\n if (Objects.equals(oldJsonExt, newJsonExt)) {\n // skip updating if not data changed.\n return Mono.just(extension);\n }\n\n var onlyStatusChanged =\n isOnlyStatusChanged(oldJsonExt.getInternal(), newJsonExt.getInternal());\n\n var store = this.converter.convertTo(newJsonExt);\n var doUpdate =\n doUpdate(extension, store.getName(), store.getVersion(), store.getData());\n if (!onlyStatusChanged) {\n doUpdate = doUpdate.flatMap(updated -> Mono.fromCallable(\n () -> {\n watchers.onUpdate(convertToRealExtension(old),\n convertToRealExtension(updated));\n return updated;\n })\n .subscribeOn(this.scheduler)\n );\n }\n return doUpdate;\n });\n }\n\n private Mono getLatest(Extension extension) {\n if (extension instanceof Unstructured) {\n return get(extension.groupVersionKind(), extension.getMetadata().getName());\n }\n if (extension instanceof JsonExtension) {\n return getJsonExtension(\n extension.groupVersionKind(),\n extension.getMetadata().getName()\n );\n }\n return get(extension.getClass(), extension.getMetadata().getName());\n }\n\n @Override\n public Mono delete(E extension) {\n // make sure the version is not null, or it will cause extension insertion.\n Assert.notNull(extension.getMetadata().getVersion(), \"Extension version must not be null\");\n // set deletionTimestamp\n extension.getMetadata().setDeletionTimestamp(Instant.now());\n var es = converter.convertTo(extension);\n return doUpdate(extension, es.getName(), es.getVersion(), es.getData())\n .flatMap(deleted -> Mono.fromCallable(\n () -> {\n watchers.onDelete(convertToRealExtension(extension));\n return deleted;\n })\n .subscribeOn(this.scheduler)\n );\n }\n\n @Override\n public IndexedQueryEngine indexedQueryEngine() {\n return new IndexedQueryEngine() {\n @Override\n public ListResult retrieve(GroupVersionKind gvk, ListOptions options,\n PageRequest page) {\n var scheme = schemeManager.get(gvk);\n return indexEngine.retrieve(scheme.type(), options, page);\n }\n\n @Override\n public List retrieveAll(GroupVersionKind gvk, ListOptions options, Sort sort) {\n var scheme = schemeManager.get(gvk);\n return StreamSupport.stream(\n indexEngine.retrieveAll(scheme.type(), options, sort).spliterator(), false\n )\n .toList();\n }\n };\n }\n\n /**\n * Create extension in store and update index. Please make sure subscribe on proper scheduler.\n *\n * @param oldExtension the extension to create\n * @param name the name of the extension\n * @param data the data of the extension\n * @param the type of the extension\n * @return the created extension\n */\n @SuppressWarnings(\"unchecked\")\n Mono doCreate(E oldExtension, String name, byte[] data) {\n return Mono.defer(() -> {\n var type = (Class) oldExtension.getClass();\n return client.create(name, data)\n .map(created -> converter.convertFrom(type, created))\n .flatMap(extension -> Mono.fromCallable(\n () -> {\n this.indexEngine.insert(List.of(convertToRealExtension(extension)));\n return extension;\n })\n .subscribeOn(this.scheduler)\n )\n .as(transactionalOperator::transactional);\n });\n }\n\n /**\n * Update extension in store and update index. Please make sure subscribe on proper scheduler.\n *\n * @param oldExtension the extension to update\n * @param name the name of the extension\n * @param version the version of the extension\n * @param data the data of the extension\n * @param the type of the extension\n * @return the updated extension\n */\n @SuppressWarnings(\"unchecked\")\n Mono doUpdate(E oldExtension, String name, Long version, byte[] data) {\n return Mono.defer(() -> {\n var type = (Class) oldExtension.getClass();\n return client.update(name, version, data)\n .map(updated -> converter.convertFrom(type, updated))\n .flatMap(extension -> Mono.fromCallable(\n () -> {\n this.indexEngine.update(List.of(convertToRealExtension(extension)));\n return extension;\n })\n .subscribeOn(this.scheduler)\n )\n .as(transactionalOperator::transactional);\n });\n }\n\n private Extension convertToRealExtension(Extension extension) {\n var gvk = extension.groupVersionKind();\n var realType = schemeManager.get(gvk).type();\n Extension realExtension = extension;\n if (extension instanceof Unstructured) {\n realExtension = Unstructured.OBJECT_MAPPER.convertValue(extension, realType);\n } else if (extension instanceof JsonExtension jsonExtension) {\n realExtension = jsonExtension.getObjectMapper().convertValue(jsonExtension, realType);\n }\n return realExtension;\n }\n\n @Override\n public void watch(Watcher watcher) {\n this.watchers.addWatcher(watcher);\n }\n\n private static boolean isOnlyStatusChanged(ObjectNode oldNode, ObjectNode newNode) {\n if (Objects.equals(oldNode, newNode)) {\n return false;\n }\n // WARNING!!!\n // Do not edit the ObjectNode\n var oldFields = new HashSet();\n var newFields = new HashSet();\n oldNode.fieldNames().forEachRemaining(oldFields::add);\n newNode.fieldNames().forEachRemaining(newFields::add);\n oldFields.remove(\"status\");\n newFields.remove(\"status\");\n if (!Objects.equals(oldFields, newFields)) {\n return false;\n }\n for (var field : oldFields) {\n if (!Objects.equals(oldNode.get(field), newNode.get(field))) {\n return false;\n }\n }\n return true;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/availability/IndexBuildState.java", "content": "package run.halo.app.extension.availability;\n\nimport org.springframework.boot.availability.AvailabilityState;\n\npublic enum IndexBuildState implements AvailabilityState {\n BUILDING,\n BUILT;\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/controller/DefaultControllerManager.java", "content": "package run.halo.app.extension.controller;\n\nimport static org.springframework.core.ResolvableType.forClassWithGenerics;\n\nimport java.util.concurrent.ConcurrentHashMap;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.beans.BeansException;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.ApplicationContextAware;\nimport org.springframework.context.SmartLifecycle;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.infra.InitializationPhase;\n\n@Slf4j\npublic class DefaultControllerManager implements ApplicationContextAware, SmartLifecycle {\n\n private final ExtensionClient client;\n\n private ApplicationContext applicationContext;\n\n /**\n * Map with key: reconciler class name, value: controller self.\n */\n private final ConcurrentHashMap controllers;\n\n private volatile boolean running;\n\n public DefaultControllerManager(ExtensionClient client) {\n this.client = client;\n controllers = new ConcurrentHashMap<>();\n }\n\n @Override\n public void start() {\n if (this.running) {\n return;\n }\n this.running = true;\n // register reconcilers in system after scheme initialized\n applicationContext.>getBeanProvider(\n forClassWithGenerics(Reconciler.class, Request.class))\n .orderedStream()\n .forEach(this::start);\n }\n\n void start(Reconciler reconciler) {\n var builder = new ControllerBuilder(reconciler, client);\n var controller = reconciler.setupWith(builder);\n controllers.put(reconciler.getClass().getName(), controller);\n controller.start();\n }\n\n @Override\n public void stop() {\n if (!running) {\n return;\n }\n this.running = false;\n log.info(\"Shutting down {} controllers...\", controllers.size());\n controllers.forEach((name, controller) -> disposeSilently(controller));\n log.info(\"Shutdown {} controllers.\", controllers.size());\n }\n\n private static void disposeSilently(Controller controller) {\n if (controller == null) {\n return;\n }\n try {\n log.info(\"Shutting down controller {}...\", controller.getName());\n controller.dispose();\n log.info(\"Shutdown controller {} successfully\", controller.getName());\n } catch (Throwable t) {\n log.error(\"Failed to dispose controller {}\", controller.getName(), t);\n }\n }\n\n @Override\n public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {\n this.applicationContext = applicationContext;\n }\n\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.CONTROLLERS.getPhase();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/event/IndexerBuiltEvent.java", "content": "package run.halo.app.extension.event;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.extension.Scheme;\n\n/**\n * IndexBuildEvent is fired when index build of a scheme is triggered and completed.\n */\npublic class IndexerBuiltEvent extends ApplicationEvent {\n\n @Getter\n private final Scheme scheme;\n\n public IndexerBuiltEvent(Object source, Scheme scheme) {\n super(source);\n this.scheme = scheme;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/event/SchemeAddedEvent.java", "content": "package run.halo.app.extension.event;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.extension.Scheme;\n\n/**\n * Event published when a scheme is added.\n *\n * @author johnniang\n */\npublic class SchemeAddedEvent extends ApplicationEvent {\n\n @Getter\n private final Scheme scheme;\n\n public SchemeAddedEvent(Object source, Scheme scheme) {\n super(source);\n this.scheme = scheme;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/event/SchemeRemovedEvent.java", "content": "package run.halo.app.extension.event;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.extension.Scheme;\n\n/**\n * Event published when a scheme is removed.\n *\n * @author johnniang\n */\npublic class SchemeRemovedEvent extends ApplicationEvent {\n\n @Getter\n private final Scheme scheme;\n\n public SchemeRemovedEvent(Object source, Scheme scheme) {\n super(source);\n this.scheme = scheme;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/exception/ExtensionConvertException.java", "content": "package run.halo.app.extension.exception;\n\n/**\n * ExtensionConvertException is thrown when an Extension conversion error occurs.\n *\n * @author johnniang\n */\npublic class ExtensionConvertException extends ExtensionException {\n\n public ExtensionConvertException(String reason) {\n super(reason);\n }\n\n public ExtensionConvertException(String reason, Throwable cause) {\n super(reason, cause);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/exception/ExtensionNotFoundException.java", "content": "package run.halo.app.extension.exception;\n\nimport java.net.URI;\nimport org.springframework.http.HttpStatus;\nimport run.halo.app.extension.GroupVersionKind;\n\npublic class ExtensionNotFoundException extends ExtensionException {\n\n public static final URI TYPE =\n URI.create(\"https://www.halo.run/api/errors/extension-not-found\");\n\n public ExtensionNotFoundException(GroupVersionKind gvk, String name) {\n super(HttpStatus.NOT_FOUND, \"Extension \" + gvk + \"/\" + name + \" was not found.\",\n null, null, new Object[] {gvk, name});\n setType(TYPE);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/exception/SchemaViolationException.java", "content": "package run.halo.app.extension.exception;\n\nimport org.openapi4j.core.validation.ValidationResults;\nimport org.springframework.http.HttpStatus;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * This exception is thrown when Schema is violation.\n *\n * @author johnniang\n */\npublic class SchemaViolationException extends ExtensionException {\n\n /**\n * Validation errors.\n */\n private final ValidationResults errors;\n\n public SchemaViolationException(GroupVersionKind gvk, ValidationResults errors) {\n super(HttpStatus.BAD_REQUEST, \"Failed to validate \" + gvk, null, null,\n new Object[] {gvk, errors});\n this.errors = errors;\n }\n\n public ValidationResults getErrors() {\n return errors;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/gc/GcControllerInitializer.java", "content": "package run.halo.app.extension.gc;\n\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.infra.InitializationPhase;\n\n@Component\nclass GcControllerInitializer implements SmartLifecycle {\n\n private volatile boolean running;\n\n private final Controller gcController;\n\n public GcControllerInitializer(GcReconciler gcReconciler) {\n this.gcController = gcReconciler.setupWith(null);\n }\n\n @Override\n public void start() {\n if (running) {\n return;\n }\n running = true;\n gcController.start();\n }\n\n @Override\n public void stop() {\n if (!running) {\n return;\n }\n running = false;\n gcController.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.GC_CONTROLLER.getPhase();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/gc/GcReconciler.java", "content": "package run.halo.app.extension.gc;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.function.Predicate;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.transaction.reactive.TransactionalOperator;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionConverter;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\n\n@Slf4j\n@Component\nclass GcReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n private final ReactiveExtensionStoreClient storeClient;\n\n private final ExtensionConverter converter;\n\n private final IndexEngine indexEngine;\n\n private final SchemeManager schemeManager;\n\n private final RequestQueue queue;\n\n private final GcSynchronizer synchronizer;\n\n private final ReactiveTransactionManager transactionManager;\n\n private Scheduler scheduler;\n\n GcReconciler(ExtensionClient client,\n ReactiveExtensionStoreClient storeClient,\n ExtensionConverter converter,\n SchemeManager schemeManager,\n IndexEngine indexEngine, ReactiveTransactionManager transactionManager) {\n this.client = client;\n this.storeClient = storeClient;\n this.converter = converter;\n this.indexEngine = indexEngine;\n this.transactionManager = transactionManager;\n this.queue = new DefaultQueue<>(Instant::now, Duration.ofMillis(500));\n this.synchronizer = new GcSynchronizer(client, queue, schemeManager);\n this.schemeManager = schemeManager;\n this.scheduler = Schedulers.boundedElastic();\n }\n\n @Override\n public Result reconcile(GcRequest request) {\n log.debug(\"Extension {} is being deleted\", request);\n var scheme = schemeManager.get(request.gvk());\n client.fetch(scheme.type(), request.name())\n .filter(deletable())\n .ifPresent(extension -> doDelete(extension).blockOptional(Duration.ofSeconds(30)));\n return null;\n }\n\n private Mono doDelete(E extension) {\n var extensionStore = converter.convertTo(extension);\n var tx = TransactionalOperator.create(transactionManager);\n\n return storeClient.delete(extensionStore.getName(), extensionStore.getVersion())\n .flatMap(deleted -> Mono.fromRunnable(() -> indexEngine.delete(List.of(extension)))\n .subscribeOn(this.scheduler)\n )\n .as(tx::transactional)\n .then()\n .doOnSuccess(ignored ->\n log.info(\"Extension {}/{} was deleted\", extension.groupVersionKind(), extension)\n );\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n \"garbage-collector-controller\",\n this,\n queue,\n synchronizer,\n Duration.ofMillis(500),\n Duration.ofSeconds(1000),\n // TODO Make it configurable\n 10);\n }\n\n @EventListener\n void onSchemeAddedEvent(SchemeAddedEvent event) {\n synchronizer.onApplicationEvent(event);\n }\n\n private Predicate deletable() {\n return extension -> CollectionUtils.isEmpty(extension.getMetadata().getFinalizers())\n && extension.getMetadata().getDeletionTimestamp() != null;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/gc/GcRequest.java", "content": "package run.halo.app.extension.gc;\n\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.GroupVersionKind;\n\nrecord GcRequest(GroupVersionKind gvk, String name) {\n\n public GcRequest {\n Assert.notNull(gvk, \"Group, version and kind must not be null\");\n Assert.hasText(name, \"Extension name must not be blank\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/gc/GcSynchronizer.java", "content": "package run.halo.app.extension.gc;\n\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.extension.index.query.Queries.not;\n\nimport java.util.List;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.Watcher;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.extension.controller.Synchronizer;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.router.selector.FieldSelector;\n\nclass GcSynchronizer implements Synchronizer, ApplicationListener {\n\n private final ExtensionClient client;\n\n private final SchemeManager schemeManager;\n\n private boolean disposed = false;\n\n private boolean started = false;\n\n private final Watcher watcher;\n\n GcSynchronizer(ExtensionClient client,\n RequestQueue queue,\n SchemeManager schemeManager) {\n this.client = client;\n this.schemeManager = schemeManager;\n this.watcher = new GcWatcher(queue);\n }\n\n @Override\n public void dispose() {\n if (isDisposed()) {\n return;\n }\n this.disposed = true;\n this.watcher.dispose();\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n\n @Override\n public void onApplicationEvent(SchemeAddedEvent event) {\n if (started) {\n var scheme = event.getScheme();\n listDeleted(scheme.type()).forEach(watcher::onDelete);\n }\n }\n\n @Override\n public void start() {\n if (isDisposed() || started) {\n return;\n }\n this.started = true;\n client.watch(watcher);\n schemeManager.schemes().stream()\n .map(Scheme::type)\n .forEach(type -> listDeleted(type).forEach(watcher::onDelete));\n }\n\n List listDeleted(Class type) {\n var options = new ListOptions()\n .setFieldSelector(\n FieldSelector.of(not(isNull(\"metadata.deletionTimestamp\")))\n );\n // TODO Refine with scrolling query\n return client.listAll(type, options, Sort.by(Sort.Order.asc(\"metadata.creationTimestamp\")));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/gc/GcWatcher.java", "content": "package run.halo.app.extension.gc;\n\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.Watcher;\nimport run.halo.app.extension.controller.RequestQueue;\n\nclass GcWatcher implements Watcher {\n\n private final RequestQueue queue;\n\n private Runnable disposeHook;\n\n private boolean disposed = false;\n\n GcWatcher(RequestQueue queue) {\n this.queue = queue;\n }\n\n @Override\n public void onAdd(Extension extension) {\n // TODO Should we ignore finalizers here?\n if (!isDisposed() && extension.getMetadata().getDeletionTimestamp() != null) {\n queue.addImmediately(\n new GcRequest(extension.groupVersionKind(), extension.getMetadata().getName()));\n }\n }\n\n @Override\n public void onUpdate(Extension oldExt, Extension newExt) {\n if (!isDisposed() && newExt.getMetadata().getDeletionTimestamp() != null) {\n queue.addImmediately(\n new GcRequest(newExt.groupVersionKind(), newExt.getMetadata().getName()));\n }\n }\n\n @Override\n public void onDelete(Extension extension) {\n if (!isDisposed() && extension.getMetadata().getDeletionTimestamp() != null) {\n queue.addImmediately(\n new GcRequest(extension.groupVersionKind(), extension.getMetadata().getName()));\n }\n }\n\n @Override\n public void registerDisposeHook(Runnable dispose) {\n this.disposeHook = dispose;\n }\n\n @Override\n public void dispose() {\n if (isDisposed()) {\n return;\n }\n this.disposed = true;\n if (this.disposeHook != null) {\n this.disposeHook.run();\n }\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/DefaultIndexEngine.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Comparator;\nimport java.util.LinkedList;\nimport java.util.PriorityQueue;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.core.convert.ConversionService;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.index.query.QueryVisitor;\n\n/**\n * Default implementation of {@link IndexEngine}.\n *\n * @author johnniang\n * @since 2.22.0\n */\n@Component\nclass DefaultIndexEngine implements IndexEngine, DisposableBean {\n\n private IndicesManager indicesManager;\n\n private final ConversionService conversionService;\n\n public DefaultIndexEngine(ConversionService conversionService) {\n this.conversionService = conversionService;\n this.indicesManager = new DefaultIndicesManager();\n }\n\n /**\n * Set the indices manager. Only for testing purpose.\n *\n * @param indicesManager the indices manager\n */\n void setIndicesManager(IndicesManager indicesManager) {\n Assert.notNull(indicesManager, \"indicesManager must not be null\");\n this.indicesManager = indicesManager;\n }\n\n @Override\n public void destroy() throws Exception {\n this.indicesManager.close();\n }\n\n @Override\n public void insert(@NonNull Iterable extensions) {\n extensions.forEach(extension -> {\n // get indices manager\n var indices = indicesManager.get((Class) extension.getClass());\n indices.insert(extension);\n });\n }\n\n @Override\n public void update(@NonNull Iterable extensions) {\n extensions.forEach(extension -> {\n var indices = indicesManager.get((Class) extension.getClass());\n indices.update(extension);\n });\n }\n\n @Override\n public void delete(@NonNull Iterable extensions) {\n extensions.forEach(extension -> {\n var indices = indicesManager.get((Class) extension.getClass());\n indices.delete(extension);\n });\n }\n\n @Override\n public ListResult retrieve(\n Class type, ListOptions options, PageRequest page) {\n if (options == null) {\n options = ListOptions.builder().build();\n }\n var finalCondition = options.toCondition();\n var indices = indicesManager.get(type);\n var queryVisitor = new QueryVisitor<>(indices, conversionService);\n queryVisitor.enter(finalCondition);\n var result = queryVisitor.getResult();\n var total = result.size();\n // create comparator\n var sort = page.getSort();\n var comparator = buildComparator(sort, indices);\n\n int offset = (page.getPageNumber() - 1) * page.getPageSize();\n int limit = page.getPageSize();\n if (limit <= 0) {\n // return all results for backward compatibility\n var finalResult = result.stream().sorted(comparator).toList();\n return new ListResult<>(\n page.getPageNumber(), page.getPageSize(), total, finalResult\n );\n }\n if (offset >= total) {\n return new ListResult<>(\n page.getPageNumber(), page.getPageSize(), total, new LinkedList<>()\n );\n }\n if (offset + limit > total) {\n limit = total - offset;\n }\n var n = offset + limit;\n if (n > 1000) {\n var finalResult = result.stream().sorted(comparator)\n .skip(offset)\n .limit(limit)\n .toList();\n return new ListResult<>(\n page.getPageNumber(), page.getPageSize(), total, finalResult\n );\n }\n var pq = new PriorityQueue<>(n, comparator.reversed());\n result.forEach(primaryKey -> {\n pq.offer(primaryKey);\n if (pq.size() > n) {\n pq.poll();\n }\n });\n var finalResult = new LinkedList();\n while (!pq.isEmpty()) {\n finalResult.addFirst(pq.poll());\n if (finalResult.size() >= limit) {\n // no need to compare further\n break;\n }\n }\n pq.clear();\n return new ListResult<>(\n page.getPageNumber(), page.getPageSize(), total, finalResult\n );\n }\n\n\n @Override\n public Iterable retrieveAll(\n Class type, ListOptions options, Sort sort) {\n if (options == null) {\n options = ListOptions.builder().build();\n }\n if (sort == null) {\n sort = Sort.unsorted();\n }\n var finalCondition = options.toCondition();\n var indices = indicesManager.get(type);\n var queryVisitor = new QueryVisitor<>(indices, conversionService);\n queryVisitor.enter(finalCondition);\n var result = queryVisitor.getResult();\n if (sort.isUnsorted()) {\n // no need to sort the result\n return result.stream()::iterator;\n }\n // create comparator\n var comparator = buildComparator(sort, indices);\n return result.stream().sorted(comparator)::iterator;\n }\n\n @Override\n public Iterable retrieveTopN(\n Class type, ListOptions options, Sort sort, int topN) {\n Assert.isTrue(topN > 0, \"topN must be greater than 0\");\n if (options == null) {\n options = ListOptions.builder().build();\n }\n if (sort == null) {\n sort = Sort.unsorted();\n }\n var finalCondition = options.toCondition();\n var indices = indicesManager.get(type);\n var queryVisitor = new QueryVisitor<>(indices, conversionService);\n queryVisitor.enter(finalCondition);\n var result = queryVisitor.getResult();\n // create comparator\n var comparator = buildComparator(sort, indices);\n // make sure using reversed comparator to get top N\n var pq = new PriorityQueue<>(topN + 1, comparator.reversed());\n result.forEach(primaryKey -> {\n pq.offer(primaryKey);\n if (pq.size() > topN) {\n pq.poll();\n }\n });\n var finalResult = new LinkedList();\n while (!pq.isEmpty()) {\n finalResult.addFirst(pq.poll());\n }\n return finalResult;\n }\n\n @Override\n public long count(Class type, ListOptions options) {\n if (options == null) {\n options = ListOptions.builder().build();\n }\n var finalCondition = options.toCondition();\n var indices = indicesManager.get(type);\n var queryVisitor = new QueryVisitor<>(indices, conversionService);\n queryVisitor.enter(finalCondition);\n return queryVisitor.getResult().size();\n }\n\n @Override\n @NonNull\n public IndicesManager getIndicesManager() {\n return this.indicesManager;\n }\n\n private Comparator buildComparator(\n Sort sort, Indices indices\n ) {\n return sort.stream()\n .map(order -> buildComparator(order, indices))\n .reduce(Comparator::thenComparing)\n .orElseGet(Comparator::naturalOrder);\n }\n\n private , E extends Extension> Comparator buildComparator(\n Sort.Order order, Indices indices\n ) {\n var index = indices.getIndex(order.getProperty());\n Comparator comparator;\n if (index instanceof MultiValueIndex multiValueIndex) {\n comparator = (left, right) -> {\n var leftKeys = multiValueIndex.getKeys(left);\n var rightKeys = multiValueIndex.getKeys(right);\n // null first by default\n if (CollectionUtils.isEmpty(leftKeys)) {\n return CollectionUtils.isEmpty(rightKeys) ? 0 : -1;\n }\n if (CollectionUtils.isEmpty(rightKeys)) {\n return 1;\n }\n // compare the first key\n K leftKey = leftKeys.iterator().next();\n K rightKey = rightKeys.iterator().next();\n return Comparator.naturalOrder().compare(leftKey, rightKey);\n };\n } else if (index instanceof SingleValueIndex singleValueIndex) {\n comparator = (left, right) -> {\n K leftKey = singleValueIndex.getKey(left);\n K rightKey = singleValueIndex.getKey(right);\n // null first by default\n if (leftKey == null) {\n return rightKey == null ? 0 : -1;\n }\n if (rightKey == null) {\n return 1;\n }\n return leftKey.compareTo(rightKey);\n };\n } else {\n throw new UnsupportedOperationException(\n \"Unsupported index type for sorting: \" + index.getClass()\n );\n }\n if (order.isDescending()) {\n comparator = comparator.reversed();\n }\n return comparator;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/DefaultIndices.java", "content": "package run.halo.app.extension.index;\n\nimport com.github.benmanes.caffeine.cache.Cache;\nimport com.github.benmanes.caffeine.cache.Caffeine;\nimport java.io.IOException;\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.concurrent.locks.ReadWriteLock;\nimport java.util.concurrent.locks.ReentrantReadWriteLock;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.io.IOUtils;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.Extension;\n\n/**\n * Default implementation of {@link Indices}.\n *\n * @param the type of extension\n * @author johnniang\n * @since 2.22.0\n */\n@Slf4j\nclass DefaultIndices implements Indices {\n\n private final Map> indexMap;\n\n private final Cache lockCache;\n\n private volatile boolean closed;\n\n public DefaultIndices(List> indices) {\n this.indexMap = indices.stream()\n .collect(Collectors.toMap(\n Index::getName,\n Function.identity(),\n // keep existing in case of duplicate names\n (existing, replacing) -> existing,\n // keep insertion order\n LinkedHashMap::new)\n );\n this.lockCache = Caffeine.newBuilder()\n .expireAfterAccess(Duration.ofHours(1))\n .maximumSize(10_000)\n .build();\n }\n\n @Override\n public void close() throws IOException {\n closed = true;\n IOUtils.close(indexMap.values().toArray(Index[]::new));\n lockCache.invalidateAll();\n }\n\n @Override\n public void insert(E extension) {\n ensureNotClosed();\n // get primary key\n var primaryKey = extension.getMetadata().getName();\n var lock = Objects.requireNonNull(\n lockCache.get(primaryKey, pk -> new ReentrantReadWriteLock())\n ).writeLock();\n var ops = new ArrayList();\n lock.lock();\n try {\n for (var index : indexMap.values()) {\n var op = index.prepareInsert(extension);\n op.prepare();\n ops.add(op);\n }\n ops.forEach(TransactionalOperation::commit);\n } catch (Exception e) {\n log.warn(\"Failed to insert extension {} and trying to rollback\", primaryKey, e);\n ops.forEach(TransactionalOperation::rollback);\n throw e;\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public void update(E extension) {\n ensureNotClosed();\n var primaryKey = extension.getMetadata().getName();\n var lock = Objects.requireNonNull(\n lockCache.get(primaryKey, pk -> new ReentrantReadWriteLock())\n ).writeLock();\n var updaters = new ArrayList();\n lock.lock();\n try {\n for (var index : indexMap.values()) {\n var updater = index.prepareUpdate(extension);\n updater.prepare();\n updaters.add(updater);\n }\n updaters.forEach(TransactionalOperation::commit);\n } catch (Exception e) {\n updaters.forEach(TransactionalOperation::rollback);\n throw e;\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n public void delete(E extension) {\n ensureNotClosed();\n var primaryKey = extension.getMetadata().getName();\n var lock = Objects.requireNonNull(\n lockCache.get(primaryKey, pk -> new ReentrantReadWriteLock())\n ).writeLock();\n var updaters = new ArrayList();\n lock.lock();\n try {\n for (var index : indexMap.values()) {\n var updater = index.prepareDelete(primaryKey);\n updater.prepare();\n updaters.add(updater);\n }\n updaters.forEach(TransactionalOperation::commit);\n } catch (Exception e) {\n updaters.forEach(TransactionalOperation::rollback);\n throw e;\n } finally {\n lock.unlock();\n }\n }\n\n @Override\n @NonNull\n public > Index getIndex(String indexName) {\n ensureNotClosed();\n var index = (Index) indexMap.get(indexName);\n if (index == null) {\n throw new IllegalArgumentException(\"No index found with name: \" + indexName);\n }\n return index;\n }\n\n private void ensureNotClosed() {\n if (closed) {\n throw new IllegalStateException(\"Indices has been closed\");\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/DefaultIndicesManager.java", "content": "package run.halo.app.extension.index;\n\nimport java.io.IOException;\nimport java.time.Instant;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport java.util.stream.Stream;\nimport org.apache.commons.io.IOUtils;\nimport run.halo.app.extension.Extension;\n\n/**\n * Default implementation of {@link IndicesManager}.\n *\n * @author johnniang\n * @since 2.22.0\n */\nclass DefaultIndicesManager implements IndicesManager {\n\n private final ConcurrentMap, Indices>\n indicesMap;\n\n DefaultIndicesManager() {\n indicesMap = new ConcurrentHashMap<>();\n }\n\n @Override\n public void add(Class type, List> indexSpecs) {\n indicesMap.computeIfAbsent(type, t -> {\n var indices = new ArrayList>();\n // the default index specs should be added first in case of index overwriting\n Stream.concat(this.createDefaultIndexSpecs().stream(), indexSpecs.stream())\n .distinct()\n .forEach(indexSpec -> {\n if (indexSpec instanceof MultiValueIndexSpec spec) {\n indices.add(new MultiValueIndex<>(spec));\n } else if (indexSpec instanceof SingleValueIndexSpec spec) {\n indices.add(new SingleValueIndex<>(spec));\n }\n // ignore other implementations, should never happen\n });\n indices.add(new LabelIndex<>());\n return new DefaultIndices<>(indices);\n });\n }\n\n @Override\n public void close() throws IOException {\n IOUtils.close(indicesMap.values().toArray(Indices[]::new));\n indicesMap.clear();\n }\n\n @Override\n public Indices get(Class type) {\n var indices = (Indices) indicesMap.get(type);\n if (indices == null) {\n throw new IllegalArgumentException(\"No indices found for type: \" + type.getName());\n }\n return indices;\n }\n\n @Override\n public void remove(Class type) {\n var indices = indicesMap.remove(type);\n IOUtils.closeQuietly(indices);\n }\n\n private List> createDefaultIndexSpecs() {\n var metadataNameSpec = IndexSpecs.single(\"metadata.name\", String.class)\n .indexFunc(e -> e.getMetadata().getName())\n .unique(true)\n .nullable(false)\n .build();\n var creationTimestampSpec =\n IndexSpecs.single(\"metadata.creationTimestamp\", Instant.class)\n .indexFunc(e -> e.getMetadata().getCreationTimestamp())\n .unique(false)\n .nullable(false)\n .build();\n var deletionTimestampSpec =\n IndexSpecs.single(\"metadata.deletionTimestamp\", Instant.class)\n .indexFunc(e -> e.getMetadata().getDeletionTimestamp())\n .unique(false)\n .nullable(true)\n .build();\n return List.of(metadataNameSpec, creationTimestampSpec, deletionTimestampSpec);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/Index.java", "content": "package run.halo.app.extension.index;\n\nimport java.io.Closeable;\nimport run.halo.app.extension.Extension;\n\n/**\n * Index for Extensions.\n *\n * @param the type of the extension.\n * @param the type of the index key.\n * @author johnniang\n * @since 2.22.0\n */\npublic interface Index> extends Closeable {\n\n /**\n * Get the name of the index.\n *\n * @return the name of the index.\n */\n String getName();\n\n /**\n * Get the type of the index key.\n *\n * @return the type of the index key.\n */\n Class getKeyType();\n\n /**\n * Whether the index is unique.\n *\n * @return true if the index is unique, false otherwise.\n */\n default boolean isUnique() {\n return false;\n }\n\n /**\n * Prepare insert operation.\n *\n * @param extension the extension to insert.\n * @return the transactional operation.\n */\n TransactionalOperation prepareInsert(E extension);\n\n /**\n * Prepare update operation.\n *\n * @param newExtension the new extension.\n * @return the transactional operation.\n */\n TransactionalOperation prepareUpdate(E newExtension);\n\n /**\n * Prepare delete operation.\n *\n * @param primaryKey the primary key of the extension to delete.\n * @return the transactional operation.\n */\n TransactionalOperation prepareDelete(String primaryKey);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/IndexEngine.java", "content": "package run.halo.app.extension.index;\n\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\n\n/**\n * Index engine for managing extension indices.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface IndexEngine {\n\n /**\n * Insert extensions into the index.\n *\n * @param extensions the extensions to insert\n * @param the type of the extension\n */\n void insert(@NonNull Iterable extensions);\n\n /**\n * Update extension in the index.\n *\n * @param extension the extension to update\n * @param the type of the extension\n */\n void update(@NonNull Iterable extension);\n\n /**\n * Delete extensions from the index.\n *\n * @param extensions the extensions to delete\n * @param the type of the extension\n */\n void delete(@NonNull Iterable extensions);\n\n /**\n * Retrieve extension names from the index.\n *\n * @param type the type of the extension\n * @param options the list options\n * @param page the page request\n * @param the type of the extension\n * @return the list result of extension names\n */\n ListResult retrieve(\n Class type, @Nullable ListOptions options, @NonNull PageRequest page\n );\n\n /**\n * Retrieve all extension names from the index.\n *\n * @param type the type of the extension\n * @param options the list options\n * @param sort the sort options\n * @param the type of the extension\n * @return the iterable of extension names\n */\n Iterable retrieveAll(\n Class type, @Nullable ListOptions options, @Nullable Sort sort\n );\n\n /**\n * Retrieve top N extension names from the index.\n *\n * @param type the type of the extension\n * @param options the list options\n * @param sort the sort options\n * @param topN the number of top extensions to retrieve\n * @param the type of the extension\n * @return the iterable of extension names\n */\n Iterable retrieveTopN(\n Class type, @Nullable ListOptions options, @Nullable Sort sort, int topN\n );\n\n /**\n * Count the number of extensions in the index.\n *\n * @param type the type of the extension\n * @param options the list options\n * @param the type of the extension\n * @return the count of extensions\n */\n long count(Class type, ListOptions options);\n\n /**\n * Get the indices' manager.\n *\n * @return the indices manager\n */\n @NonNull\n IndicesManager getIndicesManager();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/Indices.java", "content": "package run.halo.app.extension.index;\n\nimport java.io.Closeable;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.Extension;\n\npublic interface Indices extends Closeable {\n\n void insert(E extension);\n\n void update(E extension);\n\n void delete(E extension);\n\n /**\n * Get index by name.\n *\n * @param indexName index name\n * @param the key type\n * @return the index\n * @throws IllegalArgumentException if the index with the given name does not exist\n */\n @NonNull\n > Index getIndex(String indexName);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/IndicesInitializer.java", "content": "package run.halo.app.extension.index;\n\nimport run.halo.app.extension.Scheme;\n\npublic interface IndicesInitializer {\n\n void initialize(Scheme scheme);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/IndicesManager.java", "content": "package run.halo.app.extension.index;\n\nimport java.io.Closeable;\nimport java.util.List;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.Extension;\n\npublic interface IndicesManager extends Closeable {\n\n /**\n * Add a new {@link Indices} for the given extension type and index specifications.\n *\n * @param type the type of the extension\n * @param specs the list of index specifications\n * @param the type of the extension\n */\n void add(Class type, List> specs);\n\n /**\n * Get the {@link Indices} for the given extension type.\n *\n * @param type the type of the extension\n * @param the type of the extension\n * @return the indices for the given extension type\n * @throws IllegalArgumentException if the indices for the given extension type does not exist\n */\n @NonNull\n Indices get(Class type);\n\n /**\n * Remove the {@link Indices} for the given extension type and release resources.\n *\n * @param type type of the extension\n * @param type of the extension\n */\n void remove(Class type);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/LabelIndex.java", "content": "package run.halo.app.extension.index;\n\nimport static java.util.stream.Collectors.toUnmodifiableMap;\n\nimport java.io.IOException;\nimport java.util.Collection;\nimport java.util.Comparator;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport java.util.concurrent.ConcurrentNavigableMap;\nimport java.util.concurrent.ConcurrentSkipListMap;\nimport java.util.stream.Collectors;\nimport org.jetbrains.annotations.NotNull;\nimport org.jetbrains.annotations.Nullable;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.Extension;\n\n/**\n * Label index implementation.\n *\n * @param the type of extension\n * @author johnniang\n * @since 2.22.0\n */\nclass LabelIndex implements LabelIndexQuery, Index {\n\n private final ConcurrentNavigableMap> index;\n\n private final ConcurrentMap> invertedIndex;\n\n /**\n * Set of primary keys of extensions with empty labels.\n */\n private final Set emptyLabelsSet;\n\n public LabelIndex() {\n this.index = new ConcurrentSkipListMap<>();\n this.invertedIndex = new ConcurrentHashMap<>();\n this.emptyLabelsSet = ConcurrentHashMap.newKeySet();\n }\n\n @Override\n public void close() throws IOException {\n this.index.clear();\n this.invertedIndex.clear();\n this.emptyLabelsSet.clear();\n }\n\n @Override\n public String getName() {\n return \"metadata.labels\";\n }\n\n @Override\n public Class getKeyType() {\n return String.class;\n }\n\n @Override\n public TransactionalOperation prepareInsert(E extension) {\n var primaryKey = extension.getMetadata().getName();\n var labels = extension.getMetadata().getLabels();\n return new UpsertTransactionalOperation(primaryKey, labels);\n }\n\n @Override\n public TransactionalOperation prepareUpdate(E extension) {\n var primaryKey = extension.getMetadata().getName();\n var labels = extension.getMetadata().getLabels();\n return new UpsertTransactionalOperation(primaryKey, labels);\n }\n\n @Override\n public TransactionalOperation prepareDelete(String primaryKey) {\n return new DeleteTransactionalOperation(primaryKey);\n }\n\n @Override\n public Set exists(String labelKey) {\n return index.subMap(\n new LabelEntry(labelKey, null), true,\n new LabelEntry(labelKey, Character.MAX_VALUE + \"\"), true\n ).values().stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set equal(String labelKey, String labelValue) {\n return Optional.ofNullable(index.get(new LabelEntry(labelKey, labelValue)))\n .orElse(Set.of());\n }\n\n @Override\n public Set notEqual(String labelKey, String labelValue) {\n // collect all primary keys\n var labelEntry = new LabelEntry(labelKey, labelValue);\n return index.subMap(\n new LabelEntry(labelKey, null), true,\n new LabelEntry(labelKey, Character.MAX_VALUE + \"\"), true\n )\n .entrySet().stream()\n .filter(entry -> !Objects.equals(entry.getKey(), labelEntry))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set in(String labelKey, Collection labelValues) {\n if (CollectionUtils.isEmpty(labelValues)) {\n return Set.of();\n }\n return labelValues.stream()\n .distinct()\n .map(labelValue -> new LabelEntry(labelKey, labelValue))\n .map(index::get)\n .filter(Objects::nonNull)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set notIn(String labelKey, Collection labelValues) {\n if (CollectionUtils.isEmpty(labelValues)) {\n return Set.of();\n }\n var valueSet =\n labelValues instanceof Set set ? set : Set.copyOf(labelValues);\n return index.subMap(\n new LabelEntry(labelKey, null), true,\n new LabelEntry(labelKey, Character.MAX_VALUE + \"\"), true\n )\n .entrySet()\n .stream()\n .filter(entry -> !valueSet.contains(entry.getKey().labelValue()))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n record LabelEntry(@NonNull String labelKey, @Nullable String labelValue)\n implements Comparable {\n\n public LabelEntry {\n Objects.requireNonNull(labelKey, \"labelKey must not be null\");\n }\n\n @Override\n public int compareTo(@NotNull LabelEntry o) {\n var compare = Comparator.naturalOrder().compare(this.labelKey, o.labelKey);\n if (compare != 0) {\n return compare;\n }\n return Comparator.nullsFirst(Comparator.naturalOrder())\n .compare(this.labelValue, o.labelValue);\n }\n }\n\n class UpsertTransactionalOperation implements TransactionalOperation {\n\n private final String primaryKey;\n\n private final Map labels;\n\n private Map previousLabels;\n\n private boolean committed;\n\n UpsertTransactionalOperation(String primaryKey, Map labels) {\n this.primaryKey = primaryKey;\n this.labels = labels;\n }\n\n @Override\n public void prepare() {\n this.previousLabels = Optional.ofNullable(invertedIndex.get(primaryKey))\n .map(labelEntries -> labelEntries.stream()\n .filter(entry -> entry.labelValue() != null)\n .collect(toUnmodifiableMap(LabelEntry::labelKey, LabelEntry::labelValue))\n )\n .orElse(null);\n }\n\n @Override\n public void commit() {\n if (committed) {\n return;\n }\n this.committed = true;\n // remove old labels\n removeLabels(primaryKey, previousLabels);\n addLabels(primaryKey, labels);\n }\n\n @Override\n public void rollback() {\n if (!committed) {\n return;\n }\n removeLabels(primaryKey, labels);\n addLabels(primaryKey, previousLabels);\n }\n\n }\n\n class DeleteTransactionalOperation implements TransactionalOperation {\n\n private final String primaryKey;\n\n private Map previousLabels;\n\n private boolean committed;\n\n DeleteTransactionalOperation(String primaryKey) {\n this.primaryKey = primaryKey;\n }\n\n @Override\n public void prepare() {\n this.previousLabels = Optional.ofNullable(invertedIndex.get(primaryKey))\n .map(labelEntries -> labelEntries.stream()\n .filter(entry -> entry.labelValue() != null)\n .collect(toUnmodifiableMap(LabelEntry::labelKey, LabelEntry::labelValue))\n )\n .orElse(null);\n }\n\n @Override\n public void commit() {\n if (committed) {\n return;\n }\n this.committed = true;\n removeLabels(primaryKey, previousLabels);\n }\n\n @Override\n public void rollback() {\n if (!committed) {\n return;\n }\n addLabels(primaryKey, previousLabels);\n }\n }\n\n\n private void removeLabels(String primaryKey, Map labels) {\n if (CollectionUtils.isEmpty(labels)) {\n emptyLabelsSet.remove(primaryKey);\n return;\n }\n invertedIndex.remove(primaryKey);\n labels.forEach((labelKey, labelValue) -> {\n var labelEntry = new LabelEntry(labelKey, labelValue);\n index.computeIfPresent(labelEntry, (key, primaryKeys) -> {\n primaryKeys.remove(primaryKey);\n if (primaryKeys.isEmpty()) {\n return null;\n }\n return primaryKeys;\n });\n });\n }\n\n private void addLabels(String primaryKey, Map labels) {\n if (CollectionUtils.isEmpty(labels)) {\n emptyLabelsSet.add(primaryKey);\n return;\n }\n emptyLabelsSet.remove(primaryKey);\n labels.forEach((labelKey, labelValue) -> {\n var labelEntry = new LabelEntry(labelKey, labelValue);\n index.compute(labelEntry, (key, primaryKeys) -> {\n if (primaryKeys == null) {\n primaryKeys = ConcurrentHashMap.newKeySet();\n }\n primaryKeys.add(primaryKey);\n return primaryKeys;\n });\n invertedIndex.compute(primaryKey, (pk, labelEntries) -> {\n if (labelEntries == null) {\n labelEntries = ConcurrentHashMap.newKeySet();\n }\n labelEntries.add(labelEntry);\n return labelEntries;\n });\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/LabelIndexQuery.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Collection;\nimport java.util.Set;\n\n/**\n * Label index query interface.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface LabelIndexQuery {\n\n /**\n * Checks if the label with the given key exists.\n *\n * @param labelKey the label key\n * @return the set of entity IDs that have the label key\n */\n Set exists(String labelKey);\n\n /**\n * Checks if the label with the given key does not exist.\n *\n * @param labelKey the label key\n * @param labelValue the label value\n * @return the set of entity IDs that do not have the label key\n */\n Set equal(String labelKey, String labelValue);\n\n /**\n * Checks if the label with the given key does not equal the specified value.\n *\n * @param labelKey the label key\n * @param labelValue the label value\n * @return the set of entity IDs that do not have the label key equal to the specified value\n */\n Set notEqual(String labelKey, String labelValue);\n\n /**\n * Checks if the label with the given key has a value in the specified collection.\n *\n * @param labelKey the label key\n * @param labelValues the collection of label values\n * @return the set of entity IDs that have the label key with values in the specified collection\n */\n Set in(String labelKey, Collection labelValues);\n\n /**\n * Checks if the label with the given key has a value not in the specified collection.\n *\n * @param labelKey the label key\n * @param labelValues the collection of label values\n * @return the set of entity IDs that have the label key with values not in the specified\n * collection.\n */\n Set notIn(String labelKey, Collection labelValues);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/MultiValueIndex.java", "content": "package run.halo.app.extension.index;\n\nimport java.io.IOException;\nimport java.util.Collection;\nimport java.util.Collections;\nimport java.util.Comparator;\nimport java.util.Objects;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport java.util.concurrent.ConcurrentNavigableMap;\nimport java.util.concurrent.ConcurrentSkipListMap;\nimport java.util.stream.Collectors;\nimport java.util.stream.Stream;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.dao.DuplicateKeyException;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.Extension;\n\n/**\n * Multi-value index implementation.\n *\n * @param the extension type\n * @param the key type\n * @author johnniang\n * @since 2.22.0\n */\n@Slf4j\nclass MultiValueIndex>\n implements ValueIndexQuery, Index {\n\n private final ConcurrentNavigableMap> index;\n\n private final ConcurrentMap> invertedIndex;\n\n private final Set nullKeyValues;\n\n private final MultiValueIndexSpec spec;\n\n public MultiValueIndex(MultiValueIndexSpec spec) {\n this.spec = spec;\n this.index = new ConcurrentSkipListMap<>(Comparator.naturalOrder());\n this.invertedIndex = new ConcurrentHashMap<>();\n this.nullKeyValues = ConcurrentHashMap.newKeySet();\n }\n\n @Override\n public void close() throws IOException {\n this.index.clear();\n this.invertedIndex.clear();\n this.nullKeyValues.clear();\n }\n\n @Override\n public String getName() {\n return spec.getName();\n }\n\n @Override\n public Class getKeyType() {\n return spec.getKeyType();\n }\n\n @Override\n public boolean isUnique() {\n return spec.isUnique();\n }\n\n @Override\n public TransactionalOperation prepareInsert(E extension) {\n var keys = spec.getValues(extension);\n return new UpsertTransactionalOperation(extension.getMetadata().getName(), keys);\n }\n\n @Override\n public TransactionalOperation prepareUpdate(E extension) {\n // find old state\n var newKeys = spec.getValues(extension);\n var primaryKey = extension.getMetadata().getName();\n return new UpsertTransactionalOperation(primaryKey, newKeys);\n }\n\n @Override\n public TransactionalOperation prepareDelete(String primaryKey) {\n return new DeleteTransactionalOperation(primaryKey);\n }\n\n /**\n * Get the keys associated with the given primary key.\n *\n * @param primaryKey the primary key\n * @return the associated keys\n */\n Set getKeys(String primaryKey) {\n return Collections.unmodifiableSet(invertedIndex.get(primaryKey));\n }\n\n @Override\n public Set between(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support between operation\");\n }\n\n @Override\n public Set notBetween(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support notBetween operation\");\n }\n\n @Override\n public Set in(Collection keys) {\n if (CollectionUtils.isEmpty(keys)) {\n return Set.of();\n }\n return keys.stream()\n .distinct()\n .map(index::get)\n .filter(Objects::nonNull)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set notIn(Collection keys) {\n if (CollectionUtils.isEmpty(keys)) {\n return all();\n }\n var inResult = in(keys);\n return index.values().stream()\n .flatMap(Set::stream)\n .filter(v -> !inResult.contains(v))\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set lessThan(K key, boolean inclusive) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support lessThan operation\"\n );\n }\n\n @Override\n public Set greaterThan(K key, boolean inclusive) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support greaterThan operation\"\n );\n }\n\n @Override\n public Set isNull() {\n return Collections.unmodifiableSet(nullKeyValues);\n }\n\n @Override\n public Set isNotNull() {\n return index.values()\n .stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringContains(String keyword) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support stringContains operation\"\n );\n }\n\n @Override\n public Set stringNotContains(String keyword) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support stringNotContains operation\"\n );\n }\n\n @Override\n public Set stringStartsWith(String prefix) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support stringStartsWith operation\"\n );\n }\n\n @Override\n public Set stringNotStartsWith(String prefix) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support stringNotStartsWith operation\"\n );\n }\n\n @Override\n public Set stringEndsWith(String suffix) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support stringEndsWith operation\"\n );\n }\n\n @Override\n public Set stringNotEndsWith(String suffix) {\n throw new UnsupportedOperationException(\n \"Multi-value index does not support stringNotEndsWith operation\"\n );\n }\n\n @Override\n public Set notEqual(K key) {\n return notIn(Collections.singleton(key));\n }\n\n @Override\n public Set equal(K key) {\n return index.getOrDefault(key, Set.of());\n }\n\n @Override\n public Set all() {\n return Stream.concat(index.values().stream(), Stream.of(nullKeyValues))\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n class UpsertTransactionalOperation implements TransactionalOperation {\n\n @NonNull\n private final String primaryKey;\n\n @Nullable\n private final Set newKeys;\n\n private boolean committed;\n\n private Set previousKeys;\n\n private boolean previousNullKey;\n\n UpsertTransactionalOperation(\n @NonNull String primaryKey, @Nullable Set newKeys\n ) {\n this.primaryKey = primaryKey;\n this.newKeys = newKeys;\n }\n\n @Override\n public void prepare() {\n this.previousKeys = invertedIndex.get(primaryKey);\n this.previousNullKey = nullKeyValues.contains(primaryKey);\n }\n\n @Override\n public void commit() {\n if (committed) {\n return;\n }\n committed = true;\n if (Objects.equals(previousKeys, newKeys)) {\n return;\n }\n invertedIndex.put(primaryKey, newKeys);\n // remove previous keys\n if (!CollectionUtils.isEmpty(previousKeys)) {\n previousKeys.forEach(key -> index.computeIfPresent(key, (k, v) -> {\n v.remove(primaryKey);\n return v.isEmpty() ? null : v;\n }));\n }\n // add new keys\n if (!CollectionUtils.isEmpty(newKeys)) {\n for (K key : newKeys) {\n index.compute(key, (k, v) -> {\n if (v == null) {\n v = ConcurrentHashMap.newKeySet();\n }\n if (spec.isUnique() && !v.isEmpty()) {\n throw new DuplicateKeyException(\n String.format(\"Duplicate key '%s' for extension '%s'\", k,\n primaryKey)\n );\n }\n v.add(primaryKey);\n return v;\n });\n }\n nullKeyValues.remove(primaryKey);\n } else {\n nullKeyValues.add(primaryKey);\n }\n }\n\n @Override\n public void rollback() {\n if (Objects.equals(this.previousKeys, newKeys) || !committed) {\n return;\n }\n // remove possibly added new keys\n if (!CollectionUtils.isEmpty(newKeys)) {\n newKeys.forEach(key -> index.computeIfPresent(key, (k, v) -> {\n v.remove(primaryKey);\n return v.isEmpty() ? null : v;\n }));\n }\n // add previous keys\n if (this.previousKeys == null) {\n // remove from inverted index\n invertedIndex.remove(primaryKey);\n } else {\n this.previousKeys.forEach(key -> index.compute(key, (k, v) -> {\n if (v == null) {\n v = ConcurrentHashMap.newKeySet();\n }\n // No need to check duplicate here, as it was already present before.\n v.add(primaryKey);\n return v;\n }));\n invertedIndex.put(primaryKey, this.previousKeys);\n }\n if (previousNullKey) {\n nullKeyValues.add(primaryKey);\n } else {\n nullKeyValues.remove(primaryKey);\n }\n }\n\n }\n\n class DeleteTransactionalOperation implements TransactionalOperation {\n\n @NonNull\n private final String primaryKey;\n\n private boolean committed;\n\n private Set previousKeys;\n\n private boolean previousNullKey;\n\n DeleteTransactionalOperation(@NonNull String primaryKey) {\n this.primaryKey = primaryKey;\n }\n\n @Override\n public void prepare() {\n this.previousKeys = invertedIndex.get(primaryKey);\n this.previousNullKey = nullKeyValues.contains(primaryKey);\n }\n\n @Override\n public void commit() {\n if (committed) {\n return;\n }\n committed = true;\n invertedIndex.remove(primaryKey);\n if (this.previousKeys != null) {\n this.previousKeys.forEach(key -> index.computeIfPresent(key, (k, v) -> {\n v.remove(primaryKey);\n return v.isEmpty() ? null : v;\n }));\n }\n nullKeyValues.remove(primaryKey);\n }\n\n @Override\n public void rollback() {\n if (this.previousKeys == null || !committed) {\n return;\n }\n if (previousNullKey) {\n nullKeyValues.add(primaryKey);\n } else {\n nullKeyValues.remove(primaryKey);\n }\n // add previous keys\n this.previousKeys.forEach(key -> index.compute(key, (k, v) -> {\n if (v == null) {\n v = ConcurrentHashMap.newKeySet();\n }\n v.add(primaryKey);\n return v;\n }));\n invertedIndex.put(primaryKey, this.previousKeys);\n }\n }\n\n private void ensureStringKeyType() {\n Assert.isTrue(\n getKeyType() == String.class || getKeyType() == UnknownKey.class,\n \"Key type must be String for this operation\"\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/SingleValueIndex.java", "content": "package run.halo.app.extension.index;\n\nimport java.io.IOException;\nimport java.util.Collection;\nimport java.util.Comparator;\nimport java.util.HashSet;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport java.util.concurrent.ConcurrentNavigableMap;\nimport java.util.concurrent.ConcurrentSkipListMap;\nimport java.util.stream.Collectors;\nimport java.util.stream.Stream;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.DuplicateKeyException;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.extension.Extension;\n\n/**\n * Single value index implementation.\n *\n * @param the type of extension\n * @param the type of index key\n * @author johnniang\n * @since 2.22.0\n */\nclass SingleValueIndex>\n implements ValueIndexQuery, Index {\n\n private final ConcurrentNavigableMap> index;\n\n private final ConcurrentMap invertedIndex;\n\n private final Set nullKeyValues;\n\n private final SingleValueIndexSpec spec;\n\n public SingleValueIndex(SingleValueIndexSpec spec) {\n this.spec = spec;\n this.index = new ConcurrentSkipListMap<>(Comparator.naturalOrder());\n this.invertedIndex = new ConcurrentHashMap<>();\n this.nullKeyValues = ConcurrentHashMap.newKeySet();\n }\n\n @Override\n public void close() throws IOException {\n this.index.clear();\n this.invertedIndex.clear();\n this.nullKeyValues.clear();\n }\n\n @Override\n public Class getKeyType() {\n return spec.getKeyType();\n }\n\n @Override\n public Set equal(K key) {\n var primaryKeys = index.get(key);\n return CollectionUtils.isEmpty(primaryKeys) ? Set.of() : new HashSet<>(primaryKeys);\n }\n\n @Override\n public Set notEqual(K key) {\n return index.entrySet().stream()\n .filter(entry -> !Objects.equals(entry.getKey(), key))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set all() {\n return invertedIndex.keySet();\n }\n\n @Override\n public Set between(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) {\n Assert.notNull(fromKey, \"From key must not be null\");\n Assert.notNull(toKey, \"To key must not be null\");\n Assert.isTrue(fromKey.compareTo(toKey) <= 0,\n \"From key must be less than or equal to to key\"\n );\n return index.subMap(fromKey, fromInclusive, toKey, toInclusive).values()\n .stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set notBetween(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) {\n Assert.notNull(fromKey, \"From key must not be null\");\n Assert.notNull(toKey, \"To key must not be null\");\n Assert.isTrue(fromKey.compareTo(toKey) <= 0,\n \"From key must be less than or equal to to key\"\n );\n return Stream.concat(\n index.headMap(fromKey, !fromInclusive).values().stream(),\n index.tailMap(toKey, !toInclusive).values().stream()\n )\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set in(Collection keys) {\n if (CollectionUtils.isEmpty(keys)) {\n return Set.of();\n }\n return keys.stream()\n .distinct()\n .map(index::get)\n .filter(Objects::nonNull)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set notIn(Collection keys) {\n if (CollectionUtils.isEmpty(keys)) {\n return Set.of();\n }\n var keySet = keys instanceof Set set ? set : new HashSet<>(keys);\n return index.entrySet().stream()\n .distinct()\n .filter(entry -> !keySet.contains(entry.getKey()))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set lessThan(K key, boolean inclusive) {\n Assert.notNull(key, \"Key must not be null\");\n return index.headMap(key, inclusive).values().stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set greaterThan(K key, boolean inclusive) {\n Assert.notNull(key, \"Key must not be null\");\n return index.tailMap(key, inclusive).values().stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set isNull() {\n Assert.isTrue(spec.isNullable(), \"Index \" + getName() + \" is not nullable\");\n return new HashSet<>(nullKeyValues);\n }\n\n @Override\n public Set isNotNull() {\n Assert.isTrue(spec.isNullable(), \"Index is not nullable\");\n return index.values().stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringContains(String keyword) {\n ensureStringKeyType();\n return index.entrySet().stream()\n .filter(entry -> StringUtils.containsIgnoreCase(entry.getKey().toString(), keyword))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringNotContains(String keyword) {\n ensureStringKeyType();\n return index.entrySet().stream()\n .filter(entry -> !StringUtils.containsIgnoreCase(entry.getKey().toString(), keyword))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringStartsWith(String prefix) {\n ensureStringKeyType();\n var toKey = prefix + Character.MAX_VALUE;\n return index.subMap((K) prefix, true, (K) toKey, true).values().stream()\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringNotStartsWith(String prefix) {\n ensureStringKeyType();\n var toKey = prefix + Character.MAX_VALUE;\n return Stream.concat(\n index.headMap((K) prefix, false).values().stream(),\n index.tailMap((K) toKey, true).values().stream()\n )\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringEndsWith(String suffix) {\n ensureStringKeyType();\n return index.entrySet().stream()\n .filter(entry -> StringUtils.endsWithIgnoreCase(entry.getKey().toString(), suffix))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public Set stringNotEndsWith(String suffix) {\n ensureStringKeyType();\n return index.entrySet().stream()\n .filter(entry -> !StringUtils.endsWithIgnoreCase(entry.getKey().toString(), suffix))\n .map(Map.Entry::getValue)\n .flatMap(Set::stream)\n .collect(Collectors.toSet());\n }\n\n @Override\n public String getName() {\n return spec.getName();\n }\n\n @Override\n public TransactionalOperation prepareInsert(E extension) {\n var primaryKey = extension.getMetadata().getName();\n var key = spec.getValue(extension);\n return new UpsertTransactionalOperation(primaryKey, key);\n }\n\n @Override\n public TransactionalOperation prepareUpdate(E extension) {\n var primaryKey = extension.getMetadata().getName();\n var key = spec.getValue(extension);\n return new UpsertTransactionalOperation(primaryKey, key);\n }\n\n @Override\n public TransactionalOperation prepareDelete(String primaryKey) {\n return new DeleteTransactionalOperation(primaryKey);\n }\n\n /**\n * Get key for the given primary key.\n *\n * @param primaryKey the primary key\n * @return the index key, or null if not found\n */\n @Nullable\n K getKey(String primaryKey) {\n return invertedIndex.get(primaryKey);\n }\n\n @Override\n public boolean isUnique() {\n return spec.isUnique();\n }\n\n class UpsertTransactionalOperation implements TransactionalOperation {\n\n private final String primaryKey;\n\n @Nullable\n private final K newKey;\n\n private K previousKey;\n\n private boolean previousNull;\n\n private boolean committed;\n\n UpsertTransactionalOperation(String primaryKey, @Nullable K newKey) {\n this.primaryKey = primaryKey;\n this.newKey = newKey;\n }\n\n @Override\n public void prepare() {\n // preflight checks\n if (!spec.isNullable() && newKey == null) {\n throw new IllegalArgumentException(\n \"Index %s of %s is not nullable\".formatted(getName(), primaryKey)\n );\n }\n previousKey = invertedIndex.get(primaryKey);\n previousNull = nullKeyValues.contains(primaryKey);\n if (isUnique() && newKey != null && !Objects.equals(previousKey, newKey)) {\n var existingPrimaryKeys = index.get(newKey);\n if (!CollectionUtils.isEmpty(existingPrimaryKeys)) {\n throw new DuplicateKeyException(\n \"Duplicate key '\" + newKey + \"' for index '\" + getName() + \"'\"\n );\n }\n }\n }\n\n @Override\n public void commit() {\n if (committed) {\n return;\n }\n committed = true;\n removeKey(primaryKey, previousKey);\n addKey(primaryKey, newKey);\n }\n\n @Override\n public void rollback() {\n if (!committed) {\n return;\n }\n removeKey(primaryKey, newKey);\n if (spec.isNullable() || previousKey != null) {\n addKey(primaryKey, previousKey);\n }\n if (previousNull) {\n nullKeyValues.add(primaryKey);\n } else {\n nullKeyValues.remove(primaryKey);\n }\n }\n\n }\n\n class DeleteTransactionalOperation implements TransactionalOperation {\n\n private final String primaryKey;\n\n private K previousKey;\n\n private boolean previousNull;\n\n private boolean committed;\n\n DeleteTransactionalOperation(String primaryKey) {\n this.primaryKey = primaryKey;\n }\n\n @Override\n public void prepare() {\n previousKey = invertedIndex.get(primaryKey);\n previousNull = nullKeyValues.contains(primaryKey);\n }\n\n @Override\n public void commit() {\n if (committed) {\n return;\n }\n committed = true;\n removeKey(primaryKey, previousKey);\n }\n\n @Override\n public void rollback() {\n if (!committed) {\n return;\n }\n if (spec.isNullable() || previousKey != null) {\n addKey(primaryKey, previousKey);\n }\n if (previousNull) {\n nullKeyValues.add(primaryKey);\n } else {\n nullKeyValues.remove(primaryKey);\n }\n }\n\n }\n\n private void removeKey(String primaryKey, K key) {\n nullKeyValues.remove(primaryKey);\n if (key == null) {\n var oldKey = invertedIndex.remove(primaryKey);\n if (oldKey != null) {\n index.computeIfPresent(oldKey, (k, v) -> {\n v.remove(primaryKey);\n return v.isEmpty() ? null : v;\n });\n }\n return;\n }\n index.computeIfPresent(key, (k, v) -> {\n v.remove(primaryKey);\n return v.isEmpty() ? null : v;\n });\n invertedIndex.remove(primaryKey, key);\n }\n\n private void addKey(String primaryKey, K key) {\n if (!spec.isNullable() && key == null) {\n throw new IllegalArgumentException(\n \"Index %s of %s is not nullable\".formatted(getName(), primaryKey)\n );\n }\n if (key == null) {\n var oldKey = invertedIndex.remove(primaryKey);\n if (oldKey != null) {\n index.computeIfPresent(oldKey, (k, v) -> {\n v.remove(primaryKey);\n return v.isEmpty() ? null : v;\n });\n }\n nullKeyValues.add(primaryKey);\n return;\n }\n nullKeyValues.remove(primaryKey);\n index.compute(key, (k, v) -> {\n if (v == null) {\n v = ConcurrentHashMap.newKeySet();\n }\n if (!v.add(primaryKey) && spec.isUnique()) {\n throw new DuplicateKeyException(\n \"Duplicate key '\" + key + \"' for index '\" + getName() + \"'\"\n );\n }\n return v;\n });\n invertedIndex.put(primaryKey, key);\n }\n\n private void ensureStringKeyType() {\n Assert.isTrue(\n getKeyType() == String.class || getKeyType() == UnknownKey.class,\n \"Key type must be String for this operation\"\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/StringUnknownKeyConverter.java", "content": "package run.halo.app.extension.index;\n\nimport org.springframework.core.convert.converter.Converter;\nimport org.springframework.stereotype.Component;\n\n/**\n * String to UnknownKey converter.\n *\n * @author johnniang\n * @since 2.22.0\n * @deprecated for backward compatibility. May remove with {@link UnknownKey} in the future\n *\n */\n@Component\n@Deprecated(forRemoval = true, since = \"2.22.0\")\nclass StringUnknownKeyConverter implements Converter {\n\n @Override\n public UnknownKey convert(String source) {\n return new UnknownKey(source);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/TransactionalOperation.java", "content": "package run.halo.app.extension.index;\n\n/**\n * Represents a transactional operation with prepare, commit, and rollback methods.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface TransactionalOperation {\n\n /**\n * Prepares the operation for execution. Implementation should perform necessary checks here and\n * save any state needed for rollback.\n */\n void prepare();\n\n /**\n * Commits the operation.\n */\n void commit();\n\n /**\n * Rolls back the operation.\n */\n void rollback();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/ValueIndexQuery.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.Collection;\nimport java.util.Set;\n\n/**\n * Value index query interface.\n *\n * @param the type of the key\n */\npublic interface ValueIndexQuery> {\n\n /**\n * Gets the type of the key.\n *\n * @return the class of the key type\n */\n Class getKeyType();\n\n /**\n * Checks for equality with the given key.\n *\n * @param key the key to compare\n * @return the set of entity IDs that match the equality condition\n */\n Set equal(K key);\n\n /**\n * Checks for inequality with the given key.\n *\n * @param key the key to compare\n * @return the set of entity IDs that match the inequality condition\n */\n Set notEqual(K key);\n\n /**\n * Gets all entity IDs in the index.\n *\n * @return the set of all entity IDs\n */\n Set all();\n\n /**\n * Gets entity IDs between the specified range.\n *\n * @param fromKey the starting key\n * @param fromInclusive whether the starting key is inclusive\n * @param toKey the ending key\n * @param toInclusive whether the ending key is inclusive\n * @return the set of entity IDs within the specified range\n */\n Set between(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive);\n\n /**\n * Gets entity IDs not between the specified range.\n *\n * @param fromKey the starting key\n * @param fromInclusive whether the starting key is inclusive\n * @param toKey the ending key\n * @param toInclusive whether the ending key is inclusive\n * @return the set of entity IDs outside the specified range\n */\n Set notBetween(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive);\n\n /**\n * Gets entity IDs with keys in the specified collection.\n *\n * @param keys the collection of keys\n * @return the set of entity IDs with keys in the collection\n */\n Set in(Collection keys);\n\n /**\n * Gets entity IDs with keys not in the specified collection.\n *\n * @param keys the collection of keys\n * @return the set of entity IDs with keys not in the collection\n */\n Set notIn(Collection keys);\n\n /**\n * Gets entity IDs with keys less than the specified key.\n *\n * @param key the key to compare\n * @param inclusive whether the comparison is inclusive\n * @return the set of entity IDs with keys less than the specified key\n */\n Set lessThan(K key, boolean inclusive);\n\n /**\n * Gets entity IDs with keys greater than the specified key.\n *\n * @param key the key to compare\n * @param inclusive whether the comparison is inclusive\n * @return the set of entity IDs with keys greater than the specified key\n */\n Set greaterThan(K key, boolean inclusive);\n\n /**\n * Gets entity IDs with null keys.\n *\n * @return the set of entity IDs with null keys\n * @throws IllegalArgumentException if the key type is not nullable\n */\n Set isNull();\n\n /**\n * Gets entity IDs with non-null keys.\n *\n * @return the set of entity IDs with non-null keys\n */\n Set isNotNull();\n\n /**\n * Gets entity IDs where the string representation of the key contains the specified keyword.\n *\n * @param keyword the keyword to search for\n * @return the set of entity IDs that contain the keyword\n * @throws IllegalArgumentException if the key type is not String\n */\n Set stringContains(String keyword);\n\n /**\n * Gets entity IDs where the string representation of the key does not contain the specified\n * keyword.\n *\n * @param keyword the keyword to search for\n * @return the set of entity IDs that do not contain the keyword\n * @throws IllegalArgumentException if the key type is not String\n */\n Set stringNotContains(String keyword);\n\n /**\n * Gets entity IDs where the string representation of the key starts with the specified prefix.\n *\n * @param prefix the prefix to search for\n * @return the set of entity IDs that start with the prefix\n * @throws IllegalArgumentException if the key type is not String\n */\n Set stringStartsWith(String prefix);\n\n /**\n * Gets entity IDs where the string representation of the key does not start with the\n * specified prefix.\n *\n * @param prefix the prefix to search for\n * @return the set of entity IDs that do not start with the prefix\n * @throws IllegalArgumentException if the key type is not String\n */\n Set stringNotStartsWith(String prefix);\n\n /**\n * Gets entity IDs where the string representation of the key ends with the specified suffix.\n *\n * @param suffix the suffix to search for\n * @return the set of entity IDs that end with the suffix\n * @throws IllegalArgumentException if the key type is not String\n */\n Set stringEndsWith(String suffix);\n\n /**\n * Gets entity IDs where the string representation of the key does not end with the specified\n * suffix.\n *\n * @param suffix the suffix to search for\n * @return the set of entity IDs that do not end with the suffix\n * @throws IllegalArgumentException if the key type is not String\n */\n Set stringNotEndsWith(String suffix);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/index/query/QueryVisitor.java", "content": "package run.halo.app.extension.index.query;\n\nimport java.util.Collection;\nimport java.util.HashSet;\nimport java.util.Set;\nimport lombok.Getter;\nimport org.springframework.core.convert.ConversionService;\nimport org.springframework.data.relational.core.sql.Visitable;\nimport org.springframework.data.relational.core.sql.Visitor;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.index.Indices;\nimport run.halo.app.extension.index.LabelIndexQuery;\nimport run.halo.app.extension.index.ValueIndexQuery;\n\n/**\n * A visitor that visits a query and returns the matching extension names.\n *\n * @param the type of extension\n * @author johnniang\n * @since 2.22.0\n */\npublic class QueryVisitor implements Visitor {\n\n private final ConversionService conversionService;\n\n private final Indices indices;\n\n private final Set result;\n\n public QueryVisitor(Indices indices, ConversionService conversionService) {\n this.indices = indices;\n this.result = new HashSet<>();\n this.conversionService = conversionService;\n }\n\n @Override\n public void enter(Visitable segment) {\n var visitor = new ConditionVisitor();\n segment.visit(visitor);\n result.addAll(visitor.getResult());\n }\n\n @NonNull\n public Set getResult() {\n return result;\n }\n\n class ConditionVisitor implements Visitor {\n\n @Getter\n private final Set result;\n\n ConditionVisitor() {\n result = new HashSet<>();\n }\n\n @Override\n public void enter(@NonNull Visitable segment) {\n switch (segment) {\n case And(var left, var right) ->\n // delegate to AndCondition for backward compatibility\n new AndCondition(left, right).visit(this);\n case EmptyCondition ignored -> result.addAll(allQuery(\"metadata.name\", false));\n case AndCondition(var left, var right) -> {\n if (left instanceof EmptyCondition) {\n right.visit(this);\n return;\n }\n if (right instanceof EmptyCondition) {\n left.visit(this);\n return;\n }\n left.visit(this);\n // fail fast if left result is empty\n if (!result.isEmpty()) {\n var rightVisitor = new ConditionVisitor();\n right.visit(rightVisitor);\n result.retainAll(rightVisitor.getResult());\n }\n }\n case OrCondition(var left, var right) -> {\n if (left instanceof EmptyCondition) {\n left.visit(this);\n return;\n }\n if (right instanceof EmptyCondition) {\n right.visit(this);\n return;\n }\n left.visit(this);\n var rightVisitor = new ConditionVisitor();\n right.visit(rightVisitor);\n result.addAll(rightVisitor.getResult());\n }\n case NotCondition(var condition) -> {\n if (condition instanceof EmptyCondition) {\n return;\n }\n condition.not().visit(this);\n }\n case EqualCondition(var indexName, var key) ->\n result.addAll(equalQuery(indexName, key, false));\n case NotEqualCondition(var indexName, var key) ->\n result.addAll(equalQuery(indexName, key, true));\n case InCondition(var indexName, var keys) ->\n result.addAll(inQuery(indexName, keys, false));\n case NotInCondition(var indexName, var keys) ->\n result.addAll(inQuery(indexName, keys, true));\n case LessThanCondition(var indexName, var upperBound, var inclusive) ->\n result.addAll(lessThanQuery(indexName, upperBound, inclusive, false));\n case GreaterThanCondition(var indexName, var lowerBound, var inclusive) ->\n result.addAll(lessThanQuery(indexName, lowerBound, inclusive, true));\n case BetweenCondition bc -> result.addAll(betweenQuery(\n bc.indexName(), bc.fromKey(), bc.fromInclusive(), bc.toKey(),\n bc.toInclusive(), false\n )\n );\n case NotBetweenCondition nbc -> result.addAll(betweenQuery(\n nbc.indexName(), nbc.fromKey(), nbc.fromInclusive(), nbc.toKey(),\n nbc.toInclusive(), true\n ));\n case IsNullCondition(var indexName) ->\n result.addAll(isNullQuery(indexName, false));\n case IsNotNullCondition(var indexName) ->\n result.addAll(isNullQuery(indexName, true));\n case StringContainsCondition(var indexName, var keyword) ->\n result.addAll(stringContainsQuery(indexName, keyword, false));\n case StringNotContainsCondition(var indexName, var keyword) ->\n result.addAll(stringContainsQuery(indexName, keyword, true));\n case StringStartsWithCondition(var indexName, var prefix) ->\n result.addAll(stringStartsWithQuery(indexName, prefix, false));\n case StringNotStartsWithCondition(var indexName, var prefix) ->\n result.addAll(stringStartsWithQuery(indexName, prefix, true));\n case StringEndsWithCondition(var indexName, var suffix) ->\n result.addAll(stringEndsWithQuery(indexName, suffix, false));\n case StringNotEndsWithCondition(var indexName, var suffix) ->\n result.addAll(stringEndsWithQuery(indexName, suffix, true));\n case AllCondition(var indexName) -> result.addAll(allQuery(indexName, false));\n case NoneCondition(var indexName) -> result.addAll(allQuery(indexName, true));\n case LabelExistsCondition(var labelKey) ->\n result.addAll(labelExistsQuery(labelKey));\n case LabelNotExistsCondition(var labelKey) -> {\n // To get all extensions that do not have the label, we get all extensions\n result.addAll(allQuery(\"metadata.name\", false));\n result.removeAll(labelExistsQuery(labelKey));\n }\n case LabelEqualsCondition(var labelKey, var labelValue) ->\n result.addAll(labelEqualsQuery(labelKey, labelValue, false));\n case LabelNotEqualsCondition(var labelKey, var labelValue) -> {\n // Only for backward compatibility\n result.addAll(allQuery(\"metadata.name\", false));\n result.removeAll(labelEqualsQuery(labelKey, labelValue, false));\n }\n case LabelInCondition(var labelKey, var labelValues) ->\n result.addAll(labelInQuery(labelKey, labelValues, false));\n case LabelNotInCondition(var labelKey, var labelValues) ->\n result.addAll(labelInQuery(labelKey, labelValues, true));\n default -> {\n }\n }\n }\n\n private Set labelInQuery(String labelKey, Collection labelValues,\n boolean negated) {\n var index = this.getLabelIndexQuery();\n if (negated) {\n return index.notIn(labelKey, labelValues);\n }\n return index.in(labelKey, labelValues);\n }\n\n private Set labelEqualsQuery(String labelKey, String labelValue,\n boolean negated) {\n var index = this.getLabelIndexQuery();\n if (negated) {\n return index.notEqual(labelKey, labelValue);\n }\n return index.equal(labelKey, labelValue);\n }\n\n private Set labelExistsQuery(String labelKey) {\n var index = getLabelIndexQuery();\n return index.exists(labelKey);\n }\n\n private Set stringEndsWithQuery(String indexName, String suffix, boolean negated) {\n var index = getValueIndexQuery(indexName);\n if (negated) {\n return index.stringNotEndsWith(suffix);\n }\n return index.stringEndsWith(suffix);\n }\n\n private Set allQuery(String indexName, boolean negated) {\n var index = getValueIndexQuery(indexName);\n if (negated) {\n return Set.of();\n }\n return index.all();\n }\n\n private Set stringStartsWithQuery(String indexName, String prefix,\n boolean negated) {\n var index = getValueIndexQuery(indexName);\n if (negated) {\n return index.stringNotStartsWith(prefix);\n }\n return index.stringStartsWith(prefix);\n }\n\n private Set stringContainsQuery(String indexName, String keyword, boolean negated) {\n var index = getValueIndexQuery(indexName);\n if (negated) {\n return index.stringNotContains(keyword);\n }\n return index.stringContains(keyword);\n }\n\n private > Set isNullQuery(String indexName,\n boolean negated) {\n var index = this.getValueIndexQuery(indexName);\n if (negated) {\n return index.isNotNull();\n }\n return index.isNull();\n }\n\n private > Set betweenQuery(String indexName, Object fromKey,\n boolean fromInclusive,\n Object toKey, boolean toInclusive, boolean negated) {\n var index = this.getValueIndexQuery(indexName);\n if (!conversionService.canConvert(fromKey.getClass(), index.getKeyType())) {\n throw new IllegalArgumentException(\n \"Cannot convert key: \" + fromKey + \" to type: \" + index.getKeyType()\n );\n }\n if (!conversionService.canConvert(toKey.getClass(), index.getKeyType())) {\n throw new IllegalArgumentException(\n \"Cannot convert key: \" + toKey + \" to type: \" + index.getKeyType()\n );\n }\n if (negated) {\n return index.notBetween(\n conversionService.convert(fromKey, index.getKeyType()),\n fromInclusive,\n conversionService.convert(toKey, index.getKeyType()),\n toInclusive\n );\n } else {\n return index.between(\n conversionService.convert(fromKey, index.getKeyType()),\n fromInclusive,\n conversionService.convert(toKey, index.getKeyType()),\n toInclusive\n );\n }\n }\n\n private > Set lessThanQuery(String indexName, Object bound,\n boolean inclusive,\n boolean negated) {\n var index = this.getValueIndexQuery(indexName);\n if (!conversionService.canConvert(bound.getClass(), index.getKeyType())) {\n throw new IllegalArgumentException(\n \"Cannot convert key: \" + bound + \" to type: \" + index.getKeyType()\n );\n }\n if (negated) {\n return index.greaterThan(\n conversionService.convert(bound, index.getKeyType()), inclusive\n );\n } else {\n return index.lessThan(conversionService.convert(bound, index.getKeyType()),\n inclusive);\n }\n }\n\n private > Set equalQuery(String indexName, Object key,\n boolean negated) {\n var index = this.getValueIndexQuery(indexName);\n if (!conversionService.canConvert(key.getClass(), index.getKeyType())) {\n throw new IllegalArgumentException(\n \"Cannot convert key: \" + key + \" to type: \" + index.getKeyType()\n );\n }\n if (negated) {\n return index.notEqual(conversionService.convert(key, index.getKeyType()));\n } else {\n return index.equal(conversionService.convert(key, index.getKeyType()));\n }\n }\n\n private > Set inQuery(\n String indexName, Collection keys, boolean negated\n ) {\n var index = this.getValueIndexQuery(indexName);\n var convertedKeys = keys.stream()\n .map(key -> {\n if (!conversionService.canConvert(key.getClass(), index.getKeyType())) {\n throw new IllegalArgumentException(\n \"Cannot convert key: \" + key + \" to type: \" + index.getKeyType()\n );\n }\n return conversionService.convert(key, index.getKeyType());\n })\n .toList();\n if (negated) {\n return index.notIn(convertedKeys);\n } else {\n return index.in(convertedKeys);\n }\n }\n\n private > ValueIndexQuery getValueIndexQuery(String indexName) {\n var index = indices.getIndex(indexName);\n if (!(index instanceof ValueIndexQuery valueIndexQuery)) {\n throw new IllegalArgumentException(\"Index is not in-memory: \" + indexName);\n }\n return (ValueIndexQuery) valueIndexQuery;\n }\n\n private LabelIndexQuery getLabelIndexQuery() {\n var indexName = \"metadata.labels\";\n var index = indices.getIndex(indexName);\n if (!(index instanceof LabelIndexQuery labelIndexQuery)) {\n throw new IllegalArgumentException(\"Index is not a label index: \" + indexName);\n }\n return labelIndexQuery;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/indexer/DefaultIndicesInitializer.java", "content": "package run.halo.app.extension.indexer;\n\nimport java.util.List;\nimport java.util.concurrent.TimeUnit;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StopWatch;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionConverter;\nimport run.halo.app.extension.ExtensionStoreUtil;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.index.IndicesInitializer;\nimport run.halo.app.extension.store.ExtensionStore;\nimport run.halo.app.extension.store.ExtensionStoreClient;\n\n@Component\n@Slf4j\nclass DefaultIndicesInitializer implements IndicesInitializer {\n\n private final IndexEngine indexEngine;\n\n private final ExtensionStoreClient client;\n\n private final ExtensionConverter extensionConverter;\n\n DefaultIndicesInitializer(IndexEngine indexEngine,\n ExtensionStoreClient client,\n ExtensionConverter extensionConverter) {\n this.indexEngine = indexEngine;\n this.client = client;\n this.extensionConverter = extensionConverter;\n }\n\n @EventListener\n void onSchemeAddedEvent(SchemeAddedEvent event) {\n var scheme = event.getScheme();\n this.initialize(scheme);\n }\n\n @Override\n public void initialize(Scheme scheme) {\n doInitialize(scheme);\n }\n\n public void doInitialize(Scheme scheme) {\n var type = (Class) scheme.type();\n var prefix = ExtensionStoreUtil.buildStoreNamePrefix(scheme);\n List extensionStores;\n String nameCursor = null;\n log.info(\"Start to initialize indices for type: {}, prefix: {}\", type.getName(), prefix);\n var watch = new StopWatch(\"Initialize indices for \" + type.getName());\n var indexedCount = 0L;\n do {\n watch.start(\"Indexing from \" + (nameCursor == null ? \"@start\" : nameCursor));\n extensionStores = client.listBy(prefix, nameCursor, 100);\n indexEngine.insert(extensionStores.stream()\n .map(es -> this.extensionConverter.convertFrom(type, es))::iterator\n );\n if (!extensionStores.isEmpty()) {\n nameCursor = extensionStores.getLast().getName();\n }\n indexedCount += extensionStores.size();\n watch.stop();\n } while (!extensionStores.isEmpty());\n log.info(\"Total indexed count: {}, initialization summary: {}\",\n indexedCount, watch.prettyPrint(TimeUnit.MILLISECONDS));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionCompositeRouterFunction.java", "content": "package run.halo.app.extension.router;\n\nimport java.util.Collections;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.event.SchemeRemovedEvent;\n\n@Component\npublic class ExtensionCompositeRouterFunction implements RouterFunction {\n\n private final ConcurrentMap> schemeRouterFuncMapper;\n\n private final ReactiveExtensionClient client;\n\n public ExtensionCompositeRouterFunction(ReactiveExtensionClient client) {\n this.client = client;\n schemeRouterFuncMapper = new ConcurrentHashMap<>();\n }\n\n @Override\n @NonNull\n public Mono> route(@NonNull ServerRequest request) {\n return Flux.fromIterable(getRouterFunctions())\n .concatMap(routerFunction -> routerFunction.route(request))\n .next();\n }\n\n @Override\n public void accept(@NonNull RouterFunctions.Visitor visitor) {\n getRouterFunctions().forEach(routerFunction -> routerFunction.accept(visitor));\n }\n\n private Iterable> getRouterFunctions() {\n // TODO Copy router functions here\n return Collections.unmodifiableCollection(schemeRouterFuncMapper.values());\n }\n\n @EventListener\n void onSchemeAddedEvent(SchemeAddedEvent event) {\n var scheme = event.getScheme();\n var factory = new ExtensionRouterFunctionFactory(scheme, client);\n this.schemeRouterFuncMapper.put(scheme, factory.create());\n }\n\n @EventListener\n void onSchemeRemovedEvent(SchemeRemovedEvent event) {\n this.schemeRouterFuncMapper.remove(event.getScheme());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionCreateHandler.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator.buildExtensionPathPattern;\n\nimport java.net.URI;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.exception.ExtensionConvertException;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.CreateHandler;\n\nclass ExtensionCreateHandler implements CreateHandler {\n\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n public ExtensionCreateHandler(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @Override\n @NonNull\n public Mono handle(@NonNull ServerRequest request) {\n return request.bodyToMono(Unstructured.class)\n .switchIfEmpty(Mono.error(() -> new ExtensionConvertException(\n \"Cannot read body to \" + scheme.groupVersionKind())))\n .flatMap(client::create)\n .flatMap(createdExt -> ServerResponse\n .created(URI.create(pathPattern() + \"/\" + createdExt.getMetadata().getName()))\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(createdExt));\n }\n\n @Override\n public String pathPattern() {\n return buildExtensionPathPattern(scheme);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionDeleteHandler.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator.buildExtensionPathPattern;\n\nimport org.springframework.http.MediaType;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.DeleteHandler;\n\nclass ExtensionDeleteHandler implements DeleteHandler {\n\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n ExtensionDeleteHandler(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @Override\n public Mono handle(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return client.get(scheme.type(), name)\n .flatMap(client::delete)\n .flatMap(deleted -> ServerResponse\n .ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(deleted));\n }\n\n @Override\n public String pathPattern() {\n return buildExtensionPathPattern(scheme) + \"/{name}\";\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionGetHandler.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator.buildExtensionPathPattern;\n\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.GetHandler;\n\nclass ExtensionGetHandler implements GetHandler {\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n public ExtensionGetHandler(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @Override\n public String pathPattern() {\n return buildExtensionPathPattern(scheme) + \"/{name}\";\n }\n\n @Override\n @NonNull\n public Mono handle(@NonNull ServerRequest request) {\n var extensionName = request.pathVariable(\"name\");\n\n return client.get(scheme.type(), extensionName)\n .flatMap(extension -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(extension));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionListHandler.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator.buildExtensionPathPattern;\n\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.ListHandler;\n\nclass ExtensionListHandler implements ListHandler {\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n public ExtensionListHandler(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @Override\n @NonNull\n public Mono handle(@NonNull ServerRequest request) {\n var queryParams = new SortableRequest(request.exchange());\n return client.listBy(scheme.type(),\n queryParams.toListOptions(),\n queryParams.toPageRequest()\n )\n .flatMap(listResult -> ServerResponse\n .ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(listResult));\n }\n\n @Override\n public String pathPattern() {\n return buildExtensionPathPattern(scheme);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionPatchHandler.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator.buildExtensionPathPattern;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport com.github.fge.jsonpatch.JsonPatch;\nimport com.github.fge.jsonpatch.JsonPatchException;\nimport java.util.List;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.http.MediaType;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport org.springframework.web.server.UnsupportedMediaTypeStatusException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.JsonExtension;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.PatchHandler;\n\n/**\n * Handler for patching extension.\n *\n * @author johnniang\n */\n@Slf4j\npublic class ExtensionPatchHandler implements PatchHandler {\n\n private static final MediaType JSON_PATCH_MEDIA_TYPE =\n MediaType.valueOf(\"application/json-patch+json\");\n\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n public ExtensionPatchHandler(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @Override\n public Mono handle(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var contentTypeOpt = request.headers().contentType();\n if (contentTypeOpt.isEmpty()) {\n return Mono.error(\n new UnsupportedMediaTypeStatusException((MediaType) null,\n List.of(JSON_PATCH_MEDIA_TYPE))\n );\n }\n var contentType = contentTypeOpt.get();\n if (!contentType.isCompatibleWith(JSON_PATCH_MEDIA_TYPE)) {\n return Mono.error(\n new UnsupportedMediaTypeStatusException(contentType, List.of(JSON_PATCH_MEDIA_TYPE))\n );\n }\n\n return request.bodyToMono(JsonPatch.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required.\")))\n .flatMap(jsonPatch -> client.getJsonExtension(scheme.groupVersionKind(), name)\n .flatMap(jsonExtension -> {\n try {\n // apply the patch\n var appliedJsonNode =\n (ObjectNode) jsonPatch.apply(jsonExtension.getInternal());\n var patchedExtension =\n new JsonExtension(jsonExtension.getObjectMapper(), appliedJsonNode);\n // update the patched extension\n return client.update(patchedExtension);\n } catch (JsonPatchException e) {\n return Mono.error(e);\n }\n }))\n .flatMap(updated -> ServerResponse.ok().bodyValue(updated));\n }\n\n @Override\n public String pathPattern() {\n return buildExtensionPathPattern(scheme) + \"/{name}\";\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionRouterFunctionFactory.java", "content": "package run.halo.app.extension.router;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\n\nimport io.swagger.v3.core.util.RefUtils;\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\n\npublic class ExtensionRouterFunctionFactory {\n\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n public ExtensionRouterFunctionFactory(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @NonNull\n public RouterFunction create() {\n var getHandler = new ExtensionGetHandler(scheme, client);\n var listHandler = new ExtensionListHandler(scheme, client);\n var createHandler = new ExtensionCreateHandler(scheme, client);\n var updateHandler = new ExtensionUpdateHandler(scheme, client);\n var deleteHandler = new ExtensionDeleteHandler(scheme, client);\n var patchHandler = new ExtensionPatchHandler(scheme, client);\n // TODO More handlers here\n var gvk = scheme.groupVersionKind();\n var kind = gvk.kind();\n var tagName = gvk.kind() + StringUtils.capitalize(gvk.version());\n return SpringdocRouteBuilder.route()\n .GET(getHandler.pathPattern(), getHandler,\n builder -> builder.operationId(\"get\" + kind)\n .description(\"Get \" + kind)\n .tag(tagName)\n .parameter(parameterBuilder().in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Name of \" + scheme.singular()))\n .response(responseBuilder().responseCode(\"200\")\n .description(\"Response single \" + scheme.singular())\n .implementation(scheme.type())))\n .GET(listHandler.pathPattern(), listHandler,\n builder -> {\n builder.operationId(\"list\" + kind)\n .description(\"List \" + kind)\n .tag(tagName)\n .response(responseBuilder().responseCode(\"200\")\n .description(\"Response \" + scheme.plural())\n .implementation(ListResult.generateGenericClass(scheme)));\n SortableRequest.buildParameters(builder);\n })\n .POST(createHandler.pathPattern(), createHandler,\n builder -> builder.operationId(\"create\" + kind)\n .description(\"Create \" + kind)\n .tag(tagName)\n .requestBody(requestBodyBuilder()\n .description(\"Fresh \" + scheme.singular())\n .implementation(scheme.type()))\n .response(responseBuilder().responseCode(\"200\")\n .description(\"Response \" + scheme.plural() + \" created just now\")\n .implementation(scheme.type())))\n .PUT(updateHandler.pathPattern(), updateHandler,\n builder -> builder.operationId(\"update\" + kind)\n .description(\"Update \" + kind)\n .tag(tagName)\n .parameter(parameterBuilder().in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Name of \" + scheme.singular()))\n .requestBody(requestBodyBuilder()\n .description(\"Updated \" + scheme.singular())\n .implementation(scheme.type()))\n .response(responseBuilder().responseCode(\"200\")\n .description(\"Response \" + scheme.plural() + \" updated just now\")\n .implementation(scheme.type())))\n .PATCH(patchHandler.pathPattern(), patchHandler,\n builder -> builder.operationId(\"patch\" + kind)\n .description(\"Patch \" + kind)\n .tag(tagName)\n .parameter(parameterBuilder().in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Name of \" + scheme.singular()))\n .requestBody(requestBodyBuilder()\n .content(contentBuilder()\n .mediaType(\"application/json-patch+json\")\n .schema(\n schemaBuilder().ref(RefUtils.constructRef(JsonPatch.SCHEMA_NAME))\n )\n )\n )\n .response(responseBuilder().responseCode(\"200\")\n .description(\"Response \" + scheme.singular() + \" patched just now\")\n .implementation(scheme.type())\n )\n )\n .DELETE(deleteHandler.pathPattern(), deleteHandler,\n builder -> builder.operationId(\"delete\" + kind)\n .description(\"Delete \" + kind)\n .tag(tagName)\n .parameter(parameterBuilder().in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Name of \" + scheme.singular()))\n .response(responseBuilder().responseCode(\"200\")\n .description(\"Response \" + scheme.singular() + \" deleted just now\")))\n .build();\n }\n\n interface PathPatternGenerator {\n\n String pathPattern();\n\n static String buildExtensionPathPattern(Scheme scheme) {\n var gvk = scheme.groupVersionKind();\n StringBuilder pattern = new StringBuilder();\n if (gvk.hasGroup()) {\n pattern.append(\"/apis/\").append(gvk.group());\n } else {\n pattern.append(\"/api\");\n }\n return pattern.append('/').append(gvk.version()).append('/').append(scheme.plural())\n .toString();\n }\n }\n\n interface GetHandler extends HandlerFunction, PathPatternGenerator {\n\n }\n\n interface ListHandler extends HandlerFunction, PathPatternGenerator {\n\n }\n\n interface CreateHandler extends HandlerFunction, PathPatternGenerator {\n\n }\n\n interface UpdateHandler extends HandlerFunction, PathPatternGenerator {\n\n }\n\n interface DeleteHandler extends HandlerFunction, PathPatternGenerator {\n\n }\n\n interface PatchHandler extends HandlerFunction, PathPatternGenerator {\n\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/ExtensionUpdateHandler.java", "content": "package run.halo.app.extension.router;\n\nimport static run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator.buildExtensionPathPattern;\n\nimport java.util.Objects;\nimport org.springframework.http.MediaType;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.UpdateHandler;\n\nclass ExtensionUpdateHandler implements UpdateHandler {\n\n private final Scheme scheme;\n\n private final ReactiveExtensionClient client;\n\n ExtensionUpdateHandler(Scheme scheme, ReactiveExtensionClient client) {\n this.scheme = scheme;\n this.client = client;\n }\n\n @Override\n public Mono handle(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return request.bodyToMono(Unstructured.class)\n .filter(unstructured -> unstructured.getMetadata() != null\n && StringUtils.hasText(unstructured.getMetadata().getName())\n && Objects.equals(unstructured.getMetadata().getName(), name))\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Cannot read body to \" + scheme.groupVersionKind())))\n .flatMap(client::update)\n .flatMap(updated -> ServerResponse\n .ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(updated));\n }\n\n @Override\n public String pathPattern() {\n return buildExtensionPathPattern(scheme) + \"/{name}\";\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/router/JsonPatch.java", "content": "package run.halo.app.extension.router;\n\nimport static io.swagger.v3.oas.models.Components.COMPONENTS_SCHEMAS_REF;\n\nimport io.swagger.v3.oas.models.Components;\nimport io.swagger.v3.oas.models.media.Schema;\nimport io.swagger.v3.oas.models.media.StringSchema;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Function;\n\n/**\n * JSON schema for JSONPatch operations.\n *\n * @author johnniang\n */\npublic final class JsonPatch {\n\n private JsonPatch() {}\n\n public static final String SCHEMA_NAME = \"JsonPatch\";\n\n public static void addSchema(Components components) {\n Function> opSchemaFunc =\n op -> new StringSchema()._enum(List.of(op)).type(\"string\");\n var pathSchema = new StringSchema()\n .description(\"A JSON Pointer path\")\n .pattern(\"^(/[^/~]*(~[01][^/~]*)*)*$\")\n .example(\"/a/b/c\");\n var valueSchema = new Schema<>().description(\"Value can be any JSON value\");\n var operationSchema = new io.swagger.v3.oas.models.media.Schema<>()\n .oneOf(List.of(\n new io.swagger.v3.oas.models.media.Schema<>()\n .$ref(COMPONENTS_SCHEMAS_REF + \"AddOperation\"),\n new io.swagger.v3.oas.models.media.Schema<>()\n .$ref(COMPONENTS_SCHEMAS_REF + \"ReplaceOperation\"),\n new io.swagger.v3.oas.models.media.Schema<>()\n .$ref(COMPONENTS_SCHEMAS_REF + \"TestOperation\"),\n new io.swagger.v3.oas.models.media.Schema<>()\n .$ref(COMPONENTS_SCHEMAS_REF + \"RemoveOperation\"),\n new io.swagger.v3.oas.models.media.Schema<>()\n .$ref(COMPONENTS_SCHEMAS_REF + \"MoveOperation\"),\n new io.swagger.v3.oas.models.media.Schema<>()\n .$ref(COMPONENTS_SCHEMAS_REF + \"CopyOperation\")\n ));\n\n components.addSchemas(\"AddOperation\", new io.swagger.v3.oas.models.media.ObjectSchema()\n .required(List.of(\"op\", \"path\", \"value\"))\n .properties(Map.of(\n \"op\", opSchemaFunc.apply(\"add\"),\n \"path\", pathSchema,\n \"value\", valueSchema\n )))\n ;\n components.addSchemas(\"ReplaceOperation\", new io.swagger.v3.oas.models.media.ObjectSchema()\n .required(List.of(\"op\", \"path\", \"value\"))\n .properties(Map.of(\n \"op\", opSchemaFunc.apply(\"replace\"),\n \"path\", pathSchema,\n \"value\", valueSchema\n )))\n ;\n components.addSchemas(\"TestOperation\", new io.swagger.v3.oas.models.media.ObjectSchema()\n .required(List.of(\"op\", \"path\", \"value\"))\n .properties(Map.of(\n \"op\", opSchemaFunc.apply(\"test\"),\n \"path\", pathSchema,\n \"value\", valueSchema\n )))\n ;\n components.addSchemas(\"RemoveOperation\", new io.swagger.v3.oas.models.media.ObjectSchema()\n .required(List.of(\"op\", \"path\"))\n .properties(Map.of(\n \"op\", opSchemaFunc.apply(\"remove\"),\n \"path\", pathSchema\n )))\n ;\n components.addSchemas(\"MoveOperation\", new io.swagger.v3.oas.models.media.ObjectSchema()\n .required(List.of(\"op\", \"from\", \"path\"))\n .properties(Map.of(\n \"op\", opSchemaFunc.apply(\"move\"),\n \"from\", pathSchema\n .description(\"A JSON Pointer path pointing to the location to move/copy from.\"),\n \"path\", pathSchema\n )))\n ;\n components.addSchemas(\"CopyOperation\", new io.swagger.v3.oas.models.media.ObjectSchema()\n .required(List.of(\"op\", \"from\", \"path\"))\n .properties(Map.of(\n \"op\", opSchemaFunc.apply(\"copy\"),\n \"from\", pathSchema\n .description(\"A JSON Pointer path pointing to the location to move/copy from.\"),\n \"path\", pathSchema\n )))\n ;\n components.addSchemas(SCHEMA_NAME, new io.swagger.v3.oas.models.media.ArraySchema()\n .description(\"JSON schema for JSONPatch operations\")\n .uniqueItems(true)\n .minItems(1)\n .items(operationSchema)\n );\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/store/ExtensionStore.java", "content": "package run.halo.app.extension.store;\n\nimport lombok.Data;\nimport org.springframework.data.annotation.Id;\nimport org.springframework.data.annotation.Version;\nimport org.springframework.data.relational.core.mapping.Table;\n\n/**\n * ExtensionStore is an entity for storing Extension data into database.\n *\n * @author johnniang\n */\n@Data\n@Table(name = \"extensions\")\npublic class ExtensionStore {\n\n /**\n * Extension store name, which is globally unique.\n * We will use it to query Extensions by using left-like query clause.\n */\n @Id\n private String name;\n\n /**\n * Exactly Extension body, which might be base64 format.\n */\n private byte[] data;\n\n /**\n * This field only for serving optimistic lock value.\n */\n @Version\n private Long version;\n\n public ExtensionStore() {\n }\n\n public ExtensionStore(String name, byte[] data) {\n this.name = name;\n this.data = data;\n }\n\n public ExtensionStore(String name, Long version) {\n this.name = name;\n this.version = version;\n }\n\n public ExtensionStore(String name, byte[] data, Long version) {\n this.name = name;\n this.data = data;\n this.version = version;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/store/ExtensionStoreClient.java", "content": "package run.halo.app.extension.store;\n\nimport java.util.List;\nimport java.util.Optional;\nimport org.springframework.data.domain.Page;\nimport org.springframework.data.domain.Pageable;\n\n/**\n * An interface to query and operate ExtensionStore.\n *\n * @author johnniang\n */\npublic interface ExtensionStoreClient {\n\n /**\n * Lists all ExtensionStores by name prefix.\n *\n * @param prefix is the prefix of ExtensionStore name.\n * @return all ExtensionStores which names start with the prefix.\n */\n List listByNamePrefix(String prefix);\n\n Page listByNamePrefix(String prefix, Pageable pageable);\n\n /**\n * Lists ExtensionStores by name prefix, after the given cursor name, and limit the result size.\n *\n * @param prefix the name prefix\n * @param nameCursor cursor name, exclusive and can be null\n * @param limit the max result size\n * @return a list of extension stores\n */\n List listBy(String prefix, String nameCursor, int limit);\n\n List listByNames(List names);\n\n /**\n * Fetches an ExtensionStore by unique name.\n *\n * @param name is the full name of an ExtensionStore.\n * @return an optional ExtensionStore.\n */\n Optional fetchByName(String name);\n\n /**\n * Creates an ExtensionStore.\n *\n * @param name is the full name of an ExtensionStore.\n * @param data is Extension body to be persisted.\n * @return a fresh ExtensionStore created just now.\n */\n ExtensionStore create(String name, byte[] data);\n\n /**\n * Updates an ExtensionStore with version to prevent concurrent update.\n *\n * @param name is the full name of an ExtensionStore.\n * @param version is the expected version of ExtensionStore.\n * @param data is Extension body to be updated.\n * @return updated ExtensionStore with a fresh version.\n */\n ExtensionStore update(String name, Long version, byte[] data);\n\n /**\n * Deletes an ExtensionStore by name and current version.\n *\n * @param name is the full name of an ExtensionStore.\n * @param version is the expected version of ExtensionStore.\n * @return previous ExtensionStore.\n */\n ExtensionStore delete(String name, Long version);\n\n //TODO add watch method here.\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/store/ExtensionStoreClientJPAImpl.java", "content": "package run.halo.app.extension.store;\n\nimport java.time.Duration;\nimport java.util.List;\nimport java.util.Optional;\nimport org.springframework.data.domain.Page;\nimport org.springframework.data.domain.Pageable;\nimport org.springframework.stereotype.Service;\n\n/**\n * An implementation of ExtensionStoreClient using JPA.\n *\n * @author johnniang\n */\n@Service\npublic class ExtensionStoreClientJPAImpl implements ExtensionStoreClient {\n\n private static final Duration TIMEOUT = Duration.ofSeconds(30);\n\n private final ReactiveExtensionStoreClient storeClient;\n\n public ExtensionStoreClientJPAImpl(ReactiveExtensionStoreClient storeClient) {\n this.storeClient = storeClient;\n }\n\n @Override\n public List listByNamePrefix(String prefix) {\n return storeClient.listByNamePrefix(prefix).collectList().block(TIMEOUT);\n }\n\n @Override\n public Page listByNamePrefix(String prefix, Pageable pageable) {\n return storeClient.listByNamePrefix(prefix, pageable).block(TIMEOUT);\n }\n\n @Override\n public List listBy(String prefix, String nameCursor, int limit) {\n return storeClient.listBy(prefix, nameCursor, limit).collectList().block(TIMEOUT);\n }\n\n @Override\n public List listByNames(List names) {\n return storeClient.listByNames(names).collectList().block(TIMEOUT);\n }\n\n @Override\n public Optional fetchByName(String name) {\n return storeClient.fetchByName(name).blockOptional(TIMEOUT);\n }\n\n @Override\n public ExtensionStore create(String name, byte[] data) {\n return storeClient.create(name, data).block(TIMEOUT);\n }\n\n @Override\n public ExtensionStore update(String name, Long version, byte[] data) {\n return storeClient.update(name, version, data).block(TIMEOUT);\n }\n\n @Override\n public ExtensionStore delete(String name, Long version) {\n return storeClient.delete(name, version).block(TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/store/ExtensionStoreRepository.java", "content": "package run.halo.app.extension.store;\n\nimport java.util.Collection;\nimport org.springframework.data.domain.Pageable;\nimport org.springframework.data.r2dbc.repository.R2dbcRepository;\nimport org.springframework.stereotype.Repository;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\n/**\n * This repository contains some basic operations on ExtensionStore entity.\n *\n * @author johnniang\n */\n@Repository\npublic interface ExtensionStoreRepository extends R2dbcRepository {\n\n /**\n * Finds all ExtensionStore by name prefix.\n *\n * @param prefix is the prefix of name.\n * @return all ExtensionStores which names starts with the given prefix.\n */\n Flux findAllByNameStartingWith(String prefix);\n\n Flux findAllByNameStartingWith(String prefix, Pageable pageable);\n\n Mono countByNameStartingWith(String prefix);\n\n /**\n *

Finds all ExtensionStore by name in, the result no guarantee the same order as the given\n * names, so if you want this, please order the result by yourself.

\n *\n * @param names names to find\n * @return a flux of extension stores\n */\n Flux findByNameIn(Collection names);\n\n Flux findAllByNameStartingWithAndNameGreaterThan(\n String prefix, String nameCursor, Pageable pageable);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/store/ReactiveExtensionStoreClient.java", "content": "package run.halo.app.extension.store;\n\nimport java.util.List;\nimport org.springframework.data.domain.Page;\nimport org.springframework.data.domain.Pageable;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\npublic interface ReactiveExtensionStoreClient {\n\n Flux listByNamePrefix(String prefix);\n\n Mono> listByNamePrefix(String prefix, Pageable pageable);\n\n /**\n * List stores by name prefix, after the given cursor name, and limit the result size.\n *\n * @param prefix the name prefix\n * @param nameCursor cursor name, exclusive and can be null\n * @param limit the max result size\n * @return a flux of extension stores\n */\n Flux listBy(String prefix, @Nullable String nameCursor, int limit);\n\n Mono countByNamePrefix(String prefix);\n\n /**\n * List stores by names and return data according to given names order.\n *\n * @param names store names to list\n * @return a flux of extension stores\n */\n Flux listByNames(List names);\n\n Mono fetchByName(String name);\n\n Mono create(String name, byte[] data);\n\n Mono update(String name, Long version, byte[] data);\n\n Mono delete(String name, Long version);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/extension/store/ReactiveExtensionStoreClientImpl.java", "content": "package run.halo.app.extension.store;\n\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport java.util.stream.IntStream;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.apache.commons.lang3.Strings;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.dao.DuplicateKeyException;\nimport org.springframework.data.domain.Page;\nimport org.springframework.data.domain.Pageable;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.data.r2dbc.core.R2dbcEntityOperations;\nimport org.springframework.data.relational.core.query.Criteria;\nimport org.springframework.data.relational.core.query.Query;\nimport org.springframework.data.support.ReactivePageableExecutionUtils;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.exception.DuplicateNameException;\n\n@Component\n@RequiredArgsConstructor\npublic class ReactiveExtensionStoreClientImpl implements ReactiveExtensionStoreClient {\n\n private static final int DEFAULT_FETCH_SIZE = 100;\n\n private final ExtensionStoreRepository repository;\n\n private final R2dbcEntityOperations entityOperations;\n\n private int fetchSize = DEFAULT_FETCH_SIZE;\n\n void setFetchSize(int fetchSize) {\n Assert.isTrue(fetchSize >= 0, \"fetchSize must be greater than or equal to 0\");\n this.fetchSize = fetchSize;\n }\n\n @Override\n public Flux listByNamePrefix(String prefix) {\n Assert.hasText(prefix, \"Prefix must not be blank\");\n\n prefix = Strings.CS.appendIfMissing(prefix, \"/\");\n return entityOperations.select(ExtensionStore.class)\n .withFetchSize(fetchSize)\n .matching(Query.query(\n Criteria.where(\"name\").like(prefix + \"%\")\n )\n .sort(Sort.by(Sort.Direction.ASC, \"name\"))\n )\n .all();\n }\n\n @Override\n public Mono> listByNamePrefix(String prefix, Pageable pageable) {\n Assert.hasText(prefix, \"Prefix must not be blank\");\n\n var q = Query.query(\n Criteria.where(\"name\").like(prefix + \"%\")\n ).sort(Sort.by(Sort.Direction.ASC, \"name\"));\n var getItems = entityOperations.select(ExtensionStore.class)\n .matching(q.with(pageable))\n .all()\n .collectList();\n var getCount = entityOperations.select(ExtensionStore.class)\n .matching(q)\n .count();\n return getItems.flatMap(\n items -> ReactivePageableExecutionUtils.getPage(items, pageable, getCount)\n );\n }\n\n @Override\n public Flux listBy(String prefix, @Nullable String nameCursor, int limit) {\n Assert.hasText(prefix, \"Prefix must not be blank\");\n Assert.isTrue(limit > 0, \"Limit must be greater than 0\");\n\n prefix = Strings.CS.appendIfMissing(prefix, \"/\");\n var criteria = Criteria.where(\"name\").like(prefix + \"%\");\n if (StringUtils.isNotBlank(nameCursor)) {\n nameCursor = Strings.CS.prependIfMissing(nameCursor, prefix);\n criteria = criteria.and(Criteria.where(\"name\").greaterThan(nameCursor));\n }\n var q = Query.query(criteria).sort(Sort.by(Sort.Direction.ASC, \"name\"));\n return entityOperations.select(ExtensionStore.class)\n .matching(q.limit(limit))\n .all();\n }\n\n @Override\n public Mono countByNamePrefix(String prefix) {\n Assert.hasText(prefix, \"Prefix must not be blank\");\n\n var q = Query.query(\n Criteria.where(\"name\").like(prefix + \"%\")\n )\n .sort(Sort.by(Sort.Direction.ASC, \"name\"));\n return entityOperations.select(ExtensionStore.class)\n .matching(q)\n .count();\n }\n\n @Override\n public Flux listByNames(List names) {\n if (CollectionUtils.isEmpty(names)) {\n return Flux.empty();\n }\n // Keep the order of names efficiently\n var orderMap = IntStream.range(0, names.size())\n .boxed()\n .collect(Collectors.toMap(names::get, Function.identity(), (a, b) -> a));\n return repository.findByNameIn(names)\n .sort(Comparator.comparingInt(es -> orderMap.get(es.getName())));\n }\n\n @Override\n public Mono fetchByName(String name) {\n return repository.findById(name);\n }\n\n @Override\n public Mono create(String name, byte[] data) {\n return repository.save(new ExtensionStore(name, data))\n .onErrorMap(DuplicateKeyException.class,\n t -> new DuplicateNameException(\"Duplicate name detected.\", t));\n }\n\n @Override\n public Mono update(String name, Long version, byte[] data) {\n return repository.save(new ExtensionStore(name, data, version));\n }\n\n @Override\n public Mono delete(String name, Long version) {\n return repository.findById(name)\n .flatMap(extensionStore -> {\n // reset the version\n extensionStore.setVersion(version);\n return repository.delete(extensionStore).thenReturn(extensionStore);\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultBackupRootGetter.java", "content": "package run.halo.app.infra;\n\nimport java.nio.file.Path;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@Component\npublic class DefaultBackupRootGetter implements BackupRootGetter {\n\n private final HaloProperties haloProperties;\n\n public DefaultBackupRootGetter(HaloProperties haloProperties) {\n this.haloProperties = haloProperties;\n }\n\n @Override\n public Path get() {\n return haloProperties.getWorkDir().resolve(\"backups\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultExternalLinkProcessor.java", "content": "package run.halo.app.infra;\n\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport java.util.Optional;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.filter.reactive.ServerWebExchangeContextFilter;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.utils.PathUtils;\n\n/**\n * Default implementation of {@link ExternalLinkProcessor}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultExternalLinkProcessor implements ExternalLinkProcessor {\n private final ExternalUrlSupplier externalUrlSupplier;\n\n @Override\n public String processLink(String link) {\n var externalLink = externalUrlSupplier.getRaw();\n if (StringUtils.isBlank(link) || externalLink == null || PathUtils.isAbsoluteUri(link)) {\n return link;\n }\n return append(externalLink.toString(), link);\n }\n\n @Override\n public Mono processLink(URI uri) {\n if (uri.isAbsolute()) {\n return Mono.just(uri);\n }\n return Mono.deferContextual(contextView -> Mono.fromSupplier(\n () -> ServerWebExchangeContextFilter.getExchange(contextView)\n .map(exchange -> externalUrlSupplier.getURL(exchange.getRequest()))\n .or(() -> Optional.ofNullable(externalUrlSupplier.getRaw()))\n .map(externalUrl -> {\n try {\n var uriComponents = UriComponentsBuilder.fromUriString(uri.toASCIIString())\n .build(true);\n return UriComponentsBuilder.fromUri(externalUrl.toURI())\n .pathSegment(uriComponents.getPathSegments().toArray(new String[0]))\n .queryParams(uriComponents.getQueryParams())\n .fragment(uriComponents.getFragment())\n .build(true)\n .toUri();\n } catch (URISyntaxException e) {\n // should never happen\n return uri;\n }\n })\n .orElse(uri)\n ));\n }\n\n String append(String externalLink, String link) {\n return StringUtils.removeEnd(externalLink, \"/\")\n + StringUtils.prependIfMissing(link, \"/\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultInitializationStateGetter.java", "content": "package run.halo.app.infra;\n\nimport static org.apache.commons.lang3.BooleanUtils.isTrue;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\n\n/**\n *

A cache that caches system setup state.

\n * when setUp state changed, the cache will be updated.\n *\n * @author guqing\n * @since 2.5.2\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultInitializationStateGetter implements InitializationStateGetter {\n private final ReactiveExtensionClient client;\n private final AtomicBoolean userInitialized = new AtomicBoolean(false);\n private final AtomicBoolean dataInitialized = new AtomicBoolean(false);\n\n @Override\n public Mono userInitialized() {\n // If user is initialized, return true directly.\n if (userInitialized.get()) {\n return Mono.just(true);\n }\n return hasUser()\n .doOnNext(userInitialized::set);\n }\n\n @Override\n public Mono dataInitialized() {\n if (dataInitialized.get()) {\n return Mono.just(true);\n }\n return client.fetch(ConfigMap.class, SystemState.SYSTEM_STATES_CONFIGMAP)\n .map(config -> {\n SystemState systemState = SystemState.deserialize(config);\n return isTrue(systemState.getIsSetup());\n })\n .defaultIfEmpty(false)\n .doOnNext(dataInitialized::set);\n }\n\n private Mono hasUser() {\n var listOptions = new ListOptions();\n listOptions.setLabelSelector(LabelSelector.builder()\n .notEq(User.HIDDEN_USER_LABEL, \"true\")\n .build()\n );\n listOptions.setFieldSelector(\n FieldSelector.of(isNull(\"metadata.deletionTimestamp\")));\n return client.listBy(User.class, listOptions, PageRequestImpl.ofSize(1))\n .map(result -> result.getTotal() > 0)\n .defaultIfEmpty(false);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultReactiveUrlDataBufferFetcher.java", "content": "package run.halo.app.infra;\n\nimport java.net.URI;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.client.reactive.ReactorClientHttpConnector;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.client.ExchangeStrategies;\nimport org.springframework.web.reactive.function.client.WebClient;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.netty.http.client.HttpClient;\n\n/**\n *

A default implementation of {@link ReactiveUrlDataBufferFetcher}.

\n *\n * @author guqing\n * @since 2.6.0\n */\n@Component\npublic class DefaultReactiveUrlDataBufferFetcher implements ReactiveUrlDataBufferFetcher {\n private final HttpClient httpClient = HttpClient.create()\n .followRedirect(true);\n private final ContentLengthFetcher contentLengthFetcher = new ContentLengthFetcher();\n\n private final WebClient webClient = WebClient.builder()\n .clientConnector(new ReactorClientHttpConnector(httpClient))\n .build();\n\n @Override\n public Flux fetch(URI uri) {\n return webClient.get()\n .uri(uri)\n .accept(MediaType.APPLICATION_OCTET_STREAM)\n .retrieve()\n .bodyToFlux(DataBuffer.class);\n }\n\n @Override\n public Mono head(URI uri) {\n return contentLengthFetcher.fetchContentLength(uri);\n }\n\n static class ContentLengthFetcher {\n\n private final WebClient webClient;\n\n ContentLengthFetcher() {\n this.webClient = WebClient.builder()\n .exchangeStrategies(ExchangeStrategies.builder()\n .codecs(config -> config.defaultCodecs().maxInMemorySize(1))\n .build())\n .build();\n }\n\n Mono fetchContentLength(URI url) {\n return webClient.get()\n .uri(url)\n .exchangeToMono(response -> {\n HttpHeaders headers = response.headers().asHttpHeaders();\n\n return response.bodyToMono(byte[].class)\n .onErrorResume(ex -> Mono.empty())\n .thenReturn(headers);\n });\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultSystemConfigFetcher.java", "content": "package run.halo.app.infra;\n\nimport static run.halo.app.infra.SystemSetting.SYSTEM_CONFIG;\nimport static run.halo.app.infra.SystemSetting.SYSTEM_CONFIG_DEFAULT;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.concurrent.atomic.AtomicReference;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.core.convert.ConversionService;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonParseException;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.infra.utils.SystemConfigUtils;\nimport tools.jackson.databind.json.JsonMapper;\n\n@Component\n@RequiredArgsConstructor\n@Order(Ordered.HIGHEST_PRECEDENCE)\nclass DefaultSystemConfigFetcher\n implements SystemConfigFetcher, ApplicationListener {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final JsonMapper mapper;\n\n private final ReactiveExtensionClient extensionClient;\n\n private final ConversionService conversionService;\n\n private final AtomicReference> configMapCache = new AtomicReference<>();\n\n private final Mono> configMapMono = Mono.defer(() -> {\n var currentValue = configMapCache.get();\n if (currentValue != null) {\n return Mono.just(currentValue);\n }\n return computeSystemConfig().mapNotNull(configMap -> {\n if (configMapCache.compareAndSet(null, configMap.getData())) {\n return configMap.getData();\n } else {\n return configMapCache.get();\n }\n }).defaultIfEmpty(Map.of());\n }).cacheInvalidateIf(configMap -> {\n var currentValue = configMapCache.get();\n return currentValue == null || !currentValue.equals(configMap);\n });\n\n @Override\n public void onApplicationEvent(SystemConfigChangedEvent event) {\n configMapCache.set(event.getNewData());\n }\n\n @Override\n public Mono fetch(String key, Class type) {\n return getValuesInternal()\n .filter(map -> map.containsKey(key))\n .map(map -> map.get(key))\n .mapNotNull(stringValue -> {\n if (conversionService.canConvert(String.class, type)) {\n return conversionService.convert(stringValue, type);\n }\n return mapper.readValue(stringValue, type);\n });\n }\n\n @Override\n public Mono getBasic() {\n return fetch(SystemSetting.Basic.GROUP, SystemSetting.Basic.class)\n .switchIfEmpty(Mono.fromSupplier(SystemSetting.Basic::new));\n }\n\n @Override\n public Mono fetchComment() {\n return fetch(SystemSetting.Comment.GROUP, SystemSetting.Comment.class)\n .switchIfEmpty(Mono.fromSupplier(SystemSetting.Comment::new));\n }\n\n @Override\n public Mono fetchPost() {\n return fetch(SystemSetting.Post.GROUP, SystemSetting.Post.class)\n .switchIfEmpty(Mono.fromSupplier(SystemSetting.Post::new));\n }\n\n @Override\n public Mono fetchRouteRules() {\n return fetch(SystemSetting.ThemeRouteRules.GROUP, SystemSetting.ThemeRouteRules.class);\n }\n\n @NonNull\n private Mono> getValuesInternal() {\n return configMapMono;\n }\n\n @Override\n public Mono> getConfig() {\n return configMapMono;\n }\n\n /**\n * Load the system config map from the extension client.\n *\n * @return latest configMap from {@link ReactiveExtensionClient} without any cache.\n */\n @Override\n public Mono getConfigMap() {\n return extensionClient.fetch(ConfigMap.class, SYSTEM_CONFIG);\n }\n\n /**\n * Gets the system config map without any cache.\n *\n * @return load configMap from {@link ReactiveExtensionClient}\n */\n @Override\n public Optional getConfigMapBlocking() {\n return getConfigMap().blockOptional(BLOCKING_TIMEOUT);\n }\n\n private Mono computeSystemConfig() {\n var getOverrideConfigMap = extensionClient.fetch(ConfigMap.class, SYSTEM_CONFIG);\n var getDefaultConfigMap = extensionClient.fetch(ConfigMap.class, SYSTEM_CONFIG_DEFAULT)\n .switchIfEmpty(Mono.fromSupplier(() -> {\n var defaultConfigMap = new ConfigMap();\n defaultConfigMap.setData(Map.of());\n return defaultConfigMap;\n }));\n return Mono.zip(getDefaultConfigMap, getOverrideConfigMap,\n (defaultConfigMap, overrideConfigMap) -> {\n try {\n return SystemConfigUtils.mergeConfigMap(defaultConfigMap, overrideConfigMap);\n } catch (JsonProcessingException e) {\n throw new JsonParseException(e);\n }\n });\n }\n\n /**\n * Gets the config map cache. Only for test use.\n *\n * @return the config map cache\n */\n AtomicReference> getConfigMapCache() {\n return configMapCache;\n }\n\n /**\n * Gets the config map mono. Only for test use.\n *\n * @return the config map mono\n */\n Mono> getConfigMapMono() {\n return configMapMono;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultSystemVersionSupplier.java", "content": "package run.halo.app.infra;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.util.Objects;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.info.BuildProperties;\nimport org.springframework.stereotype.Component;\n\n/**\n * Default implementation of system version supplier.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class DefaultSystemVersionSupplier implements SystemVersionSupplier {\n private static final String DEFAULT_VERSION = \"0.0.0\";\n\n private final ObjectProvider buildProperties;\n\n public DefaultSystemVersionSupplier(ObjectProvider buildProperties) {\n this.buildProperties = buildProperties;\n }\n\n @Override\n public Version get() {\n var properties = buildProperties.getIfUnique();\n if (properties == null) {\n return Version.parse(DEFAULT_VERSION);\n }\n var projectVersion = Objects.toString(properties.getVersion(), DEFAULT_VERSION);\n return Version.parse(projectVersion);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/DefaultThemeRootGetter.java", "content": "package run.halo.app.infra;\n\nimport java.nio.file.Path;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@Component\npublic class DefaultThemeRootGetter implements ThemeRootGetter {\n\n private final HaloProperties haloProps;\n\n public DefaultThemeRootGetter(HaloProperties haloProps) {\n this.haloProps = haloProps;\n }\n\n @Override\n public Path get() {\n return haloProps.getWorkDir().resolve(\"themes\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ExtensionInitializedEvent.java", "content": "package run.halo.app.infra;\n\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * ExtensionInitializedEvent is fired after extensions have been initialized completely.\n *\n * @author johnniang\n */\npublic class ExtensionInitializedEvent extends ApplicationEvent {\n\n public ExtensionInitializedEvent(Object source) {\n super(source);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ExtensionResourceInitializer.java", "content": "package run.halo.app.infra;\n\nimport java.io.IOException;\nimport java.time.Duration;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Set;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.support.PathMatchingResourcePatternResolver;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\n/**\n *

Extension resources initializer.

\n *

Check whether {@link HaloProperties#getInitialExtensionLocations()} is configured\n * When the system ready, and load resources according to it to creates {@link Unstructured}

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class ExtensionResourceInitializer implements SmartLifecycle {\n\n private volatile boolean running;\n\n public static final Set REQUIRED_EXTENSION_LOCATIONS =\n Set.of(\"classpath:/extensions/*.yaml\", \"classpath:/extensions/*.yml\");\n private final HaloProperties haloProperties;\n private final ReactiveExtensionClient extensionClient;\n\n private final ApplicationEventPublisher eventPublisher;\n\n public ExtensionResourceInitializer(HaloProperties haloProperties,\n ReactiveExtensionClient extensionClient,\n ApplicationEventPublisher eventPublisher) {\n this.haloProperties = haloProperties;\n this.extensionClient = extensionClient;\n this.eventPublisher = eventPublisher;\n }\n\n @Override\n public void start() {\n if (running) {\n return;\n }\n running = true;\n var locations = new HashSet();\n if (!haloProperties.isRequiredExtensionDisabled()) {\n locations.addAll(REQUIRED_EXTENSION_LOCATIONS);\n }\n if (haloProperties.getInitialExtensionLocations() != null) {\n locations.addAll(haloProperties.getInitialExtensionLocations());\n }\n if (CollectionUtils.isEmpty(locations)) {\n return;\n }\n\n Flux.fromIterable(locations)\n .doOnNext(location ->\n log.debug(\"Trying to initialize extension resources from location: {}\", location))\n .map(this::listResources)\n .distinct()\n .flatMapIterable(resources -> resources)\n .doOnNext(resource -> log.debug(\"Initializing extension resource from location: {}\",\n resource))\n .map(resource -> new YamlUnstructuredLoader(resource).load())\n .flatMapIterable(extensions -> extensions)\n .doOnNext(extension -> {\n if (log.isDebugEnabled()) {\n log.debug(\"Initializing extension resource: {}/{}\",\n extension.groupVersionKind(), extension.getMetadata().getName());\n }\n })\n .flatMap(this::createOrUpdate)\n .doOnNext(extension -> {\n if (log.isDebugEnabled()) {\n log.debug(\"Initialized extension resource: {}/{}\", extension.groupVersionKind(),\n extension.getMetadata().getName());\n }\n })\n .then()\n .block(Duration.ofMinutes(1));\n eventPublisher.publishEvent(new ExtensionInitializedEvent(this));\n }\n\n @Override\n public void stop() {\n if (!running) {\n return;\n }\n running = false;\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.EXTENSION_RESOURCES.getPhase();\n }\n\n\n private Mono createOrUpdate(Unstructured extension) {\n return Mono.just(extension)\n .flatMap(ext -> extensionClient.fetch(extension.groupVersionKind(),\n extension.getMetadata().getName()))\n .flatMap(existingExt -> {\n if (ExtensionUtil.hasDoNotOverwriteLabel(existingExt)) {\n log.debug(\"Extension {} is marked as do-not-overwrite, skipping update\",\n existingExt.getMetadata().getName()\n );\n // skip update\n return Mono.just(existingExt);\n }\n // force update\n extension.getMetadata().setVersion(existingExt.getMetadata().getVersion());\n return extensionClient.update(extension);\n })\n .switchIfEmpty(Mono.defer(() -> {\n if (ExtensionUtil.isDeleted(extension)) {\n // skip deleted extension\n return Mono.empty();\n }\n return extensionClient.create(extension);\n }));\n }\n\n private List listResources(String location) {\n var resolver = new PathMatchingResourcePatternResolver();\n try {\n return List.of(resolver.getResources(location));\n } catch (IOException ie) {\n throw new IllegalArgumentException(\"Invalid extension location: \" + location, ie);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ExternalUrlChangedEvent.java", "content": "package run.halo.app.infra;\n\nimport java.net.URL;\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * Event triggered when the external URL of the application changes.\n *\n * @author johnniang\n * @since 2.21.0\n */\npublic class ExternalUrlChangedEvent extends ApplicationEvent {\n\n @Getter\n private final URL externalUrl;\n\n public ExternalUrlChangedEvent(Object source, URL externalUrl) {\n super(source);\n this.externalUrl = externalUrl;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/InitializationPhase.java", "content": "package run.halo.app.infra;\n\n/**\n * Phase of system initialization.\n *\n * @author johnniang\n */\npublic enum InitializationPhase {\n\n FIRST(Integer.MIN_VALUE),\n\n SCHEME(Integer.MIN_VALUE + 100),\n\n EXTENSION_RESOURCES,\n\n THEME_ROUTER_FUNCTIONS,\n\n GC_CONTROLLER,\n\n CONTROLLERS,\n\n LAST(Integer.MAX_VALUE),\n ;\n\n private static final int GAP = 100;\n\n private final int phase;\n\n InitializationPhase() {\n this.phase = ordinal() * GAP;\n }\n\n InitializationPhase(int phase) {\n this.phase = phase;\n }\n\n public int getPhase() {\n return phase;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/InitializationStateGetter.java", "content": "package run.halo.app.infra;\n\nimport reactor.core.publisher.Mono;\n\n/**\n *

A interface that get system initialization state.

\n *\n * @author guqing\n * @since 2.9.0\n */\npublic interface InitializationStateGetter {\n\n /**\n * Check if system user is initialized.\n *\n * @return true if system user is initialized, false otherwise.\n */\n Mono userInitialized();\n\n /**\n * Check if system basic data is initialized.\n *\n * @return true if system basic data is initialized, false otherwise.\n */\n Mono dataInitialized();\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ReactiveExtensionPaginatedOperator.java", "content": "package run.halo.app.infra;\n\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ListOptions;\n\n/**\n * Reactive extension paginated operator to handle extensions by pagination.\n *\n * @author guqing\n * @since 2.15.0\n */\npublic interface ReactiveExtensionPaginatedOperator {\n\n /**\n *

Deletes all data, including any new entries added during the execution of this method.

\n *

This method continuously monitors and removes data that appears throughout its runtime,\n * ensuring that even data created during the deletion process is also removed.

\n */\n Mono deleteContinuously(Class type,\n ListOptions listOptions);\n\n /**\n *

Deletes only the data that existed at the start of the operation.

\n *

This method takes a snapshot of the data at the beginning and deletes only that dataset;\n * any data added after the method starts will not be affected or removed.

\n */\n Flux deleteInitialBatch(Class type,\n ListOptions listOptions);\n\n /**\n *

Note that: This method can not be used for deletion operation, because\n * deletion operation will change the total records.

\n */\n Flux list(Class type, ListOptions listOptions);\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ReactiveExtensionPaginatedOperatorImpl.java", "content": "package run.halo.app.infra;\n\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@Component\n@RequiredArgsConstructor\npublic class ReactiveExtensionPaginatedOperatorImpl implements ReactiveExtensionPaginatedOperator {\n private static final int DEFAULT_PAGE_SIZE = 200;\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono deleteContinuously(Class type,\n ListOptions listOptions) {\n var pageRequest = createPageRequest();\n return cleanupContinuously(type, listOptions, pageRequest);\n }\n\n private Mono cleanupContinuously(Class type,\n ListOptions listOptions,\n PageRequest pageRequest) {\n // forever loop first page until no more to delete\n return pageBy(type, listOptions, pageRequest)\n .flatMap(page -> Flux.fromIterable(page.getItems())\n .flatMap(client::delete)\n .then(page.hasNext() ? cleanupContinuously(type, listOptions, pageRequest)\n : Mono.empty())\n );\n }\n\n @Override\n public Flux deleteInitialBatch(Class type,\n ListOptions listOptions) {\n var pageRequest = createPageRequest();\n var newFieldQuery = listOptions.getFieldSelector()\n .andQuery(isNull(\"metadata.deletionTimestamp\"));\n listOptions.setFieldSelector(newFieldQuery);\n final Instant now = Instant.now();\n\n return pageBy(type, listOptions, pageRequest)\n // forever loop first page until no more to delete\n .expand(result -> result.hasNext()\n ? pageBy(type, listOptions, pageRequest) : Mono.empty())\n .flatMap(result -> Flux.fromIterable(result.getItems()))\n .takeWhile(item -> shouldTakeNext(item, now))\n .flatMap(this::deleteWithRetry);\n }\n\n static boolean shouldTakeNext(E item, Instant now) {\n var creationTimestamp = item.getMetadata().getCreationTimestamp();\n return creationTimestamp.isBefore(now)\n || creationTimestamp.equals(now);\n }\n\n @SuppressWarnings(\"unchecked\")\n Mono deleteWithRetry(E item) {\n return client.delete(item)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> attemptToDelete((Class) item.getClass(), item.getMetadata().getName()));\n }\n\n private Mono attemptToDelete(Class type, String name) {\n return Mono.defer(() -> client.fetch(type, name)\n .flatMap(client::delete)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n @Override\n public Flux list(Class type, ListOptions listOptions) {\n var pageRequest = createPageRequest();\n return list(type, listOptions, pageRequest);\n }\n\n /**\n * Paginated list all items to avoid memory overflow.\n * 
\n     * 1. Retrieve data multiple times until all data is consumed.\n     * 2. Fetch next page if current page has more data and consumed records is less than total\n     * records.\n     * 3. Take while consumed records is less than total records.\n     * 4. totalRecords from first page to ensure new inserted data will not be counted in during\n     * querying to avoid infinite loop.\n     *
\n */\n private Flux list(Class type, ListOptions listOptions,\n PageRequest pageRequest) {\n final var now = Instant.now();\n return pageBy(type, listOptions, pageRequest)\n .expand(result -> {\n if (result.hasNext()) {\n // fetch next page\n var nextPage = nextPage(result, pageRequest.getSort());\n return pageBy(type, listOptions, nextPage);\n } else {\n return Mono.empty();\n }\n })\n .flatMap(page -> Flux.fromIterable(page.getItems()))\n .takeWhile(item -> shouldTakeNext(item, now));\n }\n\n static PageRequest nextPage(ListResult result, Sort sort) {\n return PageRequestImpl.of(result.getPage() + 1, result.getSize(), sort);\n }\n\n private PageRequest createPageRequest() {\n return PageRequestImpl.of(1, DEFAULT_PAGE_SIZE,\n Sort.by(\"metadata.creationTimestamp\", \"metadata.name\"));\n }\n\n private Mono> pageBy(Class type, ListOptions listOptions,\n PageRequest pageRequest) {\n return client.listBy(type, listOptions, pageRequest);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ReactiveUrlDataBufferFetcher.java", "content": "package run.halo.app.infra;\n\nimport java.net.URI;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.HttpHeaders;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\n/**\n *

{@link DataBuffer} stream fetcher from uri.

\n *\n * @author guqing\n * @since 2.6.0\n */\npublic interface ReactiveUrlDataBufferFetcher {\n\n /**\n *

Fetch data buffer flux from uri.

\n *\n * @param uri uri to fetch\n * @return data buffer flux\n */\n Flux fetch(URI uri);\n\n /**\n *

Get head of the uri.

\n *\n * @param uri uri to fetch\n * @return response entity\n */\n Mono head(URI uri);\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SchemeInitializer.java", "content": "package run.halo.app.infra;\n\nimport static java.util.Objects.requireNonNullElse;\nimport static run.halo.app.core.extension.Role.ROLE_AGGREGATE_LABEL_PREFIX;\nimport static run.halo.app.core.extension.content.Comment.CommentOwner.ownerIdentity;\nimport static run.halo.app.extension.index.IndexAttributeFactory.simpleAttribute;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport java.time.Instant;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.content.Stats;\nimport run.halo.app.core.attachment.extension.LocalThumbnail;\nimport run.halo.app.core.attachment.extension.Thumbnail;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.core.extension.AuthProvider;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.Device;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.core.extension.RememberMeToken;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.core.extension.UserConnection.UserConnectionSpec;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Attachment.AttachmentSpec;\nimport run.halo.app.core.extension.attachment.Attachment.AttachmentStatus;\nimport run.halo.app.core.extension.attachment.Group;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.core.extension.attachment.PolicyTemplate;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Category.CategorySpec;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Comment.CommentSpec;\nimport run.halo.app.core.extension.content.Comment.CommentStatus;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Post.PostSpec;\nimport run.halo.app.core.extension.content.Post.PostStatus;\nimport run.halo.app.core.extension.content.Post.VisibleEnum;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.content.Reply.ReplySpec;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.content.SinglePage.SinglePageSpec;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.extension.content.Tag.TagSpec;\nimport run.halo.app.core.extension.content.Tag.TagStatus;\nimport run.halo.app.core.extension.notification.Notification;\nimport run.halo.app.core.extension.notification.Notification.NotificationSpec;\nimport run.halo.app.core.extension.notification.NotificationTemplate;\nimport run.halo.app.core.extension.notification.NotifierDescriptor;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.core.extension.notification.Subscription.InterestReason;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.Secret;\nimport run.halo.app.extension.index.IndexSpec;\nimport run.halo.app.extension.index.IndexSpecs;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.migration.Backup;\nimport run.halo.app.plugin.extensionpoint.ExtensionDefinition;\nimport run.halo.app.plugin.extensionpoint.ExtensionPointDefinition;\nimport run.halo.app.security.PersonalAccessToken;\n\n@Component\nclass SchemeInitializer implements SmartLifecycle {\n\n private final SchemeManager schemeManager;\n\n private volatile boolean running;\n\n public SchemeInitializer(SchemeManager schemeManager) {\n this.schemeManager = schemeManager;\n }\n\n @Override\n public void start() {\n if (running) {\n return;\n }\n running = true;\n schemeManager.register(Role.class, is -> {\n is.add(IndexSpecs.multi(\"labels.aggregateToRoles\", String.class)\n .indexFunc(role -> Optional.ofNullable(role.getMetadata().getLabels()).map(\n labels -> labels.keySet().stream()\n .filter(key -> key.startsWith(ROLE_AGGREGATE_LABEL_PREFIX))\n .filter(key -> Boolean.parseBoolean(labels.get(key)))\n .map(key -> StringUtils.removeStart(key, ROLE_AGGREGATE_LABEL_PREFIX))\n .collect(Collectors.toSet())).orElseGet(Set::of)\n )\n );\n });\n\n // plugin.halo.run\n schemeManager.register(Plugin.class, is -> {\n is.add(IndexSpecs.single(\"spec.displayName\", String.class)\n .indexFunc(plugin ->\n Optional.ofNullable(plugin.getSpec())\n .map(Plugin.PluginSpec::getDisplayName)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.description\", String.class)\n .indexFunc(plugin -> Optional.ofNullable(plugin.getSpec())\n .map(Plugin.PluginSpec::getDescription)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.enabled\", Boolean.class)\n .indexFunc(plugin -> Optional.ofNullable(plugin.getSpec())\n .map(Plugin.PluginSpec::getEnabled)\n .orElse(false)\n )\n .nullable(false)\n );\n });\n schemeManager.register(ExtensionPointDefinition.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\n \"spec.className\", String.class\n )\n .indexFunc(definition -> definition.getSpec().getClassName())\n );\n });\n schemeManager.register(ExtensionDefinition.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\n \"spec.extensionPointName\", String.class\n )\n .indexFunc(definition -> definition.getSpec().getExtensionPointName())\n );\n });\n schemeManager.register(RoleBinding.class, is -> {\n is.add(IndexSpecs.single(\"roleRef.name\", String.class)\n .indexFunc(roleBinding -> roleBinding.getRoleRef().getName())\n );\n is.add(IndexSpecs.multi(\"subjects\", String.class)\n .indexFunc(roleBinding -> roleBinding.getSubjects().stream()\n .map(RoleBinding.Subject::toString)\n .collect(Collectors.toSet())\n )\n );\n });\n schemeManager.register(User.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.displayName\", String.class)\n .indexFunc(user -> user.getSpec().getDisplayName())\n );\n indexSpecs.add(IndexSpecs.single(\"spec.emailVerified\", Boolean.class)\n .indexFunc(user -> user.getSpec().isEmailVerified())\n );\n indexSpecs.add(IndexSpecs.single(\"spec.email\", String.class)\n .indexFunc(user -> Optional.ofNullable(user.getSpec().getEmail())\n .map(String::toLowerCase)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.multi(\n User.USER_RELATED_ROLES_INDEX, String.class\n )\n .indexFunc(user -> Optional.ofNullable(user.getMetadata())\n .map(MetadataOperator::getAnnotations)\n .map(annotations -> annotations.get(User.ROLE_NAMES_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(rolesJson -> JsonUtils.jsonToObject(\n rolesJson, new TypeReference>() {\n })\n )\n .orElseGet(Set::of)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.disabled\", Boolean.class)\n .indexFunc(user -> requireNonNullElse(user.getSpec().getDisabled(), Boolean.FALSE))\n .nullable(false)\n );\n });\n schemeManager.register(ReverseProxy.class);\n schemeManager.register(Setting.class);\n schemeManager.register(AnnotationSetting.class, indexSpecs -> indexSpecs.add(\n IndexSpecs.single(\"spec.targetRef\", String.class)\n .indexFunc(annotationSetting -> Optional.ofNullable(annotationSetting.getSpec())\n .map(AnnotationSetting.AnnotationSettingSpec::getTargetRef)\n .map(ref -> ref.group() + \"/\" + ref.kind())\n .orElse(null)\n )\n ));\n schemeManager.register(ConfigMap.class);\n schemeManager.register(Secret.class);\n schemeManager.register(Theme.class);\n schemeManager.register(Menu.class);\n schemeManager.register(MenuItem.class);\n schemeManager.register(Post.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.title\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getTitle)\n .orElse(null)\n )\n );\n\n indexSpecs.add(IndexSpecs.single(\"spec.slug\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getSlug)\n .orElse(null)\n )\n );\n\n indexSpecs.add(IndexSpecs.single(\"spec.publishTime\", Instant.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getPublishTime)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.owner\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getOwner)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.deleted\", Boolean.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getDeleted)\n .orElse(false)\n ).nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.pinned\", Boolean.class)\n .indexFunc(post ->\n Optional.ofNullable(post.getSpec())\n .map(PostSpec::getPinned)\n .orElse(false)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.priority\", Integer.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getPriority)\n .orElse(0)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.visible\", VisibleEnum.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getVisible)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.multi(\"spec.tags\", String.class)\n .indexFunc(\n post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getTags)\n .map(Set::copyOf)\n .orElse(Set.of())\n )\n );\n indexSpecs.add(IndexSpecs.multi(\"spec.categories\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getSpec())\n .map(PostSpec::getCategories)\n .map(Set::copyOf)\n .orElse(Set.of())\n )\n );\n indexSpecs.add(IndexSpecs.multi(\"status.contributors\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getStatus())\n .map(PostStatus::getContributors)\n .map(Set::copyOf).orElse(Set.of())\n )\n );\n indexSpecs.add(IndexSpecs.single(\"status.phase\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getStatus())\n .map(PostStatus::getPhase)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"status.excerpt\", String.class)\n .indexFunc(post -> Optional.ofNullable(post.getStatus())\n .map(PostStatus::getExcerpt)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"status.lastModifyTime\", Instant.class)\n .indexFunc(post -> Optional.ofNullable(post.getStatus())\n .map(PostStatus::getLastModifyTime)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"status.hideFromList\", Boolean.class)\n .indexFunc(post -> Optional.ofNullable(post.getStatus())\n .map(Post.PostStatus::getHideFromList)\n .orElse(false)\n )\n );\n indexSpecs.add(IndexSpecs.single(\n Post.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, Boolean.class\n )\n .indexFunc(post -> {\n var version = post.getMetadata().getVersion();\n var status = post.getStatus();\n if (status == null) {\n return true;\n }\n var observedVersion = status.getObservedVersion();\n return observedVersion == null || observedVersion < version;\n // do not care about the false case so return null to avoid indexing\n })\n );\n indexSpecs.add(IndexSpecs.single(\"stats.visit\", Long.class)\n .indexFunc(post -> Optional.ofNullable(post.getMetadata().getAnnotations())\n .map(a -> a.get(Post.STATS_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(json -> JsonUtils.jsonToObject(json, Stats.class))\n .map(Stats::getVisit)\n .map(i -> (long) i)\n .orElse(0L)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"stats.totalComment\", Long.class)\n .indexFunc(post -> Optional.ofNullable(post.getMetadata().getAnnotations())\n .map(a -> a.get(Post.STATS_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(json -> JsonUtils.jsonToObject(json, Stats.class))\n .map(Stats::getTotalComment)\n .map(i -> (long) i)\n .orElse(0L)\n )\n .nullable(false)\n );\n });\n schemeManager.register(Category.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.slug\", String.class)\n .indexFunc(category -> Optional.ofNullable(category.getSpec())\n .map(CategorySpec::getSlug)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.priority\", Integer.class)\n .indexFunc(category -> Optional.ofNullable(category.getSpec())\n .map(CategorySpec::getPriority)\n .orElse(0)\n )\n );\n indexSpecs.add(IndexSpecs.multi(\"spec.children\", String.class)\n .indexFunc(category -> Optional.ofNullable(category.getSpec())\n .map(CategorySpec::getChildren)\n .map(Set::copyOf)\n .orElse(Set.of())\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.hideFromList\", Boolean.class)\n .indexFunc(category -> Optional.ofNullable(category.getSpec())\n .map(CategorySpec::isHideFromList)\n .orElse(false)\n )\n );\n });\n schemeManager.register(Tag.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.displayName\", String.class)\n .indexFunc(tag -> Optional.ofNullable(tag.getSpec())\n .map(TagSpec::getDisplayName)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.slug\", String.class)\n .indexFunc(\n tag -> Optional.ofNullable(tag.getSpec())\n .map(TagSpec::getSlug)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"status.postCount\", Integer.class)\n .indexFunc(tag -> Optional.ofNullable(tag.getStatus())\n .map(TagStatus::getPostCount)\n .orElse(0)\n )\n );\n indexSpecs.add(IndexSpecs.single(\n Tag.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, Boolean.class\n )\n .indexFunc(tag -> {\n var version = tag.getMetadata().getVersion();\n var status = tag.getStatus();\n if (status == null) {\n return true;\n }\n var observedVersion = status.getObservedVersion();\n return observedVersion == null || observedVersion < version;\n // do not care about the false case so return null to avoid indexing\n })\n );\n });\n schemeManager.register(Snapshot.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.subjectRef\", String.class)\n .indexFunc(snapshot -> Optional.ofNullable(snapshot.getSpec())\n .map(Snapshot.SnapShotSpec::getSubjectRef)\n .map(Snapshot::toSubjectRefKey)\n .orElse(null)\n )\n );\n });\n schemeManager.register(Comment.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.creationTime\", Instant.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getCreationTime)\n .orElseGet(() -> comment.getMetadata().getCreationTimestamp())\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.approved\", Boolean.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getApproved)\n .orElse(false)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.owner\", String.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getOwner)\n .map(owner -> ownerIdentity(owner.getKind(), owner.getName()))\n .orElse(null)\n )\n .nullable(true)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.subjectRef\", String.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getSubjectRef)\n .map(Comment::toSubjectRefKey)\n .orElse(null)\n )\n .nullable(true)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.top\", Boolean.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getTop)\n .orElse(false)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.hidden\", Boolean.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getHidden)\n .orElse(false)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.priority\", Integer.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .filter(spec -> Boolean.TRUE.equals(spec.getTop()))\n .map(Comment.BaseCommentSpec::getPriority)\n .orElse(0)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.raw\", String.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getSpec())\n .map(CommentSpec::getRaw)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\n \"status.lastReplyTime\", Instant.class\n )\n .indexFunc(comment -> Optional.ofNullable(comment.getStatus())\n .map(CommentStatus::getLastReplyTime)\n .orElse(null)\n )\n );\n\n indexSpecs.add(IndexSpecs.single(\"status.replyCount\", Integer.class)\n .indexFunc(comment -> Optional.ofNullable(comment.getStatus())\n .map(CommentStatus::getReplyCount)\n .orElse(0)\n )\n );\n indexSpecs.add(IndexSpecs.single(\n Comment.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, Boolean.class\n )\n .indexFunc(comment -> {\n var version = comment.getMetadata().getVersion();\n var status = comment.getStatus();\n if (status == null) {\n return true;\n }\n var observedVersion = status.getObservedVersion();\n return observedVersion == null || observedVersion < version;\n // do not care about the false case so return null to avoid indexing\n })\n );\n });\n schemeManager.register(Reply.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.creationTime\", Instant.class)\n .indexFunc(reply -> Optional.ofNullable(reply.getSpec())\n .map(ReplySpec::getCreationTime)\n .orElse(reply.getMetadata().getCreationTimestamp())\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.commentName\", String.class)\n .indexFunc(reply -> Optional.ofNullable(reply.getSpec())\n .map(ReplySpec::getCommentName)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.hidden\", Boolean.class)\n .indexFunc(reply -> Optional.ofNullable(reply.getSpec())\n .map(ReplySpec::getHidden)\n .orElse(false)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.approved\", Boolean.class)\n .indexFunc(reply -> Optional.ofNullable(reply.getSpec())\n .map(ReplySpec::getApproved)\n .orElse(false)\n )\n .nullable(false)\n );\n indexSpecs.add(IndexSpecs.single(\"spec.owner\", String.class)\n .indexFunc(reply -> Optional.ofNullable(reply.getSpec())\n .map(ReplySpec::getOwner)\n .map(owner -> ownerIdentity(owner.getKind(), owner.getName()))\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\n Reply.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME, Boolean.class\n )\n .indexFunc(reply -> {\n var version = reply.getMetadata().getVersion();\n var status = reply.getStatus();\n if (status == null) {\n return true;\n }\n var observedVersion = status.getObservedVersion();\n return observedVersion == null || observedVersion < version;\n // do not care about the false case so return null to avoid indexing\n })\n );\n });\n schemeManager.register(SinglePage.class, is -> {\n is.add(IndexSpecs.single(\"spec.publishTime\", Instant.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getPublishTime)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.title\", String.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getTitle)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.slug\", String.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getSlug)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.deleted\", Boolean.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getDeleted)\n .orElse(false)\n )\n .nullable(false)\n );\n is.add(IndexSpecs.single(\"spec.visible\", VisibleEnum.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getVisible)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.pinned\", Boolean.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getPinned)\n .orElse(false)\n )\n .nullable(false)\n );\n\n is.add(IndexSpecs.single(\"spec.priority\", Integer.class)\n .indexFunc(page -> Optional.ofNullable(page.getSpec())\n .map(SinglePageSpec::getPriority)\n .orElse(0)\n )\n .nullable(false)\n );\n\n is.add(IndexSpecs.single(\"status.excerpt\", String.class)\n .indexFunc(page -> Optional.ofNullable(page.getStatus())\n .map(SinglePage.SinglePageStatus::getExcerpt)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"status.phase\", String.class)\n .indexFunc(page -> Optional.ofNullable(page.getStatus())\n .map(SinglePage.SinglePageStatus::getPhase)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.multi(\"status.contributors\", String.class)\n .indexFunc(page -> Optional.ofNullable(page.getStatus())\n .map(SinglePage.SinglePageStatus::getContributors)\n .map(Set::copyOf)\n .orElse(Set.of())\n )\n );\n });\n // storage.halo.run\n schemeManager.register(Group.class);\n schemeManager.register(Policy.class);\n schemeManager.register(Attachment.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.displayName\", String.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getSpec())\n .map(AttachmentSpec::getDisplayName)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.policyName\", String.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getSpec())\n .map(AttachmentSpec::getPolicyName)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.groupName\", String.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getSpec())\n .map(AttachmentSpec::getGroupName)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.mediaType\", String.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getSpec())\n .map(AttachmentSpec::getMediaType)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.ownerName\", String.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getSpec())\n .map(AttachmentSpec::getOwnerName)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.size\", Long.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getSpec())\n .map(AttachmentSpec::getSize)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"status.permalink\", String.class)\n .indexFunc(attachment -> Optional.ofNullable(attachment.getStatus())\n .map(AttachmentStatus::getPermalink)\n .orElse(null)\n )\n );\n });\n schemeManager.register(PolicyTemplate.class);\n schemeManager.register(Thumbnail.class, indexSpec -> {\n indexSpec.add(new IndexSpec()\n // see run.halo.app.core.attachment.ThumbnailMigration\n // .setUnique(true)\n .setName(Thumbnail.ID_INDEX)\n .setIndexFunc(simpleAttribute(Thumbnail.class, Thumbnail::idIndexFunc)));\n });\n schemeManager.register(LocalThumbnail.class, indexSpec -> {\n // make sure image and size are unique\n indexSpec.add(new IndexSpec()\n // see run.halo.app.core.attachment.ThumbnailMigration\n // .setUnique(true)\n .setName(LocalThumbnail.UNIQUE_IMAGE_AND_SIZE_INDEX)\n .setIndexFunc(\n simpleAttribute(LocalThumbnail.class, LocalThumbnail::uniqueImageAndSize)\n )\n );\n indexSpec.add(new IndexSpec().setName(\"spec.imageSignature\")\n .setIndexFunc(simpleAttribute(LocalThumbnail.class,\n thumbnail -> thumbnail.getSpec().getImageSignature())\n )\n );\n indexSpec.add(new IndexSpec().setName(\"spec.thumbSignature\").setUnique(true)\n .setIndexFunc(simpleAttribute(LocalThumbnail.class,\n thumbnail -> thumbnail.getSpec().getThumbSignature())\n )\n );\n indexSpec.add(new IndexSpec().setName(\"status.phase\").setIndexFunc(\n simpleAttribute(LocalThumbnail.class,\n thumbnail -> Optional.of(thumbnail.getStatus())\n .map(LocalThumbnail.Status::getPhase)\n .map(LocalThumbnail.Phase::name)\n .orElse(null)\n )\n ));\n });\n // metrics.halo.run\n schemeManager.register(Counter.class);\n // auth.halo.run\n schemeManager.register(AuthProvider.class);\n schemeManager.register(UserConnection.class, is -> {\n is.add(IndexSpecs.single(\"spec.username\", String.class)\n .indexFunc(connection -> Optional.ofNullable(connection.getSpec())\n .map(UserConnectionSpec::getUsername)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.registrationId\", String.class)\n .indexFunc(connection -> Optional.ofNullable(connection.getSpec())\n .map(UserConnectionSpec::getRegistrationId)\n .orElse(null)\n )\n );\n is.add(IndexSpecs.single(\"spec.providerUserId\", String.class)\n .indexFunc(connection -> Optional.ofNullable(connection.getSpec())\n .map(UserConnectionSpec::getProviderUserId)\n .orElse(null)\n )\n );\n });\n\n // security.halo.run\n schemeManager.register(PersonalAccessToken.class);\n schemeManager.register(RememberMeToken.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.series\", String.class)\n .indexFunc(token -> Optional.ofNullable(token.getSpec())\n .map(RememberMeToken.Spec::getSeries)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.username\", String.class)\n .indexFunc(token -> Optional.ofNullable(token.getSpec())\n .map(RememberMeToken.Spec::getUsername)\n .orElse(null)\n )\n );\n });\n schemeManager.register(Device.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.principalName\", String.class)\n .indexFunc(device -> Optional.ofNullable(device.getSpec())\n .map(Device.Spec::getPrincipalName)\n .orElse(null)\n )\n );\n });\n\n // migration.halo.run\n schemeManager.register(Backup.class);\n\n // notification.halo.run\n schemeManager.register(ReasonType.class);\n schemeManager.register(Reason.class);\n schemeManager.register(NotificationTemplate.class, indexSpecs -> {\n indexSpecs.add(\n IndexSpecs.single(\"spec.reasonSelector.reasonType\",\n String.class).indexFunc(template -> Optional.ofNullable(template.getSpec())\n .map(NotificationTemplate.Spec::getReasonSelector)\n .map(NotificationTemplate.ReasonSelector::getReasonType)\n .orElse(null)\n )\n );\n });\n schemeManager.register(Subscription.class, indexSpecs -> {\n indexSpecs.add(\n IndexSpecs.single(\"spec.reason.reasonType\", String.class)\n .indexFunc(\n sub -> Optional.ofNullable(sub.getSpec()).map(Subscription.Spec::getReason)\n .map(InterestReason::getReasonType)\n .orElse(null)\n )\n );\n indexSpecs.add(\n IndexSpecs.single(\"spec.reason.subject\", String.class)\n .indexFunc(sub -> Optional.ofNullable(sub.getSpec())\n .map(Subscription.Spec::getReason)\n .map(InterestReason::getSubject)\n .map(Object::toString)\n .orElse(null)\n )\n );\n indexSpecs.add(\n IndexSpecs.single(\"spec.reason.expression\", String.class)\n .indexFunc(sub -> Optional.ofNullable(sub.getSpec())\n .map(Subscription.Spec::getReason)\n .map(InterestReason::getExpression)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.subscriber\", String.class)\n .indexFunc(sub -> Optional.ofNullable(sub.getSpec())\n .map(Subscription.Spec::getSubscriber)\n .map(Object::toString)\n .orElse(null)\n )\n );\n });\n schemeManager.register(NotifierDescriptor.class);\n schemeManager.register(Notification.class, indexSpecs -> {\n indexSpecs.add(IndexSpecs.single(\"spec.unread\", Boolean.class)\n .indexFunc(notification -> Optional.ofNullable(notification.getSpec())\n .map(NotificationSpec::isUnread)\n .orElse(false)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.reason\", String.class)\n .indexFunc(notification -> Optional.ofNullable(notification.getSpec())\n .map(NotificationSpec::getReason)\n .orElse(null)\n )\n );\n indexSpecs.add(IndexSpecs.single(\"spec.recipient\", String.class)\n .indexFunc(notification -> Optional.ofNullable(notification.getSpec())\n .map(NotificationSpec::getRecipient)\n .orElse(null)\n )\n );\n });\n }\n\n @Override\n public void stop() {\n if (!running) {\n return;\n }\n running = false;\n schemeManager.schemes().forEach(schemeManager::unregister);\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n @Override\n public int getPhase() {\n return InitializationPhase.SCHEME.getPhase();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SecureRequestMappingHandlerAdapter.java", "content": "package run.halo.app.infra;\n\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.reactive.HandlerResult;\nimport org.springframework.web.reactive.result.method.annotation.RequestMappingHandlerAdapter;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * Secure request mapping handler adapter.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class SecureRequestMappingHandlerAdapter extends RequestMappingHandlerAdapter {\n\n @Override\n @NonNull\n public Mono handle(\n @NonNull ServerWebExchange exchange,\n @NonNull Object handler\n ) {\n return super.handle(new SecureServerWebExchange(exchange), handler);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SecureServerRequest.java", "content": "package run.halo.app.infra;\n\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.support.ServerRequestWrapper;\nimport org.springframework.web.server.ServerWebExchange;\n\n/**\n * Secure server request without application context available.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class SecureServerRequest extends ServerRequestWrapper {\n\n /**\n * Create a new {@code ServerRequestWrapper} that wraps the given request.\n *\n * @param delegate the request to wrap\n */\n public SecureServerRequest(ServerRequest delegate) {\n super(delegate);\n }\n\n @Override\n @NonNull\n public ServerWebExchange exchange() {\n return new SecureServerWebExchange(super.exchange());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SecureServerWebExchange.java", "content": "package run.halo.app.infra;\n\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.ServerWebExchangeDecorator;\n\n/**\n * Secure server web exchange without application context available.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class SecureServerWebExchange extends ServerWebExchangeDecorator {\n\n public SecureServerWebExchange(ServerWebExchange delegate) {\n super(delegate);\n }\n\n @Override\n public ApplicationContext getApplicationContext() {\n // Always return null to prevent access to application context\n return null;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SystemConfigChangedEvent.java", "content": "package run.halo.app.infra;\n\nimport java.util.Map;\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * Event that is published when the system configuration changes.\n *\n * @author johnniang\n * @since 2.21.0\n */\npublic class SystemConfigChangedEvent extends ApplicationEvent {\n\n /**\n * Old configuration data. Unmodifiable.\n */\n @Getter\n private final Map oldData;\n\n /**\n * New configuration data. Unmodifiable.\n */\n @Getter\n private final Map newData;\n\n public SystemConfigChangedEvent(\n Object source,\n Map oldData,\n Map newData\n ) {\n super(source);\n this.oldData = Map.copyOf(oldData);\n this.newData = Map.copyOf(newData);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SystemConfigFetcher.java", "content": "package run.halo.app.infra;\n\nimport java.util.Map;\nimport java.util.Optional;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * A fetcher that fetches the system configuration from the extension client.\n * If there are {@link ConfigMap}s named system-default and system at\n * the same time, the {@link ConfigMap} named system will be json merge patch to\n * {@link ConfigMap} named system-default\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface SystemConfigFetcher {\n\n Mono fetch(String key, Class type);\n\n Mono getBasic();\n\n Mono fetchComment();\n\n Mono fetchPost();\n\n Mono fetchRouteRules();\n\n /**\n * Gets the system config values as a map(merged). Do not update this map directly.\n *\n * @return system config values map, cached, unmodifiable\n */\n Mono> getConfig();\n\n /**\n * Load the system config map from the extension client.\n *\n * @return latest configMap from {@link ReactiveExtensionClient} without any cache.\n */\n Mono getConfigMap();\n\n /**\n * Load the system config map from the extension client in a blocking way.\n *\n * @return latest configMap from {@link ReactiveExtensionClient} without any cache.\n */\n Optional getConfigMapBlocking();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SystemConfigFirstExternalUrlSupplier.java", "content": "package run.halo.app.infra;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport java.net.URL;\nimport java.time.Duration;\nimport java.util.Optional;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.boot.webflux.autoconfigure.WebFluxProperties;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.http.HttpRequest;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.StringUtils;\nimport reactor.core.Exceptions;\nimport run.halo.app.infra.properties.HaloProperties;\n\n/**\n * Default implementation for getting external url from system config first, halo properties second.\n *\n * @author johnniang\n */\n@Slf4j\n@Component\nclass SystemConfigFirstExternalUrlSupplier implements ExternalUrlSupplier {\n\n private final HaloProperties haloProperties;\n\n private final WebFluxProperties webFluxProperties;\n\n private final SystemConfigFetcher systemConfigFetcher;\n\n @Nullable\n private URL externalUrl;\n\n public SystemConfigFirstExternalUrlSupplier(HaloProperties haloProperties,\n WebFluxProperties webFluxProperties,\n SystemConfigFetcher systemConfigFetcher) {\n this.haloProperties = haloProperties;\n this.webFluxProperties = webFluxProperties;\n this.systemConfigFetcher = systemConfigFetcher;\n }\n\n @EventListener\n void onExtensionInitialized(ExtensionInitializedEvent ignored) {\n refetchExternalUrl().ifPresent(externalUrl -> this.externalUrl = externalUrl);\n }\n\n @EventListener\n void onExternalUrlChanged(ExternalUrlChangedEvent event) {\n this.externalUrl = event.getExternalUrl();\n }\n\n Optional refetchExternalUrl() {\n return systemConfigFetcher.getBasic()\n .mapNotNull(SystemSetting.Basic::getExternalUrl)\n .filter(StringUtils::hasText)\n .mapNotNull(externalUrlString -> {\n try {\n return URI.create(externalUrlString).toURL();\n } catch (MalformedURLException e) {\n log.error(\"\"\"\n Cannot parse external URL {} from system config. Fallback to default \\\n external URL supplier from properties.\\\n \"\"\", externalUrlString, e);\n // For continuing the application startup, we need to return null here.\n return null;\n }\n })\n .blockOptional(Duration.ofSeconds(10));\n }\n\n @Override\n public URI get() {\n try {\n if (!haloProperties.isUseAbsolutePermalink()) {\n return URI.create(getBasePath());\n }\n if (externalUrl != null) {\n return externalUrl.toURI();\n }\n return haloProperties.getExternalUrl().toURI();\n } catch (URISyntaxException e) {\n throw Exceptions.propagate(e);\n }\n }\n\n @Override\n public URL getURL(HttpRequest request) {\n if (this.externalUrl != null) {\n return this.externalUrl;\n }\n var externalUrl = haloProperties.getExternalUrl();\n if (externalUrl != null) {\n return externalUrl;\n }\n try {\n externalUrl = request.getURI().resolve(getBasePath()).toURL();\n } catch (MalformedURLException e) {\n throw new RuntimeException(\"Cannot parse request URI to URL.\", e);\n }\n return externalUrl;\n }\n\n @Nullable\n @Override\n public URL getRaw() {\n return externalUrl != null ? externalUrl : haloProperties.getExternalUrl();\n }\n\n private String getBasePath() {\n var basePath = webFluxProperties.getBasePath();\n if (!StringUtils.hasText(basePath)) {\n basePath = \"/\";\n }\n return basePath;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SystemConfigInitializer.java", "content": "package run.halo.app.infra;\n\nimport java.util.HashMap;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass SystemConfigInitializer {\n\n private final ReactiveExtensionClient client;\n\n @EventListener\n @Order(Ordered.HIGHEST_PRECEDENCE)\n Mono onApplicationEvent(ExtensionInitializedEvent ignored) {\n return client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG)\n .switchIfEmpty(Mono.defer(() -> {\n log.info(\"Initializing system config...\");\n var configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(SystemSetting.SYSTEM_CONFIG);\n configMap.setData(new HashMap<>());\n return client.create(configMap)\n .doOnSuccess(created -> {\n log.info(\"System config initialized: {}\", created.getMetadata().getName());\n });\n }))\n .then();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SystemInfoGetterImpl.java", "content": "package run.halo.app.infra;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.net.URL;\nimport java.util.Locale;\nimport java.util.TimeZone;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.boot.web.server.autoconfigure.ServerProperties;\nimport org.springframework.boot.webflux.autoconfigure.WebFluxProperties;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\n\n@Component\n@RequiredArgsConstructor\npublic class SystemInfoGetterImpl implements SystemInfoGetter {\n private final SystemConfigFetcher environmentFetcher;\n private final SystemVersionSupplier systemVersionSupplier;\n private final ExternalUrlSupplier externalUrlSupplier;\n private final ServerProperties serverProperties;\n private final WebFluxProperties webFluxProperties;\n\n @Override\n public Mono get() {\n var systemInfo = new SystemInfo()\n .setVersion(systemVersionSupplier.get())\n .setUrl(getExternalUrl())\n // TODO populate locale and timezone from system settings in the future\n .setLocale(Locale.getDefault())\n .setTimeZone(TimeZone.getDefault());\n\n var basicMono =\n environmentFetcher.fetch(SystemSetting.Basic.GROUP, SystemSetting.Basic.class)\n .doOnNext(basic -> systemInfo.setTitle(basic.getTitle())\n .setSubtitle(basic.getSubtitle())\n .setLogo(basic.getLogo())\n .setFavicon(basic.getFavicon())\n );\n\n var seoMono = environmentFetcher.fetch(SystemSetting.Seo.GROUP, SystemSetting.Seo.class)\n .doOnNext(seo -> systemInfo.setSeo(new SystemInfo.SeoProp()\n .setBlockSpiders(BooleanUtils.isTrue(seo.blockSpiders))\n .setKeywords(seo.getKeywords())\n .setDescription(seo.getDescription())\n ));\n\n var themeMono =\n environmentFetcher.fetch(SystemSetting.Theme.GROUP, SystemSetting.Theme.class)\n .doOnNext(theme -> systemInfo.setActivatedThemeName(theme.getActive()));\n return Mono.when(basicMono, seoMono, themeMono)\n .thenReturn(systemInfo);\n }\n\n private URL getExternalUrl() {\n var url = externalUrlSupplier.getRaw();\n if (url != null) {\n return url;\n }\n var port = serverProperties.getPort();\n var basePath = StringUtils.defaultIfBlank(webFluxProperties.getBasePath(), \"/\");\n try {\n var uriStr = \"http://localhost:\" + port + basePath;\n return URI.create(StringUtils.removeEnd(uriStr, \"/\")).toURL();\n } catch (MalformedURLException e) {\n // Should not happen\n throw new RuntimeException(\"Cannot create URL from server properties.\", e);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/SystemState.java", "content": "package run.halo.app.infra;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.github.fge.jsonpatch.JsonPatchException;\nimport com.github.fge.jsonpatch.mergepatch.JsonMergePatch;\nimport java.time.Duration;\nimport java.util.HashMap;\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport java.util.function.Consumer;\nimport lombok.Data;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonParseException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * A model for system state deserialize from {@link run.halo.app.extension.ConfigMap}\n * named {@code system-states}.\n *\n * @author guqing\n * @since 2.8.0\n */\n@Data\npublic class SystemState {\n public static final String SYSTEM_STATES_CONFIGMAP = \"system-states\";\n\n static final String GROUP = \"states\";\n\n private Boolean isSetup;\n\n /**\n * Deserialize from {@link ConfigMap}.\n *\n * @return config map\n */\n public static SystemState deserialize(@NonNull ConfigMap configMap) {\n Map data = configMap.getData();\n if (data == null) {\n return new SystemState();\n }\n return JsonUtils.jsonToObject(data.getOrDefault(GROUP, emptyJsonObject()),\n SystemState.class);\n }\n\n /**\n * Update modified system state to config map.\n *\n * @param systemState modified system state\n * @param configMap config map\n */\n public static void update(@NonNull SystemState systemState, @NonNull ConfigMap configMap) {\n Map data = configMap.getData();\n if (data == null) {\n data = new LinkedHashMap<>();\n configMap.setData(data);\n }\n JsonNode modifiedJson = JsonUtils.mapper()\n .convertValue(systemState, JsonNode.class);\n // original\n JsonNode sourceJson =\n JsonUtils.jsonToObject(data.getOrDefault(GROUP, emptyJsonObject()), JsonNode.class);\n try {\n // patch\n JsonMergePatch jsonMergePatch = JsonMergePatch.fromJson(modifiedJson);\n // apply patch to original\n JsonNode patchedNode = jsonMergePatch.apply(sourceJson);\n data.put(GROUP, JsonUtils.objectToJson(patchedNode));\n } catch (JsonPatchException e) {\n throw new JsonParseException(e);\n }\n }\n\n /**\n *

Update system state by the given {@link Consumer}.

\n *

if the system state config map does not exist, it will create a new one.

\n */\n public static Mono upsetSystemState(ReactiveExtensionClient client,\n Consumer consumer) {\n return Mono.defer(() -> client.fetch(ConfigMap.class, SYSTEM_STATES_CONFIGMAP)\n .switchIfEmpty(Mono.defer(() -> {\n ConfigMap configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(SYSTEM_STATES_CONFIGMAP);\n configMap.setData(new HashMap<>());\n return client.create(configMap);\n }))\n .flatMap(configMap -> {\n SystemState systemState = deserialize(configMap);\n consumer.accept(systemState);\n update(systemState, configMap);\n return client.update(configMap);\n })\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance)\n )\n .then();\n }\n\n private static String emptyJsonObject() {\n return \"{}\";\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ThemeRootGetter.java", "content": "package run.halo.app.infra;\n\nimport java.nio.file.Path;\nimport java.util.function.Supplier;\n\n/**\n * ThemeRootGetter allows us to get root path of themes.\n *\n * @author johnniang\n */\npublic interface ThemeRootGetter extends Supplier {\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/actuator/DatabaseInfoContributor.java", "content": "package run.halo.app.infra.actuator;\n\nimport io.r2dbc.spi.Connection;\nimport io.r2dbc.spi.ConnectionFactory;\nimport io.r2dbc.spi.ConnectionMetadata;\nimport java.time.Duration;\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.boot.actuate.info.Info;\nimport org.springframework.boot.actuate.info.InfoContributor;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n@Slf4j\n@Component\nclass DatabaseInfoContributor implements InfoContributor, InitializingBean {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private static final String DATABASE_INFO_KEY = \"database\";\n\n private final ConnectionFactory connectionFactory;\n\n @Nullable\n private ConnectionMetadata connectionMetadata;\n\n public DatabaseInfoContributor(ConnectionFactory connectionFactory) {\n this.connectionFactory = connectionFactory;\n }\n\n @Override\n public void afterPropertiesSet() throws Exception {\n var connectionMetadata = Mono.usingWhen(\n this.connectionFactory.create(),\n connection -> Mono.just(connection.getMetadata()),\n Connection::close\n )\n .blockOptional(BLOCKING_TIMEOUT)\n .orElseThrow(() -> new IllegalStateException(\"Unable to get database metadata\"));\n if (log.isDebugEnabled()) {\n log.debug(\"Database Metadata initialized: name={}, version={}\",\n connectionMetadata.getDatabaseProductName(),\n connectionMetadata.getDatabaseVersion());\n }\n this.connectionMetadata = connectionMetadata;\n }\n\n @Override\n public void contribute(Info.Builder builder) {\n if (this.connectionMetadata != null) {\n builder.withDetail(DATABASE_INFO_KEY, Map.of(\n \"name\", this.connectionMetadata.getDatabaseProductName(),\n \"version\", this.connectionMetadata.getDatabaseVersion()\n ));\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/actuator/GlobalInfo.java", "content": "package run.halo.app.infra.actuator;\n\nimport java.net.URL;\nimport java.util.Locale;\nimport java.util.TimeZone;\nimport lombok.Data;\n\n/**\n * Global info.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Data\npublic class GlobalInfo {\n\n private URL externalUrl;\n\n private TimeZone timeZone;\n\n private Locale locale;\n\n private boolean allowAnonymousComments;\n\n private boolean allowRegistration;\n\n private String favicon;\n\n private String postSlugGenerationStrategy;\n\n private Boolean mustVerifyEmailOnRegistration;\n\n private String siteTitle;\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/actuator/GlobalInfoEndpoint.java", "content": "package run.halo.app.infra.actuator;\n\nimport org.springframework.boot.actuate.endpoint.annotation.ReadOperation;\nimport org.springframework.boot.actuate.endpoint.web.annotation.WebEndpoint;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\n\n/**\n * Global info endpoint.\n */\n@WebEndpoint(id = \"globalinfo\")\n@Component\nclass GlobalInfoEndpoint {\n\n private final GlobalInfoService globalInfoService;\n\n public GlobalInfoEndpoint(GlobalInfoService globalInfoService) {\n this.globalInfoService = globalInfoService;\n }\n\n @ReadOperation\n public Mono globalInfo() {\n return globalInfoService.getGlobalInfo();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/actuator/GlobalInfoService.java", "content": "package run.halo.app.infra.actuator;\n\nimport reactor.core.publisher.Mono;\n\n/**\n * Global info service.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface GlobalInfoService {\n\n /**\n * Get global info.\n *\n * @return global info\n */\n Mono getGlobalInfo();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/actuator/GlobalInfoServiceImpl.java", "content": "package run.halo.app.infra.actuator;\n\nimport java.util.ArrayList;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.TimeZone;\nimport lombok.RequiredArgsConstructor;\nimport org.reactivestreams.Publisher;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.stereotype.Service;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n/**\n * Global info service implementation.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Service\n@RequiredArgsConstructor\npublic class GlobalInfoServiceImpl implements GlobalInfoService {\n\n private final ObjectProvider systemConfigFetcher;\n\n private final ExternalUrlSupplier externalUrl;\n\n @Override\n public Mono getGlobalInfo() {\n final var info = new GlobalInfo();\n info.setExternalUrl(externalUrl.getRaw());\n info.setLocale(Locale.getDefault());\n info.setTimeZone(TimeZone.getDefault());\n\n var publishers = new ArrayList>(1);\n publishers.add(handleSettings(info));\n return Mono.when(publishers).then(Mono.just(info));\n }\n\n private Mono handleSettings(GlobalInfo info) {\n return Optional.ofNullable(systemConfigFetcher.getIfUnique())\n .map(fetcher -> fetcher.getConfig()\n .doOnNext(config -> {\n handleCommentSetting(info, config);\n handleUserSetting(info, config);\n handleBasicSetting(info, config);\n handlePostSlugGenerationStrategy(info, config);\n })\n .then()\n )\n .orElseGet(Mono::empty);\n }\n\n private void handleCommentSetting(GlobalInfo info, Map config) {\n var comment =\n SystemSetting.get(config, SystemSetting.Comment.GROUP, SystemSetting.Comment.class);\n if (comment == null) {\n info.setAllowAnonymousComments(true);\n } else {\n info.setAllowAnonymousComments(\n comment.getSystemUserOnly() == null || !comment.getSystemUserOnly());\n }\n }\n\n private void handleUserSetting(GlobalInfo info, Map config) {\n var userSetting =\n SystemSetting.get(config, SystemSetting.User.GROUP, SystemSetting.User.class);\n if (userSetting == null) {\n info.setAllowRegistration(false);\n info.setMustVerifyEmailOnRegistration(false);\n } else {\n info.setAllowRegistration(userSetting.isAllowRegistration());\n info.setMustVerifyEmailOnRegistration(userSetting.isMustVerifyEmailOnRegistration());\n }\n }\n\n private void handlePostSlugGenerationStrategy(GlobalInfo info, Map config) {\n var post = SystemSetting.get(config, SystemSetting.Post.GROUP, SystemSetting.Post.class);\n if (post != null) {\n info.setPostSlugGenerationStrategy(post.getSlugGenerationStrategy());\n }\n }\n\n private void handleBasicSetting(GlobalInfo info, Map config) {\n var basic = SystemSetting.get(config, SystemSetting.Basic.GROUP, SystemSetting.Basic.class);\n if (basic != null) {\n info.setFavicon(basic.getFavicon());\n info.setSiteTitle(basic.getTitle());\n basic.useSystemLocale().ifPresent(info::setLocale);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/actuator/RestartEndpoint.java", "content": "package run.halo.app.infra.actuator;\n\nimport java.io.Closeable;\nimport java.io.IOException;\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.boot.SpringApplication;\nimport org.springframework.boot.actuate.endpoint.annotation.WriteOperation;\nimport org.springframework.boot.actuate.endpoint.web.annotation.WebEndpoint;\nimport org.springframework.boot.context.event.ApplicationStartedEvent;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.context.ConfigurableApplicationContext;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.Application;\n\n@WebEndpoint(id = \"restart\")\n@Component\n@Slf4j\nclass RestartEndpoint implements ApplicationListener {\n\n private SpringApplication application;\n\n private String[] args;\n\n private ConfigurableApplicationContext context;\n\n @WriteOperation\n public Mono> restart() {\n return Mono.fromSupplier(() -> {\n var threadGroup = new ThreadGroup(\"RestartGroup\");\n var thread = new Thread(threadGroup, this::doRestart, \"restartMain\");\n thread.setDaemon(false);\n thread.setContextClassLoader(Application.class.getClassLoader());\n thread.start();\n return Map.of(\"message\", \"Restarting\");\n });\n }\n\n private synchronized void doRestart() {\n log.info(\"Restarting...\");\n if (this.context != null) {\n try {\n closeRecursively(this.context);\n var shutdownHandlers = SpringApplication.getShutdownHandlers();\n if (shutdownHandlers instanceof Runnable runnable) {\n // clear closedContext in org.springframework.boot.SpringApplicationShutdownHook\n runnable.run();\n }\n this.context = this.application.run(args);\n log.info(\"Restarted\");\n } catch (Throwable t) {\n log.error(\"Failed to restart.\", t);\n }\n }\n }\n\n private static void closeRecursively(ApplicationContext ctx) {\n while (ctx != null) {\n if (ctx instanceof Closeable closeable) {\n try {\n closeable.close();\n } catch (IOException e) {\n log.error(\"Cannot close context: {}\", ctx.getId(), e);\n }\n }\n ctx = ctx.getParent();\n }\n }\n\n @Override\n public void onApplicationEvent(ApplicationStartedEvent event) {\n if (this.context == null) {\n this.application = event.getSpringApplication();\n this.args = event.getArgs();\n this.context = event.getApplicationContext();\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/ExtensionConfiguration.java", "content": "package run.halo.app.infra.config;\n\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.DefaultControllerManager;\n\n@Configuration(proxyBeanMethods = false)\npublic class ExtensionConfiguration {\n\n @Bean\n @ConditionalOnProperty(\n name = \"halo.extension.controller.disabled\",\n havingValue = \"false\",\n matchIfMissing = true\n )\n DefaultControllerManager controllerManager(ExtensionClient client) {\n return new DefaultControllerManager(client);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/HaloConfiguration.java", "content": "package run.halo.app.infra.config;\n\nimport static com.fasterxml.jackson.annotation.JsonInclude.Include.NON_NULL;\n\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport java.io.IOException;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;\nimport org.springframework.boot.jackson.autoconfigure.JsonMapperBuilderCustomizer;\nimport org.springframework.cache.annotation.EnableCaching;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.scheduling.annotation.EnableAsync;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.search.lucene.LuceneSearchEngine;\nimport tools.jackson.databind.MapperFeature;\n\n@EnableCaching\n@Configuration(proxyBeanMethods = false)\n@EnableAsync\npublic class HaloConfiguration {\n\n @Bean\n JsonMapperBuilderCustomizer objectMapperCustomizer(\n ObjectProvider objectMapperProvider\n ) {\n return builder -> {\n builder.changeDefaultPropertyInclusion(v ->\n v.withValueInclusion(NON_NULL).withContentInclusion(NON_NULL)\n );\n builder.enable(MapperFeature.ACCEPT_CASE_INSENSITIVE_ENUMS);\n builder.addModule(\n new JacksonAdapterModule(objectMapperProvider::getIfAvailable)\n );\n };\n }\n\n @Bean\n @ConditionalOnProperty(prefix = \"halo.search-engine.lucene\", name = \"enabled\",\n havingValue = \"true\",\n matchIfMissing = true)\n LuceneSearchEngine luceneSearchEngine(HaloProperties haloProperties) throws IOException {\n return new LuceneSearchEngine(haloProperties.getWorkDir()\n .resolve(\"indices\")\n .resolve(\"halo\"));\n }\n}" }, { "path": "application/src/main/java/run/halo/app/infra/config/JacksonAdapterModule.java", "content": "package run.halo.app.infra.config;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport com.github.fge.jsonpatch.JsonPatch;\nimport java.util.function.Supplier;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.JsonExtension;\nimport tools.jackson.core.JacksonException;\nimport tools.jackson.core.JsonGenerator;\nimport tools.jackson.core.JsonParser;\nimport tools.jackson.core.Version;\nimport tools.jackson.databind.DeserializationContext;\nimport tools.jackson.databind.SerializationContext;\nimport tools.jackson.databind.ValueDeserializer;\nimport tools.jackson.databind.ValueSerializer;\nimport tools.jackson.databind.exc.InvalidFormatException;\nimport tools.jackson.databind.exc.JsonNodeException;\nimport tools.jackson.databind.module.SimpleModule;\n\n/**\n * Jackson module to adapt legacy {@link JsonNode} serialization and deserialization.\n * This module makes sure the plugin system using legacy Jackson can correctly\n *\n * @author johnniang\n * @since 2.23.0\n */\npublic class JacksonAdapterModule extends SimpleModule {\n\n private final Supplier objectMapper;\n\n public JacksonAdapterModule(Supplier objectMapper) {\n super(JacksonAdapterModule.class.getSimpleName(), new Version(1, 0, 0, null, null, null));\n this.objectMapper = objectMapper;\n addSerializer(new JsonNodeSerializer());\n addSerializer(new JsonPatchSerializer());\n addSerializer(new JsonExtensionSerializer());\n\n addDeserializer(JsonNode.class, new JsonNodeDeserializer<>(JsonNode.class));\n addDeserializer(ObjectNode.class, new JsonNodeDeserializer<>(ObjectNode.class));\n addDeserializer(JsonExtension.class, new JsonExtensionDeSerializer());\n }\n\n class JsonExtensionDeSerializer extends ValueDeserializer {\n\n @Override\n public JsonExtension deserialize(JsonParser p,\n DeserializationContext ctxt) throws JacksonException {\n var json = p.readValueAsTree().toString();\n try {\n return objectMapper.get().readValue(json, JsonExtension.class);\n } catch (JsonProcessingException e) {\n throw InvalidFormatException.from(p, \"Failed to deserialize JsonExtension\");\n }\n }\n\n }\n\n class JsonExtensionSerializer extends ValueSerializer {\n\n @Override\n public void serialize(JsonExtension value, JsonGenerator gen,\n SerializationContext ctxt) throws JacksonException {\n try {\n var raw = objectMapper.get().writeValueAsString(value);\n gen.writeRawValue(raw);\n } catch (JsonProcessingException e) {\n throw InvalidFormatException.from(gen, \"Failed to serialize JsonExtension\");\n }\n }\n\n @Override\n public Class handledType() {\n return JsonExtension.class;\n }\n }\n\n class JsonPatchSerializer extends ValueSerializer {\n\n @Override\n public void serialize(JsonPatch value, JsonGenerator gen,\n SerializationContext ctxt)\n throws JacksonException {\n try {\n gen.writeRawValue(objectMapper.get().writeValueAsString(value));\n } catch (JsonProcessingException e) {\n throw InvalidFormatException.from(gen, \"Failed to serialize JsonPatch\");\n }\n }\n\n @Override\n public Class handledType() {\n return JsonPatch.class;\n }\n\n }\n\n class JsonNodeSerializer extends ValueSerializer {\n\n @Override\n public void serialize(JsonNode value, JsonGenerator gen,\n SerializationContext ctxt)\n throws JacksonException {\n try {\n gen.writeRawValue(objectMapper.get().writeValueAsString(value));\n } catch (JsonProcessingException e) {\n throw InvalidFormatException.from(gen, \"Failed to serialize JsonNode\");\n }\n }\n\n @Override\n public Class handledType() {\n return JsonNode.class;\n }\n\n }\n\n class JsonNodeDeserializer\n extends ValueDeserializer {\n\n private final Class type;\n\n JsonNodeDeserializer(Class type) {\n this.type = type;\n }\n\n @Override\n public T deserialize(JsonParser p, DeserializationContext ctxt) throws JacksonException {\n var json = p.readValueAsTree().toString();\n var mapper = objectMapper.get();\n Assert.notNull(mapper, \"Legacy ObjectMapper must not be null\");\n try {\n return mapper.readValue(json, type);\n } catch (JsonProcessingException e) {\n throw JsonNodeException.from(\n p, \"Failed to bridge legacy JSON node\", e\n );\n }\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/R2dbcConfiguration.java", "content": "package run.halo.app.infra.config;\n\nimport org.springframework.beans.BeansException;\nimport org.springframework.beans.factory.config.BeanPostProcessor;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.data.r2dbc.mapping.R2dbcMappingContext;\n\n@Configuration(proxyBeanMethods = false)\nclass R2dbcConfiguration {\n\n /**\n * Modify R2DBC Mapping Context to disable force quote.\n *\n *

\n * In Spring Boot 4, the default\n * behavior is changed to enable force quote, which may cause issues with existing database\n * schemas that do not use quoted identifiers.\n *\n *

\n * See\n * this issue\n * for more details.\n *\n *

\n * Use static method to ensure that the BeanPostProcessor is registered before any\n * R2dbcMappingContext beans are initialized.\n *\n * @return the bean post processor\n */\n @Bean\n static BeanPostProcessor r2dbcMappingContextQuoteModifier() {\n return new BeanPostProcessor() {\n @Override\n public Object postProcessBeforeInitialization(Object bean, String beanName)\n throws BeansException {\n if (bean instanceof R2dbcMappingContext mappingContext) {\n mappingContext.setForceQuote(false);\n }\n return bean;\n }\n };\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/SessionConfiguration.java", "content": "package run.halo.app.infra.config;\n\nimport java.util.Optional;\nimport java.util.concurrent.ConcurrentHashMap;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;\nimport org.springframework.boot.session.autoconfigure.SessionProperties;\nimport org.springframework.boot.web.server.autoconfigure.ServerProperties;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.session.ReactiveFindByIndexNameSessionRepository;\nimport org.springframework.session.ReactiveSessionRepository;\nimport org.springframework.session.Session;\nimport org.springframework.session.config.annotation.web.server.EnableSpringWebSession;\nimport org.springframework.session.security.SpringSessionBackedReactiveSessionRegistry;\nimport run.halo.app.security.session.InMemoryReactiveIndexedSessionRepository;\nimport run.halo.app.security.session.ReactiveIndexedSessionRepository;\n\n/**\n * Configuration for Spring Web Session.\n *\n * @param the type of Session\n * @author johnniang\n * @since 2.22.11\n */\n@Configuration\n@EnableSpringWebSession\nclass SessionConfiguration {\n\n @Bean\n SpringSessionBackedReactiveSessionRegistry reactiveSessionRegistry(\n ReactiveSessionRepository sessionRepository,\n ReactiveFindByIndexNameSessionRepository indexedSessionRepository\n ) {\n return new SpringSessionBackedReactiveSessionRegistry<>(\n sessionRepository, indexedSessionRepository\n );\n }\n\n @Configuration\n @ConditionalOnProperty(\n value = \"halo.session.store-type\", havingValue = \"in-memory\", matchIfMissing = true\n )\n static class InMemorySessionConfig {\n\n @Bean\n ReactiveIndexedSessionRepository inMemorySessionRepository(\n SessionProperties sessionProperties, ServerProperties serverProperties\n ) {\n var repository =\n new InMemoryReactiveIndexedSessionRepository(new ConcurrentHashMap<>());\n var timeout = Optional.ofNullable(sessionProperties.getTimeout())\n .orElseGet(() -> serverProperties.getReactive().getSession().getTimeout());\n repository.setDefaultMaxInactiveInterval(timeout);\n return repository;\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/SwaggerConfig.java", "content": "package run.halo.app.infra.config;\n\nimport static org.springdoc.core.utils.Constants.SPRINGDOC_ENABLED;\n\nimport io.swagger.v3.core.converter.ModelConverter;\nimport io.swagger.v3.core.jackson.ModelResolver;\nimport io.swagger.v3.core.jackson.TypeNameResolver;\nimport io.swagger.v3.oas.models.Components;\nimport io.swagger.v3.oas.models.OpenAPI;\nimport io.swagger.v3.oas.models.info.Info;\nimport io.swagger.v3.oas.models.security.SecurityRequirement;\nimport io.swagger.v3.oas.models.security.SecurityScheme;\nimport java.util.Set;\nimport org.springdoc.core.customizers.GlobalOpenApiCustomizer;\nimport org.springdoc.core.models.GroupedOpenApi;\nimport org.springdoc.core.properties.SpringDocConfigProperties;\nimport org.springdoc.core.providers.ObjectMapperProvider;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnWebApplication;\nimport org.springframework.boot.info.BuildProperties;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport run.halo.app.extension.router.JsonPatch;\n\n@Configuration\n@ConditionalOnProperty(name = SPRINGDOC_ENABLED, matchIfMissing = true)\n@ConditionalOnWebApplication\npublic class SwaggerConfig {\n\n @Bean\n OpenAPI haloOpenApi(ObjectProvider buildPropertiesProvider,\n SpringDocConfigProperties docConfigProperties) {\n var buildProperties = buildPropertiesProvider.getIfAvailable();\n var version = \"unknown\";\n if (buildProperties != null) {\n version = buildProperties.getVersion();\n }\n return new OpenAPI()\n .specVersion(docConfigProperties.getSpecVersion())\n // See https://swagger.io/docs/specification/authentication/ for more.\n .components(new Components()\n .addSecuritySchemes(\"basicAuth\", new SecurityScheme()\n .type(SecurityScheme.Type.HTTP)\n .scheme(\"basic\"))\n .addSecuritySchemes(\"bearerAuth\", new SecurityScheme()\n .type(SecurityScheme.Type.HTTP)\n .scheme(\"bearer\")\n .bearerFormat(\"JWT\"))\n )\n .addSecurityItem(new SecurityRequirement()\n .addList(\"basicAuth\")\n .addList(\"bearerAuth\"))\n .info(new Info()\n .title(\"Halo\")\n .version(version)\n );\n }\n\n @Bean\n GlobalOpenApiCustomizer openApiCustomizer() {\n return openApi -> JsonPatch.addSchema(openApi.getComponents());\n }\n\n @Bean\n GroupedOpenApi aggregatedV1alpha1Api() {\n return GroupedOpenApi.builder()\n .group(\"apis_aggregated.api_v1alpha1\")\n .displayName(\"Aggregated API V1alpha1\")\n .pathsToMatch(\n \"/apis/*/v1alpha1/**\",\n \"/api/v1alpha1/**\",\n \"/login/**\",\n \"/system/setup\"\n )\n .build();\n }\n\n @Bean\n GroupedOpenApi publicV1alpha1Api() {\n return GroupedOpenApi.builder()\n .group(\"apis_public.api_v1alpha1\")\n .displayName(\"Public API V1alpha1\")\n .pathsToMatch(\n \"/apis/api.*/**\"\n )\n .pathsToExclude(\n \"/apis/api.console.*/v1alpha1/**\",\n // compatible with legacy issues\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/**\",\n \"/apis/api.notification.halo.run/v1alpha1/notifiers/**\"\n )\n .build();\n }\n\n @Bean\n GroupedOpenApi consoleV1alpha1Api() {\n return GroupedOpenApi.builder()\n .group(\"apis_console.api_v1alpha1\")\n .displayName(\"Console API V1alpha1\")\n .pathsToMatch(\n \"/apis/console.api.*/v1alpha1/**\",\n \"/apis/api.console.halo.run/v1alpha1/**\"\n )\n .build();\n }\n\n\n @Bean\n GroupedOpenApi ucV1alpha1Api() {\n return GroupedOpenApi.builder()\n .group(\"apis_uc.api_v1alpha1\")\n .displayName(\"User-center API V1alpha1\")\n .pathsToMatch(\n \"/apis/uc.api.*/v1alpha1/**\",\n // compatible with legacy issues\n \"/apis/api.notification.halo.run/v1alpha1/userspaces/**\",\n \"/apis/api.notification.halo.run/v1alpha1/notifiers/**\"\n )\n .build();\n }\n\n\n @Bean\n GroupedOpenApi extensionV1alpha1Api() {\n return GroupedOpenApi.builder()\n .group(\"apis_extension.api_v1alpha1\")\n .displayName(\"Extension API V1alpha1\")\n .pathsToMatch(\n \"/api/v1alpha1/**\",\n \"/apis/content.halo.run/v1alpha1/**\",\n \"/apis/theme.halo.run/v1alpha1/**\",\n \"/apis/security.halo.run/v1alpha1/**\",\n \"/apis/migration.halo.run/v1alpha1/**\",\n \"/apis/auth.halo.run/v1alpha1/**\",\n \"/apis/metrics.halo.run/v1alpha1/**\",\n \"/apis/storage.halo.run/v1alpha1/**\",\n \"/apis/plugin.halo.run/v1alpha1/**\",\n \"/apis/notification.halo.run/**\",\n \"/apis/migration.halo.run/**\"\n )\n .build();\n }\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE)\n ModelConverter customModelConverter(ObjectMapperProvider objectMapperProvider) {\n return new ModelResolver(objectMapperProvider.jsonMapper(), new CustomTypeNameResolver());\n }\n\n static class CustomTypeNameResolver extends TypeNameResolver {\n @Override\n protected String nameForClass(Class cls, Set options) {\n // Obey the rule of keys that match the regular expression ^[a-zA-Z0-9\\.\\-_]+$.\n // See https://spec.openapis.org/oas/v3.0.3#fixed-fields-5 for more.\n return super.nameForClass(cls, options).replaceAll(\"\\\\$\", \".\");\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/WebFluxConfig.java", "content": "package run.halo.app.infra.config;\n\nimport static org.springframework.util.ResourceUtils.FILE_URL_PREFIX;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\nimport static run.halo.app.infra.utils.FileUtils.checkDirectoryTraversal;\n\nimport java.util.List;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.boot.webflux.autoconfigure.WebFluxRegistrations;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.CacheControl;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.CodecConfigurer;\nimport org.springframework.http.codec.HttpMessageWriter;\nimport org.springframework.http.codec.ServerCodecConfigurer;\nimport org.springframework.http.codec.json.JacksonJsonDecoder;\nimport org.springframework.http.codec.json.JacksonJsonEncoder;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.filter.reactive.ServerWebExchangeContextFilter;\nimport org.springframework.web.filter.reactive.UrlHandlerFilter;\nimport org.springframework.web.reactive.config.ResourceHandlerRegistration;\nimport org.springframework.web.reactive.config.ResourceHandlerRegistry;\nimport org.springframework.web.reactive.config.WebFluxConfigurer;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.reactive.resource.EncodedResourceResolver;\nimport org.springframework.web.reactive.resource.PathResourceResolver;\nimport org.springframework.web.reactive.result.method.annotation.RequestMappingHandlerAdapter;\nimport org.springframework.web.reactive.result.view.ViewResolutionResultHandler;\nimport org.springframework.web.reactive.result.view.ViewResolver;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.thumbnail.LocalThumbnailService;\nimport run.halo.app.core.attachment.thumbnail.ThumbnailResourceTransformer;\nimport run.halo.app.core.endpoint.WebSocketHandlerMapping;\nimport run.halo.app.core.endpoint.console.CustomEndpointsBuilder;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.infra.SecureRequestMappingHandlerAdapter;\nimport run.halo.app.infra.properties.AttachmentProperties;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.ui.ProxyFilter;\nimport run.halo.app.infra.ui.WebSocketRequestPredicate;\nimport run.halo.app.infra.webfilter.AdditionalWebFilterChainProxy;\nimport run.halo.app.infra.webfilter.LocaleChangeWebFilter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.UserLocaleRequestAttributeWriteFilter;\nimport tools.jackson.databind.json.JsonMapper;\n\n@Configuration\n@RequiredArgsConstructor\npublic class WebFluxConfig implements WebFluxConfigurer {\n\n private final JsonMapper jsonMapper;\n\n private final HaloProperties haloProp;\n\n private final WebProperties webProperties;\n\n private final ApplicationContext applicationContext;\n\n private final LocalThumbnailService localThumbnailService;\n\n private final AttachmentRootGetter attachmentRootGetter;\n\n @Bean\n WebFluxRegistrations webFluxRegistrations() {\n return new WebFluxRegistrations() {\n @Override\n public RequestMappingHandlerAdapter getRequestMappingHandlerAdapter() {\n // Because we have no chance to customize ServerWebExchangeMethodArgumentResolver,\n // we have to use SecureRequestMappingHandlerAdapter to replace a secure\n // ServerWebExchange.\n return new SecureRequestMappingHandlerAdapter();\n }\n };\n }\n\n @Bean\n ServerResponse.Context context(CodecConfigurer codec,\n ViewResolutionResultHandler resultHandler) {\n return new ServerResponse.Context() {\n @Override\n @NonNull\n public List> messageWriters() {\n return codec.getWriters();\n }\n\n @Override\n @NonNull\n public List viewResolvers() {\n return resultHandler.getViewResolvers();\n }\n };\n }\n\n @Override\n public void configureHttpMessageCodecs(ServerCodecConfigurer configurer) {\n // we need to customize the Jackson2Json[Decoder][Encoder] here to serialize and\n // deserialize special types, e.g.: Instant, LocalDateTime. So we use ObjectMapper\n // created by outside.\n configurer.defaultCodecs().jacksonJsonDecoder(new JacksonJsonDecoder(jsonMapper));\n configurer.defaultCodecs().jacksonJsonEncoder(new JacksonJsonEncoder(jsonMapper));\n }\n\n @Bean\n RouterFunction customEndpoints(ApplicationContext context) {\n var builder = new CustomEndpointsBuilder();\n context.getBeansOfType(CustomEndpoint.class).values().forEach(builder::add);\n return builder.build();\n }\n\n @Bean\n public WebSocketHandlerMapping webSocketHandlerMapping() {\n WebSocketHandlerMapping handlerMapping = new WebSocketHandlerMapping();\n handlerMapping.setOrder(-2);\n return handlerMapping;\n }\n\n @Bean\n RouterFunction uiPageEndpoints() {\n var consolePagePredicate = path(\"/console/**\")\n .and(accept(MediaType.TEXT_HTML))\n .and(new WebSocketRequestPredicate().negate());\n\n var ucPagePredicate = path(\"/uc/**\")\n .and(accept(MediaType.TEXT_HTML))\n .and(new WebSocketRequestPredicate().negate());\n\n var consolePageHtml = applicationContext.getResource(\"classpath:/ui/console.html\");\n\n var ucPageHtml = applicationContext.getResource(\"classpath:/ui/uc.html\");\n\n return RouterFunctions.route()\n .GET(consolePagePredicate,\n request -> ServerResponse.ok()\n .cacheControl(CacheControl.noStore())\n .bodyValue(consolePageHtml)\n )\n .GET(ucPagePredicate,\n request -> ServerResponse.ok()\n .cacheControl(CacheControl.noStore())\n .bodyValue(ucPageHtml)\n )\n .build();\n }\n\n @Override\n public void addResourceHandlers(ResourceHandlerRegistry registry) {\n var attachmentsRoot = attachmentRootGetter.get();\n var resourceProperties = webProperties.getResources();\n var cacheControl = resourceProperties.getCache()\n .getCachecontrol()\n .toHttpCacheControl();\n if (cacheControl == null) {\n cacheControl = CacheControl.empty();\n }\n final var useLastModified = resourceProperties.getCache().isUseLastModified();\n\n // Mandatory resource mapping\n var uploadRegistration = registry.addResourceHandler(\"/upload/**\")\n .addResourceLocations(FILE_URL_PREFIX + attachmentsRoot.resolve(\"upload\") + \"/\")\n .setUseLastModified(useLastModified)\n .setCacheControl(cacheControl);\n\n registry.addResourceHandler(\"/ui-assets/**\")\n .addResourceLocations(\"classpath:/ui/ui-assets/\")\n .setCacheControl(cacheControl)\n .setUseLastModified(useLastModified)\n .resourceChain(true)\n .addResolver(new EncodedResourceResolver())\n .addResolver(new PathResourceResolver());\n\n // Additional resource mappings\n var staticResources = haloProp.getAttachment().getResourceMappings();\n for (AttachmentProperties.ResourceMapping staticResource : staticResources) {\n ResourceHandlerRegistration registration;\n if (Objects.equals(staticResource.getPathPattern(), \"/upload/**\")) {\n registration = uploadRegistration;\n } else {\n registration = registry.addResourceHandler(staticResource.getPathPattern())\n .setCacheControl(cacheControl)\n .setUseLastModified(useLastModified);\n }\n for (String location : staticResource.getLocations()) {\n var path = attachmentsRoot.resolve(location);\n checkDirectoryTraversal(attachmentsRoot, path);\n registration.addResourceLocations(FILE_URL_PREFIX + path + \"/\");\n }\n if (registration != uploadRegistration) {\n applyThumbnailChain(registration);\n }\n }\n applyThumbnailChain(uploadRegistration);\n\n var haloStaticPath = haloProp.getWorkDir().resolve(\"static\");\n registry.addResourceHandler(\"/**\")\n .addResourceLocations(FILE_URL_PREFIX + haloStaticPath + \"/\")\n .addResourceLocations(resourceProperties.getStaticLocations())\n .setCacheControl(cacheControl)\n .setUseLastModified(useLastModified)\n .resourceChain(true)\n .addResolver(new EncodedResourceResolver())\n .addResolver(new PathResourceResolver());\n }\n\n private void applyThumbnailChain(ResourceHandlerRegistration registration) {\n registration.resourceChain(false)\n .addTransformer(\n new ThumbnailResourceTransformer(localThumbnailService)\n );\n }\n\n /**\n * Order of this filter is higher than\n * {@link LocaleChangeWebFilter} to allow change locale in dev\n * mode.\n * {@link UserLocaleRequestAttributeWriteFilter} is before {@link LocaleChangeWebFilter} to\n * obtain the locale\n */\n @ConditionalOnProperty(name = \"halo.ui.proxy.enabled\", havingValue = \"true\")\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE + 2)\n ProxyFilter uiProxyFilter() {\n return new ProxyFilter(haloProp.getUi().getProxy(), \"/console/**\", \"/uc/**\");\n }\n\n /**\n * Create a WebFilterChainProxy for all AdditionalWebFilters.\n *\n *

The reason why the order is -101 is that the current\n * AdditionalWebFilterChainProxy should be executed before WebFilterChainProxy\n * and the order of WebFilterChainProxy is -100.\n *\n *

See {@code org.springframework.security.config.annotation.web.reactive\n * .WebFluxSecurityConfiguration#WEB_FILTER_CHAIN_FILTER_ORDER} for more\n *\n * @param extensionGetter extension getter.\n * @return additional web filter chain proxy.\n */\n @Bean\n @Order(-101)\n AdditionalWebFilterChainProxy additionalWebFilterChainProxy(ExtensionGetter extensionGetter) {\n return new AdditionalWebFilterChainProxy(extensionGetter);\n }\n\n @Bean\n // We expect this filter to be executed before AdditionalWebFilterChainProxy\n @Order(-102)\n ServerWebExchangeContextFilter serverWebExchangeContextFilter() {\n return new ServerWebExchangeContextFilter();\n }\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE)\n UrlHandlerFilter urlHandlerFilter() {\n return UrlHandlerFilter\n .trailingSlashHandler(\"/**\").mutateRequest()\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/config/WebServerSecurityConfig.java", "content": "package run.halo.app.infra.config;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport java.util.HashMap;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.security.config.annotation.method.configuration.EnableReactiveMethodSecurity;\nimport org.springframework.security.config.annotation.web.reactive.EnableWebFluxSecurity;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.crypto.argon2.Argon2PasswordEncoder;\nimport org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;\nimport org.springframework.security.crypto.password.DelegatingPasswordEncoder;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.security.web.server.SecurityWebFilterChain;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.security.web.server.context.WebSessionServerSecurityContextRepository;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.NegatedServerWebExchangeMatcher;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.security.DefaultUserDetailService;\nimport run.halo.app.security.HaloServerRequestCache;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.security.authentication.impl.RsaKeyService;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n/**\n * Security configuration for WebFlux.\n *\n * @author johnniang\n */\n@Configuration\n@EnableWebFluxSecurity\n@EnableReactiveMethodSecurity\n@RequiredArgsConstructor\npublic class WebServerSecurityConfig {\n\n @Bean\n SecurityWebFilterChain filterChain(ServerHttpSecurity http,\n ObjectProvider securityConfigurers,\n ServerSecurityContextRepository securityContextRepository,\n HaloProperties haloProperties,\n ServerRequestCache serverRequestCache) {\n\n var pathMatcher = pathMatchers(\"/**\");\n var staticResourcesMatcher = pathMatchers(HttpMethod.GET,\n \"/console/assets/**\",\n \"/uc/assets/**\",\n \"/themes/{themeName}/assets/{*resourcePaths}\",\n \"/plugins/{pluginName}/assets/**\",\n \"/webjars/**\",\n \"/js/**\",\n \"/styles/**\",\n \"/halo-tracker.js\",\n \"/images/**\"\n );\n\n var securityMatcher = new AndServerWebExchangeMatcher(pathMatcher,\n new NegatedServerWebExchangeMatcher(staticResourcesMatcher));\n\n http.securityMatcher(securityMatcher)\n .anonymous(spec -> {\n spec.authorities(AuthorityUtils.ROLE_PREFIX + AnonymousUserConst.Role);\n spec.principal(AnonymousUserConst.PRINCIPAL);\n })\n .securityContextRepository(securityContextRepository)\n .httpBasic(basic -> {\n if (haloProperties.getSecurity().getBasicAuth().isDisabled()) {\n basic.disable();\n }\n })\n .headers(headerSpec -> headerSpec\n .frameOptions(frameSpec -> {\n var frameOptions = haloProperties.getSecurity().getFrameOptions();\n frameSpec.mode(frameOptions.getMode());\n if (frameOptions.isDisabled()) {\n frameSpec.disable();\n }\n })\n .referrerPolicy(referrerPolicySpec -> referrerPolicySpec.policy(\n haloProperties.getSecurity().getReferrerOptions().getPolicy())\n )\n .hsts(hstsSpec -> hstsSpec.includeSubdomains(false))\n )\n .requestCache(spec -> spec.requestCache(serverRequestCache));\n\n // Integrate with other configurers separately\n securityConfigurers.orderedStream()\n .forEach(securityConfigurer -> securityConfigurer.configure(http));\n return http.build();\n }\n\n @Bean\n ServerRequestCache serverRequestCache() {\n return new HaloServerRequestCache();\n }\n\n @Bean\n ServerSecurityContextRepository securityContextRepository() {\n return new WebSessionServerSecurityContextRepository();\n }\n\n @Bean\n DefaultUserDetailService userDetailsService(UserService userService,\n RoleService roleService,\n HaloProperties haloProperties) {\n var userDetailService = new DefaultUserDetailService(userService, roleService);\n var twoFactorAuthDisabled = haloProperties.getSecurity().getTwoFactorAuth().isDisabled();\n userDetailService.setTwoFactorAuthDisabled(twoFactorAuthDisabled);\n return userDetailService;\n }\n\n @Bean\n @SuppressWarnings(\"deprecation\")\n PasswordEncoder passwordEncoder() {\n // For removing the length limit of password, we have to create an argon2 password encoder\n // as default encoder.\n // When https://github.com/spring-projects/spring-security/issues/16879 resolved,\n // we can remove this code.\n var encodingId = \"argon2@SpringSecurity_v5_8\";\n var encoders = new HashMap();\n encoders.put(encodingId, Argon2PasswordEncoder.defaultsForSpringSecurity_v5_8());\n encoders.put(\"bcrypt\", new BCryptPasswordEncoder());\n return new DelegatingPasswordEncoder(encodingId, encoders);\n }\n\n @Bean\n CryptoService cryptoService(HaloProperties haloProperties) {\n return new RsaKeyService(haloProperties.getWorkDir().resolve(\"keys\"));\n }\n\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/AccessDeniedException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\n/**\n * AccessDeniedException will resolve i18n message and response 403 status.\n *\n * @author johnniang\n */\npublic class AccessDeniedException extends ResponseStatusException {\n\n public AccessDeniedException() {\n this(\"Access to the resource is forbidden\");\n }\n\n public AccessDeniedException(String reason) {\n this(reason, null, null);\n }\n\n public AccessDeniedException(String reason, String detailCode, Object[] detailArgs) {\n super(HttpStatus.FORBIDDEN, reason, null, detailCode, detailArgs);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/AttachmentAlreadyExistsException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * AttachmentAlreadyExistsException accepts filename parameter as detail message arguments.\n *\n * @author johnniang\n */\npublic class AttachmentAlreadyExistsException extends ServerWebInputException {\n\n public AttachmentAlreadyExistsException(String filename) {\n super(\"File \" + filename + \" already exists.\", null, null, null, new Object[] {filename});\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/DuplicateNameException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\npublic class DuplicateNameException extends ResponseStatusException {\n\n public DuplicateNameException() {\n this(\"Duplicate name detected\");\n }\n\n public DuplicateNameException(String reason) {\n this(reason, null);\n }\n\n public DuplicateNameException(String reason, Throwable cause) {\n this(reason, cause, null, null);\n }\n\n public DuplicateNameException(String reason, Throwable cause, String messageDetailCode,\n Object[] messageDetailArguments) {\n super(HttpStatus.BAD_REQUEST, reason, cause, messageDetailCode, messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/EmailAlreadyTakenException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Exception thrown when email is already verified and taken.\n *\n * @author johnniang\n */\npublic class EmailAlreadyTakenException extends ServerWebInputException {\n\n public static final URI TYPE = URI.create(\"https://halo.run/errors/email-already-taken\");\n\n public EmailAlreadyTakenException(String reason) {\n super(reason);\n setType(TYPE);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/EmailVerificationFailed.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Exception thrown when email verification failed.\n *\n * @author guqing\n * @since 2.11.0\n */\npublic class EmailVerificationFailed extends ServerWebInputException {\n\n public EmailVerificationFailed() {\n super(\"Invalid verification code\");\n }\n\n public EmailVerificationFailed(String reason, @Nullable Throwable cause) {\n super(reason, null, cause);\n }\n\n public EmailVerificationFailed(String reason, @Nullable Throwable cause,\n @Nullable String messageDetailCode, @Nullable Object[] messageDetailArguments) {\n super(reason, null, cause, messageDetailCode, messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/Exceptions.java", "content": "package run.halo.app.infra.exception;\n\nimport static org.springframework.core.annotation.MergedAnnotations.SearchStrategy.TYPE_HIERARCHY;\n\nimport io.github.resilience4j.ratelimiter.RequestNotPermitted;\nimport java.net.URI;\nimport java.time.Instant;\nimport java.util.Locale;\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.MessageSource;\nimport org.springframework.core.annotation.MergedAnnotations;\nimport org.springframework.dao.ConcurrencyFailureException;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.HttpStatusCode;\nimport org.springframework.http.ProblemDetail;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.web.ErrorResponse;\nimport org.springframework.web.bind.annotation.ResponseStatus;\nimport org.springframework.web.server.ServerWebExchange;\n\n@Slf4j\npublic enum Exceptions {\n ;\n\n public static final String DEFAULT_TYPE = \"about:blank\";\n\n public static final String THEME_ALREADY_EXISTS_TYPE =\n \"https://halo.run/probs/theme-alreay-exists\";\n\n public static final String INVALID_CREDENTIAL_TYPE =\n \"https://halo.run/probs/invalid-credential\";\n\n public static final String REQUEST_NOT_PERMITTED_TYPE =\n \"https://halo.run/probs/request-not-permitted\";\n\n public static final String CONFLICT_TYPE =\n \"https://halo.run/probs/conflict\";\n\n /**\n * Non-ErrorResponse exception to type map.\n */\n public static final Map, String> EXCEPTION_TYPE_MAP = Map.of(\n RequestNotPermitted.class, REQUEST_NOT_PERMITTED_TYPE,\n BadCredentialsException.class, INVALID_CREDENTIAL_TYPE\n );\n\n public static ErrorResponse createErrorResponse(Throwable t, @Nullable HttpStatusCode status,\n ServerWebExchange exchange, MessageSource messageSource) {\n final ErrorResponse errorResponse;\n if (t instanceof ErrorResponse er) {\n errorResponse = er;\n } else {\n var er = handleConflictException(t);\n if (er == null) {\n er = handleException(t, status);\n }\n errorResponse = er;\n }\n var problemDetail = errorResponse.updateAndGetBody(messageSource, getLocale(exchange));\n problemDetail.setInstance(exchange.getRequest().getURI());\n problemDetail.setProperty(\"requestId\", exchange.getRequest().getId());\n problemDetail.setProperty(\"timestamp\", Instant.now());\n return errorResponse;\n }\n\n @NonNull\n private static ErrorResponse handleException(Throwable t, @Nullable HttpStatusCode status) {\n var responseStatusAnno = MergedAnnotations.from(t.getClass(), TYPE_HIERARCHY)\n .get(ResponseStatus.class);\n if (status == null) {\n status = responseStatusAnno.getValue(\"code\", HttpStatus.class)\n .orElse(HttpStatus.INTERNAL_SERVER_ERROR);\n }\n var type = EXCEPTION_TYPE_MAP.getOrDefault(t.getClass(), DEFAULT_TYPE);\n var detail = responseStatusAnno.getValue(\"reason\", String.class)\n .orElseGet(t::getMessage);\n var builder = ErrorResponse.builder(t, status, detail)\n .type(URI.create(type));\n if (status.is5xxServerError()) {\n builder.detailMessageCode(\"problemDetail.internalServerError\")\n .titleMessageCode(\"problemDetail.title.internalServerError\");\n }\n return builder.build();\n }\n\n @Nullable\n private static ErrorResponse handleConflictException(Throwable t) {\n if (t instanceof ConcurrencyFailureException) {\n return ErrorResponse.builder(t, ProblemDetail.forStatus(HttpStatus.CONFLICT))\n .type(URI.create(CONFLICT_TYPE))\n .titleMessageCode(\"problemDetail.title.conflict\")\n .detailMessageCode(\"problemDetail.conflict\")\n .build();\n }\n return null;\n }\n\n\n public static Locale getLocale(ServerWebExchange exchange) {\n var locale = exchange.getLocaleContext().getLocale();\n return locale == null ? Locale.getDefault() : locale;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/FileSizeExceededException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\npublic class FileSizeExceededException extends ResponseStatusException {\n\n public FileSizeExceededException(String reason, String messageDetailCode,\n Object[] messageDetailArguments) {\n this(reason, null, messageDetailCode, messageDetailArguments);\n }\n\n public FileSizeExceededException(String reason, Throwable cause,\n String messageDetailCode, Object[] messageDetailArguments) {\n super(HttpStatus.PAYLOAD_TOO_LARGE, reason, cause, messageDetailCode,\n messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/FileTypeNotAllowedException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\npublic class FileTypeNotAllowedException extends ResponseStatusException {\n\n public FileTypeNotAllowedException(String reason, String messageDetailCode,\n Object[] messageDetailArguments) {\n this(reason, null, messageDetailCode, messageDetailArguments);\n }\n\n public FileTypeNotAllowedException(String reason, Throwable cause,\n String messageDetailCode, Object[] messageDetailArguments) {\n super(HttpStatus.UNSUPPORTED_MEDIA_TYPE, reason, cause, messageDetailCode,\n messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/NotFoundException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ResponseStatusException;\n\n/**\n * Not found exception.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class NotFoundException extends ResponseStatusException {\n\n public NotFoundException(@Nullable String reason) {\n this(reason, null);\n }\n\n public NotFoundException(@Nullable String reason,\n @Nullable Throwable cause) {\n super(HttpStatus.NOT_FOUND, reason, cause);\n }\n\n public NotFoundException(@Nullable Throwable cause) {\n this(cause == null ? \"\" : cause.getMessage(), cause);\n }\n\n public NotFoundException(String messageDetailCode, Object[] messageDetailArgs, String reason) {\n super(HttpStatus.NOT_FOUND, reason, null, messageDetailCode, messageDetailArgs);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/OAuth2UserAlreadyBoundException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.web.server.ServerWebInputException;\nimport run.halo.app.core.extension.UserConnection;\n\n/**\n * An exception that the user has been bound to another OAuth2 user.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class OAuth2UserAlreadyBoundException extends ServerWebInputException {\n\n public OAuth2UserAlreadyBoundException(UserConnection connection) {\n super(\"The user has been bound to another account\", null, null, null, new Object[] {\n connection.getSpec().getUsername(),\n connection.getSpec().getProviderUserId(),\n connection.getSpec().getRegistrationId(),\n connection.getSpec().getUpdatedAt()\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/PluginAlreadyExistsException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * PluginAlreadyExistsException indicates the provided plugin has already installed before.\n *\n * @author johnniang\n */\npublic class PluginAlreadyExistsException extends ServerWebInputException {\n\n public static final String PLUGIN_ALREADY_EXISTS_TYPE =\n \"https://halo.run/probs/plugin-alreay-exists\";\n\n public PluginAlreadyExistsException(String pluginName) {\n super(\"Plugin already exists.\", null, null, null, new Object[] {pluginName});\n setType(URI.create(PLUGIN_ALREADY_EXISTS_TYPE));\n getBody().setProperty(\"pluginName\", pluginName);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/PluginDependenciesNotEnabledException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport java.util.List;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Plugin dependencies not enabled exception.\n *\n * @author johnniang\n */\npublic class PluginDependenciesNotEnabledException extends ServerWebInputException {\n\n public static final URI TYPE =\n URI.create(\"https://www.halo.run/probs/plugin-dependencies-not-enabled\");\n\n /**\n * Instantiates a new Plugin dependencies not enabled exception.\n *\n * @param dependencies dependencies that are not enabled\n */\n public PluginDependenciesNotEnabledException(List dependencies) {\n super(\"Plugin dependencies are not fully enabled, please enable them first.\",\n null,\n null,\n null,\n new Object[] {dependencies});\n setType(TYPE);\n getBody().setProperty(\"dependencies\", dependencies);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/PluginDependencyException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport java.util.List;\nimport org.pf4j.DependencyResolver.WrongDependencyVersion;\nimport org.springframework.web.server.ServerWebInputException;\n\npublic abstract class PluginDependencyException extends ServerWebInputException {\n\n public PluginDependencyException(String reason) {\n super(reason);\n }\n\n public PluginDependencyException(String reason, Throwable cause) {\n super(reason, null, cause);\n }\n\n protected PluginDependencyException(String reason, Throwable cause,\n String messageDetailCode, Object[] messageDetailArguments) {\n super(reason, null, cause, messageDetailCode, messageDetailArguments);\n }\n\n public static class CyclicException extends PluginDependencyException {\n\n public static final String TYPE = \"https://halo.run/probs/plugin-cyclic-dependency\";\n\n public CyclicException() {\n super(\"A cyclic dependency was detected.\");\n setType(URI.create(TYPE));\n }\n }\n\n public static class NotFoundException extends PluginDependencyException {\n\n public static final String TYPE = \"https://halo.run/probs/plugin-dependencies-not-found\";\n\n public NotFoundException(List dependencies) {\n super(\"Dependencies were not found.\", null, null, new Object[] {dependencies});\n setType(URI.create(TYPE));\n getBody().setProperty(\"dependencies\", dependencies);\n }\n\n }\n\n public static class WrongVersionsException extends PluginDependencyException {\n\n public static final String TYPE =\n \"https://halo.run/probs/plugin-dependencies-with-wrong-versions\";\n\n public WrongVersionsException(List versions) {\n super(\"Dependencies have wrong version.\", null, null, new Object[] {versions});\n setType(URI.create(TYPE));\n getBody().setProperty(\"versions\", versions);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/PluginDependentsNotDisabledException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport java.util.List;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Plugin dependents not disabled exception.\n *\n * @author johnniang\n */\npublic class PluginDependentsNotDisabledException extends ServerWebInputException {\n\n public static final URI TYPE =\n URI.create(\"https://www.halo.run/probs/plugin-dependents-not-disabled\");\n\n /**\n * Instantiates a new Plugin dependents not disabled exception.\n *\n * @param dependents dependents that are not disabled\n */\n public PluginDependentsNotDisabledException(List dependents) {\n super(\"Plugin dependents are not fully disabled, please disable them first.\",\n null,\n null,\n null,\n new Object[] {dependents});\n setType(TYPE);\n getBody().setProperty(\"dependents\", dependents);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/PluginInstallationException.java", "content": "package run.halo.app.infra.exception;\n\nimport jakarta.validation.constraints.Null;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * {@link ServerWebInputException} subclass that indicates plugin installation failure.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PluginInstallationException extends ServerWebInputException {\n\n public PluginInstallationException(String reason, @Nullable String messageDetailCode,\n @Null Object[] messageDetailArguments) {\n super(reason, null, null, messageDetailCode, messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/PluginRuntimeIncompatibleException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport org.springframework.web.server.ServerErrorException;\n\n/**\n * Exception thrown when an incompatible plugin is detected.\n * This usually occurs when a plugin is not compatible with the current version of Halo at runtime.\n *\n * @author johnniang\n * @since 2.21.0\n */\npublic class PluginRuntimeIncompatibleException extends ServerErrorException {\n\n private static final URI TYPE =\n URI.create(\"https://www.halo.run/probs/plugin-runtime-incompatible\");\n\n public PluginRuntimeIncompatibleException(Throwable cause) {\n super(\"Incompatible plugin detected.\", cause);\n setType(TYPE);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/RateLimitExceededException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ResponseStatusException;\n\npublic class RateLimitExceededException extends ResponseStatusException {\n\n public RateLimitExceededException(@Nullable Throwable cause) {\n super(HttpStatus.TOO_MANY_REQUESTS, \"You have exceeded your quota\", cause);\n setType(URI.create(Exceptions.REQUEST_NOT_PERMITTED_TYPE));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/RequestBodyValidationException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Locale;\nimport lombok.Getter;\nimport org.springframework.context.MessageSource;\nimport org.springframework.context.MessageSourceResolvable;\nimport org.springframework.http.ProblemDetail;\nimport org.springframework.lang.Nullable;\nimport org.springframework.validation.Errors;\nimport org.springframework.web.server.ServerWebInputException;\nimport org.springframework.web.util.BindErrorUtils;\n\n@Getter\npublic class RequestBodyValidationException extends ServerWebInputException {\n\n private final Errors errors;\n\n public RequestBodyValidationException(Errors errors) {\n super(\"Validation failure\", null, null, null, null);\n this.errors = errors;\n }\n\n @Override\n public ProblemDetail updateAndGetBody(MessageSource messageSource, Locale locale) {\n var detail = super.updateAndGetBody(messageSource, locale);\n detail.setProperty(\"errors\", collectAllErrors(messageSource, locale));\n return detail;\n }\n\n private List collectAllErrors(MessageSource messageSource, Locale locale) {\n var globalErrors = resolveErrors(errors.getGlobalErrors(), messageSource, locale);\n var fieldErrors = resolveErrors(errors.getFieldErrors(), messageSource, locale);\n var errors = new ArrayList(globalErrors.size() + fieldErrors.size());\n errors.addAll(globalErrors);\n errors.addAll(fieldErrors);\n return errors;\n }\n\n @Override\n public Object[] getDetailMessageArguments(MessageSource messageSource, Locale locale) {\n return new Object[] {\n resolveErrors(errors.getGlobalErrors(), messageSource, locale),\n resolveErrors(errors.getFieldErrors(), messageSource, locale)\n };\n }\n\n @Override\n public Object[] getDetailMessageArguments() {\n return new Object[] {\n resolveErrors(errors.getGlobalErrors(), null, Locale.getDefault()),\n resolveErrors(errors.getFieldErrors(), null, Locale.getDefault())\n };\n }\n\n private static List resolveErrors(\n List errors,\n @Nullable MessageSource messageSource,\n Locale locale) {\n return messageSource == null\n ? BindErrorUtils.resolve(errors).values().stream().toList()\n : BindErrorUtils.resolve(errors, messageSource, locale).values().stream().toList();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/RequestRestrictedException.java", "content": "package run.halo.app.infra.exception;\n\n/**\n *

{@link RequestRestrictedException} indicates that the client's request was denied because\n * it did not meet certain required conditions.

\n *

Typically, this exception is thrown when a user attempts to perform an action that\n * requires prior approval or validation, such as replying to a comment that has not yet been\n * approved.

\n *

The server understands the request but refuses to process it due to the lack of\n * necessary approval.

\n *\n * @author guqing\n * @since 2.20.0\n */\npublic class RequestRestrictedException extends AccessDeniedException {\n\n public RequestRestrictedException(String reason) {\n super(reason);\n }\n\n public RequestRestrictedException(String reason, String detailCode, Object[] detailArgs) {\n super(reason, detailCode, detailArgs);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/RestrictedNameException.java", "content": "package run.halo.app.infra.exception;\n\nimport jakarta.validation.constraints.Null;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Restricted name exception.\n *\n * @author lywq\n * @since 2025/10/30 11:47\n **/\npublic class RestrictedNameException extends ServerWebInputException {\n\n public RestrictedNameException() {\n super(\"The name is restricted\");\n }\n\n public RestrictedNameException(String reason, @Nullable String messageDetailCode,\n @Null Object[] messageDetailArguments) {\n super(reason, null, null, messageDetailCode, messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/ThemeAlreadyExistsException.java", "content": "package run.halo.app.infra.exception;\n\nimport java.net.URI;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * {@link ThemeAlreadyExistsException} indicates the provided theme has already installed before.\n *\n * @author guqing\n * @since 2.6.0\n */\npublic class ThemeAlreadyExistsException extends ServerWebInputException {\n\n /**\n * Constructs a {@code ThemeAlreadyExistsException} with the given theme name.\n *\n * @param themeName theme name must not be blank\n */\n public ThemeAlreadyExistsException(@NonNull String themeName) {\n super(\"Theme already exists.\", null, null, \"problemDetail.theme.install.alreadyExists\",\n new Object[] {themeName});\n setType(URI.create(Exceptions.THEME_ALREADY_EXISTS_TYPE));\n getBody().setProperty(\"themeName\", themeName);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/ThemeInstallationException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\n/**\n * @author guqing\n * @author johnniang\n * @since 2.0.0\n */\npublic class ThemeInstallationException extends ResponseStatusException {\n\n public ThemeInstallationException(String reason, String detailCode, Object[] detailArgs) {\n super(HttpStatus.BAD_REQUEST, reason, null, detailCode, detailArgs);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/ThemeUninstallException.java", "content": "package run.halo.app.infra.exception;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class ThemeUninstallException extends RuntimeException {\n\n public ThemeUninstallException(String message) {\n super(message);\n }\n\n public ThemeUninstallException(String message, Throwable cause) {\n super(message, cause);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/ThemeUpgradeException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\n/**\n * ThemeUpgradeException will response bad request status if failed to upgrade theme.\n *\n * @author johnniang\n */\npublic class ThemeUpgradeException extends ResponseStatusException {\n\n public ThemeUpgradeException(String reason, String detailCode, Object[] detailArgs) {\n super(HttpStatus.BAD_REQUEST, reason, null, detailCode, detailArgs);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/UnsatisfiedAttributeValueException.java", "content": "package run.halo.app.infra.exception;\n\nimport jakarta.validation.constraints.Null;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * {@link ServerWebInputException} subclass that indicates an unsatisfied\n * attribute value in request parameters.\n *\n * @author guqing\n * @since 2.2.0\n */\npublic class UnsatisfiedAttributeValueException extends ServerWebInputException {\n\n public UnsatisfiedAttributeValueException(String reason) {\n super(reason);\n }\n\n public UnsatisfiedAttributeValueException(String reason, @Nullable String messageDetailCode,\n @Null Object[] messageDetailArguments) {\n super(reason, null, null, messageDetailCode, messageDetailArguments);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/UserNotFoundException.java", "content": "package run.halo.app.infra.exception;\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\npublic class UserNotFoundException extends ResponseStatusException {\n\n public UserNotFoundException(String username) {\n super(HttpStatus.NOT_FOUND, \"User \" + username + \" was not found\", null, null,\n new Object[] {username});\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/handlers/HaloErrorConfiguration.java", "content": "package run.halo.app.infra.exception.handlers;\n\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.boot.webflux.autoconfigure.error.ErrorWebFluxAutoConfiguration;\nimport org.springframework.boot.webflux.error.ErrorAttributes;\nimport org.springframework.boot.webflux.error.ErrorWebExceptionHandler;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.MessageSource;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.codec.ServerCodecConfigurer;\nimport org.springframework.web.reactive.result.view.ViewResolver;\nimport org.springframework.web.server.WebExceptionHandler;\n\n/**\n * Configuration to render errors via a WebFlux\n * {@link WebExceptionHandler}.\n *
\n *
\n * See\n * {@link ErrorWebFluxAutoConfiguration}\n * for more.\n *\n * @author guqing\n * @author johnniang\n * @since 2.1.0\n */\n@Configuration\npublic class HaloErrorConfiguration {\n\n /**\n * Customize the default {@link ErrorWebExceptionHandler}.\n */\n @Bean\n @Order(-1)\n ErrorWebExceptionHandler errorWebExceptionHandler(\n ErrorAttributes errorAttributes,\n WebProperties webProperties,\n ObjectProvider viewResolvers,\n ServerCodecConfigurer serverCodecConfigurer,\n ApplicationContext applicationContext\n ) {\n var exceptionHandler = new HaloErrorWebExceptionHandler(\n errorAttributes,\n webProperties.getResources(),\n webProperties.getError(),\n applicationContext);\n exceptionHandler.setViewResolvers(viewResolvers.orderedStream().toList());\n exceptionHandler.setMessageWriters(serverCodecConfigurer.getWriters());\n exceptionHandler.setMessageReaders(serverCodecConfigurer.getReaders());\n return exceptionHandler;\n }\n\n /**\n * Customize the default {@link ErrorAttributes}.\n */\n @Bean\n ErrorAttributes errorAttributes(MessageSource messageSource) {\n return new ProblemDetailErrorAttributes(messageSource);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/handlers/HaloErrorWebExceptionHandler.java", "content": "package run.halo.app.infra.exception.handlers;\n\nimport java.util.Map;\nimport java.util.Optional;\nimport org.springframework.boot.autoconfigure.web.ErrorProperties;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.boot.webflux.autoconfigure.error.DefaultErrorWebExceptionHandler;\nimport org.springframework.boot.webflux.error.ErrorAttributes;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.ProblemDetail;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.util.context.Context;\nimport run.halo.app.theme.ThemeContext;\nimport run.halo.app.theme.ThemeResolver;\nimport run.halo.app.theme.engine.ThemeTemplateAvailabilityProvider;\n\npublic class HaloErrorWebExceptionHandler extends DefaultErrorWebExceptionHandler {\n\n private final ThemeTemplateAvailabilityProvider templateAvailabilityProvider;\n\n private final ThemeResolver themeResolver;\n\n /**\n * Create a new {@code DefaultErrorWebExceptionHandler} instance.\n *\n * @param errorAttributes the error attributes\n * @param resources the resources configuration properties\n * @param errorProperties the error configuration properties\n * @param applicationContext the current application context\n * @since 2.4.0\n */\n public HaloErrorWebExceptionHandler(\n ErrorAttributes errorAttributes,\n WebProperties.Resources resources,\n ErrorProperties errorProperties,\n ApplicationContext applicationContext) {\n super(errorAttributes, resources, errorProperties, applicationContext);\n this.templateAvailabilityProvider =\n applicationContext.getBean(ThemeTemplateAvailabilityProvider.class);\n this.themeResolver = applicationContext.getBean(ThemeResolver.class);\n }\n\n @Override\n protected int getHttpStatus(Map errorAttributes) {\n var problemDetail = (ProblemDetail) errorAttributes.get(\"error\");\n return problemDetail.getStatus();\n }\n\n @Override\n protected Mono renderErrorResponse(ServerRequest request) {\n var errorAttributes =\n getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.ALL));\n return ServerResponse.status(getHttpStatus(errorAttributes))\n .contentType(MediaType.APPLICATION_PROBLEM_JSON)\n .bodyValue(errorAttributes.get(\"error\"));\n }\n\n @Override\n protected Mono renderErrorView(ServerRequest request) {\n return themeResolver.getTheme(request.exchange())\n .flatMap(themeContext -> super.renderErrorView(request)\n .contextWrite(Context.of(ThemeContext.class, themeContext)));\n }\n\n @Override\n protected Mono renderErrorView(String viewName,\n ServerResponse.BodyBuilder responseBody, Map error) {\n return Mono.deferContextual(contextView -> {\n Optional themeContext = contextView.getOrEmpty(ThemeContext.class);\n if (themeContext.isPresent()\n && templateAvailabilityProvider.isTemplateAvailable(themeContext.get(), viewName)) {\n return responseBody.render(viewName, error);\n }\n return super.renderErrorView(viewName, responseBody, error);\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/exception/handlers/ProblemDetailErrorAttributes.java", "content": "package run.halo.app.infra.exception.handlers;\n\nimport static run.halo.app.infra.exception.Exceptions.createErrorResponse;\n\nimport java.util.Map;\nimport org.springframework.boot.web.error.ErrorAttributeOptions;\nimport org.springframework.boot.webflux.error.DefaultErrorAttributes;\nimport org.springframework.context.MessageSource;\nimport org.springframework.web.reactive.function.server.ServerRequest;\n\n/**\n * See {@link DefaultErrorAttributes} for more.\n *\n * @author johnn\n */\npublic class ProblemDetailErrorAttributes extends DefaultErrorAttributes {\n\n private final MessageSource messageSource;\n\n public ProblemDetailErrorAttributes(MessageSource messageSource) {\n this.messageSource = messageSource;\n }\n\n @Override\n public Map getErrorAttributes(ServerRequest request,\n ErrorAttributeOptions options) {\n final var errAttributes = super.getErrorAttributes(request, options);\n var error = getError(request);\n var errorResponse = createErrorResponse(error, null, request.exchange(), messageSource);\n errAttributes.put(\"error\", errorResponse.getBody());\n return errAttributes;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/AttachmentProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport jakarta.validation.Valid;\nimport jakarta.validation.constraints.Max;\nimport jakarta.validation.constraints.Min;\nimport jakarta.validation.constraints.PositiveOrZero;\nimport java.util.LinkedList;\nimport java.util.List;\nimport lombok.Data;\nimport org.springframework.boot.context.properties.NestedConfigurationProperty;\n\n@Data\npublic class AttachmentProperties {\n\n private List resourceMappings = new LinkedList<>();\n\n @Valid\n @NestedConfigurationProperty\n private final ThumbnailProperties thumbnail = new ThumbnailProperties();\n\n @Data\n public static class ThumbnailProperties {\n\n /**\n * Whether to disable thumbnail generation.\n */\n private boolean disabled;\n\n /**\n * The concurrent threads for thumbnail generation.\n */\n @Min(1)\n private Integer concurrentThreads;\n\n /**\n * The quality of generated thumbnails, value between 0.0 and 1.0.\n */\n @PositiveOrZero\n @Max(1)\n private Double quality;\n\n }\n\n @Data\n public static class ResourceMapping {\n\n /**\n * Like: {@code /upload/**}.\n */\n private String pathPattern;\n\n /**\n * The location is a relative path to attachments folder in working directory.\n */\n private List locations;\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/CacheProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport lombok.Data;\n\n@Data\npublic class CacheProperties {\n\n private boolean disabled;\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/ExtensionProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport lombok.Data;\n\n@Data\npublic class ExtensionProperties {\n\n private Controller controller = new Controller();\n\n @Data\n public static class Controller {\n\n private boolean disabled;\n\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/HaloProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport jakarta.validation.Valid;\nimport jakarta.validation.constraints.NotNull;\nimport java.net.URISyntaxException;\nimport java.net.URL;\nimport java.nio.file.Path;\nimport java.util.HashSet;\nimport java.util.Set;\nimport lombok.Data;\nimport org.springframework.boot.context.properties.ConfigurationProperties;\nimport org.springframework.boot.context.properties.NestedConfigurationProperty;\nimport org.springframework.validation.Errors;\nimport org.springframework.validation.Validator;\nimport org.springframework.validation.annotation.Validated;\n\n/**\n * @author guqing\n * @since 2022-04-12\n */\n@Data\n@ConfigurationProperties(prefix = \"halo\")\n@Validated\npublic class HaloProperties implements Validator {\n\n @NotNull\n private Path workDir;\n\n /**\n * External URL must be a URL and it can be null.\n */\n private URL externalUrl;\n\n /**\n * Indicates if we use absolute permalink to post, page, category, tag and so on.\n */\n private boolean useAbsolutePermalink;\n\n private Set initialExtensionLocations = new HashSet<>();\n\n /**\n * This property could stop initializing required Extensions defined in classpath.\n * See {@link run.halo.app.infra.ExtensionResourceInitializer#REQUIRED_EXTENSION_LOCATIONS}\n * for more.\n */\n private boolean requiredExtensionDisabled;\n\n @Valid\n @NestedConfigurationProperty\n private final ExtensionProperties extension = new ExtensionProperties();\n\n @Valid\n @NestedConfigurationProperty\n private final SecurityProperties security = new SecurityProperties();\n\n @Valid\n @NestedConfigurationProperty\n private final UiProperties ui = new UiProperties();\n\n @Valid\n @NestedConfigurationProperty\n private final ThemeProperties theme = new ThemeProperties();\n\n @Valid\n @NestedConfigurationProperty\n private final AttachmentProperties attachment = new AttachmentProperties();\n\n @Override\n public boolean supports(Class clazz) {\n return HaloProperties.class.isAssignableFrom(clazz);\n }\n\n @Override\n public void validate(Object target, Errors errors) {\n var props = (HaloProperties) target;\n var externalUrl = props.getExternalUrl();\n if (props.isUseAbsolutePermalink() && externalUrl == null) {\n errors.rejectValue(\"externalUrl\", \"external-url.required.when-using-absolute-permalink\",\n \"External URL is required when property `use-absolute-permalink` is set to true.\");\n }\n // check if the external URL is a http or https URL and is not an opaque URL.\n if (externalUrl != null && !isValidExternalUrl(externalUrl)) {\n errors.rejectValue(\"externalUrl\", \"external-url.invalid-format\",\n \"External URL must be a http or https URL.\");\n }\n }\n\n private boolean isValidExternalUrl(URL externalUrl) {\n try {\n var uri = externalUrl.toURI();\n return !uri.isOpaque()\n && uri.getAuthority() != null\n && Set.of(\"http\", \"https\").contains(uri.getScheme());\n } catch (URISyntaxException e) {\n return false;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/JwtProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport jakarta.validation.constraints.NotNull;\nimport java.io.ByteArrayInputStream;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.nio.charset.StandardCharsets;\nimport java.security.interfaces.RSAPrivateKey;\nimport java.security.interfaces.RSAPublicKey;\nimport org.springframework.boot.context.properties.source.InvalidConfigurationPropertyValueException;\nimport org.springframework.core.io.Resource;\nimport org.springframework.security.converter.RsaKeyConverters;\nimport org.springframework.security.oauth2.jose.jws.SignatureAlgorithm;\nimport org.springframework.util.Assert;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.validation.annotation.Validated;\n\n/**\n * @author guqing\n * @author johnniang\n * @date 2022-04-12\n */\n@Validated\npublic class JwtProperties {\n\n /**\n * URI that can either be an OpenID Connect discovery endpoint or an OAuth 2.0\n * Authorization Server Metadata endpoint defined by RFC 8414.\n */\n private String issuerUri;\n\n /**\n * JSON Web Algorithm used for verifying the digital signatures.\n */\n private SignatureAlgorithm jwsAlgorithm;\n\n /**\n * Location of the file containing the public key used to verify a JWT.\n */\n @NotNull\n private Resource publicKeyLocation;\n\n @NotNull\n private Resource privateKeyLocation;\n\n private final RSAPrivateKey privateKey;\n\n private final RSAPublicKey publicKey;\n\n public JwtProperties(String issuerUri, SignatureAlgorithm jwsAlgorithm,\n Resource publicKeyLocation,\n Resource privateKeyLocation) throws IOException {\n this.issuerUri = issuerUri;\n this.jwsAlgorithm = jwsAlgorithm;\n if (jwsAlgorithm == null) {\n this.jwsAlgorithm = SignatureAlgorithm.RS256;\n }\n this.publicKeyLocation = publicKeyLocation;\n this.privateKeyLocation = privateKeyLocation;\n\n //TODO initialize private and public keys at first startup.\n this.privateKey = this.readPrivateKey();\n this.publicKey = this.readPublicKey();\n }\n\n public String getIssuerUri() {\n return issuerUri;\n }\n\n public void setIssuerUri(String issuerUri) {\n this.issuerUri = issuerUri;\n }\n\n public SignatureAlgorithm getJwsAlgorithm() {\n return this.jwsAlgorithm;\n }\n\n public void setJwsAlgorithm(SignatureAlgorithm jwsAlgorithm) {\n this.jwsAlgorithm = jwsAlgorithm;\n }\n\n public Resource getPublicKeyLocation() {\n return this.publicKeyLocation;\n }\n\n public void setPublicKeyLocation(Resource publicKeyLocation) {\n this.publicKeyLocation = publicKeyLocation;\n }\n\n public Resource getPrivateKeyLocation() {\n return privateKeyLocation;\n }\n\n public void setPrivateKeyLocation(Resource privateKeyLocation) {\n this.privateKeyLocation = privateKeyLocation;\n }\n\n public RSAPrivateKey getPrivateKey() {\n return privateKey;\n }\n\n public RSAPublicKey getPublicKey() {\n return publicKey;\n }\n\n private RSAPublicKey readPublicKey() throws IOException {\n String key = \"halo.security.oauth2.jwt.public-key-location\";\n Assert.notNull(this.publicKeyLocation, \"PublicKeyLocation must not be null\");\n if (!this.publicKeyLocation.exists()) {\n throw new InvalidConfigurationPropertyValueException(key, this.publicKeyLocation,\n \"Public key location does not exist\");\n }\n try (InputStream inputStream = this.publicKeyLocation.getInputStream()) {\n String source = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);\n return RsaKeyConverters.x509()\n .convert(new ByteArrayInputStream(source.getBytes()));\n }\n }\n\n private RSAPrivateKey readPrivateKey() throws IOException {\n String key = \"halo.security.oauth2.jwt.private-key-location\";\n Assert.notNull(this.privateKeyLocation, \"PrivateKeyLocation must not be null\");\n if (!this.privateKeyLocation.exists()) {\n throw new InvalidConfigurationPropertyValueException(key, this.privateKeyLocation,\n \"Private key location does not exist\");\n }\n try (InputStream inputStream = this.privateKeyLocation.getInputStream()) {\n String source = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);\n return RsaKeyConverters.pkcs8()\n .convert(new ByteArrayInputStream(source.getBytes()));\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/ProxyProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport java.net.URI;\nimport lombok.Data;\n\n@Data\npublic class ProxyProperties {\n\n /**\n * Console endpoint in development environment to be proxied. e.g.: http://localhost:8090/\n */\n private URI endpoint;\n\n /**\n * Indicates if the proxy behaviour is enabled. Default is false\n */\n private boolean enabled = false;\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/SecurityProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport static org.springframework.security.web.server.header.ReferrerPolicyServerHttpHeadersWriter.ReferrerPolicy.STRICT_ORIGIN_WHEN_CROSS_ORIGIN;\n\nimport java.net.URI;\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.List;\nimport lombok.Data;\nimport org.springframework.boot.actuate.autoconfigure.endpoint.web.CorsEndpointProperties;\nimport org.springframework.security.web.server.header.ReferrerPolicyServerHttpHeadersWriter.ReferrerPolicy;\nimport org.springframework.security.web.server.header.XFrameOptionsServerHttpHeadersWriter.Mode;\n\n@Data\npublic class SecurityProperties {\n\n private final FrameOptions frameOptions = new FrameOptions();\n\n private final ReferrerOptions referrerOptions = new ReferrerOptions();\n\n private final CorsOptions corsOptions = new CorsOptions();\n\n private final RememberMeOptions rememberMe = new RememberMeOptions();\n\n private final TwoFactorAuthOptions twoFactorAuth = new TwoFactorAuthOptions();\n\n private final BasicAuthOptions basicAuth = new BasicAuthOptions();\n\n private final List passwordResetMethods = new ArrayList<>();\n\n @Data\n public static class BasicAuthOptions {\n /**\n * Whether basic authentication is disabled.\n */\n private boolean disabled = true;\n }\n\n @Data\n public static class TwoFactorAuthOptions {\n\n /**\n * Whether two-factor authentication is disabled.\n */\n private boolean disabled;\n\n }\n\n @Data\n public static class CorsOptions {\n\n private boolean disabled;\n\n private final List configs = new ArrayList<>();\n\n }\n\n @Data\n public static class CorsConfig {\n\n private String pathPattern;\n\n private CorsEndpointProperties config;\n\n }\n\n @Data\n public static class FrameOptions {\n\n private boolean disabled;\n\n private Mode mode = Mode.SAMEORIGIN;\n }\n\n @Data\n public static class ReferrerOptions {\n\n private ReferrerPolicy policy = STRICT_ORIGIN_WHEN_CROSS_ORIGIN;\n\n }\n\n @Data\n public static class RememberMeOptions {\n private Duration tokenValidity = Duration.ofDays(14);\n }\n\n @Data\n public static class PasswordResetMethod {\n\n private String name;\n\n private URI href;\n\n private URI icon;\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/ThemeProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport jakarta.validation.Valid;\nimport lombok.Data;\n\n@Data\npublic class ThemeProperties {\n\n @Valid\n private final Initializer initializer = new Initializer();\n\n /**\n * Indicates whether the generator meta needs to be disabled.\n */\n private boolean generatorMetaDisabled;\n\n @Data\n public static class Initializer {\n\n private boolean disabled = false;\n\n private String location = \"classpath:themes/theme-earth.zip\";\n\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/properties/UiProperties.java", "content": "package run.halo.app.infra.properties;\n\nimport jakarta.validation.Valid;\nimport lombok.Data;\nimport org.springframework.boot.context.properties.NestedConfigurationProperty;\n\n@Data\npublic class UiProperties {\n\n private String location = \"classpath:/ui/\";\n\n @Valid\n @NestedConfigurationProperty\n private ProxyProperties proxy = new ProxyProperties();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ui/ProxyFilter.java", "content": "package run.halo.app.infra.ui;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.NegatedServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers;\nimport org.springframework.web.reactive.function.client.WebClient;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.properties.ProxyProperties;\n\n@Slf4j\npublic class ProxyFilter implements WebFilter {\n\n private final ProxyProperties proxyProperties;\n\n private final ServerWebExchangeMatcher requestMatcher;\n\n private final WebClient webClient;\n\n public ProxyFilter(ProxyProperties proxyProperties, String... patterns) {\n this.proxyProperties = proxyProperties;\n var requestMatcher = ServerWebExchangeMatchers.pathMatchers(HttpMethod.GET, patterns);\n requestMatcher = new AndServerWebExchangeMatcher(requestMatcher,\n new NegatedServerWebExchangeMatcher(new WebSocketServerWebExchangeMatcher()));\n this.requestMatcher = requestMatcher;\n this.webClient = WebClient.create(proxyProperties.getEndpoint().toString());\n log.debug(\"Initialized ProxyFilter to proxy {} to endpoint {}\",\n java.util.Arrays.toString(patterns),\n proxyProperties.getEndpoint());\n }\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n return requestMatcher.matches(exchange)\n .filter(ServerWebExchangeMatcher.MatchResult::isMatch)\n .filter(matchResult -> isHtmlRequest(exchange))\n .switchIfEmpty(chain.filter(exchange).then(Mono.empty()))\n .map(matchResult -> getProxyUri(exchange))\n .doOnNext(uri -> {\n if (log.isTraceEnabled()) {\n log.trace(\"Proxy {} to {}\", uri, proxyProperties.getEndpoint());\n }\n })\n .flatMap(uri -> webClient.get()\n .uri(uri)\n .headers(httpHeaders -> httpHeaders.addAll(exchange.getRequest().getHeaders()))\n .exchangeToMono(clientResponse -> {\n var response = exchange.getResponse();\n var httpStatusCode = clientResponse.statusCode();\n // set headers\n var httpHeaders = clientResponse.headers().asHttpHeaders();\n response.getHeaders().putAll(httpHeaders);\n // set cookies\n response.getCookies().putAll(clientResponse.cookies());\n // set status code\n response.setStatusCode(httpStatusCode);\n var contentLength = clientResponse.headers().contentLength().orElse(0L);\n if (httpStatusCode.is3xxRedirection()\n || httpStatusCode.equals(HttpStatus.NO_CONTENT)\n || contentLength == 0) {\n return Mono.empty();\n }\n var body = clientResponse.bodyToFlux(DataBuffer.class);\n return response.writeWith(body);\n }));\n }\n\n private boolean isHtmlRequest(ServerWebExchange exchange) {\n var acceptHeaders = exchange.getRequest().getHeaders().getAccept();\n if (acceptHeaders.isEmpty()) {\n return true;\n }\n return acceptHeaders.stream()\n .anyMatch(mediaType -> mediaType.isCompatibleWith(MediaType.TEXT_HTML));\n }\n\n private String getProxyUri(ServerWebExchange exchange) {\n var requestPath = exchange.getRequest().getPath().pathWithinApplication().value();\n return UriComponentsBuilder.fromUriString(getUiEntryPath(requestPath))\n .queryParams(exchange.getRequest().getQueryParams())\n .build()\n .toUriString();\n }\n\n private String getUiEntryPath(String requestPath) {\n if (requestPath.startsWith(\"/console\")) {\n return \"/console\";\n }\n if (requestPath.startsWith(\"/uc\")) {\n return \"/uc\";\n }\n return requestPath;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ui/WebSocketRequestPredicate.java", "content": "package run.halo.app.infra.ui;\n\nimport static run.halo.app.infra.ui.WebSocketUtils.isWebSocketUpgrade;\n\nimport org.springframework.web.reactive.function.server.RequestPredicate;\nimport org.springframework.web.reactive.function.server.ServerRequest;\n\npublic class WebSocketRequestPredicate implements RequestPredicate {\n\n @Override\n public boolean test(ServerRequest request) {\n var httpHeaders = request.exchange().getRequest().getHeaders();\n return isWebSocketUpgrade(httpHeaders);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ui/WebSocketServerWebExchangeMatcher.java", "content": "package run.halo.app.infra.ui;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher.MatchResult.match;\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher.MatchResult.notMatch;\nimport static run.halo.app.infra.ui.WebSocketUtils.isWebSocketUpgrade;\n\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\npublic class WebSocketServerWebExchangeMatcher implements ServerWebExchangeMatcher {\n @Override\n public Mono matches(ServerWebExchange exchange) {\n return isWebSocketUpgrade(exchange.getRequest().getHeaders()) ? match() : notMatch();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/ui/WebSocketUtils.java", "content": "package run.halo.app.infra.ui;\n\nimport java.util.Objects;\nimport org.springframework.http.HttpHeaders;\n\npublic enum WebSocketUtils {\n ;\n\n public static boolean isWebSocketUpgrade(HttpHeaders headers) {\n // See io.netty.handler.codec.http.websocketx.extensions.WebSocketExtensionUtil\n // .isWebsocketUpgrade for more.\n var upgradeConnection = headers.getConnection().stream().map(String::toLowerCase)\n .anyMatch(conn -> Objects.equals(conn, \"upgrade\"));\n\n return headers.containsHeader(HttpHeaders.UPGRADE)\n && upgradeConnection\n && \"websocket\".equalsIgnoreCase(headers.getUpgrade());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/Base62Utils.java", "content": "package run.halo.app.infra.utils;\n\nimport io.seruco.encoding.base62.Base62;\nimport java.nio.charset.Charset;\nimport java.nio.charset.StandardCharsets;\nimport org.apache.commons.lang3.StringUtils;\n\n/**\n *

Base62 tool class, which provides the encoding and decoding scheme of base62.

\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class Base62Utils {\n private static final Charset DEFAULT_CHARSET = StandardCharsets.UTF_8;\n private static final Base62 INSTANCE = Base62.createInstance();\n\n public static String encode(String source) {\n return encode(source, DEFAULT_CHARSET);\n }\n\n /**\n * Base62 encode.\n *\n * @param source the encoded base62 string\n * @param charset the charset default is utf_8\n * @return encoded string by base62\n */\n public static String encode(String source, Charset charset) {\n return encode(StringUtils.getBytes(source, charset));\n }\n\n public static String encode(byte[] source) {\n return new String(INSTANCE.encode(source));\n }\n\n /**\n * Base62 decode.\n *\n * @param base62Str the Base62 decoded string\n * @return decoded bytes\n */\n public static byte[] decode(String base62Str) {\n return decode(StringUtils.getBytes(base62Str, DEFAULT_CHARSET));\n }\n\n public static byte[] decode(byte[] base62bytes) {\n return INSTANCE.decode(base62bytes);\n }\n\n public static String decodeToString(String source) {\n return decodeToString(source, DEFAULT_CHARSET);\n }\n\n public static String decodeToString(String source, Charset charset) {\n return StringUtils.toEncodedString(decode(source), charset);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/FileNameUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport com.google.common.io.Files;\nimport java.util.function.Supplier;\nimport java.util.regex.Pattern;\nimport org.apache.commons.lang3.RandomStringUtils;\nimport org.apache.commons.lang3.StringUtils;\n\npublic final class FileNameUtils {\n\n private FileNameUtils() {\n }\n\n /**\n * Check whether the file name has an extension.\n *\n * @param filename is name of file.\n * @return True if file name has extension, otherwise false.\n */\n public static boolean hasFileExtension(String filename) {\n if (filename == null || filename.isEmpty()) {\n return false;\n }\n var extensionRegex = \".*\\\\.[a-zA-Z0-9]+$\";\n return Pattern.matches(extensionRegex, filename);\n }\n\n public static String removeFileExtension(String filename, boolean removeAllExtensions) {\n if (filename == null || filename.isEmpty()) {\n return filename;\n }\n var extPattern = \"(?\n * Case 1: halo.run -> halo-xyz.run\n * Case 2: .run -> xyz.run\n * Case 3: halo -> halo-xyz\n * \n *\n * @param filename is name of file.\n * @param length is for generating random string with specific length.\n * @return File name with random string.\n */\n public static String randomFileName(String filename, int length) {\n return renameFilename(\n filename, () -> RandomStringUtils.secure().nextAlphabetic(length), false\n );\n }\n\n public static String renameFilename(\n String filename,\n Supplier renameSupplier,\n boolean excludeBasename) {\n var nameWithoutExt = Files.getNameWithoutExtension(filename);\n var ext = Files.getFileExtension(filename);\n var rename = renameSupplier.get();\n if (StringUtils.isBlank(nameWithoutExt)) {\n return rename + \".\" + ext;\n }\n if (StringUtils.isBlank(ext)) {\n if (excludeBasename) {\n return rename;\n }\n return nameWithoutExt + \"-\" + rename;\n }\n if (excludeBasename) {\n return rename + \".\" + ext;\n }\n return nameWithoutExt + \"-\" + rename + \".\" + ext;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/FileUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport static java.nio.file.StandardCopyOption.REPLACE_EXISTING;\nimport static org.springframework.core.io.buffer.DataBufferUtils.subscriberInputStream;\nimport static org.springframework.util.FileSystemUtils.deleteRecursively;\n\nimport java.io.Closeable;\nimport java.io.IOException;\nimport java.nio.file.CopyOption;\nimport java.nio.file.DirectoryNotEmptyException;\nimport java.nio.file.FileVisitResult;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.nio.file.SimpleFileVisitor;\nimport java.nio.file.attribute.BasicFileAttributes;\nimport java.util.Set;\nimport java.util.function.Consumer;\nimport java.util.function.Predicate;\nimport java.util.jar.JarEntry;\nimport java.util.jar.JarOutputStream;\nimport java.util.stream.Stream;\nimport java.util.zip.ZipEntry;\nimport java.util.zip.ZipInputStream;\nimport java.util.zip.ZipOutputStream;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.Nullable;\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.AntPathMatcher;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.infra.exception.AccessDeniedException;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\npublic abstract class FileUtils {\n\n private FileUtils() {\n }\n\n /**\n * Unzip the given content to target path. Please note that no default scheduler will be used.\n *\n * @param content the zip content\n * @param targetPath the target path\n * @return a Mono signaling when unzip is complete\n */\n public static Mono unzip(Publisher content, @NonNull Path targetPath) {\n return unzip(content, targetPath, null);\n }\n\n /**\n * Unzip the given content to target path.\n *\n * @param content the zip content\n * @param targetPath the target path\n * @param scheduler the scheduler\n * @return a Mono signaling when unzip is complete\n */\n public static Mono unzip(\n Publisher content, @NonNull Path targetPath, @Nullable Scheduler scheduler\n ) {\n var unzip = Mono.fromCallable(() -> {\n try (var is = subscriberInputStream(content, 1);\n var zis = new ZipInputStream(is)) {\n log.debug(\"Unzipping to target path: {}\", targetPath);\n unzip(zis, targetPath);\n log.debug(\"Unzipped to target path: {}\", targetPath);\n }\n return null;\n }).then();\n if (scheduler != null) {\n return unzip.subscribeOn(scheduler);\n }\n return unzip;\n }\n\n public static void unzip(@NonNull ZipInputStream zis, @NonNull Path targetPath)\n throws IOException {\n // 1. unzip file to folder\n // 2. return the folder path\n Assert.notNull(zis, \"Zip input stream must not be null\");\n Assert.notNull(targetPath, \"Target path must not be null\");\n\n // Create path if absent\n createIfAbsent(targetPath);\n\n // Folder must be empty\n ensureEmpty(targetPath);\n\n ZipEntry zipEntry = zis.getNextEntry();\n\n while (zipEntry != null) {\n // Resolve the entry path\n Path entryPath = targetPath.resolve(zipEntry.getName());\n\n checkDirectoryTraversal(targetPath, entryPath);\n\n if (Files.notExists(entryPath.getParent())) {\n Files.createDirectories(entryPath.getParent());\n }\n\n if (zipEntry.isDirectory()) {\n // Create directory\n Files.createDirectory(entryPath);\n } else {\n // Copy file\n Files.copy(zis, entryPath);\n }\n\n zipEntry = zis.getNextEntry();\n }\n }\n\n public static void zip(Path sourcePath, Path targetPath) throws IOException {\n try (var zos = new ZipOutputStream(Files.newOutputStream(targetPath))) {\n Files.walkFileTree(sourcePath, new SimpleFileVisitor<>() {\n @Override\n public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)\n throws IOException {\n checkDirectoryTraversal(sourcePath, file);\n var relativePath = sourcePath.relativize(file);\n var entry = new ZipEntry(relativePath.toString());\n zos.putNextEntry(entry);\n Files.copy(file, zos);\n zos.closeEntry();\n return super.visitFile(file, attrs);\n }\n });\n }\n }\n\n public static void jar(Path sourcePath, Path targetPath) throws IOException {\n try (var jos = new JarOutputStream(Files.newOutputStream(targetPath))) {\n Files.walkFileTree(sourcePath, new SimpleFileVisitor<>() {\n @Override\n public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)\n throws IOException {\n checkDirectoryTraversal(sourcePath, file);\n var relativePath = sourcePath.relativize(file);\n var entry = new JarEntry(relativePath.toString());\n jos.putNextEntry(entry);\n Files.copy(file, jos);\n jos.closeEntry();\n return super.visitFile(file, attrs);\n }\n });\n }\n }\n\n /**\n * Creates directories if absent.\n *\n * @param path path must not be null\n * @throws IOException io exception\n */\n public static void createIfAbsent(@NonNull Path path) throws IOException {\n Assert.notNull(path, \"Path must not be null\");\n\n if (Files.notExists(path)) {\n // Create directories\n Files.createDirectories(path);\n\n log.debug(\"Created directory: [{}]\", path);\n }\n }\n\n /**\n * The given path must be empty.\n *\n * @param path path must not be null\n * @throws IOException io exception\n */\n public static void ensureEmpty(@NonNull Path path) throws IOException {\n if (!isEmpty(path)) {\n throw new DirectoryNotEmptyException(\"Target directory: \" + path + \" was not empty\");\n }\n }\n\n /**\n * Checks if the given path is empty.\n *\n * @param path path must not be null\n * @return true if the given path is empty; false otherwise\n * @throws IOException io exception\n */\n public static boolean isEmpty(@NonNull Path path) throws IOException {\n Assert.notNull(path, \"Path must not be null\");\n\n if (!Files.isDirectory(path) || Files.notExists(path)) {\n return true;\n }\n\n try (Stream pathStream = Files.list(path)) {\n return pathStream.findAny().isEmpty();\n }\n }\n\n public static void closeQuietly(final Closeable closeable) {\n closeQuietly(closeable, null);\n }\n\n /**\n * Closes the given {@link Closeable} as a null-safe operation while consuming IOException by\n * the given {@code consumer}.\n *\n * @param closeable The resource to close, may be null.\n * @param consumer Consumes the IOException thrown by {@link Closeable#close()}.\n */\n public static void closeQuietly(final Closeable closeable,\n final Consumer consumer) {\n if (closeable != null) {\n try {\n closeable.close();\n } catch (IOException e) {\n if (consumer != null) {\n consumer.accept(e);\n }\n }\n }\n }\n\n /**\n * Checks directory traversal vulnerability.\n *\n * @param parentPath parent path must not be null.\n * @param pathToCheck path to check must not be null\n */\n public static void checkDirectoryTraversal(@NonNull Path parentPath,\n @NonNull Path pathToCheck) {\n Assert.notNull(parentPath, \"Parent path must not be null\");\n Assert.notNull(pathToCheck, \"Path to check must not be null\");\n\n if (pathToCheck.normalize().startsWith(parentPath)) {\n return;\n }\n\n throw new AccessDeniedException(\"Directory traversal detected: \" + pathToCheck,\n \"problemDetail.directoryTraversal\", new Object[] {parentPath, pathToCheck});\n }\n\n /**\n * Checks directory traversal vulnerability.\n *\n * @param parentPath parent path must not be null.\n * @param pathToCheck path to check must not be null\n */\n public static void checkDirectoryTraversal(@NonNull String parentPath,\n @NonNull String pathToCheck) {\n checkDirectoryTraversal(Paths.get(parentPath), Paths.get(pathToCheck));\n }\n\n /**\n * Checks directory traversal vulnerability.\n *\n * @param parentPath parent path must not be null.\n * @param pathToCheck path to check must not be null\n */\n public static void checkDirectoryTraversal(@NonNull Path parentPath,\n @NonNull String pathToCheck) {\n checkDirectoryTraversal(parentPath, Paths.get(pathToCheck));\n }\n\n /**\n * Delete folder recursively without exception throwing.\n *\n * @param root the root File to delete\n */\n public static void deleteRecursivelyAndSilently(Path root) {\n try {\n var deleted = deleteRecursively(root);\n if (log.isDebugEnabled()) {\n log.debug(\"Delete {} result: {}\", root, deleted);\n }\n } catch (IOException ignored) {\n // Ignore this error\n }\n }\n\n public static Mono deleteRecursivelyAndSilently(\n Path root, @Nullable Scheduler scheduler\n ) {\n var delete = Mono.fromSupplier(() -> {\n try {\n return deleteRecursively(root);\n } catch (IOException ignored) {\n return false;\n }\n });\n if (scheduler != null) {\n return delete.subscribeOn(scheduler);\n }\n return delete;\n }\n\n\n public static Mono deleteFileSilently(Path file) {\n return deleteFileSilently(file, Schedulers.boundedElastic());\n }\n\n public static Mono deleteFileSilently(Path file, Scheduler scheduler) {\n return Mono.fromSupplier(\n () -> {\n if (file == null || !Files.isRegularFile(file)) {\n return false;\n }\n try {\n return Files.deleteIfExists(file);\n } catch (IOException ignored) {\n return false;\n }\n })\n .subscribeOn(scheduler);\n }\n\n public static void copyResource(Resource resource, Path path) {\n try (var inputStream = resource.getInputStream()) {\n Files.copy(inputStream, path, REPLACE_EXISTING);\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n\n public static void copy(Path source, Path dest, CopyOption... options) {\n try {\n Files.copy(source, dest, options);\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n\n public static void copyRecursively(Path src, Path target, Set excludes)\n throws IOException {\n var pathMatcher = new AntPathMatcher();\n Predicate shouldExclude = path -> excludes.stream()\n .anyMatch(pattern -> pathMatcher.match(pattern, path.toString()));\n Files.walkFileTree(src, new SimpleFileVisitor<>() {\n @Override\n public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)\n throws IOException {\n if (!shouldExclude.test(src.relativize(file))) {\n Files.copy(file, target.resolve(src.relativize(file)), REPLACE_EXISTING);\n }\n return super.visitFile(file, attrs);\n }\n\n @Override\n public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs)\n throws IOException {\n if (shouldExclude.test(src.relativize(dir))) {\n return FileVisitResult.SKIP_SUBTREE;\n }\n Files.createDirectories(target.resolve(src.relativize(dir)));\n return super.preVisitDirectory(dir, attrs);\n }\n });\n }\n\n public static Mono createTempDir(String prefix, @Nullable Scheduler scheduler) {\n var createTempDir = Mono.fromCallable(() -> Files.createTempDirectory(prefix));\n if (scheduler != null) {\n return createTempDir.subscribeOn(scheduler);\n }\n return createTempDir;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/HaloUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.net.URI;\nimport java.nio.charset.StandardCharsets;\nimport java.time.Instant;\nimport java.time.ZoneId;\nimport java.util.function.UnaryOperator;\nimport lombok.experimental.UtilityClass;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.core.io.ClassPathResource;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.util.Assert;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.util.InvalidUrlException;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport org.springframework.web.util.UriComponentsBuilder.ParserType;\nimport org.springframework.web.util.UriUtils;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * Halo utilities.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@UtilityClass\npublic class HaloUtils {\n\n /**\n * Check if the request is an XMLHttpRequest.\n */\n public static boolean isXhr(HttpHeaders headers) {\n return headers.getOrEmpty(\"X-Requested-With\").contains(\"XMLHttpRequest\");\n }\n\n /**\n *

Read the file under the classpath as a string.

\n *\n * @param location the file location relative to classpath\n * @return file content\n */\n public static String readClassPathResourceAsString(String location) {\n ClassPathResource classPathResource = new ClassPathResource(location);\n try (InputStream inputStream = classPathResource.getInputStream()) {\n return StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);\n } catch (IOException e) {\n throw new IllegalArgumentException(\n String.format(\"Failed to read class path file as string from location [%s]\",\n location), e);\n }\n }\n\n /**\n * Gets user-agent from server request.\n *\n * @param request server request\n * @return user-agent string if found, otherwise \"unknown\"\n */\n public static String userAgentFrom(ServerRequest request) {\n HttpHeaders httpHeaders = request.headers().asHttpHeaders();\n // https://en.wikipedia.org/wiki/User_agent\n String userAgent = httpHeaders.getFirst(HttpHeaders.USER_AGENT);\n if (StringUtils.isBlank(userAgent)) {\n // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-CH-UA\n userAgent = httpHeaders.getFirst(\"Sec-CH-UA\");\n }\n return StringUtils.defaultIfBlank(userAgent, \"unknown\");\n }\n\n public static String getDayText(Instant instant) {\n Assert.notNull(instant, \"Instant must not be null\");\n int dayValue = instant.atZone(ZoneId.systemDefault()).getDayOfMonth();\n return StringUtils.leftPad(String.valueOf(dayValue), 2, '0');\n }\n\n public static String getMonthText(Instant instant) {\n Assert.notNull(instant, \"Instant must not be null\");\n int monthValue = instant.atZone(ZoneId.systemDefault()).getMonthValue();\n return StringUtils.leftPad(String.valueOf(monthValue), 2, '0');\n }\n\n public static String getYearText(Instant instant) {\n Assert.notNull(instant, \"Instant must not be null\");\n return String.valueOf(instant.atZone(ZoneId.systemDefault()).getYear());\n }\n\n /**\n * Mark the response as no cache.\n *\n * @return the server request operator\n */\n public static UnaryOperator noCache() {\n return request -> {\n request.exchange().getAttributes().put(ModelConst.NO_CACHE, true);\n return request;\n };\n }\n\n /**\n * Safely convert string to URI. This method will assume the input string is already encoded.\n * If failed, it will try to encode the string.\n *\n * @param uri the uri string\n * @return the uri\n */\n public static URI safeToUri(String uri) {\n // try to decode first\n var decodedUri = UriUtils.decode(uri, StandardCharsets.UTF_8);\n UriComponentsBuilder uriBuilder;\n try {\n uriBuilder = UriComponentsBuilder.fromUriString(decodedUri);\n } catch (InvalidUrlException e) {\n uriBuilder = UriComponentsBuilder.fromUriString(decodedUri, ParserType.WHAT_WG);\n }\n return uriBuilder\n .build(false)\n .encode()\n .toUri();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/IpAddressUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.ServerRequest;\n\n/**\n * Ip address utils.\n * Code from internet.\n */\n@Slf4j\npublic class IpAddressUtils {\n public static final String UNKNOWN = \"unknown\";\n\n private static final String[] IP_HEADER_NAMES = {\n \"X-Forwarded-For\",\n \"X-Real-IP\",\n \"Proxy-Client-IP\",\n \"WL-Proxy-Client-IP\",\n \"CF-Connecting-IP\",\n \"HTTP_X_FORWARDED_FOR\",\n \"HTTP_X_FORWARDED\",\n \"HTTP_X_CLUSTER_CLIENT_IP\",\n \"HTTP_CLIENT_IP\",\n \"HTTP_FORWARDED_FOR\",\n \"HTTP_FORWARDED\",\n \"HTTP_VIA\",\n \"REMOTE_ADDR\",\n };\n\n /**\n * Gets the IP address from request.\n *\n * @param request is server http request\n * @return IP address if found, otherwise {@link #UNKNOWN}.\n */\n public static String getClientIp(ServerHttpRequest request) {\n for (String header : IP_HEADER_NAMES) {\n String ipList = request.getHeaders().getFirst(header);\n if (StringUtils.hasText(ipList) && !UNKNOWN.equalsIgnoreCase(ipList)) {\n String[] ips = ipList.trim().split(\"[,;]\");\n for (String ip : ips) {\n if (StringUtils.hasText(ip) && !UNKNOWN.equalsIgnoreCase(ip)) {\n return ip;\n }\n }\n }\n }\n var remoteAddress = request.getRemoteAddress();\n return remoteAddress == null || remoteAddress.isUnresolved()\n ? UNKNOWN : remoteAddress.getAddress().getHostAddress();\n }\n\n\n /**\n * Gets the ip address from request.\n *\n * @param request http request\n * @return ip address if found, otherwise {@link #UNKNOWN}.\n */\n public static String getIpAddress(ServerRequest request) {\n try {\n return getClientIp(request.exchange().getRequest());\n } catch (Exception e) {\n log.warn(\"Failed to obtain client IP, and fallback to unknown.\", e);\n return UNKNOWN;\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/ReactiveUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport java.time.Duration;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.context.Context;\nimport reactor.util.context.ContextView;\n\n/**\n * Utility class for reactive.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic enum ReactiveUtils {\n ;\n\n /**\n * Default timeout for blocking operation.\n */\n public static final Duration DEFAULT_TIMEOUT = Duration.ofSeconds(10);\n\n /**\n * Resolve reactive value by blocking operation.\n *\n * @param value the normal value or reactive value\n * @return the resolved value\n */\n @Nullable\n public static Object blockReactiveValue(@Nullable Object value) {\n return blockReactiveValue(value, DEFAULT_TIMEOUT);\n }\n\n /**\n * Resolve reactive value by blocking operation.\n *\n * @param value the normal value or reactive value\n * @return the resolved value\n */\n @Nullable\n public static Object blockReactiveValue(@Nullable Object value, ContextView contextView) {\n return blockReactiveValue(value, contextView, DEFAULT_TIMEOUT);\n }\n\n /**\n * Resolve reactive value by blocking operation.\n *\n * @param value the normal value or reactive value\n * @param timeout the timeout of blocking operation\n * @return the resolved value\n */\n @Nullable\n public static Object blockReactiveValue(\n @Nullable Object value, @Nullable ContextView contextView, @NonNull Duration timeout\n ) {\n if (value == null) {\n return null;\n }\n if (contextView == null) {\n contextView = Context.empty();\n }\n Class clazz = value.getClass();\n if (Mono.class.isAssignableFrom(clazz)) {\n return ((Mono) value).contextWrite(contextView).blockOptional(timeout).orElse(null);\n }\n if (Flux.class.isAssignableFrom(clazz)) {\n return ((Flux) value).contextWrite(contextView).collectList().block(timeout);\n }\n return value;\n }\n\n /**\n * Resolve reactive value by blocking operation.\n *\n * @param value the normal value or reactive value\n * @param timeout the timeout of blocking operation\n * @return the resolved value\n */\n @Nullable\n public static Object blockReactiveValue(@Nullable Object value, @NonNull Duration timeout) {\n return blockReactiveValue(value, null, timeout);\n }\n\n /**\n * Check if the class is a reactive type.\n *\n * @param clazz the class to check\n * @return true if the class is a reactive type, false otherwise\n */\n public static boolean isReactiveType(@NonNull Class clazz) {\n return Mono.class.isAssignableFrom(clazz) || Flux.class.isAssignableFrom(clazz);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/SettingUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport static com.fasterxml.jackson.annotation.JsonInclude.Include.NON_NULL;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.github.fge.jsonpatch.JsonPatchException;\nimport com.github.fge.jsonpatch.mergepatch.JsonMergePatch;\nimport java.util.HashMap;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.stream.Collectors;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler.Result;\nimport run.halo.app.extension.controller.RequeueException;\nimport tools.jackson.core.JacksonException;\nimport tools.jackson.databind.JsonNode;\nimport tools.jackson.databind.json.JsonMapper;\nimport tools.jackson.databind.node.ObjectNode;\n\npublic enum SettingUtils {\n ;\n\n private static final JsonMapper MAPPER = JsonMapper.builder()\n .changeDefaultPropertyInclusion(v ->\n v.withValueInclusion(NON_NULL).withContentInclusion(NON_NULL)\n )\n .build();\n\n private static final String VALUE_FIELD = \"value\";\n private static final String NAME_FIELD = \"name\";\n\n /**\n * Read setting default value from {@link Setting} forms.\n *\n * @param setting {@link Setting} extension\n * @return a map of setting default value\n */\n @NonNull\n public static Map settingDefinedDefaultValueMap(Setting setting) {\n List forms = setting.getSpec().getForms();\n if (CollectionUtils.isEmpty(forms)) {\n return Map.of();\n }\n Map data = new LinkedHashMap<>();\n for (Setting.SettingForm form : forms) {\n String group = form.getGroup();\n Map groupValue = form.getFormSchema().stream()\n .map(o -> MAPPER.convertValue(o, JsonNode.class))\n .filter(jsonNode -> jsonNode.isObject() && jsonNode.has(NAME_FIELD)\n && jsonNode.has(VALUE_FIELD))\n .map(jsonNode -> {\n String name = jsonNode.get(NAME_FIELD).asString();\n JsonNode value = jsonNode.get(VALUE_FIELD);\n return Map.entry(name, value);\n })\n .collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue));\n data.put(group, MAPPER.writeValueAsString(groupValue));\n }\n return data;\n }\n\n /**\n * Create or update config map by provided setting name and configMapName.\n *\n * @param client extension client\n * @param settingName a name for {@link Setting}\n * @param configMapName a name for {@link ConfigMap}\n */\n public static void createOrUpdateConfigMap(ExtensionClient client, String settingName,\n String configMapName) {\n Assert.notNull(client, \"Extension client must not be null\");\n Assert.hasText(settingName, \"Setting name must not be blank\");\n Assert.hasText(configMapName, \"Config map name must not be blank\");\n\n client.fetch(Setting.class, settingName)\n .ifPresentOrElse(setting -> {\n final var source = SettingUtils.settingDefinedDefaultValueMap(setting);\n client.fetch(ConfigMap.class, configMapName)\n .ifPresentOrElse(configMap -> {\n Map modified =\n Objects.requireNonNullElse(configMap.getData(), Map.of());\n var copy = new HashMap<>(modified);\n\n var merged = SettingUtils.mergePatch(modified, source);\n configMap.setData(merged);\n\n if (!Objects.equals(copy, configMap.getData())) {\n client.update(configMap);\n }\n }, () -> {\n ConfigMap configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(configMapName);\n configMap.setData(source);\n client.create(configMap);\n });\n }, () -> {\n // requeue if setting was not found\n throw new RequeueException(Result.requeue(null),\n \"Theme setting %s was not found\".formatted(settingName)\n );\n });\n }\n\n public static ConfigMap populateDefaultConfig(Setting setting, String configMapName) {\n var data = settingDefinedDefaultValueMap(setting);\n ConfigMap configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(configMapName);\n configMap.setData(data);\n return configMap;\n }\n\n /**\n * Construct a JsonMergePatch from a difference between two Maps and apply patch to\n * {@code source}.\n *\n * @param modified the modified object\n * @param source the source object\n * @return patched map object\n */\n public static Map mergePatch(Map modified,\n Map source) {\n var modifiedJson = mapToJsonNode(modified);\n // original\n var sourceJson = mapToJsonNode(source);\n try {\n // patch\n var jsonMergePatch = JsonMergePatch.fromJson(modifiedJson);\n // apply patch to original\n var patchedNode = jsonMergePatch.apply(sourceJson);\n return jsonNodeToStringMap(patchedNode);\n } catch (JsonPatchException e) {\n throw new JsonParseException(e);\n }\n }\n\n /**\n * Convert {@link Setting} related configMap data to JsonNode.\n *\n * @param configMap {@link ConfigMap} instance\n * @return JsonNode\n */\n public static ObjectNode settingConfigToJson(ConfigMap configMap) {\n if (configMap.getData() == null) {\n return MAPPER.createObjectNode();\n }\n return mapToObjectNode(configMap.getData());\n }\n\n /**\n * Convert the result of {@link #settingConfigToJson(ConfigMap)} in reverse to Map.\n *\n * @param node JsonNode object\n * @return {@link ConfigMap#getData()}\n */\n public static Map settingConfigJsonToMap(ObjectNode node) {\n return jsonNodeToStringMap(node);\n }\n\n /**\n * Convert {@code Map} to\n * {@link com.fasterxml.jackson.databind.node.ObjectNode}.\n *\n * @param map source map\n * @return ObjectNode\n */\n private static com.fasterxml.jackson.databind.node.ObjectNode mapToJsonNode(\n Map map) {\n var objectNode = JsonUtils.mapper().createObjectNode();\n map.forEach((k, v) -> {\n if (v == null) {\n objectNode.putNull(k);\n return;\n }\n try {\n var value = JsonUtils.mapper().readTree(v);\n objectNode.set(k, value);\n } catch (JsonProcessingException ignored) {\n // ignore exception and put as text\n objectNode.put(k, v);\n }\n });\n return objectNode;\n }\n\n private static ObjectNode mapToObjectNode(Map map) {\n var objectNode = MAPPER.createObjectNode();\n map.forEach((k, v) -> {\n if (v == null) {\n objectNode.putNull(k);\n return;\n }\n try {\n var value = MAPPER.readTree(v);\n objectNode.set(k, value);\n } catch (JacksonException ignored) {\n // ignore exception and put as text\n objectNode.put(k, v);\n }\n });\n return objectNode;\n }\n\n private static Map jsonNodeToStringMap(\n com.fasterxml.jackson.databind.JsonNode node\n ) {\n Map stringMap = new LinkedHashMap<>();\n node.forEachEntry((k, v) -> {\n if (v == null || v.isNull() || v.isMissingNode()) {\n stringMap.put(k, null);\n return;\n }\n if (v.isTextual()) {\n stringMap.put(k, v.asText());\n return;\n }\n if (v.isContainerNode()) {\n stringMap.put(k, v.toString());\n return;\n }\n stringMap.put(k, v.asText());\n });\n return stringMap;\n }\n\n private static Map jsonNodeToStringMap(JsonNode node) {\n Map stringMap = new LinkedHashMap<>();\n node.forEachEntry((k, v) -> {\n if (v == null || v.isNull() || v.isMissingNode()) {\n stringMap.put(k, null);\n return;\n }\n if (v.isString()) {\n stringMap.put(k, v.asString());\n return;\n }\n if (v.isContainer()) {\n stringMap.put(k, v.toString());\n return;\n }\n stringMap.put(k, v.asString());\n });\n return stringMap;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/SortUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport java.util.List;\nimport lombok.experimental.UtilityClass;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\n\n@UtilityClass\npublic class SortUtils {\n static final String delimiter = \",\";\n\n /**\n *

Resolve from direction params, e.g. \"name,asc\" or \"name\"

\n *\n * @param directionParams direction params\n * @return sort object\n */\n public static Sort resolve(List directionParams) {\n if (CollectionUtils.isEmpty(directionParams)) {\n return Sort.unsorted();\n }\n Sort.Order[] orders = new Sort.Order[directionParams.size()];\n for (int i = 0; i < directionParams.size(); i++) {\n String[] parts = directionParams.get(i).split(delimiter);\n if (parts.length == 1) {\n orders[i] = new Sort.Order(Sort.Direction.ASC, parts[0]);\n } else {\n orders[i] = new Sort.Order(toDirection(parts[1]), parts[0]);\n }\n }\n return Sort.by(orders);\n }\n\n private static Sort.Direction toDirection(@NonNull String direction) {\n Assert.notNull(direction, \"Direction must not be null\");\n if (direction.contains(\" \")) {\n throw new IllegalArgumentException(\"Direction must not contain whitespace\");\n }\n return Sort.Direction.fromString(direction);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/SystemConfigUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport com.google.common.hash.Hashing;\nimport java.nio.charset.StandardCharsets;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.extension.ConfigMap;\n\n/**\n * Utility class for merging configuration maps containing JSON strings.\n *\n * @author johnniang\n * @since 2.22.0\n */\n@Slf4j\npublic enum SystemConfigUtils {\n ;\n\n private static final ObjectMapper mapper = JsonUtils.mapper();\n\n private static final String DATA_SNAPSHOT_ANNO = \"halo.run/data-snapshot\";\n\n /**\n * Merge two configuration maps containing JSON strings.\n *\n * @param defaultMap the default configuration map\n * @param overrideMap the override configuration map\n * @return the merged configuration map\n * @throws JsonProcessingException if JSON processing fails\n */\n public static Map mergeMap(\n Map defaultMap, Map overrideMap\n ) throws JsonProcessingException {\n if (CollectionUtils.isEmpty(defaultMap)) {\n return overrideMap;\n }\n if (CollectionUtils.isEmpty(overrideMap)) {\n return defaultMap;\n }\n var result = new HashMap<>(defaultMap);\n for (Map.Entry entry : overrideMap.entrySet()) {\n var group = entry.getKey();\n var overrideJson = entry.getValue();\n if (result.containsKey(group)) {\n // Perform a deep merge of the two JSON strings\n String defaultJson = result.get(group);\n result.put(group, mergeJsonStrings(defaultJson, overrideJson));\n } else {\n // Key only exists in override map\n result.put(group, overrideJson);\n }\n }\n return result;\n }\n\n /**\n * Compute the merged ConfigMap from default and override ConfigMaps.\n *\n * @param defaultConfigMap the default ConfigMap\n * @param overrideConfigMap the override ConfigMap\n * @return the merged ConfigMap\n * @throws JsonProcessingException if JSON processing fails\n */\n public static ConfigMap mergeConfigMap(\n ConfigMap defaultConfigMap,\n ConfigMap overrideConfigMap\n ) throws JsonProcessingException {\n var mergedData = mergeMap(\n defaultConfigMap.getData() != null ? defaultConfigMap.getData() : Map.of(),\n overrideConfigMap.getData() != null ? overrideConfigMap.getData() : Map.of()\n );\n var merged = new ConfigMap();\n merged.setMetadata(overrideConfigMap.getMetadata());\n merged.setData(mergedData);\n return merged;\n }\n\n private static String mergeJsonStrings(String mainJson, String updateJson)\n throws JsonProcessingException {\n var mainNode = mapper.readTree(mainJson);\n var updateNode = mapper.readTree(updateJson);\n\n // This performs a deep merge into the mainNode\n var mergedNode = deepMerge(mainNode, updateNode);\n\n return mapper.writeValueAsString(mergedNode);\n }\n\n private static JsonNode deepMerge(JsonNode mainNode, JsonNode updateNode) {\n // If they aren't both objects, the update simply replaces the main\n if (!mainNode.isObject() || !updateNode.isObject()) {\n return updateNode;\n }\n var mainObject = (ObjectNode) mainNode;\n updateNode.properties().forEach(entry -> {\n String key = entry.getKey();\n JsonNode value = entry.getValue();\n\n if (mainObject.has(key)) {\n mainObject.set(key, deepMerge(mainObject.get(key), value));\n } else {\n mainObject.set(key, value);\n }\n });\n return mainObject;\n }\n\n /**\n * Populate checksum annotation in the ConfigMap.\n *\n * @param configMap the ConfigMap to populate checksum for\n * @return true if the checksum was updated, false otherwise\n */\n public static boolean populateChecksum(ConfigMap configMap) {\n var toHash = Optional.ofNullable(configMap.getData())\n .map(Objects::toString)\n .orElse(\"\");\n var checksum = Hashing.sha256().hashString(toHash, StandardCharsets.UTF_8)\n .toString();\n var metadata = configMap.getMetadata();\n var notChanged = Optional.ofNullable(metadata.getAnnotations())\n .map(annotations -> annotations.get(Constant.CHECKSUM_CONFIG_ANNO))\n .stream()\n .anyMatch(existingChecksum -> Objects.equals(checksum, existingChecksum));\n if (notChanged) {\n log.debug(\"ConfigMap '{}' has not changed.\", configMap.getMetadata().getName());\n return false;\n }\n log.debug(\"ConfigMap '{}' has changed, updating checksum {}.\",\n configMap.getMetadata().getName(), checksum);\n if (metadata.getAnnotations() == null) {\n metadata.setAnnotations(new HashMap<>());\n }\n metadata.getAnnotations().put(Constant.CHECKSUM_CONFIG_ANNO, checksum);\n return true;\n }\n\n /**\n * Update data snapshot annotation in the ConfigMap.\n *\n * @param configMap the ConfigMap\n */\n public static void updateDataSnapshot(ConfigMap configMap) {\n Optional.ofNullable(configMap.getData())\n .map(JsonUtils::objectToJson)\n .ifPresent(dataJson -> {\n var metadata = configMap.getMetadata();\n if (metadata.getAnnotations() == null) {\n metadata.setAnnotations(new HashMap<>());\n }\n metadata.getAnnotations().put(DATA_SNAPSHOT_ANNO, dataJson);\n });\n }\n\n /**\n * Get data snapshot from ConfigMap annotations.\n *\n * @param configMap the ConfigMap\n * @return the data snapshot\n */\n public static Map getDataSnapshot(ConfigMap configMap) {\n return Optional.ofNullable(configMap.getMetadata().getAnnotations())\n .map(annotations -> annotations.get(DATA_SNAPSHOT_ANNO))\n .map(dataJson -> JsonUtils.jsonToObject(\n dataJson,\n new TypeReference>() {\n }\n ))\n .orElse(Map.of());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/VersionUtils.java", "content": "package run.halo.app.infra.utils;\n\nimport com.github.zafarkhaja.semver.Version;\nimport com.github.zafarkhaja.semver.expr.Expression;\nimport lombok.experimental.UtilityClass;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.web.server.ServerWebInputException;\n\n@UtilityClass\npublic class VersionUtils {\n\n /**\n * Check if this \"requires\" param satisfies for a given (system) version.\n *\n * @param version the version to check\n * @return true if version satisfies the \"requires\" or if requires was left blank\n */\n public static boolean satisfiesRequires(String version, String requires) {\n String requiresVersion = StringUtils.trim(requires);\n\n // an exact version x.y.z will implicitly mean the same as >=x.y.z\n if (requiresVersion.matches(\"^\\\\d+\\\\.\\\\d+\\\\.\\\\d+$\")) {\n // If exact versions are not allowed in requires, rewrite to >= expression\n requiresVersion = \">=\" + requiresVersion;\n }\n return version.equals(\"0.0.0\") || checkVersionConstraint(version, requiresVersion);\n }\n\n /**\n * Checks if a version satisfies the specified SemVer {@link Expression} string.\n * If the constraint is empty or null then the method returns true.\n * Constraint examples: {@code >2.0.0} (simple), {@code \">=1.4.0 & <1.6.0\"} (range).\n * See\n * semver-expressions-api-ranges for more info.\n *\n * @param version the version to check\n * @param constraint the SemVer Expression string\n * @return true if version satisfies the constraint or if constraint was left blank\n */\n public static boolean checkVersionConstraint(String version, String constraint) {\n try {\n return StringUtils.isBlank(constraint)\n || \"*\".equals(constraint)\n || Version.parse(version).satisfies(constraint);\n } catch (Exception e) {\n throw new ServerWebInputException(\"Illegal requires version expression.\", null, e);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/utils/YamlUnstructuredLoader.java", "content": "package run.halo.app.infra.utils;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.springframework.beans.factory.config.YamlProcessor;\nimport org.springframework.core.io.Resource;\nimport run.halo.app.extension.Unstructured;\n\n/**\n *

Process the content in yaml that matches the {@link DocumentMatcher} and convert it to an\n * unstructured list.

\n *

Multiple resources can be processed at one time.

\n *

The following specified key must be included before the resource can be processed:\n * 

\n *     apiVersion\n *     kind\n *     metadata.name\n *
\n * Otherwise, skip it and continue to read the next resource.\n *

\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class YamlUnstructuredLoader extends YamlProcessor {\n\n private static final DocumentMatcher DEFAULT_UNSTRUCTURED_MATCHER = properties -> {\n if (properties.containsKey(\"apiVersion\")\n && properties.containsKey(\"kind\")\n && (properties.containsKey(\"metadata.name\")\n || properties.containsKey(\"metadata.generateName\"))) {\n return YamlProcessor.MatchStatus.FOUND;\n }\n return MatchStatus.NOT_FOUND;\n };\n\n public YamlUnstructuredLoader(Resource... resources) {\n setResources(resources);\n setDocumentMatchers(DEFAULT_UNSTRUCTURED_MATCHER);\n }\n\n public List load() {\n List unstructuredList = new ArrayList<>();\n process((properties, map) -> {\n Unstructured unstructured = JsonUtils.mapToObject(map, Unstructured.class);\n unstructuredList.add(unstructured);\n });\n return unstructuredList;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/webfilter/AdditionalWebFilterChainProxy.java", "content": "package run.halo.app.infra.webfilter;\n\nimport lombok.Setter;\nimport org.springframework.core.annotation.AnnotationAwareOrderComparator;\nimport org.springframework.security.web.server.WebFilterChainProxy;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.security.AdditionalWebFilter;\n\npublic class AdditionalWebFilterChainProxy implements WebFilter {\n\n private final ExtensionGetter extensionGetter;\n\n @Setter\n private WebFilterChainProxy.WebFilterChainDecorator filterChainDecorator;\n\n public AdditionalWebFilterChainProxy(ExtensionGetter extensionGetter) {\n this.extensionGetter = extensionGetter;\n this.filterChainDecorator = new WebFilterChainProxy.DefaultWebFilterChainDecorator();\n }\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n return extensionGetter.getEnabledExtensions(AdditionalWebFilter.class)\n .sort(AnnotationAwareOrderComparator.INSTANCE)\n .cast(WebFilter.class)\n .collectList()\n .map(filters -> filterChainDecorator.decorate(chain, filters))\n .flatMap(decoratedChain -> decoratedChain.filter(exchange));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/infra/webfilter/LocaleChangeWebFilter.java", "content": "package run.halo.app.infra.webfilter;\n\nimport static run.halo.app.theme.ThemeLocaleContextResolver.LANGUAGE_COOKIE_NAME;\n\nimport java.util.Locale;\nimport java.util.Objects;\nimport java.util.Set;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.ResponseCookie;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.MediaTypeServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher.MatchResult;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.ThemeLocaleContextResolver;\nimport run.halo.app.theme.UserLocaleRequestAttributeWriteFilter;\n\n/**\n * {@link UserLocaleRequestAttributeWriteFilter} is before {@link LocaleChangeWebFilter} to\n * obtain the locale.\n */\n@Component\n@Order(Ordered.HIGHEST_PRECEDENCE + 1)\npublic class LocaleChangeWebFilter implements WebFilter {\n\n private final ServerWebExchangeMatcher matcher;\n private final ThemeLocaleContextResolver themeLocaleContextResolver;\n\n public LocaleChangeWebFilter(ThemeLocaleContextResolver themeLocaleContextResolver) {\n this.themeLocaleContextResolver = themeLocaleContextResolver;\n var pathMatcher = ServerWebExchangeMatchers.pathMatchers(HttpMethod.GET, \"/**\");\n var textHtmlMatcher = new MediaTypeServerWebExchangeMatcher(MediaType.TEXT_HTML);\n textHtmlMatcher.setIgnoredMediaTypes(Set.of(MediaType.ALL));\n matcher = new AndServerWebExchangeMatcher(pathMatcher, textHtmlMatcher);\n }\n\n @Override\n @NonNull\n public Mono filter(ServerWebExchange exchange, @NonNull WebFilterChain chain) {\n return matcher.matches(exchange)\n .filter(MatchResult::isMatch)\n .doOnNext(result -> {\n var localeContext = themeLocaleContextResolver.resolveLocaleContext(exchange);\n var locale = localeContext.getLocale();\n if (locale != null) {\n setLanguageCookieIfAbsent(exchange, locale);\n }\n })\n .then(Mono.defer(() -> chain.filter(exchange)));\n }\n\n void setLanguageCookieIfAbsent(ServerWebExchange exchange, Locale locale) {\n var languageCookie = exchange.getRequest().getCookies().getFirst(LANGUAGE_COOKIE_NAME);\n if (languageCookie != null\n && Objects.equals(languageCookie.getValue(), locale.toLanguageTag())) {\n return;\n }\n var cookie = ResponseCookie.from(LANGUAGE_COOKIE_NAME, locale.toLanguageTag())\n .path(\"/\")\n .secure(\"https\".equalsIgnoreCase(exchange.getRequest().getURI().getScheme()))\n .sameSite(\"Lax\")\n .build();\n exchange.getResponse().getCookies().set(LANGUAGE_COOKIE_NAME, cookie);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/migration/BackupFile.java", "content": "package run.halo.app.migration;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport java.nio.file.Path;\nimport java.time.Instant;\nimport lombok.Data;\n\n/**\n * Backup file.\n *\n * @author johnniang\n */\n@Data\npublic class BackupFile {\n\n @JsonIgnore\n private Path path;\n\n /**\n * Filename of backup file.\n */\n private String filename;\n\n /**\n * Size of backup file.\n */\n private long size;\n\n /**\n * Last modified time of backup file.\n */\n private Instant lastModifiedTime;\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/migration/BackupReconciler.java", "content": "package run.halo.app.migration;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.isDeleted;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.controller.Reconciler.Result.doNotRetry;\nimport static run.halo.app.migration.Constant.HOUSE_KEEPER_FINALIZER;\n\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Set;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport reactor.core.Exceptions;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.migration.Backup.Phase;\n\n@Slf4j\n@Component\npublic class BackupReconciler implements Reconciler {\n\n private final ExtensionClient client;\n\n private final MigrationService migrationService;\n\n private Clock clock;\n\n public BackupReconciler(ExtensionClient client, MigrationService migrationService) {\n this.client = client;\n this.migrationService = migrationService;\n clock = Clock.systemDefaultZone();\n }\n\n /**\n * Set clock. The method is only for unit test.\n *\n * @param clock is new clock\n */\n void setClock(Clock clock) {\n this.clock = clock;\n }\n\n @Override\n public Result reconcile(Request request) {\n return client.fetch(Backup.class, request.name())\n .map(backup -> {\n var metadata = backup.getMetadata();\n var status = backup.getStatus();\n var spec = backup.getSpec();\n if (isDeleted(backup)) {\n if (removeFinalizers(metadata, Set.of(HOUSE_KEEPER_FINALIZER))) {\n migrationService.cleanup(backup).block(ReactiveUtils.DEFAULT_TIMEOUT);\n client.update(backup);\n }\n return doNotRetry();\n }\n if (addFinalizers(metadata, Set.of(HOUSE_KEEPER_FINALIZER))) {\n client.update(backup);\n }\n\n if (Phase.PENDING.equals(status.getPhase())) {\n // Do backup\n try {\n status.setPhase(Phase.RUNNING);\n status.setStartTimestamp(Instant.now(clock));\n updateStatus(request.name(), status);\n // Long period execution when backing up\n migrationService.backup(backup).block(Duration.ofMinutes(30));\n status.setPhase(Phase.SUCCEEDED);\n status.setCompletionTimestamp(Instant.now(clock));\n updateStatus(request.name(), status);\n } catch (Throwable t) {\n var unwrapped = Exceptions.unwrap(t);\n log.error(\"Failed to backup\", unwrapped);\n // Only happen when shutting down\n status.setPhase(Phase.FAILED);\n if (unwrapped instanceof InterruptedException) {\n status.setFailureReason(\"Interrupted\");\n status.setFailureMessage(\"The backup process was interrupted.\");\n } else {\n status.setFailureReason(\"SystemError\");\n status.setFailureMessage(\n \"Something went wrong! Error message: \" + unwrapped.getMessage());\n }\n updateStatus(request.name(), status);\n }\n }\n // Only happen when failing to update status when interrupted\n if (Phase.RUNNING.equals(status.getPhase())) {\n status.setPhase(Phase.FAILED);\n status.setFailureReason(\"UnexpectedExit\");\n status.setFailureMessage(\"The backup process may exit abnormally.\");\n updateStatus(request.name(), status);\n }\n // Check the expires at and requeue if necessary\n if (isTerminal(status.getPhase())) {\n var expiresAt = spec.getExpiresAt();\n if (expiresAt != null) {\n var now = Instant.now(clock);\n if (now.isBefore(expiresAt)) {\n return new Result(true, Duration.between(now, expiresAt));\n }\n client.delete(backup);\n }\n }\n return doNotRetry();\n }).orElseGet(Result::doNotRetry);\n }\n\n private void updateStatus(String name, Backup.Status status) {\n client.fetch(Backup.class, name)\n .ifPresent(backup -> {\n backup.setStatus(status);\n client.update(backup);\n });\n }\n\n private static boolean isTerminal(Phase phase) {\n return Phase.FAILED.equals(phase) || Phase.SUCCEEDED.equals(phase);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Backup())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/migration/MigrationEndpoint.java", "content": "package run.halo.app.migration;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.net.MalformedURLException;\nimport java.net.URISyntaxException;\nimport java.net.URL;\nimport java.util.Optional;\nimport java.util.function.Supplier;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.core.io.buffer.DefaultDataBufferFactory;\nimport org.springframework.data.util.Optionals;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.http.codec.multipart.FormFieldPart;\nimport org.springframework.http.codec.multipart.Part;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ReactiveUrlDataBufferFetcher;\n\n@Component\npublic class MigrationEndpoint implements CustomEndpoint {\n\n private final MigrationService migrationService;\n\n private final ReactiveExtensionClient client;\n\n private final ReactiveUrlDataBufferFetcher dataBufferFetcher;\n\n public MigrationEndpoint(MigrationService migrationService,\n ReactiveExtensionClient client,\n ReactiveUrlDataBufferFetcher dataBufferFetcher) {\n this.migrationService = migrationService;\n this.client = client;\n this.dataBufferFetcher = dataBufferFetcher;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"MigrationV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"/backup-files\",\n this::getBackups,\n builder -> builder.operationId(\"getBackupFiles\")\n .tag(tag)\n .description(\"Get backup files from backup root.\")\n .response(responseBuilder()\n .implementationArray(BackupFile.class)\n )\n )\n .GET(\"/backups/{name}/files/{filename}\",\n request -> {\n var name = request.pathVariable(\"name\");\n return client.get(Backup.class, name)\n .flatMap(migrationService::download)\n .flatMap(backupResource -> ServerResponse.ok()\n .header(HttpHeaders.CONTENT_DISPOSITION,\n \"attachment; filename=\\\"\" + backupResource.getFilename() + \"\\\"\")\n .contentType(MediaType.APPLICATION_OCTET_STREAM)\n .bodyValue(backupResource));\n },\n builder -> builder\n .tag(tag)\n .operationId(\"DownloadBackups\")\n .parameter(parameterBuilder()\n .name(\"name\")\n .description(\"Backup name.\")\n .required(true)\n .in(ParameterIn.PATH))\n .parameter(parameterBuilder()\n .name(\"filename\")\n .description(\"Backup filename.\")\n .required(true)\n .in(ParameterIn.PATH))\n .build())\n .POST(\"/restorations\", request -> request.multipartData()\n .map(RestoreRequest::new)\n .flatMap(restoreRequest -> {\n var content = getContent(restoreRequest)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Please upload a file \"\n + \"or provide a download link or backup name.\")));\n return migrationService.restore(content);\n })\n .then(Mono.defer(\n () -> ServerResponse.ok().bodyValue(\"Restored successfully!\")\n )),\n builder -> builder\n .tag(tag)\n .description(\"Restore backup by uploading file \"\n + \"or providing download link or backup name.\")\n .operationId(\"RestoreBackup\")\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(RestoreRequest.class))\n )\n )\n .build())\n .build();\n }\n\n private Mono getBackups(ServerRequest request) {\n var backupFiles = migrationService.getBackupFiles();\n return ServerResponse.ok().body(backupFiles, BackupFile.class);\n }\n\n private Flux getContent(RestoreRequest request) {\n Supplier>> contentFromFilename = () ->\n request.getFilename().map(filename -> migrationService.getBackupFile(filename)\n .map(BackupFile::getPath)\n .flatMapMany(\n path -> DataBufferUtils.read(\n path,\n DefaultDataBufferFactory.sharedInstance,\n StreamUtils.BUFFER_SIZE)));\n\n Supplier>> contentFromDownloadUrl = () -> request.getDownloadUrl()\n .map(downloadURL -> {\n try {\n var url = new URL(downloadURL);\n return dataBufferFetcher.fetch(url.toURI());\n } catch (MalformedURLException e) {\n return Flux.error(new ServerWebInputException(\n \"Invalid download URL: \" + downloadURL));\n } catch (URISyntaxException e) {\n // Should never happen\n return Flux.error(e);\n }\n });\n\n Supplier>> contentFromUpload = () -> request.getFile()\n .map(Part::content);\n\n Supplier>> contentFromBackupName = () -> request.getBackupName()\n .map(backupName -> client.get(Backup.class, backupName)\n .flatMap(migrationService::download)\n .flatMapMany(resource -> DataBufferUtils.read(resource,\n DefaultDataBufferFactory.sharedInstance,\n StreamUtils.BUFFER_SIZE)));\n\n return Optionals.firstNonEmpty(\n contentFromUpload,\n contentFromDownloadUrl,\n contentFromBackupName,\n contentFromFilename\n )\n .orElseGet(() -> Flux.error(new ServerWebInputException(\"\"\"\n Please upload a file or provide a download link or backup name or backup filename.\\\n \"\"\")));\n }\n\n @Schema(types = \"object\")\n public static class RestoreRequest {\n private final MultiValueMap multipart;\n\n public RestoreRequest(MultiValueMap multipart) {\n this.multipart = multipart;\n }\n\n @Schema(requiredMode = NOT_REQUIRED, name = \"file\", description = \"Backup file.\")\n public Optional getFile() {\n var part = multipart.getFirst(\"file\");\n if (part instanceof FilePart filePart) {\n return Optional.of(filePart);\n }\n return Optional.empty();\n }\n\n @Schema(requiredMode = NOT_REQUIRED, name = \"filename\", description = \"\"\"\n Filename of backup file in backups root.\\\n \"\"\")\n public Optional getFilename() {\n var part = multipart.getFirst(\"filename\");\n if (part instanceof FormFieldPart filenamePart) {\n return Optional.of(filenamePart.value())\n .filter(StringUtils::hasText);\n }\n return Optional.empty();\n }\n\n @Schema(requiredMode = NOT_REQUIRED,\n name = \"downloadUrl\",\n description = \"Remote backup HTTP URL.\")\n public Optional getDownloadUrl() {\n var part = multipart.getFirst(\"downloadUrl\");\n if (part instanceof FormFieldPart downloadUrlPart) {\n return Optional.of(downloadUrlPart.value())\n .filter(StringUtils::hasText);\n }\n return Optional.empty();\n }\n\n @Schema(requiredMode = NOT_REQUIRED,\n name = \"backupName\",\n description = \"Backup metadata name.\")\n public Optional getBackupName() {\n var part = multipart.getFirst(\"backupName\");\n if (part instanceof FormFieldPart backupNamePart) {\n return Optional.of(backupNamePart.value())\n .filter(StringUtils::hasText);\n }\n return Optional.empty();\n }\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\n \"console.api.\" + Constant.GROUP + \"/\" + Constant.VERSION);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/migration/MigrationService.java", "content": "package run.halo.app.migration;\n\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\npublic interface MigrationService {\n\n Mono backup(Backup backup);\n\n Mono download(Backup backup);\n\n Mono restore(Publisher content);\n\n /**\n * Clean up backup file.\n *\n * @param backup backup detail.\n * @return void publisher.\n */\n Mono cleanup(Backup backup);\n\n /**\n * Gets backup files.\n *\n * @return backup files, sorted by last modified time.\n */\n Flux getBackupFiles();\n\n /**\n * Get backup file by filename.\n *\n * @param filename filename of backup file\n * @return backup file or empty if file is not found\n */\n Mono getBackupFile(String filename);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/migration/impl/MigrationServiceImpl.java", "content": "package run.halo.app.migration.impl;\n\nimport static java.nio.file.Files.deleteIfExists;\nimport static java.util.Comparator.comparing;\nimport static org.apache.commons.io.FilenameUtils.isExtension;\nimport static org.springframework.util.FileSystemUtils.copyRecursively;\nimport static run.halo.app.infra.utils.FileUtils.checkDirectoryTraversal;\nimport static run.halo.app.infra.utils.FileUtils.copyRecursively;\nimport static run.halo.app.infra.utils.FileUtils.createTempDir;\nimport static run.halo.app.infra.utils.FileUtils.deleteRecursivelyAndSilently;\nimport static run.halo.app.infra.utils.FileUtils.unzip;\n\nimport com.fasterxml.jackson.core.util.MinimalPrettyPrinter;\nimport com.fasterxml.jackson.databind.MappingIterator;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.json.JsonMapper;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.time.ZoneId;\nimport java.time.format.DateTimeFormatter;\nimport java.util.Locale;\nimport java.util.Set;\nimport java.util.concurrent.atomic.AtomicInteger;\nimport java.util.function.Predicate;\nimport java.util.stream.BaseStream;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.reactivestreams.Publisher;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.data.r2dbc.core.R2dbcEntityTemplate;\nimport org.springframework.stereotype.Service;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.transaction.TransactionDefinition;\nimport org.springframework.transaction.reactive.TransactionalOperator;\nimport org.springframework.transaction.support.DefaultTransactionDefinition;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.extension.ExtensionStoreUtil;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.store.ExtensionStore;\nimport run.halo.app.extension.store.ExtensionStoreRepository;\nimport run.halo.app.infra.BackupRootGetter;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.migration.Backup;\nimport run.halo.app.migration.BackupFile;\nimport run.halo.app.migration.MigrationService;\n\n@Slf4j\n@Service\n@RequiredArgsConstructor\nclass MigrationServiceImpl implements MigrationService, InitializingBean {\n\n private static final int BATCH_SIZE = 100;\n\n private static final String BACKUP_STORE_PREFIX =\n ExtensionStoreUtil.buildStoreNamePrefix(Scheme.buildFromType(Backup.class)) + \"/\";\n\n private final ExtensionStoreRepository repository;\n\n private final HaloProperties haloProperties;\n\n private final BackupRootGetter backupRoot;\n\n private final ReactiveTransactionManager txManager;\n\n private final R2dbcEntityTemplate entityTemplate;\n\n private final Set excludes = Set.of(\n \"**/.git/**\",\n \"**/node_modules/**\",\n \"backups/**\",\n \"db/**\",\n \"logs/**\",\n \"indices/**\",\n \"docker-compose.yaml\",\n \"docker-compose.yml\",\n \"mysql/**\",\n \"mysqlBackup/**\",\n \"**/.idea/**\",\n \"**/.vscode/**\",\n \"attachments/thumbnails/**\"\n );\n\n private final ObjectMapper objectMapper = JsonMapper.builder()\n .defaultPrettyPrinter(new MinimalPrettyPrinter())\n .build();\n\n private final DateTimeFormatter dateTimeFormatter = DateTimeFormatter\n .ofPattern(\"yyyyMMddHHmmss\")\n .withLocale(Locale.getDefault())\n .withZone(ZoneId.systemDefault());\n\n private final Scheduler scheduler = Schedulers.newBoundedElastic(10, 1_00, \"migration-worker\");\n\n DateTimeFormatter getDateTimeFormatter() {\n return dateTimeFormatter;\n }\n\n ObjectMapper getObjectMapper() {\n return objectMapper;\n }\n\n Path getBackupsRoot() {\n return backupRoot.get();\n }\n\n @Override\n public Mono backup(Backup backup) {\n return Mono.usingWhen(\n createTempDir(\"halo-full-backup-\", scheduler),\n tempDir -> backupExtensions(tempDir)\n .then(Mono.defer(() -> backupWorkDir(tempDir)))\n .then(Mono.defer(() -> packageBackup(tempDir, backup))),\n tempDir -> deleteRecursivelyAndSilently(tempDir, scheduler)\n );\n }\n\n @Override\n public Mono download(Backup backup) {\n return Mono.create(sink -> {\n var status = backup.getStatus();\n if (!Backup.Phase.SUCCEEDED.equals(status.getPhase()) || status.getFilename() == null) {\n sink.error(new ServerWebInputException(\"Current backup is not downloadable.\"));\n return;\n }\n var backupFile = getBackupsRoot().resolve(status.getFilename());\n var resource = new FileSystemResource(backupFile);\n if (!resource.exists()) {\n sink.error(\n new NotFoundException(\"problemDetail.migration.backup.notFound\",\n new Object[] {},\n \"Backup file doesn't exist or deleted.\"));\n return;\n }\n sink.success(resource);\n });\n }\n\n @Override\n public Mono restore(Publisher content) {\n var tx = TransactionalOperator.create(txManager);\n return Mono.usingWhen(\n createTempDir(\"halo-restore-\", scheduler),\n tempDir -> unpackBackup(content, tempDir)\n .then(Mono.defer(() ->\n // This step skips index verification such as unique index.\n // In order to avoid index conflicts after recovery or\n // OptimisticLockingFailureException when updating the same record,\n // so we need to truncate all extension stores before saving(create or\n // update).\n repository.deleteAll()\n .then(restoreExtensions(tempDir))\n .as(tx::transactional)\n ))\n .then(Mono.defer(() -> restoreWorkdir(tempDir))),\n tempDir -> deleteRecursivelyAndSilently(tempDir, scheduler)\n );\n }\n\n @Override\n public Mono cleanup(Backup backup) {\n return Mono.create(sink -> {\n var status = backup.getStatus();\n if (status == null || !StringUtils.hasText(status.getFilename())) {\n sink.success();\n return;\n }\n var filename = status.getFilename();\n var backupsRoot = getBackupsRoot();\n var backupFile = backupsRoot.resolve(filename);\n try {\n checkDirectoryTraversal(backupsRoot, backupFile);\n deleteIfExists(backupFile);\n sink.success();\n } catch (IOException e) {\n sink.error(e);\n }\n }).subscribeOn(scheduler);\n }\n\n @Override\n public Flux getBackupFiles() {\n return Flux.using(\n () -> Files.list(getBackupsRoot()),\n Flux::fromStream,\n BaseStream::close\n )\n .filter(Files::isRegularFile)\n .filter(Files::isReadable)\n .filter(path -> isExtension(path.getFileName().toString(), \"zip\"))\n .map(this::toBackupFile)\n .sort(comparing(BackupFile::getLastModifiedTime).reversed()\n .thenComparing(BackupFile::getFilename)\n )\n .subscribeOn(this.scheduler);\n }\n\n @Override\n public Mono getBackupFile(String filename) {\n return Mono.fromCallable(() -> {\n var backupsRoot = getBackupsRoot();\n var backupFilePath = backupsRoot.resolve(filename);\n checkDirectoryTraversal(backupsRoot, backupFilePath);\n if (Files.notExists(backupFilePath)) {\n return null;\n }\n return toBackupFile(backupFilePath);\n }).subscribeOn(this.scheduler);\n }\n\n private BackupFile toBackupFile(Path path) {\n var backupFile = new BackupFile();\n backupFile.setPath(path);\n backupFile.setFilename(path.getFileName().toString());\n try {\n backupFile.setSize(Files.size(path));\n backupFile.setLastModifiedTime(Files.getLastModifiedTime(path).toInstant());\n return backupFile;\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n }\n }\n\n private Mono restoreWorkdir(Path backupRoot) {\n return Mono.create(sink -> {\n try {\n var workdir = backupRoot.resolve(\"workdir\");\n if (Files.exists(workdir)) {\n copyRecursively(workdir, haloProperties.getWorkDir());\n }\n sink.success();\n } catch (IOException e) {\n sink.error(e);\n }\n }).subscribeOn(scheduler);\n }\n\n private Mono restoreExtensions(Path backupRoot) {\n var extensionsPath = backupRoot.resolve(\"extensions.data\");\n if (Files.notExists(extensionsPath)) {\n return Mono.error(new ServerWebInputException(\"Extensions data file not found.\"));\n }\n var reader = objectMapper.readerFor(ExtensionStore.class);\n var total = new AtomicInteger(0);\n return Mono.>using(\n () -> reader.readValues(extensionsPath.toFile()),\n itr -> Flux.fromIterable(() -> itr)\n // reset version\n .filter(Predicate.not(MigrationServiceImpl::isInBlocklist))\n .doOnNext(extensionStore -> extensionStore.setVersion(null))\n .buffer(100)\n .flatMap(repository::saveAll)\n .doOnNext(store -> {\n var t = total.incrementAndGet();\n if (t % BATCH_SIZE == 0) {\n log.info(\"Restored {} extension stores so far...\", t);\n }\n if (log.isDebugEnabled()) {\n log.debug(\"Restored extension store: {}\", store.getName());\n }\n })\n .then()\n .doOnSuccess(ignored -> log.info(\n \"Extension stores restore completed, total {} record(s) restored.\",\n total.get())\n ),\n FileUtils::closeQuietly)\n .subscribeOn(scheduler);\n }\n\n private Mono unpackBackup(Publisher content, Path target) {\n return unzip(content, target, scheduler);\n }\n\n private Mono packageBackup(Path baseDir, Backup backup) {\n return Mono.fromCallable(\n () -> {\n var backupsFolder = getBackupsRoot();\n Files.createDirectories(backupsFolder);\n var backupName = backup.getMetadata().getName();\n var startTimestamp = backup.getStatus().getStartTimestamp();\n var timePart = this.dateTimeFormatter.format(startTimestamp);\n var backupFile = backupsFolder.resolve(timePart + '-' + backupName + \".zip\");\n FileUtils.zip(baseDir, backupFile);\n backup.getStatus().setFilename(backupFile.getFileName().toString());\n backup.getStatus().setSize(Files.size(backupFile));\n return backupsFolder;\n }\n ).subscribeOn(scheduler).then();\n }\n\n private Mono backupWorkDir(Path baseDir) {\n return Mono.fromCallable(() -> {\n var workdirPath = Files.createDirectory(baseDir.resolve(\"workdir\"));\n copyRecursively(haloProperties.getWorkDir(), workdirPath, excludes);\n return workdirPath;\n }).subscribeOn(scheduler).then();\n }\n\n private Mono backupExtensions(Path baseDir) {\n var total = new AtomicInteger(0);\n var excludes = new AtomicInteger(0);\n return Mono.fromCallable(() -> Files.createFile(baseDir.resolve(\"extensions.data\")))\n .subscribeOn(scheduler)\n .flatMap(extensionsPath -> Mono.usingWhen(\n Mono.fromCallable(\n () -> objectMapper.writerFor(ExtensionStore.class)\n .writeValuesAsArray(extensionsPath.toFile())\n )\n .subscribeOn(scheduler),\n seqWriter -> fetchAllExtensionStores(BATCH_SIZE)\n .filter(extensionStore -> {\n if (isInBlocklist(extensionStore)) {\n excludes.incrementAndGet();\n return false;\n }\n return true;\n })\n .buffer(100)\n .publishOn(scheduler)\n .concatMap(stores -> Mono.fromCallable(() -> {\n total.addAndGet(stores.size());\n seqWriter.writeAll(stores);\n log.debug(\"Backed up {} extension stores so far...\", total.get());\n return null;\n }))\n .then()\n .doOnSuccess(ignored -> log.info(\n \"\"\"\n Extension stores backup completed, total {} record(s) backed up, \\\n {} record(s) excluded.\"\"\",\n total.get(), excludes.get()\n )),\n seqWriter -> Mono.fromCallable(() -> {\n seqWriter.flush();\n FileUtils.closeQuietly(seqWriter);\n return null;\n }).subscribeOn(scheduler)\n ));\n }\n\n private Flux fetchAllExtensionStores(int batchSize) {\n var txDefinition = new DefaultTransactionDefinition(TransactionDefinition.withDefaults());\n txDefinition.setIsolationLevel(TransactionDefinition.ISOLATION_REPEATABLE_READ);\n txDefinition.setReadOnly(true);\n var tx = TransactionalOperator.create(txManager, txDefinition);\n return entityTemplate.select(ExtensionStore.class)\n .withFetchSize(batchSize)\n .all()\n .as(tx::transactional);\n }\n\n @Override\n public void afterPropertiesSet() throws Exception {\n Files.createDirectories(getBackupsRoot());\n }\n\n private static boolean isInBlocklist(ExtensionStore store) {\n return store.getName().startsWith(BACKUP_STORE_PREFIX);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultNotificationCenter.java", "content": "package run.halo.app.notification;\n\nimport static org.apache.commons.lang3.StringUtils.defaultString;\n\nimport java.util.HashMap;\nimport java.util.Locale;\nimport java.util.Optional;\nimport lombok.Builder;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.notification.Notification;\nimport run.halo.app.core.extension.notification.NotifierDescriptor;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.notification.endpoint.SubscriptionRouter;\n\n/**\n * A default implementation of {@link NotificationCenter}.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class DefaultNotificationCenter implements NotificationCenter {\n private final ReactiveExtensionClient client;\n private final NotificationSender notificationSender;\n private final NotifierConfigStore notifierConfigStore;\n private final ReasonNotificationTemplateSelector notificationTemplateSelector;\n private final UserNotificationPreferenceService userNotificationPreferenceService;\n private final NotificationTemplateRender notificationTemplateRender;\n private final SubscriptionRouter subscriptionRouter;\n private final RecipientResolver recipientResolver;\n private final SubscriptionService subscriptionService;\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public Mono notify(Reason reason) {\n return recipientResolver.resolve(reason)\n .doOnNext(subscriber -> {\n log.debug(\"Dispatching notification to subscriber [{}] for reason [{}]\",\n subscriber, reason.getMetadata().getName());\n })\n .flatMap(subscriber -> dispatchNotification(reason, subscriber))\n .then();\n }\n\n @Override\n public Mono subscribe(Subscription.Subscriber subscriber,\n Subscription.InterestReason reason) {\n return unsubscribe(subscriber, reason)\n .then(Mono.defer(() -> {\n var subscription = new Subscription();\n subscription.setMetadata(new Metadata());\n subscription.getMetadata().setGenerateName(\"subscription-\");\n subscription.setSpec(new Subscription.Spec());\n subscription.getSpec().setUnsubscribeToken(Subscription.generateUnsubscribeToken());\n subscription.getSpec().setSubscriber(subscriber);\n Subscription.InterestReason.ensureSubjectHasValue(reason);\n subscription.getSpec().setReason(reason);\n return client.create(subscription);\n }));\n }\n\n @Override\n public Mono unsubscribe(Subscription.Subscriber subscriber) {\n return subscriptionService.remove(subscriber).then();\n }\n\n @Override\n public Mono unsubscribe(Subscription.Subscriber subscriber,\n Subscription.InterestReason reason) {\n return subscriptionService.remove(subscriber, reason).then();\n }\n\n Flux getNotifiersBySubscriber(Subscriber subscriber, Reason reason) {\n var reasonType = reason.getSpec().getReasonType();\n return userNotificationPreferenceService.getByUser(subscriber.name())\n .map(UserNotificationPreference::getReasonTypeNotifier)\n .map(reasonTypeNotification -> reasonTypeNotification.getNotifiers(reasonType))\n .flatMapMany(Flux::fromIterable);\n }\n\n Mono dispatchNotification(Reason reason, Subscriber subscriber) {\n return getNotifiersBySubscriber(subscriber, reason)\n .flatMap(notifierName -> client.fetch(NotifierDescriptor.class, notifierName))\n .flatMap(descriptor -> prepareNotificationElement(subscriber, reason, descriptor))\n .flatMap(element -> {\n var dispatchMono = sendNotification(element);\n if (subscriber.isAnonymous()) {\n return dispatchMono;\n }\n // create notification for user\n var innerNofificationMono = createNotification(element);\n return Mono.when(dispatchMono, innerNofificationMono);\n })\n .then();\n }\n\n Mono prepareNotificationElement(Subscriber subscriber, Reason reason,\n NotifierDescriptor descriptor) {\n return getLocaleFromSubscriber(subscriber)\n .flatMap(locale -> inferenceTemplate(reason, subscriber, locale))\n .map(notificationContent -> NotificationElement.builder()\n .descriptor(descriptor)\n .reason(reason)\n .subscriber(subscriber)\n .reasonType(notificationContent.reasonType())\n .notificationTitle(notificationContent.title())\n .reasonAttributes(notificationContent.reasonAttributes())\n .notificationRawBody(defaultString(notificationContent.rawBody()))\n .notificationHtmlBody(defaultString(notificationContent.htmlBody()))\n .build()\n );\n }\n\n Mono sendNotification(NotificationElement notificationElement) {\n var descriptor = notificationElement.descriptor();\n var subscriber = notificationElement.subscriber();\n final var notifierExtName = descriptor.getSpec().getNotifierExtName();\n return notificationContextFrom(notificationElement)\n .flatMap(notificationContext -> notificationSender.sendNotification(notifierExtName,\n notificationContext)\n .onErrorResume(throwable -> {\n log.error(\n \"Failed to send notification to subscriber [{}] through notifier [{}]\",\n subscriber,\n descriptor.getSpec().getDisplayName(),\n throwable);\n return Mono.empty();\n })\n )\n .then();\n }\n\n Mono createNotification(NotificationElement notificationElement) {\n var reason = notificationElement.reason();\n var subscriber = notificationElement.subscriber();\n return client.fetch(User.class, subscriber.name())\n .flatMap(user -> {\n Notification notification = new Notification();\n notification.setMetadata(new Metadata());\n notification.getMetadata().setGenerateName(\"notification-\");\n notification.setSpec(new Notification.NotificationSpec());\n notification.getSpec().setTitle(notificationElement.notificationTitle());\n notification.getSpec().setRawContent(notificationElement.notificationRawBody());\n notification.getSpec().setHtmlContent(notificationElement.notificationHtmlBody);\n notification.getSpec().setRecipient(subscriber.name());\n notification.getSpec().setReason(reason.getMetadata().getName());\n notification.getSpec().setUnread(true);\n return client.create(notification);\n });\n }\n\n private ReasonAttributes toReasonAttributes(Reason reason) {\n var model = new ReasonAttributes();\n var attributes = reason.getSpec().getAttributes();\n if (attributes != null) {\n model.putAll(attributes);\n }\n return model;\n }\n\n Mono notificationContextFrom(NotificationElement element) {\n final var descriptorName = element.descriptor().getMetadata().getName();\n final var reason = element.reason();\n final var descriptor = element.descriptor();\n final var subscriber = element.subscriber();\n\n var messagePayload = new NotificationContext.MessagePayload();\n messagePayload.setTitle(element.notificationTitle());\n messagePayload.setRawBody(element.notificationRawBody());\n messagePayload.setHtmlBody(element.notificationHtmlBody());\n messagePayload.setAttributes(element.reasonAttributes());\n\n var message = new NotificationContext.Message();\n message.setRecipient(subscriber.name());\n message.setPayload(messagePayload);\n message.setTimestamp(reason.getMetadata().getCreationTimestamp());\n var reasonSubject = reason.getSpec().getSubject();\n var subject = NotificationContext.Subject.builder()\n .apiVersion(reasonSubject.getApiVersion())\n .kind(reasonSubject.getKind())\n .title(reasonSubject.getTitle())\n .url(reasonSubject.getUrl())\n .build();\n message.setSubject(subject);\n\n var notificationContext = new NotificationContext();\n notificationContext.setMessage(message);\n\n return Mono.just(notificationContext)\n .flatMap(context -> {\n Mono receiverConfigMono =\n Optional.ofNullable(descriptor.getSpec().getReceiverSettingRef())\n .map(ref -> notifierConfigStore.fetchReceiverConfig(descriptorName)\n .doOnNext(context::setReceiverConfig)\n .then()\n )\n .orElse(Mono.empty());\n\n Mono senderConfigMono =\n Optional.ofNullable(descriptor.getSpec().getSenderSettingRef())\n .map(ref -> notifierConfigStore.fetchSenderConfig(descriptorName)\n .doOnNext(context::setSenderConfig)\n .then()\n )\n .orElse(Mono.empty());\n\n return Mono.when(receiverConfigMono, senderConfigMono)\n .thenReturn(context);\n });\n }\n\n Mono inferenceTemplate(Reason reason, Subscriber subscriber,\n Locale locale) {\n var reasonTypeName = reason.getSpec().getReasonType();\n return getReasonType(reasonTypeName)\n .flatMap(reasonType -> notificationTemplateSelector.select(reasonTypeName, locale)\n .flatMap(template -> {\n final var templateContent = template.getSpec().getTemplate();\n var model = toReasonAttributes(reason);\n var subscriberInfo = new HashMap<>();\n if (subscriber.isAnonymous()) {\n subscriberInfo.put(\"displayName\", subscriber.getEmail().orElseThrow());\n } else {\n subscriberInfo.put(\"displayName\", \"@\" + subscriber.username());\n }\n subscriberInfo.put(\"id\", subscriber.name());\n model.put(\"subscriber\", subscriberInfo);\n\n var unsubscriptionMono = getUnsubscribeUrl(subscriber.subscriptionName())\n .doOnNext(url -> model.put(\"unsubscribeUrl\", url));\n\n var builder = NotificationContent.builder()\n .reasonType(reasonType)\n .reasonAttributes(model);\n\n var titleMono = notificationTemplateRender\n .render(templateContent.getTitle(), model)\n .doOnNext(builder::title);\n\n var rawBodyMono = notificationTemplateRender\n .render(templateContent.getRawBody(), model)\n .doOnNext(builder::rawBody);\n\n var htmlBodyMono = notificationTemplateRender\n .render(templateContent.getHtmlBody(), model)\n .doOnNext(builder::htmlBody);\n return Mono.when(unsubscriptionMono, titleMono, rawBodyMono, htmlBodyMono)\n .then(Mono.fromSupplier(builder::build));\n })\n );\n }\n\n @Builder\n record NotificationContent(String title, String rawBody, String htmlBody, ReasonType reasonType,\n ReasonAttributes reasonAttributes) {\n }\n\n Mono getUnsubscribeUrl(String subscriptionName) {\n return client.get(Subscription.class, subscriptionName)\n .map(subscriptionRouter::getUnsubscribeUrl);\n }\n\n @Builder\n record NotificationElement(ReasonType reasonType, Reason reason,\n Subscriber subscriber, NotifierDescriptor descriptor,\n String notificationTitle,\n String notificationRawBody,\n String notificationHtmlBody,\n ReasonAttributes reasonAttributes) {\n }\n\n Mono getReasonType(String reasonTypeName) {\n return client.get(ReasonType.class, reasonTypeName);\n }\n\n Mono getLocaleFromSubscriber(Subscriber subscriber) {\n // TODO get locale from subscriber\n return environmentFetcher.getBasic()\n .map(SystemSetting.Basic::useSystemLocale)\n .map(localeOpt -> localeOpt.orElse(Locale.getDefault()));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultNotificationReasonEmitter.java", "content": "package run.halo.app.notification;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport java.util.List;\nimport java.util.function.Consumer;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.exception.NotFoundException;\n\n/**\n * A default {@link NotificationReasonEmitter} implementation.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultNotificationReasonEmitter implements NotificationReasonEmitter {\n\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono emit(String reasonType,\n Consumer builder) {\n Assert.notNull(reasonType, \"Reason type must not be empty.\");\n var reason = createReason(reasonType, buildReasonPayload(builder));\n return validateReason(reason)\n .then(Mono.defer(() -> client.create(reason)))\n .then();\n }\n\n Mono validateReason(Reason reason) {\n String reasonTypeName = reason.getSpec().getReasonType();\n return client.fetch(ReasonType.class, reasonTypeName)\n .switchIfEmpty(Mono.error(new NotFoundException(\n \"ReasonType [\" + reasonTypeName + \"] not found, do you forget to register it?\"))\n )\n .doOnNext(reasonType -> {\n var valueMap = reason.getSpec().getAttributes();\n nullSafeList(reasonType.getSpec().getProperties())\n .forEach(property -> {\n if (property.isOptional()) {\n return;\n }\n if (valueMap.get(property.getName()) == null) {\n throw new IllegalArgumentException(\n \"Reason property [\" + property.getName() + \"] is required.\");\n }\n });\n })\n .then();\n }\n\n List nullSafeList(List t) {\n return defaultIfNull(t, List.of());\n }\n\n Reason createReason(String reasonType, ReasonPayload reasonData) {\n Reason reason = new Reason();\n reason.setMetadata(new Metadata());\n reason.getMetadata().setGenerateName(\"reason-\");\n reason.setSpec(new Reason.Spec());\n if (reasonData.getAuthor() != null) {\n reason.getSpec().setAuthor(reasonData.getAuthor().name());\n }\n reason.getSpec().setReasonType(reasonType);\n reason.getSpec().setSubject(reasonData.getSubject());\n\n var reasonAttributes = new ReasonAttributes();\n if (reasonData.getAttributes() != null) {\n reasonAttributes.putAll(reasonData.getAttributes());\n }\n reason.getSpec().setAttributes(reasonAttributes);\n return reason;\n }\n\n ReasonPayload buildReasonPayload(Consumer reasonData) {\n var builder = ReasonPayload.builder();\n reasonData.accept(builder);\n return builder.build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultNotificationSender.java", "content": "package run.halo.app.notification;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.UUID;\nimport lombok.AllArgsConstructor;\nimport lombok.EqualsAndHashCode;\nimport lombok.Getter;\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.DefaultController;\nimport run.halo.app.extension.controller.DefaultQueue;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequestQueue;\nimport run.halo.app.plugin.extensionpoint.ExtensionDefinition;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * A default {@link NotificationSender} implementation.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Slf4j\n@Component\npublic class DefaultNotificationSender\n implements NotificationSender, Reconciler,\n SmartLifecycle {\n private static final Duration TIMEOUT = Duration.ofSeconds(30);\n private final ReactiveExtensionClient client;\n private final ExtensionGetter extensionGetter;\n\n private final RequestQueue requestQueue;\n\n private final Controller controller;\n\n private boolean running = false;\n\n /**\n * Constructs a new notification sender with the given {@link ReactiveExtensionClient} and\n * {@link ExtensionGetter}.\n */\n public DefaultNotificationSender(ReactiveExtensionClient client,\n ExtensionGetter extensionGetter) {\n this.client = client;\n this.extensionGetter = extensionGetter;\n requestQueue = new DefaultQueue<>(Instant::now);\n controller = this.setupWith(null);\n }\n\n @Override\n public Mono sendNotification(String notifierExtensionName, NotificationContext context) {\n return selectNotifier(notifierExtensionName)\n .flatMap(notifier -> Mono.fromRunnable(\n () -> {\n var item = new QueueItem(UUID.randomUUID().toString(),\n () -> notifier.notify(context).block(TIMEOUT), 0);\n requestQueue.addImmediately(item);\n })\n .subscribeOn(Schedulers.boundedElastic())\n )\n .then();\n }\n\n Mono selectNotifier(String notifierExtensionName) {\n return client.fetch(ExtensionDefinition.class, notifierExtensionName)\n .flatMap(extDefinition -> extensionGetter.getEnabledExtensions(\n ReactiveNotifier.class)\n .filter(notifier -> notifier.getClass().getName()\n .equals(extDefinition.getSpec().getClassName())\n )\n .next()\n );\n }\n\n @Override\n public Result reconcile(QueueItem request) {\n if (request.getTimes() > 3) {\n log.error(\"Failed to send notification after retrying 3 times, discard it.\");\n return Result.doNotRetry();\n }\n log.debug(\"Executing send notification task, [{}] remaining to-do tasks\",\n requestQueue.size());\n request.setTimes(request.getTimes() + 1);\n request.getTask().run();\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return new DefaultController<>(\n this.getClass().getName(),\n this,\n requestQueue,\n null,\n Duration.ofMillis(100),\n Duration.ofSeconds(1000),\n 5\n );\n }\n\n @Override\n public void start() {\n controller.start();\n running = true;\n }\n\n @Override\n public void stop() {\n running = false;\n controller.dispose();\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n /**\n *

Queue item for {@link #requestQueue}.

\n *

It holds a {@link Runnable} and a {@link #times} field.

\n *

{@link Runnable} used to send email when consuming.

\n *

{@link #times} will be used to record the number of\n * times the task has been executed, if retry three times on failure, it will be discarded.

\n *

It also holds a {@link #id} field, which is used to identify the item. queue item with\n * the same id is considered to be the same item to ensure that controller can\n * discard the existing item in the queue when item re-queued on failure.

\n */\n @Getter\n @AllArgsConstructor\n @EqualsAndHashCode(onlyExplicitlyIncluded = true)\n public static class QueueItem {\n\n @EqualsAndHashCode.Include\n private final String id;\n\n private final Runnable task;\n\n @Setter\n private int times;\n }\n\n}\n\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultNotificationService.java", "content": "package run.halo.app.notification;\n\nimport java.time.Instant;\nimport java.util.List;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Notification;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.exception.AccessDeniedException;\n\n/**\n * A default implementation of {@link UserNotificationService}.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultNotificationService implements UserNotificationService {\n\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono> listByUser(String username, UserNotificationQuery query) {\n return client.listBy(Notification.class, query.toListOptions(), query.toPageRequest());\n }\n\n @Override\n public Mono markAsRead(String username, String name) {\n return client.fetch(Notification.class, name)\n .filter(notification -> isRecipient(notification, username))\n .flatMap(notification -> {\n notification.getSpec().setUnread(false);\n notification.getSpec().setLastReadAt(Instant.now());\n return client.update(notification);\n });\n }\n\n @Override\n public Flux markSpecifiedAsRead(String username, List names) {\n return Flux.fromIterable(names)\n .flatMap(name -> markAsRead(username, name))\n .map(notification -> notification.getMetadata().getName());\n }\n\n @Override\n public Mono deleteByName(String username, String name) {\n return client.get(Notification.class, name)\n .doOnNext(notification -> {\n var recipient = notification.getSpec().getRecipient();\n if (!username.equals(recipient)) {\n throw new AccessDeniedException(\n \"You have no permission to delete this notification.\");\n }\n })\n .flatMap(client::delete);\n }\n\n static boolean isRecipient(Notification notification, String username) {\n Assert.notNull(notification, \"Notification must not be null\");\n Assert.notNull(username, \"Username must not be null\");\n return username.equals(notification.getSpec().getRecipient());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultNotificationTemplateRender.java", "content": "package run.halo.app.notification;\n\nimport static org.apache.commons.lang3.StringUtils.defaultString;\n\nimport java.util.HashMap;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.spring6.SpringTemplateEngine;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n/**\n *

Default implementation of {@link NotificationTemplateRender}.

\n *

This implementation use {@link TemplateEngine} to render template, and the template engine\n * use {@link StringTemplateResolver} to resolve template, so the template\n * in {@link #render(String template, Map)} is template content.

\n *

Template syntax:\n * usingthymeleaf.html#textual-syntax\n *

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultNotificationTemplateRender implements NotificationTemplateRender {\n\n private static final TemplateEngine TEMPLATE_ENGINE = createTemplateEngine();\n\n private final SystemConfigFetcher environmentFetcher;\n private final ExternalUrlSupplier externalUrlSupplier;\n\n @Override\n public Mono render(String template, Map model) {\n var context = new Context(Locale.getDefault(), model);\n var externalUrl = Optional.ofNullable(externalUrlSupplier.getRaw())\n .map(url -> StringUtils.removeEnd(url.toString(), \"/\"))\n .orElse(StringUtils.EMPTY);\n var globalAttributeMono = getBasicSetting()\n .doOnNext(basic -> {\n var site = new HashMap<>();\n site.put(\"title\", basic.getTitle());\n site.put(\"logo\", basic.getLogo());\n site.put(\"subtitle\", basic.getSubtitle());\n site.put(\"url\", externalUrl);\n context.setVariable(\"site\", site);\n });\n return Mono.when(globalAttributeMono)\n .then(Mono.fromSupplier(() ->\n TEMPLATE_ENGINE.process(defaultString(template), context)));\n }\n\n static TemplateEngine createTemplateEngine() {\n var template = new SpringTemplateEngine();\n template.setTemplateResolver(new StringTemplateResolver());\n return template;\n }\n\n Mono getBasicSetting() {\n return environmentFetcher.fetch(SystemSetting.Basic.GROUP, SystemSetting.Basic.class);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultNotifierConfigStore.java", "content": "package run.halo.app.notification;\n\nimport static run.halo.app.extension.MetadataUtil.SYSTEM_FINALIZER;\n\nimport com.fasterxml.jackson.databind.node.JsonNodeFactory;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Secret;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * A default implementation of {@link NotifierConfigStore}.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultNotifierConfigStore implements NotifierConfigStore {\n public static final String SECRET_NAME = \"notifier-setting-secret\";\n public static final String RECEIVER_KEY = \"receiver\";\n public static final String SENDER_KEY = \"sender\";\n\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono fetchReceiverConfig(String notifierDescriptorName) {\n return fetchConfig(notifierDescriptorName)\n .mapNotNull(setting -> (ObjectNode) setting.get(RECEIVER_KEY))\n .defaultIfEmpty(JsonNodeFactory.instance.objectNode());\n }\n\n @Override\n public Mono fetchSenderConfig(String notifierDescriptorName) {\n return fetchConfig(notifierDescriptorName)\n .mapNotNull(setting -> (ObjectNode) setting.get(SENDER_KEY))\n .defaultIfEmpty(JsonNodeFactory.instance.objectNode());\n }\n\n @Override\n public Mono saveReceiverConfig(String notifierDescriptorName, ObjectNode config) {\n return saveConfig(notifierDescriptorName, RECEIVER_KEY, config);\n }\n\n @Override\n public Mono saveSenderConfig(String notifierDescriptorName, ObjectNode config) {\n return saveConfig(notifierDescriptorName, SENDER_KEY, config);\n }\n\n Mono saveConfig(String notifierDescriptorName, String key, ObjectNode config) {\n return client.fetch(Secret.class, SECRET_NAME)\n .switchIfEmpty(Mono.defer(() -> {\n Secret secret = new Secret();\n secret.setMetadata(new Metadata());\n secret.getMetadata().setName(SECRET_NAME);\n secret.getMetadata().setFinalizers(Set.of(SYSTEM_FINALIZER));\n secret.setStringData(new HashMap<>());\n return client.create(secret);\n }))\n .flatMap(secret -> {\n if (secret.getStringData() == null) {\n secret.setStringData(new HashMap<>());\n }\n Map map = secret.getStringData();\n ObjectNode wrapperNode = JsonNodeFactory.instance.objectNode();\n wrapperNode.set(key, config);\n map.put(resolveKey(notifierDescriptorName), JsonUtils.objectToJson(wrapperNode));\n return client.update(secret);\n })\n .then();\n }\n\n Mono fetchConfig(String notifierDescriptorName) {\n return client.fetch(Secret.class, SECRET_NAME)\n .mapNotNull(Secret::getStringData)\n .mapNotNull(map -> map.get(resolveKey(notifierDescriptorName)))\n .filter(StringUtils::isNotBlank)\n .map(value -> JsonUtils.jsonToObject(value, ObjectNode.class))\n .defaultIfEmpty(JsonNodeFactory.instance.objectNode());\n }\n\n String resolveKey(String notifierDescriptorName) {\n return notifierDescriptorName + \".json\";\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/DefaultSubscriberEmailResolver.java", "content": "package run.halo.app.notification;\n\nimport lombok.NonNull;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n *

Default implementation of {@link SubscriberEmailResolver}.

\n *

If the subscriber is an anonymous subscriber, the email will be extracted from the\n * subscriber name.

\n *

An anonymous subscriber's name is in the format of {@code anonymous#email}.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultSubscriberEmailResolver implements SubscriberEmailResolver {\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono resolve(Subscription.Subscriber subscriber) {\n var identity = UserIdentity.of(subscriber.getName());\n if (identity.isAnonymous()) {\n return Mono.fromSupplier(() -> getEmail(subscriber));\n }\n return client.fetch(User.class, subscriber.getName())\n .filter(user -> user.getSpec().isEmailVerified())\n .mapNotNull(user -> user.getSpec().getEmail());\n }\n\n @Override\n public Subscription.Subscriber ofEmail(String email) {\n if (StringUtils.isBlank(email)) {\n throw new IllegalArgumentException(\"Email must not be blank\");\n }\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(UserIdentity.anonymousWithEmail(email).name());\n return subscriber;\n }\n\n @NonNull\n String getEmail(Subscription.Subscriber subscriber) {\n var identity = UserIdentity.of(subscriber.getName());\n if (!identity.isAnonymous()) {\n throw new IllegalStateException(\"The subscriber is not an anonymous subscriber\");\n }\n return identity.getEmail()\n .filter(StringUtils::isNotBlank)\n .orElseThrow(() -> new IllegalStateException(\"The subscriber does not have an email\"));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/EmailNotifier.java", "content": "package run.halo.app.notification;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport java.util.concurrent.atomic.AtomicReference;\nimport lombok.NonNull;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.data.util.Pair;\nimport org.springframework.mail.javamail.JavaMailSender;\nimport org.springframework.mail.javamail.JavaMailSenderImpl;\nimport org.springframework.mail.javamail.MimeMessagePreparator;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.notification.EmailSenderHelper.EmailSenderConfig;\n\n/**\n *

A notifier that can send email.

\n *\n * @author guqing\n * @see ReactiveNotifier\n * @see JavaMailSenderImpl\n * @since 2.10.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class EmailNotifier implements ReactiveNotifier {\n\n private final SubscriberEmailResolver subscriberEmailResolver;\n private final NotificationTemplateRender notificationTemplateRender;\n private final EmailSenderHelper emailSenderHelper;\n private final AtomicReference>\n emailSenderConfigPairRef = new AtomicReference<>();\n\n @Override\n public Mono notify(NotificationContext context) {\n JsonNode senderConfig = context.getSenderConfig();\n var emailSenderConfig =\n JsonUtils.DEFAULT_JSON_MAPPER.convertValue(senderConfig, EmailSenderConfig.class);\n\n if (!emailSenderConfig.isEnable()) {\n log.debug(\"Email notifier is disabled, skip sending email.\");\n return Mono.empty();\n }\n\n JavaMailSender javaMailSender = getJavaMailSender(emailSenderConfig);\n\n String recipient = context.getMessage().getRecipient();\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(recipient);\n var payload = context.getMessage().getPayload();\n return subscriberEmailResolver.resolve(subscriber)\n .flatMap(toEmail -> {\n if (StringUtils.isBlank(toEmail)) {\n log.debug(\"Cannot resolve email for subscriber: [{}], skip sending email.\",\n subscriber);\n return Mono.empty();\n }\n var htmlMono = appendHtmlBodyFooter(payload.getAttributes())\n .doOnNext(footer -> {\n if (StringUtils.isNotBlank(payload.getHtmlBody())) {\n payload.setHtmlBody(payload.getHtmlBody() + \"\\n\" + footer);\n }\n });\n var rawMono = appendRawBodyFooter(payload.getAttributes())\n .doOnNext(footer -> {\n if (StringUtils.isNotBlank(payload.getRawBody())) {\n payload.setRawBody(payload.getRawBody() + \"\\n\" + footer);\n }\n });\n return Mono.when(htmlMono, rawMono)\n .thenReturn(toEmail);\n })\n .map(toEmail -> getMimeMessagePreparator(toEmail, emailSenderConfig, payload))\n .publishOn(Schedulers.boundedElastic())\n .doOnNext(javaMailSender::send)\n .then();\n }\n\n @NonNull\n private MimeMessagePreparator getMimeMessagePreparator(String toEmail,\n EmailSenderConfig emailSenderConfig, NotificationContext.MessagePayload payload) {\n return emailSenderHelper.createMimeMessagePreparator(emailSenderConfig, toEmail,\n payload.getTitle(),\n payload.getRawBody(), payload.getHtmlBody());\n }\n\n JavaMailSender getJavaMailSender(EmailSenderConfig emailSenderConfig) {\n return emailSenderConfigPairRef.updateAndGet(pair -> {\n if (pair != null && pair.getFirst().equals(emailSenderConfig)) {\n return pair;\n }\n return Pair.of(emailSenderConfig,\n emailSenderHelper.createJavaMailSender(emailSenderConfig));\n }).getSecond();\n }\n\n Mono appendRawBodyFooter(ReasonAttributes attributes) {\n return notificationTemplateRender.render(\"\"\"\n ---\n 如果您不想再收到此类通知，点击链接退订: [(${unsubscribeUrl})]\n [(${site.title})]\n \"\"\", attributes);\n }\n\n Mono appendHtmlBodyFooter(ReasonAttributes attributes) {\n return notificationTemplateRender.render(\"\"\"\n
\n \n

\n —
请勿直接回复此邮件，\n 查看通知\n 或\n 取消订阅。\n

\n
\n \"\"\", attributes);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/EmailSenderHelper.java", "content": "package run.halo.app.notification;\n\nimport lombok.Data;\nimport lombok.NonNull;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.mail.javamail.JavaMailSender;\nimport org.springframework.mail.javamail.MimeMessagePreparator;\n\npublic interface EmailSenderHelper {\n\n @NonNull\n JavaMailSender createJavaMailSender(EmailSenderConfig senderConfig);\n\n @NonNull\n MimeMessagePreparator createMimeMessagePreparator(EmailSenderConfig senderConfig,\n String toEmail, String subject, String raw, String html);\n\n @Data\n class EmailSenderConfig {\n private boolean enable;\n private String displayName;\n private String username;\n private String sender;\n private String password;\n private String host;\n private Integer port;\n private String encryption;\n\n /**\n * Gets email display name.\n *\n * @return display name if not blank, otherwise username.\n */\n public String getDisplayName() {\n return StringUtils.defaultIfBlank(displayName, username);\n }\n\n /**\n * Gets email sender address.\n *\n * @return sender if not blank, otherwise username\n */\n public String getSender() {\n return StringUtils.defaultIfBlank(sender, username);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/EmailSenderHelperImpl.java", "content": "package run.halo.app.notification;\n\nimport java.nio.charset.StandardCharsets;\nimport java.util.Properties;\nimport lombok.NonNull;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.mail.javamail.JavaMailSender;\nimport org.springframework.mail.javamail.JavaMailSenderImpl;\nimport org.springframework.mail.javamail.MimeMessageHelper;\nimport org.springframework.mail.javamail.MimeMessagePreparator;\nimport org.springframework.stereotype.Component;\n\n/**\n *

A default implementation of {@link EmailSenderHelper}.

\n *\n * @author guqing\n * @since 2.14.0\n */\n@Slf4j\n@Component\npublic class EmailSenderHelperImpl implements EmailSenderHelper {\n\n @Override\n @NonNull\n public JavaMailSender createJavaMailSender(EmailSenderConfig senderConfig) {\n JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();\n javaMailSender.setHost(senderConfig.getHost());\n javaMailSender.setPort(senderConfig.getPort());\n javaMailSender.setUsername(senderConfig.getUsername());\n javaMailSender.setPassword(senderConfig.getPassword());\n\n Properties props = javaMailSender.getJavaMailProperties();\n props.put(\"mail.transport.protocol\", \"smtp\");\n props.put(\"mail.smtp.auth\", \"true\");\n if (\"SSL\".equals(senderConfig.getEncryption())) {\n props.put(\"mail.smtp.ssl.enable\", \"true\");\n }\n\n if (\"TLS\".equals(senderConfig.getEncryption())) {\n props.put(\"mail.smtp.starttls.enable\", \"true\");\n }\n\n if (\"NONE\".equals(senderConfig.getEncryption())) {\n props.put(\"mail.smtp.ssl.enable\", \"false\");\n props.put(\"mail.smtp.starttls.enable\", \"false\");\n }\n\n if (log.isDebugEnabled()) {\n props.put(\"mail.debug\", \"true\");\n }\n return javaMailSender;\n }\n\n @Override\n @NonNull\n public MimeMessagePreparator createMimeMessagePreparator(EmailSenderConfig senderConfig,\n String toEmail, String subject, String raw, String html) {\n return mimeMessage -> {\n MimeMessageHelper helper =\n new MimeMessageHelper(mimeMessage, true, StandardCharsets.UTF_8.name());\n helper.setFrom(senderConfig.getSender(), senderConfig.getDisplayName());\n\n helper.setSubject(subject);\n helper.setText(raw, html);\n helper.setTo(toEmail);\n };\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/LanguageUtils.java", "content": "package run.halo.app.notification;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Locale;\nimport lombok.experimental.UtilityClass;\nimport org.apache.commons.lang3.StringUtils;\n\n/**\n * Language utils to help us to compute the language.\n *\n * @author guqing\n * @since 2.10.0\n */\n@UtilityClass\npublic class LanguageUtils {\n\n /**\n * Compute all the possible languages we should use: *_gl_ES-gheada, *_gl_ES, _gl... from a\n * given locale.\n * The first element of the list is \"default\" if it can not find the language, use default.\n *\n * @param locale locale\n * @return list of possible languages, from less specific to more specific.\n */\n public static List computeLangFromLocale(Locale locale) {\n final List resourceNames = new ArrayList<>(5);\n\n if (StringUtils.isBlank(locale.getLanguage())) {\n throw new IllegalArgumentException(\n \"Locale \\\"\" + locale + \"\\\" \"\n + \"cannot be used as it does not specify a language.\");\n }\n\n resourceNames.add(\"default\");\n resourceNames.add(locale.getLanguage());\n\n if (StringUtils.isNotBlank(locale.getCountry())) {\n resourceNames.add(locale.getLanguage() + \"_\" + locale.getCountry());\n }\n\n if (StringUtils.isNotBlank(locale.getVariant())) {\n resourceNames.add(\n locale.getLanguage() + \"_\" + locale.getCountry() + \"-\" + locale.getVariant());\n }\n return resourceNames;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/NotificationSender.java", "content": "package run.halo.app.notification;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Reason;\n\n/**\n *

{@link NotificationSender} used to send notification.

\n *

Send notification is a time-consuming task, so we use a queue to send notification\n * asynchronously.

\n *

The caller may not be reactive, and in many cases it is blocking called\n * {@link NotificationCenter#notify(Reason)}, so here use the queue to ensure asynchronous\n * sending of notification without blocking the calling thread.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@FunctionalInterface\npublic interface NotificationSender {\n\n Mono sendNotification(String notifierExtensionName, NotificationContext context);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/NotificationTemplateRender.java", "content": "package run.halo.app.notification;\n\nimport java.util.Map;\nimport reactor.core.publisher.Mono;\n\n/**\n * {@link NotificationTemplateRender} is used to render the notification template.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface NotificationTemplateRender {\n\n Mono render(String template, Map context);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/NotificationTrigger.java", "content": "package run.halo.app.notification;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\n\nimport java.time.Duration;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n *

Notification trigger for {@link Reason}.

\n *

Triggered when a new {@link Reason} is received, and then notify through\n * {@link NotificationCenter}.

\n *

It will add a finalizer to the {@link Reason} to avoid duplicate notification, In other\n * words, it will only notify once.

\n *\n * @author guqing\n * @since 2.10.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class NotificationTrigger implements Reconciler {\n\n public static final String TRIGGERED_FINALIZER = \"triggered\";\n private static final Duration TIMEOUT = Duration.ofMinutes(1);\n\n private final ExtensionClient client;\n private final NotificationCenter notificationCenter;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Reason.class, request.name()).ifPresent(reason -> {\n if (ExtensionUtil.isDeleted(reason)) {\n if (removeFinalizers(reason.getMetadata(), Set.of(TRIGGERED_FINALIZER))) {\n client.update(reason);\n log.info(\"Cleaned up notification reason {}\", request.name());\n }\n return;\n }\n if (addFinalizers(reason.getMetadata(), Set.of(TRIGGERED_FINALIZER))) {\n // notifier\n onNewReasonReceived(reason);\n }\n // cleanup reason after notified\n client.delete(reason);\n });\n return Result.doNotRetry();\n }\n\n private void onNewReasonReceived(Reason reason) {\n var name = reason.getMetadata().getName();\n log.info(\"Sending notification for reason: {}\", name);\n notificationCenter.notify(reason).block(TIMEOUT);\n log.info(\"Notification sent for reason: {}\", name);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Reason())\n .workerCount(10)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/NotifierConfigStore.java", "content": "package run.halo.app.notification;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport reactor.core.publisher.Mono;\n\n/**\n *

{@link NotifierConfigStore} to store notifier config.

\n *

It provides methods to fetch and save config for receiver and sender.

\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface NotifierConfigStore {\n\n Mono fetchReceiverConfig(String notifierDescriptorName);\n\n Mono fetchSenderConfig(String notifierDescriptorName);\n\n Mono saveReceiverConfig(String notifierDescriptorName, ObjectNode config);\n\n Mono saveSenderConfig(String notifierDescriptorName, ObjectNode config);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/ReasonNotificationTemplateSelector.java", "content": "package run.halo.app.notification;\n\nimport java.util.Locale;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.NotificationTemplate;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.extension.Metadata;\n\n/**\n * Reason notification template selector to select notification template by reason type and locale.\n *\n * @author guqing\n * @see NotificationTemplate\n * @see ReasonType\n * @since 2.10.0\n */\npublic interface ReasonNotificationTemplateSelector {\n\n /**\n * Select notification template by reason type and locale.\n *

Locale order is important: as we will let values from more specific to less specific (e.g.\n * a value for gl_ES will have more precedence than a value for gl).

\n *

If specific locale found and has multiple templates, we will order them by\n * {@link Metadata#getCreationTimestamp()} and return the latest one.

\n *\n * @param reasonType reason type\n * @param locale locale\n * @return notification template if found, or empty\n */\n Mono select(String reasonType, Locale locale);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/ReasonNotificationTemplateSelectorImpl.java", "content": "package run.halo.app.notification;\n\nimport static org.apache.commons.lang3.StringUtils.defaultIfBlank;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.util.Collections;\nimport java.util.Comparator;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.function.Function;\nimport java.util.function.Predicate;\nimport java.util.stream.Collectors;\nimport lombok.NonNull;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.Nullable;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.NotificationTemplate;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\n\n/**\n * A default implementation of {@link ReasonNotificationTemplateSelector}.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class ReasonNotificationTemplateSelectorImpl implements ReasonNotificationTemplateSelector {\n\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono select(String reasonType, Locale locale) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n equal(\"spec.reasonSelector.reasonType\", reasonType))\n );\n return client.listAll(NotificationTemplate.class, listOptions, Sort.unsorted())\n .collect(Collectors.groupingBy(\n getLanguageKey(),\n Collectors.maxBy(Comparator.comparing(t -> t.getMetadata().getCreationTimestamp()))\n ))\n .mapNotNull(map -> lookupTemplateByLocale(locale, map));\n }\n\n @Nullable\n static NotificationTemplate lookupTemplateByLocale(Locale locale,\n Map> map) {\n return LanguageUtils.computeLangFromLocale(locale).stream()\n // reverse order to ensure that the variant is the first element and the default\n // is the last element\n .sorted(Collections.reverseOrder())\n .map(key -> map.getOrDefault(key, Optional.empty()))\n .filter(Optional::isPresent)\n .map(Optional::get)\n .findFirst()\n .orElse(null);\n }\n\n @NonNull\n static Predicate matchReasonType(String reasonType) {\n return template -> template.getSpec().getReasonSelector().getReasonType()\n .equals(reasonType);\n }\n\n static Function getLanguageKey() {\n return template -> defaultIfBlank(template.getSpec().getReasonSelector().getLanguage(),\n \"default\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/RecipientResolver.java", "content": "package run.halo.app.notification;\n\nimport reactor.core.publisher.Flux;\nimport run.halo.app.core.extension.notification.Reason;\n\npublic interface RecipientResolver {\n\n Flux resolve(Reason reason);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/RecipientResolverImpl.java", "content": "package run.halo.app.notification;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport com.google.common.base.Throwables;\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.Map;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.expression.MapAccessor;\nimport org.springframework.core.convert.support.DefaultConversionService;\nimport org.springframework.expression.EvaluationContext;\nimport org.springframework.expression.EvaluationException;\nimport org.springframework.expression.Expression;\nimport org.springframework.expression.ExpressionParser;\nimport org.springframework.expression.ParseException;\nimport org.springframework.expression.spel.standard.SpelExpressionParser;\nimport org.springframework.expression.spel.support.DataBindingPropertyAccessor;\nimport org.springframework.expression.spel.support.SimpleEvaluationContext;\nimport org.springframework.integration.json.JsonPropertyAccessor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class RecipientResolverImpl implements RecipientResolver {\n private final ExpressionParser expressionParser = new SpelExpressionParser();\n private final EvaluationContext evaluationContext = createEvaluationContext();\n private final SubscriptionService subscriptionService;\n\n @Override\n public Flux resolve(Reason reason) {\n var reasonType = reason.getSpec().getReasonType();\n return subscriptionService.listByPerPage(reasonType)\n .filter(this::isNotDisabled)\n .filter(subscription -> {\n var interestReason = subscription.getSpec().getReason();\n if (hasSubject(interestReason)) {\n return subjectMatch(subscription, reason.getSpec().getSubject());\n } else if (StringUtils.isNotBlank(interestReason.getExpression())) {\n return expressionMatch(subscription.getMetadata().getName(),\n interestReason.getExpression(), reason);\n }\n return false;\n })\n .map(subscription -> {\n var id = UserIdentity.of(subscription.getSpec().getSubscriber().getName());\n return new Subscriber(id, subscription.getMetadata().getName());\n })\n .distinct(Subscriber::name);\n }\n\n boolean hasSubject(Subscription.InterestReason interestReason) {\n return !Subscription.InterestReason.isFallbackSubject(interestReason.getSubject());\n }\n\n boolean expressionMatch(String subscriptionName, String expressionStr, Reason reason) {\n try {\n Expression expression =\n expressionParser.parseExpression(expressionStr);\n var result = expression.getValue(evaluationContext,\n exprRootObject(reason),\n Boolean.class);\n return BooleanUtils.isTrue(result);\n } catch (ParseException | EvaluationException e) {\n log.debug(\"Failed to parse or evaluate expression for subscription [{}], skip it.\",\n subscriptionName, Throwables.getRootCause(e));\n return false;\n }\n }\n\n Map exprRootObject(Reason reason) {\n var map = new HashMap(3, 1);\n map.put(\"props\", defaultIfNull(reason.getSpec().getAttributes(), new ReasonAttributes()));\n map.put(\"subject\", reason.getSpec().getSubject());\n map.put(\"author\", reason.getSpec().getAuthor());\n return Collections.unmodifiableMap(map);\n }\n\n static boolean subjectMatch(Subscription subscription, Reason.Subject reasonSubject) {\n Assert.notNull(subscription, \"The subscription must not be null\");\n Assert.notNull(reasonSubject, \"The reasonSubject must not be null\");\n final var sourceSubject = subscription.getSpec().getReason().getSubject();\n\n var matchSubject = new Subscription.ReasonSubject();\n matchSubject.setKind(reasonSubject.getKind());\n matchSubject.setApiVersion(reasonSubject.getApiVersion());\n\n if (StringUtils.isBlank(sourceSubject.getName())) {\n return sourceSubject.equals(matchSubject);\n }\n matchSubject.setName(reasonSubject.getName());\n return sourceSubject.equals(matchSubject);\n }\n\n boolean isNotDisabled(Subscription subscription) {\n return !subscription.getSpec().isDisabled();\n }\n\n EvaluationContext createEvaluationContext() {\n return SimpleEvaluationContext.forPropertyAccessors(\n DataBindingPropertyAccessor.forReadOnlyAccess(),\n new MapAccessor(),\n new JsonPropertyAccessor()\n )\n .withConversionService(DefaultConversionService.getSharedInstance())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/Subscriber.java", "content": "package run.halo.app.notification;\n\nimport java.util.Optional;\nimport org.springframework.util.Assert;\nimport run.halo.app.infra.AnonymousUserConst;\n\npublic record Subscriber(UserIdentity identity, String subscriptionName) {\n public Subscriber {\n Assert.notNull(identity, \"The subscriber must not be null\");\n Assert.hasText(subscriptionName, \"The subscription name must not be blank\");\n }\n\n public String name() {\n return identity.name();\n }\n\n public String username() {\n return identity.isAnonymous() ? AnonymousUserConst.PRINCIPAL : identity.name();\n }\n\n public boolean isAnonymous() {\n return identity.isAnonymous();\n }\n\n public Optional getEmail() {\n return identity.getEmail();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/SubscriberEmailResolver.java", "content": "package run.halo.app.notification;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Subscription;\n\n/**\n *

{@link SubscriberEmailResolver} used to resolve email from {@link Subscription.Subscriber}\n * .

\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface SubscriberEmailResolver {\n\n Mono resolve(Subscription.Subscriber subscriber);\n\n /**\n * Creates an email subscriber from email.\n *\n * @param email email\n * @return email subscriber\n */\n Subscription.Subscriber ofEmail(String email);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/SubscriptionService.java", "content": "package run.halo.app.notification;\n\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.ListOptions;\n\npublic interface SubscriptionService {\n\n /**\n *

List subscriptions by page one by one.only consume one page then next page will be\n * loaded.

\n *

Note that: result can not be used to delete the subscription, it is only used to query the\n * subscription.

\n */\n Flux listByPerPage(String reasonType);\n\n Mono remove(Subscription.Subscriber subscriber,\n Subscription.InterestReason interestReasons);\n\n Mono remove(Subscription.Subscriber subscriber);\n\n Mono remove(Subscription subscription);\n\n Flux removeBy(ListOptions listOptions);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/SubscriptionServiceImpl.java", "content": "package run.halo.app.notification;\n\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.extension.index.query.Queries.startsWith;\n\nimport java.time.Duration;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.ReactiveExtensionPaginatedOperator;\n\n@Component\n@RequiredArgsConstructor\npublic class SubscriptionServiceImpl implements SubscriptionService {\n private final ReactiveExtensionClient client;\n private final ReactiveExtensionPaginatedOperator paginatedOperator;\n\n @Override\n public Mono remove(Subscription.Subscriber subscriber,\n Subscription.InterestReason interestReason) {\n Assert.notNull(subscriber, \"The subscriber must not be null\");\n Assert.notNull(interestReason, \"The interest reason must not be null\");\n var reasonType = interestReason.getReasonType();\n var expression = interestReason.getExpression();\n var subject = interestReason.getSubject();\n\n var listOptions = new ListOptions();\n var fieldQuery = and(isNull(\"metadata.deletionTimestamp\"),\n equal(\"spec.subscriber\", subscriber.toString()),\n equal(\"spec.reason.reasonType\", reasonType));\n\n if (subject != null) {\n fieldQuery = and(fieldQuery, reasonSubjectMatch(subject));\n }\n if (StringUtils.isNotBlank(expression)) {\n fieldQuery = and(fieldQuery, equal(\"spec.reason.expression\", expression));\n }\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return paginatedOperator.deleteInitialBatch(Subscription.class, listOptions).then();\n }\n\n @Override\n public Mono remove(Subscription.Subscriber subscriber) {\n var listOptions = new ListOptions();\n var fieldQuery = and(isNull(\"metadata.deletionTimestamp\"),\n equal(\"spec.subscriber\", subscriber.toString()));\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return paginatedOperator.deleteInitialBatch(Subscription.class, listOptions)\n .then();\n }\n\n @Override\n public Mono remove(Subscription subscription) {\n return client.delete(subscription)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> attemptToDelete(subscription.getMetadata().getName()));\n }\n\n @Override\n public Flux removeBy(ListOptions listOptions) {\n return paginatedOperator.deleteInitialBatch(Subscription.class, listOptions);\n }\n\n @Override\n public Flux listByPerPage(String reasonType) {\n final var listOptions = new ListOptions();\n var fieldQuery = and(isNull(\"metadata.deletionTimestamp\"),\n equal(\"spec.reason.reasonType\", reasonType));\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return paginatedOperator.list(Subscription.class, listOptions);\n }\n\n private Mono attemptToDelete(String subscriptionName) {\n return Mono.defer(() -> client.fetch(Subscription.class, subscriptionName)\n .flatMap(client::delete)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n Condition reasonSubjectMatch(Subscription.ReasonSubject reasonSubject) {\n Assert.notNull(reasonSubject, \"The reasonSubject must not be null\");\n if (StringUtils.isNotBlank(reasonSubject.getName())) {\n return equal(\"spec.reason.subject\", reasonSubject.toString());\n }\n var matchAllSubject = new Subscription.ReasonSubject();\n matchAllSubject.setKind(reasonSubject.getKind());\n matchAllSubject.setApiVersion(reasonSubject.getApiVersion());\n return startsWith(\"spec.reason.subject\", matchAllSubject.toString());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/UserNotificationPreference.java", "content": "package run.halo.app.notification;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport java.util.HashMap;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.Getter;\nimport org.springframework.lang.NonNull;\n\n/**\n * Notification preference of user.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Getter\npublic class UserNotificationPreference {\n private static final String DEFAULT_NOTIFIER = \"default-email-notifier\";\n\n private final ReasonTypeNotifier reasonTypeNotifier = new ReasonTypeNotifier();\n\n public static class ReasonTypeNotifier extends HashMap {\n\n /**\n * Gets notifiers by reason type.\n *\n * @param reasonType reason type\n * @return if key of reasonType not exists, return default notifier, otherwise return the\n * notifiers\n */\n @NonNull\n public Set getNotifiers(String reasonType) {\n var result = this.get(reasonType);\n return result == null ? Set.of(DEFAULT_NOTIFIER)\n : defaultIfNull(result.getNotifiers(), Set.of());\n }\n }\n\n @Data\n public static class NotifierSetting {\n private Set notifiers;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/UserNotificationPreferenceService.java", "content": "package run.halo.app.notification;\n\nimport reactor.core.publisher.Mono;\n\n/**\n * User notification preference service.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface UserNotificationPreferenceService {\n\n Mono getByUser(String username);\n\n Mono saveByUser(String username,\n UserNotificationPreference userNotificationPreference);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/UserNotificationPreferenceServiceImpl.java", "content": "package run.halo.app.notification;\n\nimport java.util.HashMap;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * User notification preference service implementation.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class UserNotificationPreferenceServiceImpl implements UserNotificationPreferenceService {\n\n public static final String NOTIFICATION_PREFERENCE = \"notification\";\n\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono getByUser(String username) {\n var configName = buildUserPreferenceConfigMapName(username);\n return client.fetch(ConfigMap.class, configName)\n .map(config -> {\n if (config.getData() == null) {\n return new UserNotificationPreference();\n }\n String s = config.getData().get(NOTIFICATION_PREFERENCE);\n if (StringUtils.isNotBlank(s)) {\n return JsonUtils.jsonToObject(s, UserNotificationPreference.class);\n }\n return new UserNotificationPreference();\n })\n .defaultIfEmpty(new UserNotificationPreference());\n }\n\n @Override\n public Mono saveByUser(String username,\n UserNotificationPreference userNotificationPreference) {\n var configName = buildUserPreferenceConfigMapName(username);\n return client.fetch(ConfigMap.class, configName)\n .switchIfEmpty(Mono.defer(() -> {\n var configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(configName);\n return client.create(configMap);\n }))\n .flatMap(config -> {\n if (config.getData() == null) {\n config.setData(new HashMap<>());\n }\n config.getData().put(NOTIFICATION_PREFERENCE,\n JsonUtils.objectToJson(userNotificationPreference));\n return client.update(config);\n })\n .then();\n }\n\n static String buildUserPreferenceConfigMapName(String username) {\n return \"user-preferences-\" + username;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/UserNotificationQuery.java", "content": "package run.halo.app.notification;\n\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.router.selector.SelectorUtil.labelAndFieldSelectorToListOptions;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.web.server.ServerWebExchange;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.router.SortableRequest;\n\n/**\n * Notification query object for authenticated user.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic class UserNotificationQuery extends SortableRequest {\n\n private final String username;\n\n public UserNotificationQuery(ServerWebExchange exchange, String username) {\n super(exchange);\n this.username = username;\n }\n\n /**\n * Build a list options from the query object.\n */\n @Override\n public ListOptions toListOptions() {\n var listOptions =\n labelAndFieldSelectorToListOptions(getLabelSelector(), getFieldSelector());\n var builder = ListOptions.builder(listOptions);\n if (StringUtils.isNotBlank(username)) {\n builder.andQuery(equal(\"spec.recipient\", username));\n }\n return builder.build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/UserNotificationService.java", "content": "package run.halo.app.notification;\n\nimport java.util.List;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Notification;\nimport run.halo.app.extension.ListResult;\n\n/**\n * Notification service.\n *\n * @author guqing\n * @since 2.10.0\n */\npublic interface UserNotificationService {\n\n /**\n * List notifications for the authenticated user.\n *\n * @param query query object\n * @return a page result of notifications\n */\n Mono> listByUser(String username, UserNotificationQuery query);\n\n /**\n * Mark the specified notification as read.\n *\n * @param name notification name\n * @return read notification\n */\n Mono markAsRead(String username, String name);\n\n /**\n * Mark the specified notifications as read.\n *\n * @param names the names of notifications\n * @return the names of read notification that has been marked as read\n */\n Flux markSpecifiedAsRead(String username, List names);\n\n Mono deleteByName(String username, String name);\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/endpoint/ConsoleNotifierEndpoint.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.notification.NotifierConfigStore;\n\n/**\n * Custom notifier endpoint.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class ConsoleNotifierEndpoint implements CustomEndpoint {\n\n private final NotifierConfigStore notifierConfigStore;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"NotifierV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .GET(\"/notifiers/{name}/sender-config\", this::fetchSenderConfig,\n builder -> builder.operationId(\"FetchSenderConfig\")\n .description(\"Fetch sender config of notifier\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Notifier name\")\n .required(true)\n )\n .response(responseBuilder().implementation(Object.class))\n )\n .POST(\"/notifiers/{name}/sender-config\", this::saveSenderConfig,\n builder -> builder.operationId(\"SaveSenderConfig\")\n .description(\"Save sender config of notifier\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Notifier name\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder().implementation(Object.class))\n )\n )\n .response(responseBuilder().implementation(Void.class))\n )\n .build();\n }\n\n private Mono fetchSenderConfig(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return notifierConfigStore.fetchSenderConfig(name)\n .flatMap(config -> ServerResponse.ok().bodyValue(config));\n }\n\n private Mono saveSenderConfig(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return request.bodyToMono(ObjectNode.class)\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"Request body must not be empty.\"))\n )\n .flatMap(jsonNode -> notifierConfigStore.saveSenderConfig(name, jsonNode))\n .then(ServerResponse.ok().build());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/endpoint/EmailConfigValidationEndpoint.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.security.Principal;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.mail.MailException;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.notification.EmailSenderHelper;\n\n/**\n * Validation endpoint for email config.\n *\n * @author guqing\n * @since 2.14.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class EmailConfigValidationEndpoint implements CustomEndpoint {\n private static final String EMAIL_SUBJECT = \"测试邮件 - 验证邮箱连通性\";\n private static final String EMAIL_BODY = \"\"\"\n 你好！
\n 这是一封测试邮件，旨在验证您的邮箱发件配置是否正确。
\n 此邮件由系统自动发送，请勿回复。
\n 祝好\n \"\"\";\n\n private final EmailSenderHelper emailSenderHelper;\n private final ReactiveExtensionClient client;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"NotifierV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .POST(\"/notifiers/default-email-notifier/verify-connection\",\n this::verifyEmailSenderConfig,\n builder -> builder.operationId(\"VerifyEmailSenderConfig\")\n .description(\"Verify email sender config.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(ValidationRequest.class)\n )\n .response(responseBuilder().implementation(Void.class))\n )\n .build();\n }\n\n private Mono verifyEmailSenderConfig(ServerRequest request) {\n return request.bodyToMono(ValidationRequest.class)\n .switchIfEmpty(\n Mono.error(new ServerWebInputException(\"Required request body is missing.\"))\n )\n .flatMap(validationRequest -> getCurrentUserEmail()\n .flatMap(recipient -> {\n var mailSender = emailSenderHelper.createJavaMailSender(validationRequest);\n var message = emailSenderHelper.createMimeMessagePreparator(validationRequest,\n recipient, EMAIL_SUBJECT, EMAIL_BODY, EMAIL_BODY);\n try {\n mailSender.send(message);\n } catch (MailException e) {\n String errorMsg =\n \"Failed to send email, please check your email configuration.\";\n log.error(errorMsg, e);\n throw new ServerWebInputException(errorMsg, null, e);\n }\n return ServerResponse.ok().build();\n })\n );\n }\n\n Mono getCurrentUserEmail() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName)\n .flatMap(username -> client.fetch(User.class, username))\n .flatMap(user -> {\n var email = user.getSpec().getEmail();\n if (StringUtils.isBlank(email)) {\n return Mono.error(new ServerWebInputException(\n \"Your email is missing, please set it in your profile.\"));\n }\n return Mono.just(email);\n });\n }\n\n @Data\n @EqualsAndHashCode(callSuper = true)\n @Schema(name = \"EmailConfigValidationRequest\")\n static class ValidationRequest extends EmailSenderHelper.EmailSenderConfig {\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"console.api.notification.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/endpoint/SubscriptionRouter.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.net.URI;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ExternalUrlSupplier;\n\n/**\n * A router for {@link Subscription}.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class SubscriptionRouter {\n\n public static final String UNSUBSCRIBE_PATTERN =\n \"/apis/api.notification.halo.run/v1alpha1/subscriptions/{name}/unsubscribe\";\n\n private final ExternalUrlSupplier externalUrlSupplier;\n private final ReactiveExtensionClient client;\n\n @Bean\n RouterFunction notificationSubscriptionRouter() {\n final var tag = \"NotificationV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(UNSUBSCRIBE_PATTERN, this::unsubscribe, builder -> {\n builder.operationId(\"Unsubscribe\")\n .tag(tag)\n .description(\"Unsubscribe a subscription\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Subscription name\")\n .required(true)\n ).parameter(parameterBuilder()\n .in(ParameterIn.QUERY)\n .name(\"token\")\n .description(\"Unsubscribe token\")\n .required(true)\n )\n .response(responseBuilder().implementation(String.class))\n .build();\n })\n .build();\n }\n\n Mono unsubscribe(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var token = request.queryParam(\"token\").orElse(\"\");\n return client.fetch(Subscription.class, name)\n .filter(subscription -> {\n var unsubscribeToken = subscription.getSpec().getUnsubscribeToken();\n return StringUtils.equals(token, unsubscribeToken);\n })\n .flatMap(client::delete)\n .then(Mono.defer(() -> ServerResponse.ok()\n .contentType(MediaType.TEXT_PLAIN)\n .bodyValue(\"Unsubscribe successfully.\"))\n );\n }\n\n /**\n * Gets unsubscribe url from the given subscription.\n *\n * @param subscription subscription must not be null\n * @return unsubscribe url\n */\n public String getUnsubscribeUrl(Subscription subscription) {\n var name = subscription.getMetadata().getName();\n var token = subscription.getSpec().getUnsubscribeToken();\n var externalUrl = defaultIfNull(externalUrlSupplier.getRaw(), URI.create(\"/\"));\n return UriComponentsBuilder.fromUriString(externalUrl.toString())\n .path(UNSUBSCRIBE_PATTERN)\n .queryParam(\"token\", token)\n .build(name)\n .toString();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/endpoint/UserNotificationEndpoint.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport java.util.List;\nimport java.util.function.Supplier;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.extension.notification.Notification;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.notification.UserNotificationQuery;\nimport run.halo.app.notification.UserNotificationService;\n\n/**\n * Custom notification endpoint to managing notification for authenticated user.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class UserNotificationEndpoint implements CustomEndpoint {\n\n private final UserNotificationService notificationService;\n\n @Override\n public RouterFunction endpoint() {\n return SpringdocRouteBuilder.route()\n .nest(RequestPredicates.path(\"/userspaces/{username}\"), userspaceScopedApis())\n .build();\n }\n\n Supplier> userspaceScopedApis() {\n var tag = \"NotificationV1alpha1Uc\";\n return () -> SpringdocRouteBuilder.route()\n .GET(\"/notifications\", this::listNotification,\n builder -> {\n builder.operationId(\"ListUserNotifications\")\n .description(\"List notifications for the authenticated user.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"username\")\n .description(\"Username\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(Notification.class))\n );\n UserNotificationQuery.buildParameters(builder);\n }\n )\n .PUT(\"/notifications/{name}/mark-as-read\", this::markNotificationAsRead,\n builder -> builder.operationId(\"MarkNotificationAsRead\")\n .description(\"Mark the specified notification as read.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"username\")\n .description(\"Username\")\n .required(true)\n )\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Notification name\")\n .required(true)\n )\n .response(responseBuilder().implementation(Notification.class))\n )\n .PUT(\"/notifications/-/mark-specified-as-read\", this::markNotificationsAsRead,\n builder -> builder.operationId(\"MarkNotificationsAsRead\")\n .description(\"Mark the specified notifications as read.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"username\")\n .description(\"Username\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder()\n .implementation(MarkSpecifiedRequest.class))\n )\n )\n .response(responseBuilder().implementationArray(String.class))\n )\n .DELETE(\"/notifications/{name}\", this::deleteNotification,\n builder -> builder.operationId(\"DeleteSpecifiedNotification\")\n .description(\"Delete the specified notification.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"username\")\n .description(\"Username\")\n .required(true)\n )\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Notification name\")\n .required(true)\n )\n .response(responseBuilder().implementation(Notification.class))\n )\n .build();\n }\n\n private Mono deleteNotification(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n var username = request.pathVariable(\"username\");\n return notificationService.deleteByName(username, name)\n .flatMap(notification -> ServerResponse.ok().bodyValue(notification));\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"api.notification.halo.run/v1alpha1\");\n }\n\n record MarkSpecifiedRequest(List names) {\n }\n\n private Mono listNotification(ServerRequest request) {\n var username = request.pathVariable(\"username\");\n var query = new UserNotificationQuery(request.exchange(), username);\n return notificationService.listByUser(username, query)\n .flatMap(notifications -> ServerResponse.ok().bodyValue(notifications));\n }\n\n private Mono markNotificationAsRead(ServerRequest request) {\n var username = request.pathVariable(\"username\");\n var name = request.pathVariable(\"name\");\n return notificationService.markAsRead(username, name)\n .flatMap(notification -> ServerResponse.ok().bodyValue(notification));\n }\n\n Mono markNotificationsAsRead(ServerRequest request) {\n var username = request.pathVariable(\"username\");\n return request.bodyToMono(MarkSpecifiedRequest.class)\n .flatMapMany(\n requestBody -> notificationService.markSpecifiedAsRead(username, requestBody.names))\n .collectList()\n .flatMap(names -> ServerResponse.ok().bodyValue(names));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/endpoint/UserNotificationPreferencesEndpoint.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Function;\nimport java.util.function.Supplier;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport lombok.experimental.Accessors;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.util.function.Tuples;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.extension.notification.NotifierDescriptor;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.extension.Comparators;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.notification.UserNotificationPreference;\nimport run.halo.app.notification.UserNotificationPreferenceService;\n\n/**\n * Endpoint for user notification preferences.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class UserNotificationPreferencesEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n private final UserNotificationPreferenceService userNotificationPreferenceService;\n\n @Override\n public RouterFunction endpoint() {\n return SpringdocRouteBuilder.route()\n .nest(RequestPredicates.path(\"/userspaces/{username}\"), userspaceScopedApis())\n .build();\n }\n\n Supplier> userspaceScopedApis() {\n var tag = \"NotificationV1alpha1Uc\";\n return () -> SpringdocRouteBuilder.route()\n .GET(\"/notification-preferences\", this::listNotificationPreferences,\n builder -> builder.operationId(\"ListUserNotificationPreferences\")\n .description(\"List notification preferences for the authenticated user.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"username\")\n .description(\"Username\")\n .required(true)\n )\n .response(responseBuilder()\n .implementation(ReasonTypeNotifierMatrix.class)\n )\n )\n .POST(\"/notification-preferences\", this::saveNotificationPreferences,\n builder -> builder.operationId(\"SaveUserNotificationPreferences\")\n .description(\"Save notification preferences for the authenticated user.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"username\")\n .description(\"Username\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .implementation(ReasonTypeNotifierCollectionRequest.class)\n )\n .response(responseBuilder().implementation(ReasonTypeNotifierMatrix.class))\n )\n .build();\n }\n\n private Mono saveNotificationPreferences(ServerRequest request) {\n var username = request.pathVariable(\"username\");\n return request.bodyToMono(ReasonTypeNotifierCollectionRequest.class)\n .flatMap(requestBody -> {\n var reasonTypNotifiers = requestBody.reasonTypeNotifiers();\n return userNotificationPreferenceService.getByUser(username)\n .flatMap(preference -> {\n var reasonTypeNotifierMap = preference.getReasonTypeNotifier();\n reasonTypeNotifierMap.clear();\n reasonTypNotifiers.forEach(reasonTypeNotifierRequest -> {\n var reasonType = reasonTypeNotifierRequest.getReasonType();\n var notifiers = reasonTypeNotifierRequest.getNotifiers();\n var notifierSetting = new UserNotificationPreference.NotifierSetting();\n notifierSetting.setNotifiers(\n notifiers == null ? Set.of() : Set.copyOf(notifiers));\n reasonTypeNotifierMap.put(reasonType, notifierSetting);\n });\n return userNotificationPreferenceService.saveByUser(username, preference);\n });\n })\n .then(Mono.defer(() -> listReasonTypeNotifierMatrix(username)\n .flatMap(result -> ServerResponse.ok().bodyValue(result)))\n );\n }\n\n private Mono listNotificationPreferences(ServerRequest request) {\n var username = request.pathVariable(\"username\");\n return listReasonTypeNotifierMatrix(username)\n .flatMap(matrix -> ServerResponse.ok().bodyValue(matrix));\n }\n\n @NonNull\n private static Map toNameIndexMap(List collection,\n Function nameGetter) {\n Map indexMap = new HashMap<>();\n for (int i = 0; i < collection.size(); i++) {\n var item = collection.get(i);\n indexMap.put(nameGetter.apply(item), i);\n }\n return indexMap;\n }\n\n Mono listReasonTypeNotifierMatrix(String username) {\n var listOptions = ListOptions.builder()\n .labelSelector()\n .notExists(MetadataUtil.HIDDEN_LABEL)\n .end()\n .build();\n return client.listAll(ReasonType.class, listOptions, ExtensionUtil.defaultSort())\n .map(ReasonTypeInfo::from)\n .collectList()\n .flatMap(reasonTypes -> client.list(NotifierDescriptor.class, null,\n Comparators.defaultComparator())\n .map(notifier -> new NotifierInfo(notifier.getMetadata().getName(),\n notifier.getSpec().getDisplayName(),\n notifier.getSpec().getDescription())\n )\n .collectList()\n .map(notifiers -> {\n var matrix = new ReasonTypeNotifierMatrix()\n .setReasonTypes(reasonTypes)\n .setNotifiers(notifiers)\n .setStateMatrix(new boolean[reasonTypes.size()][notifiers.size()]);\n return Tuples.of(reasonTypes, matrix);\n })\n )\n .flatMap(tuple2 -> {\n var reasonTypes = tuple2.getT1();\n var matrix = tuple2.getT2();\n\n var reasonTypeIndexMap = toNameIndexMap(reasonTypes, ReasonTypeInfo::name);\n var notifierIndexMap = toNameIndexMap(matrix.getNotifiers(), NotifierInfo::name);\n var stateMatrix = matrix.getStateMatrix();\n\n return userNotificationPreferenceService.getByUser(username)\n .doOnNext(preference -> {\n var reasonTypeNotifierMap = preference.getReasonTypeNotifier();\n for (ReasonTypeInfo reasonType : reasonTypes) {\n var reasonTypeIndex = reasonTypeIndexMap.get(reasonType.name());\n var notifierNames =\n reasonTypeNotifierMap.getNotifiers(reasonType.name());\n for (String notifierName : notifierNames) {\n // Skip if the notifier enabled in the user preference does not\n // exist to avoid null index\n if (!notifierIndexMap.containsKey(notifierName)) {\n continue;\n }\n var notifierIndex = notifierIndexMap.get(notifierName);\n stateMatrix[reasonTypeIndex][notifierIndex] = true;\n }\n }\n })\n .thenReturn(matrix);\n });\n }\n\n @Data\n @Accessors(chain = true)\n static class ReasonTypeNotifierMatrix {\n private List reasonTypes;\n private List notifiers;\n private boolean[][] stateMatrix;\n }\n\n record ReasonTypeInfo(String name, String displayName, String description,\n Set uiPermissions) {\n\n public static ReasonTypeInfo from(ReasonType reasonType) {\n var uiPermissions = Optional.of(MetadataUtil.nullSafeAnnotations(reasonType))\n .map(annotations -> annotations.get(Role.UI_PERMISSIONS_ANNO))\n .filter(StringUtils::isNotBlank)\n .map(uiPermissionStr -> JsonUtils.jsonToObject(uiPermissionStr,\n new TypeReference>() {\n })\n )\n .orElse(Set.of());\n return new ReasonTypeInfo(reasonType.getMetadata().getName(),\n reasonType.getSpec().getDisplayName(),\n reasonType.getSpec().getDescription(),\n uiPermissions);\n }\n }\n\n record NotifierInfo(String name, String displayName, String description) {\n }\n\n record ReasonTypeNotifierCollectionRequest(\n @Schema(requiredMode = REQUIRED) List reasonTypeNotifiers) {\n }\n\n @Data\n static class ReasonTypeNotifierRequest {\n private String reasonType;\n private List notifiers;\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"api.notification.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/notification/endpoint/UserNotifierEndpoint.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport lombok.RequiredArgsConstructor;\nimport org.springdoc.core.fn.builders.schema.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.notification.NotifierConfigStore;\n\n/**\n * Notifier endpoint for user center.\n *\n * @author guqing\n * @since 2.10.0\n */\n@Component\n@RequiredArgsConstructor\npublic class UserNotifierEndpoint implements CustomEndpoint {\n\n private final NotifierConfigStore notifierConfigStore;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"NotifierV1alpha1Uc\";\n return SpringdocRouteBuilder.route()\n .GET(\"/notifiers/{name}/receiver-config\", this::fetchReceiverConfig,\n builder -> builder.operationId(\"FetchReceiverConfig\")\n .description(\"Fetch receiver config of notifier\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Notifier name\")\n .required(true)\n )\n .response(responseBuilder().implementation(Object.class))\n )\n .POST(\"/notifiers/{name}/receiver-config\", this::saveReceiverConfig,\n builder -> builder.operationId(\"SaveReceiverConfig\")\n .description(\"Save receiver config of notifier\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .description(\"Notifier name\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(Builder.schemaBuilder().implementation(Object.class))\n )\n )\n .response(responseBuilder().implementation(Void.class))\n )\n .build();\n }\n\n private Mono fetchReceiverConfig(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return notifierConfigStore.fetchReceiverConfig(name)\n .flatMap(config -> ServerResponse.ok().bodyValue(config));\n }\n\n private Mono saveReceiverConfig(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return request.bodyToMono(ObjectNode.class)\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"Request body must not be empty.\"))\n )\n .flatMap(jsonNode -> notifierConfigStore.saveReceiverConfig(name, jsonNode))\n .then(ServerResponse.ok().build());\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"api.notification.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/AggregatedRouterFunction.java", "content": "package run.halo.app.plugin;\n\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.endpoint.console.CustomEndpointsBuilder;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.infra.SecureServerRequest;\n\n/**\n * Aggregated router function built from all custom endpoints.\n *\n * @author johnniang\n */\npublic class AggregatedRouterFunction implements RouterFunction {\n\n private final RouterFunction aggregated;\n\n public AggregatedRouterFunction(ObjectProvider customEndpoints) {\n var builder = new CustomEndpointsBuilder();\n customEndpoints.orderedStream()\n .forEach(builder::add);\n this.aggregated = builder.build();\n }\n\n @Override\n public Mono> route(ServerRequest request) {\n return aggregated.route(new SecureServerRequest(request));\n }\n\n @Override\n public void accept(RouterFunctions.Visitor visitor) {\n this.aggregated.accept(visitor);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/BuiltInPluginsInitializer.java", "content": "package run.halo.app.plugin;\n\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.nio.file.Path;\nimport java.time.Duration;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.core.io.support.PathMatchingResourcePatternResolver;\nimport org.springframework.core.io.support.ResourcePatternResolver;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.infra.ExtensionInitializedEvent;\nimport run.halo.app.infra.exception.PluginAlreadyExistsException;\n\n@Slf4j\n@Component\nclass BuiltInPluginsInitializer implements ApplicationListener {\n\n private static final String PRESETS_LOCATION_PATTERN = \"classpath:/plugins/built-in/*.jar\";\n\n private final ExtensionClient client;\n\n private final PluginService pluginService;\n\n private ResourcePatternResolver resourcePatternResolver;\n\n private PluginFinder pluginFinder;\n\n BuiltInPluginsInitializer(ExtensionClient client, PluginService pluginService) {\n this.client = client;\n this.pluginService = pluginService;\n this.resourcePatternResolver = new PathMatchingResourcePatternResolver();\n this.pluginFinder = new YamlPluginFinder();\n }\n\n /**\n * Only for testing purpose.\n *\n * @param resourcePatternResolver resource pattern resolver\n */\n void setResourcePatternResolver(ResourcePatternResolver resourcePatternResolver) {\n Assert.notNull(resourcePatternResolver, \"ResourcePatternResolver must not be null\");\n this.resourcePatternResolver = resourcePatternResolver;\n }\n\n /**\n * Only for testing purpose.\n *\n * @param pluginFinder plugin finder\n */\n void setPluginFinder(PluginFinder pluginFinder) {\n this.pluginFinder = pluginFinder;\n }\n\n @Override\n public void onApplicationEvent(ExtensionInitializedEvent event) {\n try {\n for (var resource : resourcePatternResolver.getResources(PRESETS_LOCATION_PATTERN)) {\n var filename = resource.getFilename();\n if (filename == null) {\n continue;\n }\n var pluginPath = Path.of(resource.getURI());\n var preflightPlugin = pluginFinder.find(pluginPath);\n var pluginName = preflightPlugin.getMetadata().getName();\n\n log.info(\"Try to installing built-in plugin '{}'...\", pluginName);\n var plugin = pluginService.install(pluginPath)\n .doOnNext(created -> {\n log.info(\"Built-in plugin '{}' has been installed.\",\n created.getMetadata().getName());\n })\n .onErrorResume(PluginAlreadyExistsException.class, e -> {\n log.info(\"Built-in plugin '{}' already installed, trying to upgrade...\",\n pluginName);\n return pluginService.upgrade(pluginName, pluginPath)\n .doOnNext(updated -> log.info(\"Built-in plugin '{}' has been upgraded.\",\n updated.getMetadata().getName()));\n })\n .blockOptional(Duration.ofSeconds(10)).orElseThrow(\n () -> new IllegalStateException(\n \"Failed to install or upgrade built-in plugin '\" + pluginName + \"'\"\n )\n );\n // try to update metadata to add system reserved label and finalizer\n var metadata = plugin.getMetadata();\n metadata.setDeletionTimestamp(null);\n if (metadata.getLabels() == null) {\n metadata.setLabels(new HashMap<>());\n }\n metadata.getLabels().put(Plugin.SYSTEM_RESERVED_LABEL_KEY, Boolean.TRUE.toString());\n if (metadata.getFinalizers() == null) {\n metadata.setFinalizers(new HashSet<>());\n }\n metadata.getFinalizers().add(Plugin.BUILT_IN_KEEPER_FINALIZER);\n client.update(plugin);\n }\n } catch (FileNotFoundException ignored) {\n // should never happen\n log.warn(\"No built-in plugins found.\");\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultDevelopmentPluginRepository.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.pf4j.DevelopmentPluginRepository;\nimport org.springframework.util.CollectionUtils;\n\n/**\n *

A {@link org.pf4j.PluginRepository} implementation that can add fixed plugin paths for\n * development {@link org.pf4j.RuntimeMode#DEVELOPMENT}.

\n *

change {@link #deletePluginPath(Path)} to a no-op method.

\n * Note: This class is not thread-safe.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class DefaultDevelopmentPluginRepository extends DevelopmentPluginRepository {\n private final List fixedPaths = new ArrayList<>();\n\n public DefaultDevelopmentPluginRepository(Path... pluginsRoots) {\n super(pluginsRoots);\n }\n\n public DefaultDevelopmentPluginRepository(List pluginsRoots) {\n super(pluginsRoots);\n }\n\n public void setFixedPaths(List paths) {\n if (CollectionUtils.isEmpty(paths)) {\n return;\n }\n fixedPaths.clear();\n fixedPaths.addAll(paths);\n }\n\n @Override\n public List getPluginPaths() {\n List paths = new ArrayList<>(fixedPaths);\n paths.addAll(super.getPluginPaths());\n return paths;\n }\n\n @Override\n public boolean deletePluginPath(Path pluginPath) {\n // If the plugin path is not included in the fixed paths,\n // return false and give another repository a chance.\n //\n // Meanwhile, there is no need to physically delete the plugin here.\n return fixedPaths.remove(pluginPath);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultPluginApplicationContextFactory.java", "content": "package run.halo.app.plugin;\n\nimport static org.springframework.util.ResourceUtils.CLASSPATH_URL_PREFIX;\n\nimport java.io.IOException;\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.List;\nimport java.util.concurrent.TimeUnit;\nimport java.util.stream.Stream;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.PluginRuntimeException;\nimport org.springframework.beans.factory.support.DefaultBeanNameGenerator;\nimport org.springframework.beans.factory.support.DefaultListableBeanFactory;\nimport org.springframework.boot.env.PropertySourceLoader;\nimport org.springframework.boot.env.YamlPropertySourceLoader;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.context.event.ContextClosedEvent;\nimport org.springframework.context.event.ContextRefreshedEvent;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.core.ResolvableType;\nimport org.springframework.core.env.PropertySource;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.ResourceLoader;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.util.StopWatch;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.Exceptions;\nimport run.halo.app.core.endpoint.WebSocketEndpoint;\nimport run.halo.app.core.endpoint.WebSocketEndpointManager;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.plugin.event.HaloPluginBeforeStopEvent;\nimport run.halo.app.plugin.event.HaloPluginStartedEvent;\nimport run.halo.app.plugin.event.HaloPluginStoppedEvent;\nimport run.halo.app.plugin.event.SpringPluginStartedEvent;\nimport run.halo.app.plugin.event.SpringPluginStoppedEvent;\nimport run.halo.app.plugin.event.SpringPluginStoppingEvent;\nimport run.halo.app.search.SearchService;\nimport run.halo.app.theme.DefaultTemplateNameResolver;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.FinderRegistry;\n\n@Slf4j\npublic class DefaultPluginApplicationContextFactory implements PluginApplicationContextFactory {\n\n private final SpringPluginManager pluginManager;\n\n public DefaultPluginApplicationContextFactory(SpringPluginManager pluginManager) {\n this.pluginManager = pluginManager;\n }\n\n /**\n * Create and refresh application context. Make sure the plugin has already loaded\n * before.\n *\n * @param pluginId plugin id\n * @return refresh application context for the plugin.\n */\n @Override\n public ApplicationContext create(String pluginId) {\n log.debug(\"Preparing to create application context for plugin {}\", pluginId);\n\n var sw = new StopWatch(\"CreateApplicationContextFor\" + pluginId);\n sw.start(\"Create\");\n\n var pluginWrapper = pluginManager.getPlugin(pluginId);\n var classLoader = pluginWrapper.getPluginClassLoader();\n\n\n /*\n * Manually creating a BeanFactory and setting the plugin's ClassLoader is necessary\n * to ensure that conditional annotations (e.g., @ConditionalOnClass) within the plugin\n * context can correctly load classes.\n * When PluginApplicationContext is created, its constructor initializes an\n * AnnotatedBeanDefinitionReader, which in turn creates a ConditionEvaluator.\n * ConditionEvaluator is responsible for evaluating conditional annotations such as\n * @ConditionalOnClass.\n * It relies on the BeanDefinitionRegistry's ClassLoader to load the classes specified in\n * the annotations.\n * Without explicitly setting the plugin's ClassLoader, the default application\n * ClassLoader is used, which fails to load classes from the plugin.\n * Therefore, a custom DefaultListableBeanFactory with the plugin ClassLoader is required\n * to resolve this issue.\n */\n var beanFactory = new DefaultListableBeanFactory();\n beanFactory.setBeanClassLoader(classLoader);\n\n var context = new PluginApplicationContext(pluginId, pluginManager, beanFactory);\n context.setBeanNameGenerator(DefaultBeanNameGenerator.INSTANCE);\n context.registerShutdownHook();\n context.setParent(pluginManager.getSharedContext());\n\n var resourceLoader = new DefaultResourceLoader(classLoader);\n context.setResourceLoader(resourceLoader);\n sw.stop();\n\n sw.start(\"LoadPropertySources\");\n var mutablePropertySources = context.getEnvironment().getPropertySources();\n\n resolvePropertySources(pluginId, resourceLoader)\n .forEach(mutablePropertySources::addLast);\n sw.stop();\n\n sw.start(\"RegisterBeans\");\n beanFactory.registerSingleton(\"pluginWrapper\", pluginWrapper);\n context.registerBean(AggregatedRouterFunction.class);\n\n if (pluginWrapper.getPlugin() instanceof SpringPlugin springPlugin) {\n beanFactory.registerSingleton(\"pluginContext\", springPlugin.getPluginContext());\n }\n\n var rootContext = pluginManager.getRootContext();\n rootContext.getBeanProvider(ViewNameResolver.class)\n .ifAvailable(viewNameResolver -> {\n var templateNameResolver =\n new DefaultTemplateNameResolver(viewNameResolver, context);\n beanFactory.registerSingleton(\"templateNameResolver\", templateNameResolver);\n });\n\n rootContext.getBeanProvider(ReactiveExtensionClient.class)\n .ifUnique(client -> {\n context.registerBean(\"reactiveSettingFetcher\", DefaultReactiveSettingFetcher.class);\n context.registerBean(\"settingFetcher\", DefaultSettingFetcher.class);\n });\n\n rootContext.getBeanProvider(PluginRequestMappingHandlerMapping.class)\n .ifAvailable(handlerMapping -> {\n var handlerMappingManager =\n new PluginHandlerMappingManager(pluginId, handlerMapping);\n beanFactory.registerSingleton(\"pluginHandlerMappingManager\", handlerMappingManager);\n });\n\n context.registerBean(PluginControllerManager.class);\n beanFactory.registerSingleton(\"springPluginStoppedEventAdapter\",\n new SpringPluginStoppedEventAdapter(pluginId));\n beanFactory.registerSingleton(\"haloPluginEventBridge\", new HaloPluginEventBridge());\n\n rootContext.getBeanProvider(FinderRegistry.class)\n .ifAvailable(finderRegistry -> {\n var finderManager = new FinderManager(pluginId, finderRegistry);\n beanFactory.registerSingleton(\"finderManager\", finderManager);\n });\n\n rootContext.getBeanProvider(WebSocketEndpointManager.class)\n .ifUnique(manager -> beanFactory.registerSingleton(\"pluginWebSocketEndpointManager\",\n new PluginWebSocketEndpointManager(manager)));\n\n rootContext.getBeanProvider(PluginRouterFunctionRegistry.class)\n .ifUnique(registry -> {\n var pluginRouterFunctionManager = new PluginRouterFunctionManager(registry);\n beanFactory.registerSingleton(\n \"pluginRouterFunctionManager\",\n pluginRouterFunctionManager\n );\n });\n\n rootContext.getBeanProvider(SearchService.class)\n .ifUnique(searchService ->\n beanFactory.registerSingleton(\"searchService\", searchService)\n );\n\n sw.stop();\n\n sw.start(\"LoadComponents\");\n var classNames = pluginManager.getExtensionClassNames(pluginId);\n classNames.stream()\n .map(className -> {\n try {\n return classLoader.loadClass(className);\n } catch (ClassNotFoundException e) {\n throw new PluginRuntimeException(String.format(\"\"\"\n Failed to load class %s for plugin %s.\\\n \"\"\", className, pluginId), e);\n }\n })\n .forEach(clazzName -> context.registerBean(clazzName));\n sw.stop();\n log.debug(\"Created application context for plugin {}\", pluginId);\n\n log.debug(\"Refreshing application context for plugin {}\", pluginId);\n sw.start(\"Refresh\");\n\n // Set the context ClassLoader to the plugin ClassLoader to ensure that\n // any class loading operations performed by the context (e.g., initializing\n // bean definitions, loading class resources during static initialization)\n // use the correct ClassLoader.\n var previous = Thread.currentThread().getContextClassLoader();\n try {\n Thread.currentThread().setContextClassLoader(classLoader);\n context.refresh();\n } finally {\n // reset the class loader to previous one to prevent resource leak\n Thread.currentThread().setContextClassLoader(previous);\n }\n sw.stop();\n log.debug(\"Refreshed application context for plugin {}\", pluginId);\n if (log.isDebugEnabled()) {\n log.debug(\"\\n{}\", sw.prettyPrint(TimeUnit.MILLISECONDS));\n }\n return context;\n }\n\n private static class FinderManager {\n\n private final String pluginId;\n\n private final FinderRegistry finderRegistry;\n\n private FinderManager(String pluginId, FinderRegistry finderRegistry) {\n this.pluginId = pluginId;\n this.finderRegistry = finderRegistry;\n }\n\n @EventListener\n public void onApplicationEvent(ContextClosedEvent ignored) {\n this.finderRegistry.unregister(this.pluginId);\n }\n\n @EventListener\n public void onApplicationEvent(ContextRefreshedEvent event) {\n this.finderRegistry.register(this.pluginId, event.getApplicationContext());\n }\n\n }\n\n private static class PluginWebSocketEndpointManager {\n\n private final WebSocketEndpointManager manager;\n\n private List endpoints;\n\n private PluginWebSocketEndpointManager(WebSocketEndpointManager manager) {\n this.manager = manager;\n }\n\n @EventListener\n public void onApplicationEvent(ContextRefreshedEvent event) {\n var context = event.getApplicationContext();\n this.endpoints = context.getBeanProvider(WebSocketEndpoint.class)\n .orderedStream()\n .toList();\n manager.register(this.endpoints);\n }\n\n @EventListener\n public void onApplicationEvent(ContextClosedEvent ignored) {\n manager.unregister(this.endpoints);\n }\n }\n\n private static class PluginRouterFunctionManager {\n\n private final PluginRouterFunctionRegistry routerFunctionRegistry;\n\n private Collection> routerFunctions;\n\n private PluginRouterFunctionManager(PluginRouterFunctionRegistry routerFunctionRegistry) {\n this.routerFunctionRegistry = routerFunctionRegistry;\n }\n\n @EventListener\n public void onApplicationEvent(ContextClosedEvent ignored) {\n if (routerFunctions != null) {\n routerFunctionRegistry.unregister(routerFunctions);\n }\n }\n\n @EventListener\n public void onApplicationEvent(ContextRefreshedEvent event) {\n var routerFunctions = event.getApplicationContext()\n .>getBeanProvider(\n ResolvableType.forClassWithGenerics(RouterFunction.class, ServerResponse.class)\n )\n .orderedStream()\n .toList();\n routerFunctionRegistry.register(routerFunctions);\n this.routerFunctions = routerFunctions;\n }\n }\n\n\n private static class PluginHandlerMappingManager {\n private final String pluginId;\n\n private final PluginRequestMappingHandlerMapping handlerMapping;\n\n private PluginHandlerMappingManager(String pluginId,\n PluginRequestMappingHandlerMapping handlerMapping) {\n this.pluginId = pluginId;\n this.handlerMapping = handlerMapping;\n }\n\n @EventListener\n public void onApplicationEvent(ContextRefreshedEvent event) {\n var context = event.getApplicationContext();\n context.getBeansWithAnnotation(Controller.class)\n .values()\n .forEach(controller ->\n handlerMapping.registerHandlerMethods(this.pluginId, controller)\n );\n }\n\n @EventListener\n public void onApplicationEvent(ContextClosedEvent ignored) {\n handlerMapping.unregister(this.pluginId);\n }\n }\n\n private class SpringPluginStoppedEventAdapter\n implements ApplicationListener {\n\n private final String pluginId;\n\n private SpringPluginStoppedEventAdapter(String pluginId) {\n this.pluginId = pluginId;\n }\n\n @Override\n public void onApplicationEvent(ContextClosedEvent event) {\n var plugin = pluginManager.getPlugin(pluginId).getPlugin();\n if (plugin instanceof SpringPlugin springPlugin) {\n event.getApplicationContext()\n .publishEvent(new SpringPluginStoppedEvent(this, springPlugin));\n }\n }\n }\n\n private class HaloPluginEventBridge {\n\n @EventListener\n public void onApplicationEvent(SpringPluginStartedEvent event) {\n var pluginContext = event.getSpringPlugin().getPluginContext();\n var pluginWrapper = pluginManager.getPlugin(pluginContext.getName());\n\n pluginManager.getRootContext()\n .publishEvent(new HaloPluginStartedEvent(this, pluginWrapper));\n }\n\n @EventListener\n public void onApplicationEvent(SpringPluginStoppingEvent event) {\n var pluginContext = event.getSpringPlugin().getPluginContext();\n var pluginWrapper = pluginManager.getPlugin(pluginContext.getName());\n pluginManager.getRootContext()\n .publishEvent(new HaloPluginBeforeStopEvent(this, pluginWrapper));\n }\n\n @EventListener\n public void onApplicationEvent(SpringPluginStoppedEvent event) {\n var pluginContext = event.getSpringPlugin().getPluginContext();\n var pluginWrapper = pluginManager.getPlugin(pluginContext.getName());\n pluginManager.getRootContext()\n .publishEvent(new HaloPluginStoppedEvent(this, pluginWrapper));\n }\n\n }\n\n private List> resolvePropertySources(String pluginId,\n ResourceLoader resourceLoader) {\n var haloProperties = pluginManager.getRootContext()\n .getBeanProvider(HaloProperties.class)\n .getIfAvailable();\n if (haloProperties == null) {\n return List.of();\n }\n\n var propertySourceLoader = new YamlPropertySourceLoader();\n var propertySources = new ArrayList>();\n var configsPath = haloProperties.getWorkDir().resolve(\"plugins\").resolve(\"configs\");\n // resolve user defined config\n Stream.of(\n configsPath.resolve(pluginId + \".yaml\"),\n configsPath.resolve(pluginId + \".yml\")\n )\n .map(path -> resourceLoader.getResource(path.toUri().toString()))\n .forEach(resource -> {\n var sources =\n loadPropertySources(\"user-defined-config\", resource, propertySourceLoader);\n propertySources.addAll(sources);\n });\n\n // resolve default config\n Stream.of(\n CLASSPATH_URL_PREFIX + \"/config.yaml\",\n CLASSPATH_URL_PREFIX + \"/config.yml\"\n )\n .map(resourceLoader::getResource)\n .forEach(resource -> {\n var sources = loadPropertySources(\"default-config\", resource, propertySourceLoader);\n propertySources.addAll(sources);\n });\n return propertySources;\n }\n\n private List> loadPropertySources(String propertySourceName,\n Resource resource,\n PropertySourceLoader propertySourceLoader) {\n if (log.isDebugEnabled()) {\n log.debug(\"Loading property sources from {}\", resource);\n }\n if (!resource.exists()) {\n return List.of();\n }\n try {\n return propertySourceLoader.load(propertySourceName, resource);\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultPluginGetter.java", "content": "package run.halo.app.plugin;\n\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.infra.exception.NotFoundException;\n\n/**\n * Default implementation of {@link PluginGetter}.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DefaultPluginGetter implements PluginGetter {\n private final ExtensionClient client;\n\n @Override\n public Plugin getPlugin(String name) {\n if (StringUtils.isBlank(name)) {\n throw new IllegalArgumentException(\"Plugin name must not be blank\");\n }\n return client.fetch(Plugin.class, name)\n .orElseThrow(() -> new NotFoundException(\"Plugin not found\"));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultPluginRouterFunctionRegistry.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Collection;\nimport java.util.concurrent.CopyOnWriteArraySet;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SecureServerRequest;\nimport run.halo.app.infra.exception.PluginRuntimeIncompatibleException;\n\n/**\n * A composite {@link RouterFunction} implementation for plugin.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class DefaultPluginRouterFunctionRegistry\n implements RouterFunction, PluginRouterFunctionRegistry {\n\n private final Collection> routerFunctions;\n\n public DefaultPluginRouterFunctionRegistry() {\n this.routerFunctions = new CopyOnWriteArraySet<>();\n }\n\n @Override\n @NonNull\n public Mono> route(@NonNull ServerRequest request) {\n var secureRequest = new SecureServerRequest(request);\n return Flux.fromIterable(this.routerFunctions)\n .concatMap(routerFunction -> {\n // wrap the handler function\n return routerFunction.route(secureRequest)\n .map(hf -> (HandlerFunction)\n serverRequest -> {\n try {\n return hf.handle(secureRequest);\n } catch (LinkageError le) {\n return Mono.error(new PluginRuntimeIncompatibleException(le));\n }\n }\n );\n })\n .next();\n }\n\n @Override\n public void accept(@NonNull RouterFunctions.Visitor visitor) {\n this.routerFunctions.forEach(routerFunction -> routerFunction.accept(visitor));\n }\n\n @Override\n public void register(Collection> routerFunctions) {\n this.routerFunctions.addAll(routerFunctions);\n }\n\n @Override\n public void unregister(Collection> routerFunctions) {\n this.routerFunctions.removeAll(routerFunctions);\n }\n\n /**\n * Only for testing.\n *\n * @return maintained router functions.\n */\n Collection> getRouterFunctions() {\n return routerFunctions;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultReactiveSettingFetcher.java", "content": "package run.halo.app.plugin;\n\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.node.JsonNodeFactory;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport java.util.function.Predicate;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.jspecify.annotations.Nullable;\nimport org.springframework.beans.BeansException;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.ApplicationContextAware;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionMatcher;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.infra.utils.SystemConfigUtils;\nimport tools.jackson.core.JacksonException;\nimport tools.jackson.databind.json.JsonMapper;\n\n/**\n * A default implementation of {@link ReactiveSettingFetcher}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\nclass DefaultReactiveSettingFetcher\n implements ReactiveSettingFetcher, Reconciler, ApplicationContextAware {\n\n private static final Duration TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final JsonMapper mapper = JsonMapper.builder().build();\n\n private final ObjectMapper v2Mapper = JsonUtils.mapper();\n\n private final ReactiveExtensionClient client;\n\n private final Mono configMapCache;\n\n private final AtomicBoolean isCacheInvalidated = new AtomicBoolean(false);\n\n /**\n * The application context of the plugin.\n */\n private ApplicationContext applicationContext;\n\n private final String pluginName;\n\n private final String configMapName;\n\n public DefaultReactiveSettingFetcher(\n PluginContext pluginContext, ReactiveExtensionClient client\n ) {\n this.client = client;\n this.pluginName = pluginContext.getName();\n this.configMapName = pluginContext.getConfigMapName();\n this.configMapCache = Mono.defer(() -> {\n if (StringUtils.isBlank(configMapName)) {\n return Mono.empty();\n }\n return client.fetch(ConfigMap.class, configMapName);\n }).cacheInvalidateIf(cm -> isCacheInvalidated.getAndSet(false));\n }\n\n @Override\n public Mono fetch(String group, Class clazz) {\n return getSettingValue(group)\n .map(n -> mapper.convertValue(n, clazz));\n }\n\n @Override\n public Mono get(String group) {\n return getValues().mapNotNull(m -> m.get(group))\n .switchIfEmpty(Mono.fromSupplier(v2Mapper::createObjectNode));\n }\n\n @Override\n public Mono getSettingValue(String group) {\n return getSettingValues().mapNotNull(m -> m.get(group));\n }\n\n @Override\n public Mono> getValues() {\n return configMapCache.mapNotNull(ConfigMap::getData)\n .map(this::toJackson2JsonNodeMap)\n .defaultIfEmpty(Map.of());\n }\n\n @Override\n public Mono> getSettingValues() {\n return configMapCache.mapNotNull(ConfigMap::getData)\n .map(this::toJackson3JsonNodeMap)\n .defaultIfEmpty(Map.of());\n }\n\n private Map toJackson3JsonNodeMap(\n @Nullable Map data\n ) {\n if (data == null) {\n return Map.of();\n }\n return data.entrySet().stream().collect(Collectors.toMap(\n Map.Entry::getKey,\n e -> toJackson3JsonNode(e.getValue())\n ));\n }\n\n private Map toJackson2JsonNodeMap(@Nullable Map data) {\n if (data == null) {\n return Map.of();\n }\n return data.entrySet().stream().collect(Collectors.toMap(\n Map.Entry::getKey,\n e -> toJackson2JsonNode(e.getValue())\n ));\n }\n\n private tools.jackson.databind.JsonNode toJackson3JsonNode(\n @Nullable String json) {\n if (StringUtils.isBlank(json)) {\n return mapper.missingNode();\n }\n try {\n return mapper.readTree(json);\n } catch (JacksonException ex) {\n log.error(\"Failed to parse plugin [{}] config json: [{}]\", pluginName, json, ex);\n return mapper.missingNode();\n }\n }\n\n private JsonNode toJackson2JsonNode(String json) {\n if (StringUtils.isBlank(json)) {\n return v2Mapper.missingNode();\n }\n try {\n return v2Mapper.readTree(json);\n } catch (JsonProcessingException e) {\n // ignore\n log.error(\"Failed to parse plugin [{}] config json: [{}]\", pluginName, json, e);\n }\n return JsonNodeFactory.instance.missingNode();\n }\n\n static String buildCacheKey(String pluginName) {\n return \"plugin-\" + pluginName + \"-configmap\";\n }\n\n @Override\n public Result reconcile(Request request) {\n return client.fetch(ConfigMap.class, configMapName)\n .filter(Predicate.not(ExtensionUtil::isDeleted))\n .flatMap(cm -> {\n // get data snapshot\n var snapshot = SystemConfigUtils.getDataSnapshot(cm);\n if (SystemConfigUtils.populateChecksum(cm)) {\n // if config map is changed\n SystemConfigUtils.updateDataSnapshot(cm);\n return client.update(cm).then(Mono.fromCallable(() -> {\n this.isCacheInvalidated.set(true);\n applicationContext.publishEvent(PluginConfigUpdatedEvent.builder()\n .source(this)\n .oldConfig(toJackson2JsonNodeMap(snapshot))\n .newConfig(toJackson2JsonNodeMap(cm.getData()))\n .oldSettingValues(toJackson3JsonNodeMap(snapshot))\n .newSettingValues(toJackson3JsonNodeMap(cm.getData()))\n .build());\n return null;\n }));\n }\n return Mono.empty();\n }).blockOptional(TIMEOUT).orElse(null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n if (StringUtils.isBlank(configMapName)) {\n // Disable the controller if the config map name is not set\n return builder\n .extension(new ConfigMap())\n .syncAllOnStart(false)\n .onAddMatcher(extension -> false)\n .onUpdateMatcher(extension -> false)\n .onDeleteMatcher(extension -> false)\n .build();\n }\n ExtensionMatcher matcher =\n extension -> Objects.equals(extension.getMetadata().getName(), configMapName);\n return builder\n .extension(new ConfigMap())\n .syncAllOnStart(true)\n .syncAllListOptions(ListOptions.builder()\n .fieldQuery(equal(\"metadata.name\", configMapName))\n .build())\n .onAddMatcher(matcher)\n .onUpdateMatcher(matcher)\n .onDeleteMatcher(matcher)\n .build();\n }\n\n @Override\n public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {\n this.applicationContext = applicationContext;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultSettingFetcher.java", "content": "package run.halo.app.plugin;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport org.springframework.lang.NonNull;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n *

A value fetcher for plugin form configuration.

\n *\n * @author guqing\n * @since 2.0.0\n */\nclass DefaultSettingFetcher implements SettingFetcher {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private final ReactiveSettingFetcher delegateFetcher;\n\n public DefaultSettingFetcher(ReactiveSettingFetcher reactiveSettingFetcher) {\n this.delegateFetcher = reactiveSettingFetcher;\n }\n\n @NonNull\n @Override\n public Optional fetch(String group, Class clazz) {\n return delegateFetcher.fetch(group, clazz)\n .blockOptional(BLOCKING_TIMEOUT);\n }\n\n @NonNull\n @Override\n public JsonNode get(String group) {\n return Objects.requireNonNull(delegateFetcher.get(group).block(BLOCKING_TIMEOUT));\n }\n\n @Override\n public tools.jackson.databind.JsonNode getSettingValue(String group) {\n return delegateFetcher.getSettingValue(group).block(BLOCKING_TIMEOUT);\n }\n\n /**\n * Get values from {@link ConfigMap}.\n *\n * @return a unmodifiable map of values(non-null).\n */\n @NonNull\n @Override\n public Map getValues() {\n return Objects.requireNonNull(delegateFetcher.getValues().block(BLOCKING_TIMEOUT));\n }\n\n @Override\n public Map getSettingValues() {\n return delegateFetcher.getSettingValues().block(BLOCKING_TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DefaultSpringPlugin.java", "content": "package run.halo.app.plugin;\n\nimport org.jspecify.annotations.NonNull;\nimport org.pf4j.Plugin;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.ConfigurableApplicationContext;\nimport run.halo.app.plugin.event.SpringPluginStartedEvent;\nimport run.halo.app.plugin.event.SpringPluginStartingEvent;\nimport run.halo.app.plugin.event.SpringPluginStoppingEvent;\n\n/**\n * Default implementation of {@link SpringPlugin}.\n *\n * @author johnniang\n * @since 2.22.0\n */\nclass DefaultSpringPlugin extends Plugin implements SpringPlugin {\n\n private ApplicationContext context;\n\n private Plugin delegate;\n\n private final PluginApplicationContextFactory contextFactory;\n\n private final PluginContext pluginContext;\n\n public DefaultSpringPlugin(PluginApplicationContextFactory contextFactory,\n PluginContext pluginContext) {\n this.contextFactory = contextFactory;\n this.pluginContext = pluginContext;\n }\n\n @Override\n public void start() {\n log.info(\"Preparing starting plugin {}\", pluginContext.getName());\n var pluginId = pluginContext.getName();\n var previous = Thread.currentThread().getContextClassLoader();\n try {\n // initialize context\n this.context = contextFactory.create(pluginId);\n Thread.currentThread().setContextClassLoader(this.context.getClassLoader());\n log.info(\"Application context {} for plugin {} is created\", this.context, pluginId);\n\n var pluginOpt = context.getBeanProvider(Plugin.class)\n .stream()\n .findFirst();\n log.info(\"Before publishing plugin starting event for plugin {}\", pluginId);\n context.publishEvent(new SpringPluginStartingEvent(this, this));\n log.info(\"After publishing plugin starting event for plugin {}\", pluginId);\n if (pluginOpt.isPresent()) {\n this.delegate = pluginOpt.get();\n log.info(\"Starting {} for plugin {}\", this.delegate, pluginId);\n this.delegate.start();\n log.info(\"Started {} for plugin {}\", this.delegate, pluginId);\n }\n log.info(\"Before publishing plugin started event for plugin {}\", pluginId);\n context.publishEvent(new SpringPluginStartedEvent(this, this));\n log.info(\"After publishing plugin started event for plugin {}\", pluginId);\n } catch (Throwable t) {\n // try to stop plugin for cleaning resources if something went wrong\n log.error(\n \"Cleaning up plugin resources for plugin {} due to not being able to start plugin.\",\n pluginId);\n this.stop();\n // propagate exception to invoker.\n throw t;\n } finally {\n Thread.currentThread().setContextClassLoader(previous);\n }\n }\n\n @Override\n public void stop() {\n var previous = Thread.currentThread().getContextClassLoader();\n try {\n if (context != null) {\n Thread.currentThread().setContextClassLoader(context.getClassLoader());\n log.info(\"Before publishing plugin stopping event for plugin {}\",\n pluginContext.getName());\n context.publishEvent(new SpringPluginStoppingEvent(this, this));\n log.info(\"After publishing plugin stopping event for plugin {}\",\n pluginContext.getName());\n }\n if (this.delegate != null) {\n log.info(\"Stopping {} for plugin {}\", this.delegate, pluginContext.getName());\n this.delegate.stop();\n log.info(\"Stopped {} for plugin {}\", this.delegate, pluginContext.getName());\n }\n } finally {\n Thread.currentThread().setContextClassLoader(previous);\n if (context instanceof ConfigurableApplicationContext configurableContext) {\n log.info(\"Closing plugin context for plugin {}\", pluginContext.getName());\n configurableContext.close();\n log.info(\"Closed plugin context for plugin {}\", pluginContext.getName());\n }\n // reset application context\n log.info(\"Reset plugin context for plugin {}\", pluginContext.getName());\n context = null;\n }\n }\n\n @Override\n public void delete() {\n if (delegate != null) {\n delegate.delete();\n }\n this.delegate = null;\n }\n\n @Override\n @NonNull\n public ApplicationContext getApplicationContext() {\n if (context == null) {\n throw new IllegalStateException(\"\"\"\n Plugin has not been started or has already been stopped; \\\n ApplicationContext is not available.\n \"\"\");\n }\n return context;\n }\n\n @Override\n @NonNull\n public PluginContext getPluginContext() {\n return pluginContext;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/DevPluginLoader.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport org.pf4j.DevelopmentPluginLoader;\nimport org.pf4j.PluginDescriptor;\nimport org.pf4j.PluginManager;\n\npublic class DevPluginLoader extends DevelopmentPluginLoader {\n\n private final PluginProperties pluginProperties;\n\n public DevPluginLoader(\n PluginManager pluginManager,\n PluginProperties pluginProperties\n ) {\n super(pluginManager);\n this.pluginProperties = pluginProperties;\n }\n\n @Override\n public ClassLoader loadPlugin(Path pluginPath, PluginDescriptor pluginDescriptor) {\n var classesDirectories = pluginProperties.getClassesDirectories();\n if (classesDirectories != null) {\n classesDirectories.forEach(\n classesDirectory -> pluginClasspath.addClassesDirectories(classesDirectory)\n );\n }\n var libDirectories = pluginProperties.getLibDirectories();\n if (libDirectories != null) {\n libDirectories.forEach(\n libDirectory -> pluginClasspath.addJarsDirectories(libDirectory)\n );\n }\n return super.loadPlugin(pluginPath, pluginDescriptor);\n }\n\n @Override\n public boolean isApplicable(Path pluginPath) {\n // Currently we only support a plugin loading from directory in dev mode.\n return Files.isDirectory(pluginPath);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/HaloPluginManager.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Stack;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.CompoundPluginLoader;\nimport org.pf4j.CompoundPluginRepository;\nimport org.pf4j.DefaultPluginManager;\nimport org.pf4j.DefaultPluginRepository;\nimport org.pf4j.DefaultPluginStatusProvider;\nimport org.pf4j.ExtensionFactory;\nimport org.pf4j.ExtensionFinder;\nimport org.pf4j.JarPluginLoader;\nimport org.pf4j.JarPluginRepository;\nimport org.pf4j.PluginDescriptorFinder;\nimport org.pf4j.PluginFactory;\nimport org.pf4j.PluginLoader;\nimport org.pf4j.PluginRepository;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginStateEvent;\nimport org.pf4j.PluginStateListener;\nimport org.pf4j.PluginStatusProvider;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.data.util.Lazy;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.plugin.event.PluginStartedEvent;\n\n/**\n * PluginManager to hold the main ApplicationContext.\n * It provides methods for managing the plugin lifecycle.\n *\n * @author guqing\n * @author johnniang\n * @since 2.0.0\n */\n@Slf4j\nclass HaloPluginManager extends DefaultPluginManager\n implements SpringPluginManager, InitializingBean {\n\n private final ApplicationContext rootContext;\n\n private Lazy sharedContext;\n\n private final PluginProperties pluginProperties;\n\n private final PluginsRootGetter pluginsRootGetter;\n\n private final SystemVersionSupplier systemVersionSupplier;\n\n public HaloPluginManager(ApplicationContext rootContext,\n PluginProperties pluginProperties,\n SystemVersionSupplier systemVersionSupplier,\n PluginsRootGetter pluginsRootGetter) {\n this.pluginProperties = pluginProperties;\n this.rootContext = rootContext;\n this.pluginsRootGetter = pluginsRootGetter;\n this.systemVersionSupplier = systemVersionSupplier;\n }\n\n @Override\n protected void initialize() {\n // Leave the implementation empty because the super#initialize eagerly initializes\n // components before properties set.\n }\n\n @Override\n public void afterPropertiesSet() throws Exception {\n super.runtimeMode = pluginProperties.getRuntimeMode();\n this.sharedContext = Lazy.of(() -> SharedApplicationContextFactory.create(rootContext));\n setExactVersionAllowed(pluginProperties.isExactVersionAllowed());\n setSystemVersion(systemVersionSupplier.get().toStableVersion().toString());\n\n super.initialize();\n // the listener must be after the super#initialize\n addPluginStateListener(new PluginStartedListener());\n }\n\n @Override\n protected ExtensionFactory createExtensionFactory() {\n return new SpringExtensionFactory(this);\n }\n\n @Override\n protected ExtensionFinder createExtensionFinder() {\n var finder = new SpringComponentsFinder(this);\n addPluginStateListener(finder);\n return finder;\n }\n\n @Override\n protected PluginFactory createPluginFactory() {\n var contextFactory = new DefaultPluginApplicationContextFactory(this);\n var pluginGetter = rootContext.getBean(PluginGetter.class);\n return new SpringPluginFactory(contextFactory, pluginGetter);\n }\n\n @Override\n protected PluginDescriptorFinder createPluginDescriptorFinder() {\n return new YamlPluginDescriptorFinder();\n }\n\n @Override\n protected PluginLoader createPluginLoader() {\n var compoundLoader = new CompoundPluginLoader();\n compoundLoader.add(new DevPluginLoader(this, this.pluginProperties), this::isDevelopment);\n compoundLoader.add(new JarPluginLoader(this));\n return compoundLoader;\n }\n\n @Override\n protected PluginStatusProvider createPluginStatusProvider() {\n if (PropertyPluginStatusProvider.isPropertySet(pluginProperties)) {\n return new PropertyPluginStatusProvider(pluginProperties);\n }\n // Only plugins root is writeable\n return new DefaultPluginStatusProvider(pluginsRootGetter.get());\n }\n\n @Override\n protected PluginRepository createPluginRepository() {\n var developmentPluginRepository =\n new DefaultDevelopmentPluginRepository(getPluginsRoots());\n developmentPluginRepository\n .setFixedPaths(pluginProperties.getFixedPluginPath());\n return new CompoundPluginRepository()\n .add(developmentPluginRepository, this::isDevelopment)\n .add(new JarPluginRepository(getPluginsRoots()))\n .add(new DefaultPluginRepository(getPluginsRoots()));\n }\n\n @Override\n protected List createPluginsRoot() {\n return List.of(pluginsRootGetter.get());\n }\n\n @Override\n public void startPlugins() {\n throw new UnsupportedOperationException(\n \"The operation of starting all plugins is not supported.\"\n );\n }\n\n @Override\n public void stopPlugins() {\n throw new UnsupportedOperationException(\n \"The operation of stopping all plugins is not supported.\"\n );\n }\n\n @Override\n public ApplicationContext getRootContext() {\n return rootContext;\n }\n\n @Override\n public ApplicationContext getSharedContext() {\n return sharedContext.get();\n }\n\n @Override\n public List getDependents(String pluginId) {\n if (getPlugin(pluginId) == null) {\n return List.of();\n }\n\n var dependents = new ArrayList();\n var stack = new Stack();\n dependencyResolver.getDependents(pluginId).forEach(stack::push);\n while (!stack.isEmpty()) {\n var dependent = stack.pop();\n var pluginWrapper = getPlugin(dependent);\n if (pluginWrapper != null) {\n dependents.add(pluginWrapper);\n dependencyResolver.getDependents(dependent).forEach(stack::push);\n }\n }\n return dependents;\n }\n\n @Override\n public List startedPlugins() {\n return List.copyOf(super.getStartedPlugins())\n .stream()\n // Make sure the plugin is really started\n .filter(p -> p.getPluginState().isStarted())\n .toList();\n }\n\n /**\n * Listener for plugin started event.\n *\n * @author johnniang\n * @since 2.17.0\n */\n private static class PluginStartedListener implements PluginStateListener {\n\n @Override\n public void pluginStateChanged(PluginStateEvent event) {\n if (PluginState.STARTED.equals(event.getPluginState())) {\n var plugin = event.getPlugin().getPlugin();\n if (plugin instanceof SpringPlugin springPlugin) {\n try {\n springPlugin.getApplicationContext()\n .publishEvent(new PluginStartedEvent(this));\n } catch (Throwable t) {\n var pluginId = event.getPlugin().getPluginId();\n log.warn(\"Error while publishing plugin started event for plugin {}\",\n pluginId, t);\n }\n }\n }\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/HaloSharedEventDelegator.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Objects;\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * The event that delegates a shared event in core into all started plugins.\n *\n * @author johnniang\n * @since 2.17\n */\n@Getter\nclass HaloSharedEventDelegator extends ApplicationEvent {\n\n private final ApplicationEvent delegate;\n\n public HaloSharedEventDelegator(Object source, ApplicationEvent delegate) {\n super(source);\n this.delegate = delegate;\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n\n HaloSharedEventDelegator that = (HaloSharedEventDelegator) o;\n return Objects.equals(delegate, that.delegate);\n }\n\n @Override\n public int hashCode() {\n return Objects.hashCode(delegate);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/OptionalDependentResolver.java", "content": "package run.halo.app.plugin;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.pf4j.PluginDependency;\nimport org.pf4j.PluginDescriptor;\nimport org.pf4j.util.DirectedGraph;\n\n/**\n *

Pass in a list of started plugin names to resolve dependency relationships, and return a\n * list of plugin names that depend on the specified plugin.

\n *

Do not consider the problem of circular dependency, because all the plugins that have been\n * started must not have this problem.

\n */\npublic class OptionalDependentResolver {\n private final DirectedGraph dependentsGraph;\n private final List plugins;\n\n public OptionalDependentResolver(List startedPlugins) {\n this.plugins = startedPlugins;\n this.dependentsGraph = new DirectedGraph<>();\n resolve();\n }\n\n private void resolve() {\n // populate graphs\n for (PluginDescriptor plugin : plugins) {\n addPlugin(plugin);\n }\n }\n\n public List getOptionalDependents(String pluginId) {\n return new ArrayList<>(dependentsGraph.getNeighbors(pluginId));\n }\n\n private void addPlugin(PluginDescriptor descriptor) {\n String pluginId = descriptor.getPluginId();\n List dependencies = descriptor.getDependencies();\n if (dependencies.isEmpty()) {\n dependentsGraph.addVertex(pluginId);\n } else {\n boolean edgeAdded = false;\n for (PluginDependency dependency : dependencies) {\n if (dependency.isOptional()) {\n edgeAdded = true;\n dependentsGraph.addEdge(dependency.getPluginId(), pluginId);\n }\n }\n\n // Register the plugin without dependencies, if all of its dependencies are optional.\n if (!edgeAdded) {\n dependentsGraph.addVertex(pluginId);\n }\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginApplicationContext.java", "content": "package run.halo.app.plugin;\n\nimport java.util.List;\nimport java.util.concurrent.locks.StampedLock;\nimport org.springframework.beans.factory.support.DefaultListableBeanFactory;\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.context.annotation.AnnotationConfigApplicationContext;\nimport org.springframework.core.ResolvableType;\nimport org.springframework.core.annotation.AnnotationUtils;\nimport org.springframework.util.Assert;\nimport org.springframework.util.LinkedMultiValueMap;\nimport org.springframework.util.MultiValueMap;\nimport run.halo.app.extension.GroupVersionKind;\n\n/**\n * The generic IOC container for plugins.\n * The plugin-classes loaded through the same plugin-classloader will be put into the same\n * {@link PluginApplicationContext} for bean creation.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PluginApplicationContext extends AnnotationConfigApplicationContext {\n\n private final GvkExtensionMapping gvkExtensionMapping = new GvkExtensionMapping();\n\n private final String pluginId;\n\n private final SpringPluginManager pluginManager;\n\n public PluginApplicationContext(String pluginId, SpringPluginManager pluginManager,\n DefaultListableBeanFactory beanFactory) {\n super(beanFactory);\n this.pluginId = pluginId;\n this.pluginManager = pluginManager;\n }\n\n public String getPluginId() {\n return pluginId;\n }\n\n /**\n * Gets the gvk-extension mapping.\n * It is thread safe\n *\n * @param gvk the group-kind-version\n * @param extensionName extension resources name\n */\n public void addExtensionMapping(GroupVersionKind gvk, String extensionName) {\n gvkExtensionMapping.addExtensionMapping(gvk, extensionName);\n }\n\n /**\n * Gets the extension names by gvk.\n * It is thread safe\n *\n * @param gvk the group-kind-version\n * @return a immutable list of extension names\n */\n public List getExtensionNames(GroupVersionKind gvk) {\n return List.copyOf(gvkExtensionMapping.getExtensionNames(gvk));\n }\n\n public MultiValueMap extensionNamesMapping() {\n return gvkExtensionMapping.extensionNamesMapping();\n }\n\n static class GvkExtensionMapping {\n private final StampedLock sl = new StampedLock();\n private final MultiValueMap extensionNamesMapping =\n new LinkedMultiValueMap<>();\n\n public void addAllExtensionMapping(GroupVersionKind gvk, List extensionNames) {\n long stamp = sl.writeLock();\n try {\n extensionNamesMapping.addAll(gvk, extensionNames);\n } finally {\n sl.unlockWrite(stamp);\n }\n }\n\n public void addExtensionMapping(GroupVersionKind gvk, String extensionName) {\n long stamp = sl.writeLock();\n try {\n extensionNamesMapping.add(gvk, extensionName);\n } finally {\n sl.unlockWrite(stamp);\n }\n }\n\n public List getExtensionNames(GroupVersionKind gvk) {\n Assert.notNull(gvk, \"The gvk must not be null\");\n long stamp = sl.tryOptimisticRead();\n List values = extensionNamesMapping.get(gvk);\n if (!sl.validate(stamp)) {\n // Check if another write lock occurs after the optimistic read lock\n // If so, escalate lock to a pessimistic lock\n stamp = sl.readLock();\n try {\n return extensionNamesMapping.get(gvk);\n } finally {\n sl.unlockRead(stamp);\n }\n }\n return values;\n }\n\n public MultiValueMap extensionNamesMapping() {\n return new LinkedMultiValueMap<>(extensionNamesMapping);\n }\n\n public void clear() {\n extensionNamesMapping.clear();\n }\n }\n\n @Override\n protected void publishEvent(Object event, ResolvableType typeHint) {\n if (event instanceof ApplicationEvent applicationEvent\n && AnnotationUtils.findAnnotation(event.getClass(), SharedEvent.class) != null) {\n // publish event via root context\n var delegateEvent = new PluginSharedEventDelegator(this, applicationEvent);\n pluginManager.getRootContext().publishEvent(delegateEvent);\n return;\n }\n // unwrap event if needed\n var originalEvent = event;\n if (event instanceof HaloSharedEventDelegator delegator) {\n originalEvent = delegator.getDelegate();\n }\n super.publishEvent(originalEvent, typeHint);\n }\n\n @Override\n protected void onClose() {\n // For subclasses: do nothing by default.\n super.onClose();\n gvkExtensionMapping.clear();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginApplicationContextFactory.java", "content": "package run.halo.app.plugin;\n\nimport org.springframework.context.ApplicationContext;\n\npublic interface PluginApplicationContextFactory {\n\n /**\n * Create and refresh application context.\n *\n * @param pluginId plugin id\n * @return refresh application context for the plugin.\n */\n ApplicationContext create(String pluginId);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginAutoConfiguration.java", "content": "package run.halo.app.plugin;\n\nimport static run.halo.app.plugin.resources.BundleResourceUtils.getJsBundleResource;\n\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.time.Instant;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.PluginManager;\nimport org.springframework.beans.factory.annotation.Qualifier;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.boot.context.properties.EnableConfigurationProperties;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.web.reactive.accept.RequestedContentTypeResolver;\nimport org.springframework.web.reactive.function.BodyInserters;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemVersionSupplier;\n\n/**\n * Plugin autoconfiguration for Spring Boot.\n *\n * @author guqing\n * @see PluginProperties\n */\n@Slf4j\n@Configuration\n@EnableConfigurationProperties(PluginProperties.class)\npublic class PluginAutoConfiguration {\n\n @Bean\n public PluginRequestMappingHandlerMapping pluginRequestMappingHandlerMapping(\n @Qualifier(\"webFluxContentTypeResolver\")\n RequestedContentTypeResolver requestedContentTypeResolver\n ) {\n PluginRequestMappingHandlerMapping mapping = new PluginRequestMappingHandlerMapping();\n mapping.setContentTypeResolver(requestedContentTypeResolver);\n mapping.setOrder(-1);\n return mapping;\n }\n\n @Bean\n public SpringPluginManager pluginManager(ApplicationContext context,\n SystemVersionSupplier systemVersionSupplier,\n PluginProperties pluginProperties,\n PluginsRootGetter pluginsRootGetter) throws FileNotFoundException, URISyntaxException {\n return new HaloPluginManager(\n context, pluginProperties, systemVersionSupplier, pluginsRootGetter\n );\n }\n\n @Bean\n public RouterFunction pluginJsBundleRoute(PluginManager pluginManager,\n WebProperties webProperties) {\n var cacheProperties = webProperties.getResources().getCache();\n return RouterFunctions.route()\n .GET(\"/plugins/{name}/assets/console/{*resource}\", request -> {\n String pluginName = request.pathVariable(\"name\");\n String fileName = request.pathVariable(\"resource\");\n\n var jsBundle = getJsBundleResource(pluginManager, pluginName, fileName);\n if (jsBundle == null || !jsBundle.exists()) {\n return ServerResponse.notFound().build();\n }\n var useLastModified = cacheProperties.isUseLastModified();\n var bodyBuilder = ServerResponse.ok()\n .cacheControl(cacheProperties.getCachecontrol().toHttpCacheControl());\n try {\n if (useLastModified) {\n var lastModified = Instant.ofEpochMilli(jsBundle.lastModified());\n return request.checkNotModified(lastModified)\n .switchIfEmpty(Mono.defer(() -> bodyBuilder.lastModified(lastModified)\n .body(BodyInserters.fromResource(jsBundle))));\n }\n return bodyBuilder.body(BodyInserters.fromResource(jsBundle));\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n })\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginBeforeStopSyncListener.java", "content": "package run.halo.app.plugin;\n\nimport java.time.Duration;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.exception.SchemeNotFoundException;\nimport run.halo.app.plugin.event.HaloPluginBeforeStopEvent;\n\n/**\n * Synchronization listener executed by the plugin before it is stopped.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\nclass PluginBeforeStopSyncListener {\n\n private static final Duration CLEANUP_TIMEOUT = Duration.ofMinutes(1);\n\n private final ReactiveExtensionClient client;\n\n public PluginBeforeStopSyncListener(ReactiveExtensionClient client) {\n this.client = client;\n }\n\n @EventListener\n void onApplicationEvent(@NonNull HaloPluginBeforeStopEvent event) {\n var pluginWrapper = event.getPlugin();\n var p = pluginWrapper.getPlugin();\n if (!(p instanceof SpringPlugin springPlugin)) {\n return;\n }\n var applicationContext = springPlugin.getApplicationContext();\n if (!(applicationContext instanceof PluginApplicationContext pluginApplicationContext)) {\n return;\n }\n cleanUpPluginExtensionResources(pluginApplicationContext).block(CLEANUP_TIMEOUT);\n }\n\n private Mono cleanUpPluginExtensionResources(PluginApplicationContext context) {\n var gvkExtensionNames = context.extensionNamesMapping();\n return Flux.fromIterable(gvkExtensionNames.entrySet())\n .flatMap(entry -> Flux.fromIterable(entry.getValue())\n .flatMap(extensionName -> client.fetch(entry.getKey(), extensionName)\n .onErrorComplete(SchemeNotFoundException.class)\n .filter(e -> !ExtensionUtil.hasDoNotOverwriteLabel(e))\n .flatMap(client::delete)\n .retryWhen(Retry.backoff(10, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance)\n )\n )\n .flatMap(e -> waitForDeleted(e.groupVersionKind(), e.getMetadata().getName())))\n .then();\n }\n\n private Mono waitForDeleted(GroupVersionKind gvk, String name) {\n return client.fetch(gvk, name)\n .flatMap(e -> {\n if (log.isDebugEnabled()) {\n log.debug(\"Wait for {}/{} deleted\", gvk, name);\n }\n return Mono.error(new IllegalStateException(\"Wait for extension deleted\"));\n })\n .retryWhen(Retry.backoff(10, Duration.ofMillis(100))\n .filter(IllegalStateException.class::isInstance)\n )\n .then()\n .doOnSuccess(v -> {\n if (log.isDebugEnabled()) {\n log.debug(\"{}/{} was deleted successfully.\", gvk, name);\n }\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginConst.java", "content": "package run.halo.app.plugin;\n\n/**\n * Plugin constants.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface PluginConst {\n /**\n * Plugin metadata labels key.\n */\n String PLUGIN_NAME_LABEL_NAME = \"plugin.halo.run/plugin-name\";\n\n String SYSTEM_PLUGIN_NAME = \"system\";\n\n String RELOAD_ANNO = \"plugin.halo.run/reload\";\n\n String REQUEST_TO_UNLOAD_LABEL = \"plugin.halo.run/request-to-unload\";\n\n String PLUGIN_PATH = \"plugin.halo.run/plugin-path\";\n\n String RUNTIME_MODE_ANNO = \"plugin.halo.run/runtime-mode\";\n\n static String assetsRoutePrefix(String pluginName) {\n return \"/plugins/\" + pluginName + \"/assets/\";\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginControllerManager.java", "content": "package run.halo.app.plugin;\n\nimport static org.springframework.core.ResolvableType.forClassWithGenerics;\n\nimport java.util.concurrent.ConcurrentHashMap;\nimport org.springframework.context.event.EventListener;\nimport reactor.core.Disposable;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.plugin.event.SpringPluginStartedEvent;\nimport run.halo.app.plugin.event.SpringPluginStoppingEvent;\n\npublic class PluginControllerManager {\n\n private final ConcurrentHashMap controllers;\n\n private final ExtensionClient client;\n\n public PluginControllerManager(ExtensionClient client) {\n this.client = client;\n controllers = new ConcurrentHashMap<>();\n }\n\n @EventListener\n public void onApplicationEvent(SpringPluginStartedEvent event) {\n event.getSpringPlugin().getApplicationContext()\n .>getBeanProvider(\n forClassWithGenerics(Reconciler.class, Reconciler.Request.class))\n .orderedStream()\n .forEach(this::start);\n }\n\n @EventListener\n public void onApplicationEvent(SpringPluginStoppingEvent event) throws Exception {\n controllers.values()\n .forEach(Disposable::dispose);\n controllers.clear();\n }\n\n private void start(Reconciler reconciler) {\n var builder = new ControllerBuilder(reconciler, client);\n var controller = reconciler.setupWith(builder);\n controllers.put(reconciler.getClass().getName(), controller);\n controller.start();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginDevelopmentInitializer.java", "content": "package run.halo.app.plugin;\n\nimport static run.halo.app.extension.MetadataUtil.nullSafeAnnotations;\n\nimport java.nio.file.Path;\nimport java.time.Duration;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.PluginManager;\nimport org.springframework.boot.context.event.ApplicationReadyEvent;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\npublic class PluginDevelopmentInitializer implements ApplicationListener {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final PluginManager pluginManager;\n\n private final PluginProperties pluginProperties;\n\n private final ReactiveExtensionClient extensionClient;\n\n public PluginDevelopmentInitializer(PluginManager pluginManager,\n PluginProperties pluginProperties, ReactiveExtensionClient extensionClient) {\n this.pluginManager = pluginManager;\n this.pluginProperties = pluginProperties;\n this.extensionClient = extensionClient;\n }\n\n @Override\n public void onApplicationEvent(@NonNull ApplicationReadyEvent ignored) {\n if (!pluginManager.isDevelopment()) {\n return;\n }\n createFixedPluginIfNecessary();\n }\n\n private void createFixedPluginIfNecessary() {\n for (Path path : pluginProperties.getFixedPluginPath()) {\n Plugin plugin = new YamlPluginFinder().find(path);\n extensionClient.fetch(Plugin.class, plugin.getMetadata().getName())\n .flatMap(persistent -> {\n plugin.getMetadata().setVersion(persistent.getMetadata().getVersion());\n nullSafeAnnotations(plugin).put(PluginConst.RUNTIME_MODE_ANNO, \"dev\");\n return extensionClient.update(plugin);\n })\n .switchIfEmpty(Mono.defer(() -> {\n nullSafeAnnotations(plugin).put(PluginConst.RUNTIME_MODE_ANNO, \"dev\");\n return extensionClient.create(plugin);\n }))\n .retryWhen(Retry.backoff(10, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException))\n .block(BLOCKING_TIMEOUT);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginExtensionLoaderUtils.java", "content": "package run.halo.app.plugin;\n\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.net.URLClassLoader;\nimport java.util.Objects;\nimport java.util.function.Predicate;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.support.PathMatchingResourcePatternResolver;\nimport org.springframework.data.util.Predicates;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.extension.Unstructured;\n\n@Slf4j\npublic class PluginExtensionLoaderUtils {\n static final String EXTENSION_LOCATION_PATTERN = \"classpath:extensions/*.{ext:yaml|yml}\";\n\n public static Predicate isSetting(String settingName) {\n if (StringUtils.isBlank(settingName)) {\n return Predicates.isFalse();\n }\n var settingGk = Setting.GVK.groupKind();\n return unstructured -> {\n var gk = unstructured.groupVersionKind().groupKind();\n var name = unstructured.getMetadata().getName();\n return Objects.equals(settingName, name) && Objects.equals(settingGk, gk);\n };\n }\n\n public static Resource[] lookupExtensions(ClassLoader classLoader) {\n if (log.isDebugEnabled()) {\n log.debug(\"Trying to lookup extensions from {}\", classLoader);\n }\n if (classLoader instanceof URLClassLoader urlClassLoader) {\n var urls = urlClassLoader.getURLs();\n // The parent class loader must be null here because we don't want to\n // get any resources from parent class loader.\n classLoader = new URLClassLoader(urls, null);\n }\n var resolver = new PathMatchingResourcePatternResolver(classLoader);\n try {\n var resources = resolver.getResources(EXTENSION_LOCATION_PATTERN);\n if (log.isDebugEnabled()) {\n log.debug(\"Looked up {} resources(s) from {}\", resources.length, classLoader);\n }\n return resources;\n } catch (FileNotFoundException ignored) {\n // Ignore the exception only if extensions folder was not found.\n } catch (IOException e) {\n throw new RuntimeException(String.format(\"\"\"\n Failed to get extension resources while resolving plugin setting \\\n in class loader %s.\\\n \"\"\", classLoader), e);\n }\n return new Resource[] {};\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginFinder.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport org.jspecify.annotations.NonNull;\nimport org.pf4j.PluginRuntimeException;\nimport run.halo.app.core.extension.Plugin;\n\n/**\n * The plugin finder to find plugin manifest from given plugin path.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface PluginFinder {\n\n /**\n * Finds plugin manifest by given plugin path.\n *\n * @param pluginPath the plugin path\n * @return the found plugin\n * @throws PluginRuntimeException if any error occurs during finding plugin\n */\n @NonNull\n Plugin find(@NonNull Path pluginPath);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginGetter.java", "content": "package run.halo.app.plugin;\n\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.infra.exception.NotFoundException;\n\n/**\n * An interface to get {@link Plugin} by name.\n *\n * @author guqing\n * @since 2.17.0\n */\n@FunctionalInterface\npublic interface PluginGetter {\n\n /**\n * Get plugin by name.\n *\n * @param name plugin name must not be null\n * @return plugin\n * @throws IllegalArgumentException if plugin name is null\n * @throws NotFoundException if plugin not found\n */\n Plugin getPlugin(String name);\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginNotFoundException.java", "content": "package run.halo.app.plugin;\n\nimport run.halo.app.infra.exception.NotFoundException;\n\n/**\n * Exception for plugin not found.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PluginNotFoundException extends NotFoundException {\n public PluginNotFoundException(String message) {\n super(message);\n }\n\n public PluginNotFoundException(Throwable cause) {\n super(cause);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginProperties.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport java.util.ArrayList;\nimport java.util.List;\nimport lombok.Data;\nimport org.pf4j.RuntimeMode;\nimport org.springframework.boot.context.properties.ConfigurationProperties;\n\n/**\n * Properties for plugin.\n *\n * @author guqing\n * @see PluginAutoConfiguration\n */\n@Data\n@ConfigurationProperties(prefix = \"halo.plugin\")\npublic class PluginProperties {\n public static final String GRADLE_LIBS_DIR = \"build/libs\";\n\n /**\n * Auto start plugin when main app is ready.\n */\n private boolean autoStartPlugin = true;\n\n /**\n * The default plugin path is obtained through file scanning.\n * In the development mode, you can specify the plugin path as the project directory.\n */\n private List fixedPluginPath = new ArrayList<>();\n\n /**\n * Plugins disabled by default.\n */\n private String[] disabledPlugins = new String[0];\n\n /**\n * Plugins enabled by default, prior to `disabledPlugins`.\n */\n private String[] enabledPlugins = new String[0];\n\n /**\n * Set to true to allow requires expression to be exactly x.y.z. The default is false, meaning\n * that using an exact version x.y.z will implicitly mean the same as >=x.y.z.\n */\n private boolean exactVersionAllowed = false;\n\n /**\n * Extended Plugin Class Directory.\n */\n private List classesDirectories = new ArrayList<>();\n\n /**\n * Extended Plugin Jar Directory.\n */\n private List libDirectories = new ArrayList<>(List.of(GRADLE_LIBS_DIR));\n\n /**\n * Runtime Mode：development/deployment.\n */\n private RuntimeMode runtimeMode = RuntimeMode.DEPLOYMENT;\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginRequestMappingHandlerMapping.java", "content": "package run.halo.app.plugin;\n\nimport java.lang.reflect.Method;\nimport java.util.Arrays;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport org.springframework.aop.support.AopUtils;\nimport org.springframework.core.MethodIntrospector;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.util.Assert;\nimport org.springframework.util.ClassUtils;\nimport org.springframework.util.LinkedMultiValueMap;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.reactive.result.method.RequestMappingInfo;\nimport org.springframework.web.reactive.result.method.RequestMappingInfoHandlerMapping;\nimport org.springframework.web.reactive.result.method.annotation.RequestMappingHandlerMapping;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * An extension of {@link RequestMappingInfoHandlerMapping} that creates\n * {@link RequestMappingInfo} instances from class-level and method-level\n * {@link RequestMapping} annotations used by plugin.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PluginRequestMappingHandlerMapping extends RequestMappingHandlerMapping {\n\n private final MultiValueMap pluginMappingInfo =\n new LinkedMultiValueMap<>();\n\n @Override\n protected void initHandlerMethods() {\n // Parent method will scan beans in the ApplicationContext\n // detect and register handler methods.\n // but this is superfluous for this class.\n }\n\n /**\n * Register handler methods according to the plugin id and the controller(annotated\n * {@link Controller}) bean.\n *\n * @param pluginId plugin id to be registered\n * @param handler controller bean\n */\n public void registerHandlerMethods(String pluginId, Object handler) {\n Class handlerType = (handler instanceof String beanName\n ? obtainApplicationContext().getType(beanName) : handler.getClass());\n\n if (handlerType != null) {\n final Class userType = ClassUtils.getUserClass(handlerType);\n Map methods = MethodIntrospector.selectMethods(userType,\n (MethodIntrospector.MetadataLookup)\n method -> getPluginMappingForMethod(pluginId, method, userType));\n if (logger.isTraceEnabled()) {\n logger.trace(formatMappings(userType, methods));\n } else if (mappingsLogger.isDebugEnabled()) {\n mappingsLogger.debug(formatMappings(userType, methods));\n }\n methods.forEach((method, mapping) -> {\n Method invocableMethod = AopUtils.selectInvocableMethod(method, userType);\n registerHandlerMethod(handler, invocableMethod, mapping);\n pluginMappingInfo.add(pluginId, mapping);\n });\n }\n }\n\n private String formatMappings(Class userType, Map methods) {\n String packageName = ClassUtils.getPackageName(userType);\n String formattedType = (StringUtils.hasText(packageName)\n ? Arrays.stream(packageName.split(\"\\\\.\"))\n .map(packageSegment -> packageSegment.substring(0, 1))\n .collect(Collectors.joining(\".\", \"\", \".\" + userType.getSimpleName())) :\n userType.getSimpleName());\n Function methodFormatter =\n method -> Arrays.stream(method.getParameterTypes())\n .map(Class::getSimpleName)\n .collect(Collectors.joining(\",\", \"(\", \")\"));\n return methods.entrySet().stream()\n .map(e -> {\n Method method = e.getKey();\n return e.getValue() + \": \" + method.getName() + methodFormatter.apply(method);\n })\n .collect(Collectors.joining(\"\\n\\t\", \"\\n\\t\" + formattedType + \":\" + \"\\n\\t\", \"\"));\n }\n\n /**\n * Remove handler methods and mapping based on plugin id.\n *\n * @param pluginId plugin id\n */\n public void unregister(String pluginId) {\n Assert.notNull(pluginId, \"The pluginId must not be null.\");\n if (!pluginMappingInfo.containsKey(pluginId)) {\n return;\n }\n pluginMappingInfo.remove(pluginId).forEach(this::unregisterMapping);\n }\n\n protected List getMappings(String pluginId) {\n List requestMappingInfos = pluginMappingInfo.get(pluginId);\n if (requestMappingInfos == null) {\n return Collections.emptyList();\n }\n return List.copyOf(requestMappingInfos);\n }\n\n protected RequestMappingInfo getPluginMappingForMethod(String pluginId,\n Method method, Class handlerType) {\n RequestMappingInfo info = super.getMappingForMethod(method, handlerType);\n if (info != null) {\n ApiVersion apiVersion = handlerType.getAnnotation(ApiVersion.class);\n if (apiVersion == null) {\n return info;\n }\n info = RequestMappingInfo.paths(buildPrefix(pluginId, apiVersion.value())).build()\n .combine(info);\n }\n return info;\n }\n\n protected String buildPrefix(String pluginName, String apiVersion) {\n GroupVersion groupVersion = GroupVersion.parseAPIVersion(apiVersion);\n if (StringUtils.hasText(groupVersion.group())) {\n // apis/{group}/{version}\n return String.format(\"/apis/%s/%s\", groupVersion.group(), groupVersion.version());\n }\n // apis/api.plugin.halo.run/{version}/plugins/{pluginName}\n return String.format(\"/apis/api.plugin.halo.run/%s/plugins/%s\", groupVersion.version(),\n pluginName);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginRouterFunctionRegistry.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Collection;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\n\npublic interface PluginRouterFunctionRegistry {\n void register(Collection> routerFunctions);\n\n void unregister(Collection> routerFunctions);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginService.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport java.util.List;\nimport java.util.function.Predicate;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Plugin;\n\npublic interface PluginService {\n\n Mono installPresetPlugins();\n\n /**\n * Installs a plugin from a temporary Jar path.\n *\n * @param path is temporary jar path. Do not set the plugin home at here.\n * @return created plugin.\n */\n Mono install(Path path);\n\n Mono upgrade(String name, Path path);\n\n /**\n *

Reload a plugin by name.

\n * Note that this method will set spec.enabled to true it means that the plugin\n * will be started.\n *\n * @param name plugin name\n * @return an updated plugin reloaded from plugin path\n * @throws ServerWebInputException if plugin not found by the given name\n * @see Plugin.PluginSpec#setEnabled(Boolean)\n */\n Mono reload(String name);\n\n /**\n * Uglify js bundle from all enabled plugins to a single js bundle string.\n *\n * @return uglified js bundle\n */\n Flux uglifyJsBundle();\n\n /**\n * Uglify css bundle from all enabled plugins to a single css bundle string.\n *\n * @return uglified css bundle\n */\n Flux uglifyCssBundle();\n\n /**\n *

Generate js/css bundle version for cache control.

\n * This method will list all enabled plugins version and sign it to a string.\n *\n * @return signed js/css bundle version by all enabled plugins version.\n */\n Mono generateBundleVersion();\n\n /**\n * Retrieves the JavaScript bundle for all enabled plugins.\n *\n *

This method combines the JavaScript bundles of all enabled plugins into a single bundle\n * and returns a representation of this bundle as a resource.\n * If the JavaScript bundle already exists and is up-to-date, the existing resource is\n * returned; otherwise, a new JavaScript bundle is generated.\n *\n *

Note: This method may perform IO operations and could potentially block, so it should be\n * used in a non-blocking environment.\n *\n * @param version The version of the CSS bundle to retrieve.\n * @return A {@code Mono} object representing the JavaScript bundle. When this\n * {@code Mono} is subscribed to, it emits the JavaScript bundle resource if successful, or\n * an error signal if an error occurs.\n */\n Mono getJsBundle(String version);\n\n /**\n * Retrieves the CSS bundle for all enabled plugins.\n *\n *

This method combines the CSS bundles of all enabled plugins into a single bundle and\n * returns a representation of this bundle as a resource.\n * If the CSS bundle already exists and is up-to-date, the existing resource is returned;\n * otherwise, a new CSS bundle is generated.\n *\n *

Note: This method may perform IO operations and could potentially block, so it should be\n * used in a non-blocking environment.\n *\n * @param version The version of the CSS bundle to retrieve.\n * @return A {@code Mono} object representing the CSS bundle. When this {@code Mono\n * } is subscribed to, it emits the CSS bundle resource if successful, or an error signal if\n * an error occurs.\n */\n Mono getCssBundle(String version);\n\n /**\n * Enables or disables a plugin by name.\n *\n * @param pluginName plugin name\n * @param requestToEnable request to enable or disable\n * @param wait wait for plugin to be enabled or disabled\n * @return updated plugin\n */\n Mono changeState(String pluginName, boolean requestToEnable, boolean wait);\n\n /**\n * Gets required dependencies of the given plugin.\n *\n * @param plugin the plugin to get dependencies from\n * {@link Plugin.PluginSpec#getPluginDependencies()}\n * @param predicate the predicate to filter by {@link PluginWrapper},such as enabled or disabled\n * @return plugin names of required dependencies\n */\n List getRequiredDependencies(Plugin plugin,\n Predicate predicate);\n\n /**\n * Get started plugin names.\n *\n * @return started plugin names\n */\n Flux getStartedPluginNames();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginServiceImpl.java", "content": "package run.halo.app.plugin;\n\nimport static java.nio.file.StandardCopyOption.REPLACE_EXISTING;\nimport static java.nio.file.StandardOpenOption.CREATE;\nimport static java.nio.file.StandardOpenOption.TRUNCATE_EXISTING;\nimport static org.pf4j.PluginState.STARTED;\nimport static run.halo.app.plugin.PluginConst.RELOAD_ANNO;\n\nimport com.github.zafarkhaja.semver.Version;\nimport com.google.common.hash.HashCode;\nimport com.google.common.hash.Hashing;\nimport java.io.IOException;\nimport java.nio.charset.StandardCharsets;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.Comparator;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport java.util.function.Predicate;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.pf4j.DependencyResolver;\nimport org.pf4j.PluginDependency;\nimport org.pf4j.PluginDescriptor;\nimport org.pf4j.PluginWrapper;\nimport org.reactivestreams.Publisher;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.WritableResource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.core.io.buffer.DefaultDataBufferFactory;\nimport org.springframework.core.io.support.PathMatchingResourcePatternResolver;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.exception.PluginAlreadyExistsException;\nimport run.halo.app.infra.exception.PluginDependenciesNotEnabledException;\nimport run.halo.app.infra.exception.PluginDependencyException;\nimport run.halo.app.infra.exception.PluginDependentsNotDisabledException;\nimport run.halo.app.infra.exception.PluginInstallationException;\nimport run.halo.app.infra.exception.UnsatisfiedAttributeValueException;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.infra.utils.VersionUtils;\nimport run.halo.app.plugin.resources.BundleResourceUtils;\n\n@Slf4j\n@Component\npublic class PluginServiceImpl implements PluginService, InitializingBean, DisposableBean {\n\n private static final String PRESET_LOCATION_PREFIX = \"classpath:/presets/plugins/\";\n private static final String PRESETS_LOCATION_PATTERN = PRESET_LOCATION_PREFIX + \"*.jar\";\n\n private final ReactiveExtensionClient client;\n\n private final SystemVersionSupplier systemVersion;\n\n private final PluginsRootGetter pluginsRootGetter;\n\n private final SpringPluginManager pluginManager;\n\n private final BundleCache jsBundleCache;\n\n private final BundleCache cssBundleCache;\n\n private Path tempDir;\n\n private final Scheduler scheduler = Schedulers.boundedElastic();\n\n private Clock clock = Clock.systemUTC();\n\n public PluginServiceImpl(ReactiveExtensionClient client,\n SystemVersionSupplier systemVersion,\n PluginsRootGetter pluginsRootGetter,\n SpringPluginManager pluginManager) {\n this.client = client;\n this.systemVersion = systemVersion;\n this.pluginsRootGetter = pluginsRootGetter;\n this.pluginManager = pluginManager;\n\n this.jsBundleCache = new BundleCache(\".js\");\n this.cssBundleCache = new BundleCache(\".css\");\n }\n\n /**\n * The method is only for testing.\n *\n * @param clock new clock\n */\n void setClock(Clock clock) {\n Assert.notNull(clock, \"Clock must not be null\");\n this.clock = clock;\n }\n\n @Override\n public Mono installPresetPlugins() {\n return getPresetJars()\n .flatMap(path -> this.install(path)\n .onErrorResume(PluginAlreadyExistsException.class, e -> Mono.empty())\n .flatMap(plugin -> FileUtils.deleteFileSilently(path)\n .thenReturn(plugin)\n )\n )\n .flatMap(this::enablePlugin)\n .subscribeOn(Schedulers.boundedElastic())\n .then();\n }\n\n private Mono enablePlugin(Plugin plugin) {\n plugin.getSpec().setEnabled(true);\n return client.update(plugin)\n .onErrorResume(OptimisticLockingFailureException.class,\n e -> enablePlugin(plugin.getMetadata().getName())\n );\n }\n\n private Mono enablePlugin(String name) {\n return Mono.defer(() -> client.get(Plugin.class, name)\n .flatMap(plugin -> {\n plugin.getSpec().setEnabled(true);\n return client.update(plugin);\n })\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n @Override\n public Mono install(Path path) {\n return findPluginManifest(path)\n .doOnNext(plugin -> {\n // validate the plugin version\n satisfiesRequiresVersion(plugin);\n checkDependencies(plugin);\n })\n .flatMap(pluginInPath ->\n client.fetch(Plugin.class, pluginInPath.getMetadata().getName())\n .flatMap(oldPlugin -> Mono.error(\n new PluginAlreadyExistsException(oldPlugin.getMetadata().getName())))\n .switchIfEmpty(Mono.defer(\n () -> copyToPluginHome(pluginInPath)\n .flatMap(this::findPluginManifest)\n .doOnNext(p -> {\n // Disable auto enable after installation\n p.getSpec().setEnabled(false);\n })\n .flatMap(client::create))\n ));\n }\n\n private void checkDependencies(Plugin plugin) {\n var resolvedPlugins = new ArrayList<>(pluginManager.getResolvedPlugins());\n var pluginDescriptors = new ArrayList(resolvedPlugins.size() + 1);\n\n resolvedPlugins.stream()\n .map(PluginWrapper::getDescriptor)\n .forEach(pluginDescriptors::add);\n\n var pluginDescriptor = YamlPluginDescriptorFinder.convert(plugin);\n pluginDescriptors.add(pluginDescriptor);\n\n var deptResolver = new DependencyResolver(pluginManager.getVersionManager());\n var result = deptResolver.resolve(pluginDescriptors);\n if (result.hasCyclicDependency()) {\n throw new PluginDependencyException.CyclicException();\n }\n var notFoundDependencies = result.getNotFoundDependencies();\n if (!CollectionUtils.isEmpty(notFoundDependencies)) {\n throw new PluginDependencyException.NotFoundException(notFoundDependencies);\n }\n\n var wrongVersionDependencies = result.getWrongVersionDependencies();\n if (!CollectionUtils.isEmpty(wrongVersionDependencies)) {\n throw new PluginDependencyException.WrongVersionsException(wrongVersionDependencies);\n }\n }\n\n @Override\n public Mono upgrade(String name, Path path) {\n return findPluginManifest(path)\n .doOnNext(plugin -> {\n satisfiesRequiresVersion(plugin);\n checkDependencies(plugin);\n })\n .flatMap(pluginInPath -> {\n // pre-check the plugin in the path\n Assert.notNull(pluginInPath.statusNonNull().getLoadLocation(),\n \"plugin.status.load-location must not be null\");\n if (!Objects.equals(name, pluginInPath.getMetadata().getName())) {\n return Mono.error(new ServerWebInputException(\n \"The provided plugin \" + pluginInPath.getMetadata().getName()\n + \" didn't match the given plugin \" + name));\n }\n\n // check if the plugin exists\n return client.fetch(Plugin.class, name)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"The given plugin with name \" + name + \" was not found.\")))\n // copy plugin into plugin home\n .flatMap(oldPlugin -> copyToPluginHome(pluginInPath).thenReturn(oldPlugin))\n .doOnNext(oldPlugin -> updatePlugin(oldPlugin, pluginInPath))\n .flatMap(client::update);\n });\n }\n\n @Override\n public Mono reload(String name) {\n return client.get(Plugin.class, name)\n .flatMap(oldPlugin -> {\n if (oldPlugin.getStatus() == null\n || oldPlugin.getStatus().getLoadLocation() == null) {\n return Mono.error(new IllegalStateException(\n \"Load location of plugin has not been populated.\"));\n }\n var loadLocation = oldPlugin.getStatus().getLoadLocation();\n var loadPath = Path.of(loadLocation);\n return findPluginManifest(loadPath)\n .doOnNext(newPlugin -> updatePlugin(oldPlugin, newPlugin))\n .thenReturn(oldPlugin);\n })\n .flatMap(client::update);\n }\n\n @Override\n public Flux uglifyJsBundle() {\n var startedPlugins = pluginManager.startedPlugins();\n var dataBufferFactory = DefaultDataBufferFactory.sharedInstance;\n var end = Mono.fromSupplier(\n () -> {\n var sb = new StringBuilder(\"this.enabledPlugins = [\");\n var iterator = startedPlugins.iterator();\n while (iterator.hasNext()) {\n var plugin = iterator.next();\n sb.append(\"\"\"\n {\"name\":\"%s\",\"version\":\"%s\"}\\\n \"\"\"\n .formatted(\n plugin.getPluginId(),\n plugin.getDescriptor().getVersion()\n )\n );\n if (iterator.hasNext()) {\n sb.append(',');\n }\n }\n sb.append(']');\n return dataBufferFactory.wrap(sb.toString().getBytes(StandardCharsets.UTF_8));\n });\n var body = Flux.fromIterable(startedPlugins)\n .sort(Comparator.comparing(PluginWrapper::getPluginId))\n .flatMapSequential(pluginWrapper -> {\n var pluginId = pluginWrapper.getPluginId();\n return getBundleResource(pluginId, BundleResourceUtils.JS_BUNDLE)\n .flatMapMany(resource -> {\n var head = Mono.fromSupplier(\n () -> dataBufferFactory.wrap(\n (\"// Generated from plugin \" + pluginId + \"\\n\").getBytes()\n ));\n var content = DataBufferUtils.read(\n resource, dataBufferFactory, StreamUtils.BUFFER_SIZE\n );\n var tail = Mono.fromSupplier(() -> dataBufferFactory.wrap(\"\\n\".getBytes()));\n return Flux.concat(head, content, tail);\n });\n });\n return Flux.concat(body, end);\n }\n\n @Override\n public Flux uglifyCssBundle() {\n return Flux.fromIterable(pluginManager.startedPlugins())\n .sort(Comparator.comparing(PluginWrapper::getPluginId))\n .flatMapSequential(pluginWrapper -> {\n var pluginId = pluginWrapper.getPluginId();\n var dataBufferFactory = DefaultDataBufferFactory.sharedInstance;\n return getBundleResource(pluginId, BundleResourceUtils.CSS_BUNDLE)\n .flatMapMany(resource -> {\n var head = Mono.fromSupplier(() -> dataBufferFactory.wrap(\n (\"/* Generated from plugin \" + pluginId + \" */\\n\").getBytes()\n ));\n var content = DataBufferUtils.read(\n resource, dataBufferFactory, StreamUtils.BUFFER_SIZE);\n var tail = Mono.fromSupplier(() -> dataBufferFactory.wrap(\"\\n\".getBytes()));\n return Flux.concat(head, content, tail);\n });\n });\n }\n\n private Mono getBundleResource(String pluginName, String bundleName) {\n return Mono.fromSupplier(\n () -> BundleResourceUtils.getJsBundleResource(pluginManager, pluginName, bundleName)\n )\n .filter(Resource::isReadable);\n }\n\n @Override\n public Mono generateBundleVersion() {\n if (pluginManager.isDevelopment()) {\n return Mono.just(String.valueOf(clock.instant().toEpochMilli()));\n }\n return Flux.fromIterable(pluginManager.startedPlugins())\n .sort(Comparator.comparing(PluginWrapper::getPluginId))\n .map(pw -> pw.getPluginId() + ':' + pw.getDescriptor().getVersion())\n .collect(Collectors.joining())\n .map(Hashing.sha256()::hashUnencodedChars)\n .map(HashCode::toString);\n }\n\n @Override\n public Mono getJsBundle(String version) {\n return jsBundleCache.computeIfAbsent(version, this.uglifyJsBundle());\n }\n\n @Override\n public Mono getCssBundle(String version) {\n return cssBundleCache.computeIfAbsent(version, this.uglifyCssBundle());\n }\n\n @Override\n public Mono changeState(String pluginName, boolean requestToEnable, boolean wait) {\n var updatedPlugin = Mono.defer(() -> client.get(Plugin.class, pluginName))\n .flatMap(plugin -> {\n if (!Objects.equals(requestToEnable, plugin.getSpec().getEnabled())) {\n // preflight check\n if (requestToEnable) {\n // make sure the dependencies are enabled\n var notStartedDependencies = getRequiredDependencies(plugin,\n pw -> pw == null || !Objects.equals(STARTED, pw.getPluginState())\n );\n if (!CollectionUtils.isEmpty(notStartedDependencies)) {\n return Mono.error(\n new PluginDependenciesNotEnabledException(notStartedDependencies)\n );\n }\n } else {\n // make sure the dependents are disabled\n var dependents = pluginManager.getDependents(pluginName);\n var notDisabledDependents = dependents.stream()\n .filter(\n dependent -> Objects.equals(STARTED, dependent.getPluginState())\n )\n .map(PluginWrapper::getPluginId)\n .toList();\n if (!CollectionUtils.isEmpty(notDisabledDependents)) {\n return Mono.error(\n new PluginDependentsNotDisabledException(notDisabledDependents)\n );\n }\n }\n\n plugin.getSpec().setEnabled(requestToEnable);\n log.debug(\"Updating plugin {} state to {}\", pluginName, requestToEnable);\n return client.update(plugin);\n }\n log.debug(\"Checking plugin {} state, no need to update\", pluginName);\n return Mono.just(plugin);\n });\n\n if (wait) {\n // if we want to wait the state of plugin to be updated\n updatedPlugin = updatedPlugin\n .flatMap(plugin -> {\n var phase = plugin.statusNonNull().getPhase();\n if (requestToEnable) {\n // if we request to enable the plugin\n if (!(Plugin.Phase.STARTED.equals(phase)\n || Plugin.Phase.FAILED.equals(phase))) {\n return Mono.error(UnexpectedPluginStateException::new);\n }\n } else {\n // if we request to disable the plugin\n if (Plugin.Phase.STARTED.equals(phase)) {\n return Mono.error(UnexpectedPluginStateException::new);\n }\n }\n return Mono.just(plugin);\n })\n .retryWhen(\n Retry.backoff(10, Duration.ofMillis(100))\n .filter(UnexpectedPluginStateException.class::isInstance)\n .doBeforeRetry(signal ->\n log.debug(\"Waiting for plugin {} to meet expected state\", pluginName)\n )\n )\n .doOnSuccess(plugin -> {\n log.info(\"Plugin {} met expected state {}\",\n pluginName, plugin.statusNonNull().getPhase());\n });\n }\n\n return updatedPlugin;\n }\n\n @Override\n public List getRequiredDependencies(Plugin plugin,\n Predicate predicate) {\n return getPluginDependency(plugin)\n .stream()\n .filter(dependency -> !dependency.isOptional())\n .map(PluginDependency::getPluginId)\n .filter(dependencyPlugin -> {\n var pluginWrapper = pluginManager.getPlugin(dependencyPlugin);\n return predicate.test(pluginWrapper);\n })\n .sorted()\n .toList();\n }\n\n @Override\n public Flux getStartedPluginNames() {\n return Flux.fromIterable(pluginManager.startedPlugins())\n .map(PluginWrapper::getPluginId);\n }\n\n private static List getPluginDependency(Plugin plugin) {\n return plugin.getSpec().getPluginDependencies().keySet()\n .stream()\n .map(PluginDependency::new)\n .toList();\n }\n\n Mono findPluginManifest(Path path) {\n return Mono.fromSupplier(\n () -> {\n final var pluginFinder = new YamlPluginFinder();\n return pluginFinder.find(path);\n })\n .onErrorMap(e -> new PluginInstallationException(\"Failed to parse the plugin manifest\",\n \"problemDetail.plugin.missingManifest\", null)\n );\n }\n\n\n @Override\n public void afterPropertiesSet() throws Exception {\n this.tempDir = Files.createTempDirectory(\"halo-plugin-bundle\");\n }\n\n @Override\n public void destroy() throws Exception {\n FileSystemUtils.deleteRecursively(this.tempDir);\n }\n\n /**\n * Set temporary directory for plugin bundle.\n *\n * @param tempDir temporary directory.\n */\n void setTempDir(Path tempDir) {\n this.tempDir = tempDir;\n }\n\n /**\n * Copy plugin into plugin home.\n *\n * @param plugin is a staging plugin.\n * @return new path in plugin home.\n */\n private Mono copyToPluginHome(Plugin plugin) {\n return Mono.fromCallable(\n () -> {\n var fileName = PluginUtils.generateFileName(plugin);\n var pluginRoot = pluginsRootGetter.get();\n try {\n Files.createDirectories(pluginRoot);\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n }\n var pluginFilePath = pluginRoot.resolve(fileName);\n FileUtils.checkDirectoryTraversal(pluginRoot, pluginFilePath);\n // move the plugin jar file to the plugin root\n // replace the old plugin jar file if exists\n var path = Path.of(plugin.getStatus().getLoadLocation());\n FileUtils.copy(path, pluginFilePath, REPLACE_EXISTING);\n return pluginFilePath;\n })\n .subscribeOn(Schedulers.boundedElastic())\n .doOnNext(loadLocation -> {\n // reset load location and annotation PLUGIN_PATH\n plugin.getStatus().setLoadLocation(loadLocation.toUri());\n var annotations = plugin.getMetadata().getAnnotations();\n if (annotations == null) {\n annotations = new HashMap<>();\n plugin.getMetadata().setAnnotations(annotations);\n }\n annotations.put(PluginConst.PLUGIN_PATH, loadLocation.toString());\n });\n }\n\n private void satisfiesRequiresVersion(Plugin newPlugin) {\n Assert.notNull(newPlugin, \"The plugin must not be null.\");\n Version version = systemVersion.get();\n // validate the plugin version\n // only use the nominal system version to compare, the format is like MAJOR.MINOR.PATCH\n String systemVersion = version.toStableVersion().toString();\n String requires = newPlugin.getSpec().getRequires();\n if (!VersionUtils.satisfiesRequires(systemVersion, requires)) {\n throw new UnsatisfiedAttributeValueException(String.format(\n \"Plugin requires a minimum system version of [%s], but the current version is \"\n + \"[%s].\",\n requires, systemVersion),\n \"problemDetail.plugin.version.unsatisfied.requires\",\n new String[] {requires, systemVersion});\n }\n }\n\n private Flux getPresetJars() {\n var resolver = new PathMatchingResourcePatternResolver();\n try {\n var resources = resolver.getResources(PRESETS_LOCATION_PATTERN);\n return Flux.fromArray(resources)\n .mapNotNull(resource -> {\n var filename = resource.getFilename();\n if (StringUtils.isBlank(filename)) {\n return null;\n }\n var path = tempDir.resolve(filename);\n FileUtils.copyResource(resource, path);\n return path;\n });\n } catch (IOException e) {\n log.debug(\"Failed to load preset plugins: {}\", e.getMessage());\n return Flux.empty();\n }\n }\n\n private static void updatePlugin(Plugin oldPlugin, Plugin newPlugin) {\n var oldMetadata = oldPlugin.getMetadata();\n var newMetadata = newPlugin.getMetadata();\n // merge labels\n if (!CollectionUtils.isEmpty(newMetadata.getLabels())) {\n var labels = oldMetadata.getLabels();\n if (labels == null) {\n labels = new HashMap<>();\n oldMetadata.setLabels(labels);\n }\n labels.putAll(newMetadata.getLabels());\n }\n\n var annotations = oldMetadata.getAnnotations();\n if (annotations == null) {\n annotations = new HashMap<>();\n oldMetadata.setAnnotations(annotations);\n }\n\n // merge annotations\n if (!CollectionUtils.isEmpty(newMetadata.getAnnotations())) {\n annotations.putAll(newMetadata.getAnnotations());\n }\n\n // request to reload\n annotations.put(RELOAD_ANNO,\n newPlugin.getStatus().getLoadLocation().toString());\n\n // apply spec and keep enabled request\n var enabled = oldPlugin.getSpec().getEnabled();\n oldPlugin.setSpec(newPlugin.getSpec());\n oldPlugin.getSpec().setEnabled(enabled);\n }\n\n class BundleCache {\n\n private final String suffix;\n\n private final AtomicBoolean writing = new AtomicBoolean();\n\n private volatile Resource resource;\n\n BundleCache(String suffix) {\n this.suffix = suffix;\n }\n\n Mono computeIfAbsent(String version, Publisher content) {\n var filename = buildBundleFilename(version, suffix);\n if (isResourceMatch(resource, filename)) {\n return Mono.just(resource);\n }\n return generateBundleVersion()\n .flatMap(newVersion -> {\n var newFilename = buildBundleFilename(newVersion, suffix);\n if (isResourceMatch(this.resource, newFilename)) {\n // if the resource was not changed, just return it\n return Mono.just(resource);\n }\n if (writing.compareAndSet(false, true)) {\n return Mono.justOrEmpty(this.resource)\n // double check of the resource\n .filter(res -> isResourceMatch(res, newFilename))\n .switchIfEmpty(Mono.using(\n () -> {\n if (!Files.exists(tempDir)) {\n Files.createDirectories(tempDir);\n }\n return tempDir.resolve(newFilename);\n },\n path -> DataBufferUtils.write(content, path,\n CREATE, TRUNCATE_EXISTING)\n .then(Mono.fromSupplier(\n () -> new FileSystemResource(path)\n )),\n path -> {\n if (shouldCleanUp(path)) {\n // clean up old resource\n cleanUp(this.resource);\n }\n })\n .subscribeOn(scheduler)\n .doOnNext(newResource -> this.resource = newResource)\n )\n .doFinally(signalType -> writing.set(false));\n } else {\n return Mono.defer(() -> {\n if (this.writing.get()) {\n log.debug(\"Waiting for the bundle file {} to be written\", filename);\n return Mono.empty();\n }\n log.debug(\"Waited the bundle file {} to be written\", filename);\n return Mono.just(this.resource);\n }).repeatWhenEmpty(100, count -> {\n // retry after 100ms\n return count.delayElements(Duration.ofMillis(100));\n });\n }\n });\n }\n\n private boolean shouldCleanUp(Path newPath) {\n if (this.resource == null || !this.resource.exists()) {\n return false;\n }\n try {\n var oldPath = this.resource.getFile().toPath();\n return !oldPath.equals(newPath);\n } catch (IOException e) {\n return false;\n }\n }\n\n private static void cleanUp(Resource resource) {\n if (resource instanceof WritableResource wr\n && wr.isWritable()\n && wr.isFile()) {\n try {\n Files.deleteIfExists(wr.getFile().toPath());\n } catch (IOException e) {\n log.warn(\"Failed to delete old bundle file {}\",\n wr.getFilename(), e);\n }\n }\n }\n\n private static boolean isResourceMatch(Resource resource, String filename) {\n return resource != null\n && resource.exists()\n && resource.isFile()\n && Objects.equals(filename, resource.getFilename());\n }\n }\n\n private static String buildBundleFilename(String v, String suffix) {\n Assert.notNull(v, \"Version must not be null\");\n Assert.notNull(suffix, \"Suffix must not be null\");\n return v + suffix;\n }\n\n private static class UnexpectedPluginStateException extends RuntimeException {\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginSharedEventDelegator.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Objects;\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.lang.NonNull;\n\n/**\n * The event that delegates to another shared event published by a plugin.\n *\n * @author johnniang\n * @since 2.17\n */\n@Getter\nclass PluginSharedEventDelegator extends ApplicationEvent {\n\n /**\n * The delegate event.\n */\n private final ApplicationEvent delegate;\n\n public PluginSharedEventDelegator(@NonNull Object source, @NonNull ApplicationEvent delegate) {\n super(source);\n this.delegate = delegate;\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n\n PluginSharedEventDelegator that = (PluginSharedEventDelegator) o;\n return Objects.equals(delegate, that.delegate);\n }\n\n @Override\n public int hashCode() {\n return Objects.hashCode(delegate);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginStartedListener.java", "content": "package run.halo.app.plugin;\n\nimport static run.halo.app.plugin.PluginConst.PLUGIN_NAME_LABEL_NAME;\nimport static run.halo.app.plugin.PluginExtensionLoaderUtils.isSetting;\nimport static run.halo.app.plugin.PluginExtensionLoaderUtils.lookupExtensions;\n\nimport java.time.Duration;\nimport java.util.HashMap;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\nimport run.halo.app.plugin.event.HaloPluginStartedEvent;\n\n/**\n * TODO Optimized Unstructured loading.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\nclass PluginStartedListener {\n\n private static final Duration TIMEOUT = Duration.ofMinutes(1);\n\n private final ReactiveExtensionClient client;\n\n public PluginStartedListener(ReactiveExtensionClient extensionClient) {\n this.client = extensionClient;\n }\n\n private Mono createOrUpdate(Unstructured unstructured) {\n var name = unstructured.getMetadata().getName();\n return client.fetch(unstructured.groupVersionKind(), name)\n .doOnNext(old -> unstructured.getMetadata().setVersion(old.getMetadata().getVersion()))\n .map(ignored -> unstructured)\n .flatMap(extension -> {\n if (ExtensionUtil.hasDoNotOverwriteLabel(extension)) {\n log.debug(\"Skip updating extension {} due to do-not-overwrite label\",\n extension.getMetadata().getName());\n return Mono.just(extension);\n }\n return client.update(extension);\n })\n .switchIfEmpty(Mono.defer(() -> client.create(unstructured)));\n }\n\n @EventListener\n void onApplicationEvent(HaloPluginStartedEvent event) {\n var pluginWrapper = event.getPlugin();\n var p = pluginWrapper.getPlugin();\n if (!(p instanceof SpringPlugin springPlugin)) {\n return;\n }\n var applicationContext = springPlugin.getApplicationContext();\n if (!(applicationContext instanceof PluginApplicationContext pluginApplicationContext)) {\n return;\n }\n var pluginName = pluginWrapper.getPluginId();\n\n client.get(Plugin.class, pluginName)\n .flatMap(plugin -> Flux.fromStream(\n () -> {\n log.debug(\"Collecting extensions for plugin {}\", pluginName);\n var resources = lookupExtensions(pluginWrapper.getPluginClassLoader());\n var loader = new YamlUnstructuredLoader(resources);\n var settingName = plugin.getSpec().getSettingName();\n // TODO The load method may be over memory consumption.\n return loader.load()\n .stream()\n .filter(isSetting(settingName).negate());\n })\n .doOnNext(unstructured -> {\n var name = unstructured.getMetadata().getName();\n pluginApplicationContext\n .addExtensionMapping(unstructured.groupVersionKind(), name);\n var labels = unstructured.getMetadata().getLabels();\n if (labels == null) {\n labels = new HashMap<>();\n unstructured.getMetadata().setLabels(labels);\n }\n labels.put(PLUGIN_NAME_LABEL_NAME, plugin.getMetadata().getName());\n })\n .flatMap(this::createOrUpdate)\n .then()\n )\n .block(TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginUtils.java", "content": "package run.halo.app.plugin;\n\nimport java.util.Objects;\nimport lombok.experimental.UtilityClass;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebInputException;\nimport run.halo.app.core.extension.Plugin;\n\n@UtilityClass\npublic class PluginUtils {\n\n public static String generateFileName(Plugin plugin) {\n Assert.notNull(plugin, \"The plugin must not be null.\");\n Assert.notNull(plugin.getMetadata(), \"The plugin metadata must not be null.\");\n Assert.notNull(plugin.getSpec(), \"The plugin spec must not be null.\");\n String version = plugin.getSpec().getVersion();\n if (StringUtils.isBlank(version)) {\n throw new ServerWebInputException(\"The plugin version must not be blank.\");\n }\n return String.format(\"%s-%s.jar\", plugin.getMetadata().getName(), version);\n }\n\n /**\n * Determine if the plugin is in development mode. Currently, we detect it from annotations.\n *\n * @param plugin is a manifest about plugin.\n * @return true if the plugin is in development mode; false otherwise.\n */\n public static boolean isDevelopmentMode(Plugin plugin) {\n var annotations = plugin.getMetadata().getAnnotations();\n return annotations != null\n && Objects.equals(\"dev\", annotations.get(PluginConst.RUNTIME_MODE_ANNO));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PluginsRootGetterImpl.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Path;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.infra.properties.HaloProperties;\n\n/**\n * Default implementation of {@link PluginsRootGetter}.\n *\n * @author johnniang\n */\n@Component\npublic class PluginsRootGetterImpl implements PluginsRootGetter {\n\n private final HaloProperties haloProperties;\n\n public PluginsRootGetterImpl(HaloProperties haloProperties) {\n this.haloProperties = haloProperties;\n }\n\n @Override\n @NonNull\n public Path get() {\n return haloProperties.getWorkDir().resolve(\"plugins\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/PropertyPluginStatusProvider.java", "content": "package run.halo.app.plugin;\n\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.List;\nimport org.pf4j.PluginStatusProvider;\nimport org.thymeleaf.util.ArrayUtils;\n\n/**\n * An implementation for PluginStatusProvider. The enabled plugins are read\n * from {@code halo.plugin.enabled-plugins} properties in application.yaml\n * and the disabled plugins are read from {@code halo.plugin.disabled-plugins}\n * in application.yaml.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class PropertyPluginStatusProvider implements PluginStatusProvider {\n\n private final List enabledPlugins;\n private final List disabledPlugins;\n\n public PropertyPluginStatusProvider(PluginProperties pluginProperties) {\n this.enabledPlugins = pluginProperties.getEnabledPlugins() != null\n ? Arrays.asList(pluginProperties.getEnabledPlugins()) : new ArrayList<>();\n this.disabledPlugins = pluginProperties.getDisabledPlugins() != null\n ? Arrays.asList(pluginProperties.getDisabledPlugins()) : new ArrayList<>();\n }\n\n public static boolean isPropertySet(PluginProperties pluginProperties) {\n return !ArrayUtils.isEmpty(pluginProperties.getEnabledPlugins())\n && !ArrayUtils.isEmpty(pluginProperties.getDisabledPlugins());\n }\n\n @Override\n public boolean isPluginDisabled(String pluginId) {\n if (disabledPlugins.contains(pluginId)) {\n return true;\n }\n return !enabledPlugins.isEmpty() && !enabledPlugins.contains(pluginId);\n }\n\n @Override\n public void disablePlugin(String pluginId) {\n if (isPluginDisabled(pluginId)) {\n return;\n }\n disabledPlugins.add(pluginId);\n enabledPlugins.remove(pluginId);\n }\n\n @Override\n public void enablePlugin(String pluginId) {\n if (!isPluginDisabled(pluginId)) {\n return;\n }\n enabledPlugins.add(pluginId);\n disabledPlugins.remove(pluginId);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SharedApplicationContextFactory.java", "content": "package run.halo.app.plugin;\n\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport org.springframework.cache.CacheManager;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.support.GenericApplicationContext;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport run.halo.app.content.PostContentService;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.DefaultSchemeManager;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.BackupRootGetter;\nimport run.halo.app.infra.ExternalLinkProcessor;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemInfoGetter;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.notification.NotificationReasonEmitter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.security.LoginHandlerEnhancer;\nimport run.halo.app.security.authentication.CryptoService;\n\n/**\n * Utility for creating shared application context.\n *\n * @author guqing\n * @author johnniang\n * @since 2.12.0\n */\npublic enum SharedApplicationContextFactory {\n ;\n\n public static ApplicationContext create(ApplicationContext rootContext) {\n // TODO Optimize creation timing\n var sharedContext = new GenericApplicationContext();\n sharedContext.registerShutdownHook();\n\n var beanFactory = sharedContext.getBeanFactory();\n\n // register shared object here\n var extensionClient = rootContext.getBean(ExtensionClient.class);\n var reactiveExtensionClient = rootContext.getBean(ReactiveExtensionClient.class);\n beanFactory.registerSingleton(\"extensionClient\", extensionClient);\n beanFactory.registerSingleton(\"reactiveExtensionClient\", reactiveExtensionClient);\n\n DefaultSchemeManager defaultSchemeManager =\n rootContext.getBean(DefaultSchemeManager.class);\n beanFactory.registerSingleton(\"schemeManager\", defaultSchemeManager);\n beanFactory.registerSingleton(\"externalUrlSupplier\",\n rootContext.getBean(ExternalUrlSupplier.class));\n beanFactory.registerSingleton(\"serverSecurityContextRepository\",\n rootContext.getBean(ServerSecurityContextRepository.class));\n beanFactory.registerSingleton(\"attachmentService\",\n rootContext.getBean(AttachmentService.class));\n beanFactory.registerSingleton(\"backupRootGetter\",\n rootContext.getBean(BackupRootGetter.class));\n beanFactory.registerSingleton(\"notificationReasonEmitter\",\n rootContext.getBean(NotificationReasonEmitter.class));\n beanFactory.registerSingleton(\"notificationCenter\",\n rootContext.getBean(NotificationCenter.class));\n beanFactory.registerSingleton(\"externalLinkProcessor\",\n rootContext.getBean(ExternalLinkProcessor.class));\n beanFactory.registerSingleton(\"postContentService\",\n rootContext.getBean(PostContentService.class));\n beanFactory.registerSingleton(\"cacheManager\",\n rootContext.getBean(CacheManager.class));\n beanFactory.registerSingleton(\"loginHandlerEnhancer\",\n rootContext.getBean(LoginHandlerEnhancer.class));\n rootContext.getBeanProvider(PluginsRootGetter.class)\n .ifUnique(pluginsRootGetter ->\n beanFactory.registerSingleton(\"pluginsRootGetter\", pluginsRootGetter)\n );\n beanFactory.registerSingleton(\"extensionGetter\",\n rootContext.getBean(ExtensionGetter.class));\n rootContext.getBeanProvider(CryptoService.class)\n .ifUnique(\n cryptoService -> beanFactory.registerSingleton(\"cryptoService\", cryptoService)\n );\n rootContext.getBeanProvider(RateLimiterRegistry.class)\n .ifUnique(rateLimiterRegistry ->\n beanFactory.registerSingleton(\"rateLimiterRegistry\", rateLimiterRegistry)\n );\n\n // Authentication plugins may need this RequestCache to handle successful login redirect\n rootContext.getBeanProvider(ServerRequestCache.class)\n .ifUnique(serverRequestCache ->\n beanFactory.registerSingleton(\"serverRequestCache\", serverRequestCache)\n );\n rootContext.getBeanProvider(UserService.class)\n .ifUnique(userService -> beanFactory.registerSingleton(\"userService\", userService));\n rootContext.getBeanProvider(RoleService.class)\n .ifUnique(roleService -> beanFactory.registerSingleton(\"roleService\", roleService));\n rootContext.getBeanProvider(ReactiveUserDetailsService.class)\n .ifUnique(userDetailsService ->\n beanFactory.registerSingleton(\"userDetailsService\", userDetailsService)\n );\n rootContext.getBeanProvider(SystemInfoGetter.class)\n .ifUnique(systemInfoGetter ->\n beanFactory.registerSingleton(\"systemInfoGetter\", systemInfoGetter)\n );\n // TODO add more shared instance here\n\n sharedContext.refresh();\n return sharedContext;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SharedEventDispatcher.java", "content": "package run.halo.app.plugin;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.context.Lifecycle;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.core.annotation.AnnotationUtils;\nimport org.springframework.stereotype.Component;\n\n@Component\n@RequiredArgsConstructor\npublic class SharedEventDispatcher {\n\n private final SpringPluginManager pluginManager;\n\n private final ApplicationEventPublisher publisher;\n\n @EventListener(ApplicationEvent.class)\n void onApplicationEvent(ApplicationEvent event) {\n if (AnnotationUtils.findAnnotation(event.getClass(), SharedEvent.class) == null) {\n return;\n }\n // we should copy the plugins list to avoid ConcurrentModificationException\n var startedPlugins = pluginManager.startedPlugins();\n // broadcast event to all started plugins except the publisher\n for (var startedPlugin : startedPlugins) {\n var plugin = startedPlugin.getPlugin();\n if (!(plugin instanceof SpringPlugin springPlugin)) {\n continue;\n }\n var context = springPlugin.getApplicationContext();\n // make sure the context is running before publishing the event\n if (context instanceof Lifecycle lifecycle && lifecycle.isRunning()) {\n context.publishEvent(new HaloSharedEventDelegator(this, event));\n }\n }\n }\n\n @EventListener(PluginSharedEventDelegator.class)\n void onApplicationEvent(PluginSharedEventDelegator event) {\n publisher.publishEvent(event.getDelegate());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SpringComponentsFinder.java", "content": "package run.halo.app.plugin;\n\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.io.InputStreamReader;\nimport java.io.Reader;\nimport java.nio.charset.StandardCharsets;\nimport java.util.HashSet;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.AbstractExtensionFinder;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginStateEvent;\nimport org.pf4j.PluginWrapper;\nimport org.pf4j.processor.ExtensionStorage;\n\n/**\n *

The spring component finder. it will read {@code META-INF/plugin-components.idx} file in\n * plugin to obtain the class name that needs to be registered in the plugin IOC.

\n *

Reading index files directly is much faster than dynamically scanning class components when\n * the plugin is enabled.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\npublic class SpringComponentsFinder extends AbstractExtensionFinder {\n public static final String EXTENSIONS_RESOURCE = \"META-INF/plugin-components.idx\";\n\n public SpringComponentsFinder(PluginManager pluginManager) {\n super(pluginManager);\n entries = new ConcurrentHashMap<>();\n }\n\n @Override\n public Map> readClasspathStorages() {\n throw new UnsupportedOperationException();\n }\n\n @Override\n public Map> readPluginsStorages() {\n throw new UnsupportedOperationException();\n }\n\n private Set readPluginStorage(PluginWrapper pluginWrapper) {\n var pluginId = pluginWrapper.getPluginId();\n log.debug(\"Reading extensions storage from plugin '{}'\", pluginId);\n var bucket = new HashSet();\n try {\n log.debug(\"Read '{}'\", EXTENSIONS_RESOURCE);\n var classLoader = pluginWrapper.getPluginClassLoader();\n try (var resourceStream = classLoader.getResourceAsStream(EXTENSIONS_RESOURCE)) {\n if (resourceStream == null) {\n log.debug(\"Cannot find '{}'\", EXTENSIONS_RESOURCE);\n } else {\n collectExtensions(resourceStream, bucket);\n }\n }\n debugExtensions(bucket);\n } catch (IOException e) {\n log.error(\"Failed to read components from \" + EXTENSIONS_RESOURCE, e);\n }\n return bucket;\n }\n\n private void collectExtensions(InputStream inputStream, Set bucket) throws IOException {\n try (Reader reader = new InputStreamReader(inputStream, StandardCharsets.UTF_8)) {\n ExtensionStorage.read(reader, bucket);\n }\n }\n\n @Override\n public void pluginStateChanged(PluginStateEvent event) {\n var pluginState = event.getPluginState();\n String pluginId = event.getPlugin().getPluginId();\n if (pluginState == PluginState.UNLOADED) {\n entries.remove(pluginId);\n } else if (pluginState == PluginState.CREATED || pluginState == PluginState.RESOLVED) {\n entries.computeIfAbsent(pluginId, id -> readPluginStorage(event.getPlugin()));\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SpringExtensionFactory.java", "content": "package run.halo.app.plugin;\n\nimport java.lang.reflect.Constructor;\nimport java.lang.reflect.InvocationTargetException;\nimport java.util.Comparator;\nimport java.util.Optional;\nimport java.util.stream.Stream;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.Extension;\nimport org.pf4j.ExtensionFactory;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.beans.factory.config.AutowireCapableBeanFactory;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.lang.Nullable;\n\n/**\n *

Basic implementation of an extension factory.

\n *

Uses Springs {@link AutowireCapableBeanFactory} to instantiate a given extension class.

\n *

All kinds of {@link Autowired} are supported (see example below). If no\n * {@link ApplicationContext} is\n * available (this is the case if either the related plugin is not a {@link BasePlugin} or the\n * given plugin manager is not a {@link HaloPluginManager}), standard Java reflection will be used\n * to instantiate an extension.

\n *

Creates a new extension instance every time a request is done.

\n * Example of supported autowire modes:\n * 
{@code\n *     @Extension\n *     public class Foo implements ExtensionPoint {\n *\n *         private final Bar bar;       // Constructor injection\n *         private Baz baz;             // Setter injection\n *         @Autowired\n *         private Qux qux;             // Field injection\n *\n *         @Autowired\n *         public Foo(final Bar bar) {\n *             this.bar = bar;\n *         }\n *\n *         @Autowired\n *         public void setBaz(final Baz baz) {\n *             this.baz = baz;\n *         }\n *     }\n * }
\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@RequiredArgsConstructor\npublic class SpringExtensionFactory implements ExtensionFactory {\n\n /**\n * The plugin manager is used for retrieving a plugin from a given extension class and as a\n * fallback supplier of an application context.\n */\n protected final PluginManager pluginManager;\n\n @Override\n @Nullable\n public T create(Class extensionClass) {\n return getPluginApplicationContextBy(extensionClass)\n .map(context -> context.getBean(extensionClass))\n .orElseGet(() -> createWithoutSpring(extensionClass));\n }\n\n /**\n * Creates an instance of the given class object by using standard Java reflection.\n *\n * @param extensionClass The class annotated with {@code @}{@link Extension}.\n * @param The type for that an instance should be created.\n * @return an instantiated extension.\n * @throws IllegalArgumentException if the given class object has no public constructor.\n * @throws RuntimeException if the called constructor cannot be instantiated with {@code\n * null}-parameters.\n */\n @SuppressWarnings(\"unchecked\")\n protected T createWithoutSpring(final Class extensionClass)\n throws IllegalArgumentException {\n final Constructor constructor =\n getPublicConstructorWithShortestParameterList(extensionClass)\n // An extension class is required to have at least one public constructor.\n .orElseThrow(\n () -> new IllegalArgumentException(\"Extension class '\" + nameOf(extensionClass)\n + \"' must have at least one public constructor.\"));\n try {\n if (log.isTraceEnabled()) {\n log.trace(\"Instantiate '\" + nameOf(extensionClass) + \"' by calling '\" + constructor\n + \"'with standard Java reflection.\");\n }\n // Creating the instance by calling the constructor with null-parameters (if there\n // are any).\n return (T) constructor.newInstance(nullParameters(constructor));\n } catch (InstantiationException | IllegalAccessException | InvocationTargetException ex) {\n // If one of these exceptions is thrown it it most likely because of NPE inside the\n // called constructor and\n // not the reflective call itself as we precisely searched for a fitting constructor.\n log.error(ex.getMessage(), ex);\n throw new RuntimeException(\n \"Most likely this exception is thrown because the called constructor (\"\n + constructor + \")\"\n + \" cannot handle 'null' parameters. Original message was: \"\n + ex.getMessage(), ex);\n }\n }\n\n private Optional> getPublicConstructorWithShortestParameterList(\n final Class extensionClass) {\n return Stream.of(extensionClass.getConstructors())\n .min(Comparator.comparing(Constructor::getParameterCount));\n }\n\n private Object[] nullParameters(final Constructor constructor) {\n return new Object[constructor.getParameterCount()];\n }\n\n protected Optional getPluginApplicationContextBy(\n final Class extensionClass) {\n return Optional.ofNullable(this.pluginManager.whichPlugin(extensionClass))\n .map(PluginWrapper::getPlugin)\n .filter(SpringPlugin.class::isInstance)\n .map(plugin -> (SpringPlugin) plugin)\n .map(SpringPlugin::getApplicationContext);\n }\n\n private String nameOf(final Class clazz) {\n return clazz.getName();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SpringPlugin.java", "content": "package run.halo.app.plugin;\n\nimport org.jspecify.annotations.NonNull;\nimport org.springframework.context.ApplicationContext;\n\n/**\n * Spring based plugin.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic interface SpringPlugin {\n\n /**\n * Gets plugin context.\n *\n * @return plugin context\n */\n @NonNull\n PluginContext getPluginContext();\n\n /**\n * Gets application context of the plugin.\n *\n * @return application context of the plugin\n * @throws IllegalStateException if the application context is not ready yet\n */\n @NonNull\n ApplicationContext getApplicationContext();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SpringPluginFactory.java", "content": "package run.halo.app.plugin;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.Plugin;\nimport org.pf4j.PluginFactory;\nimport org.pf4j.PluginWrapper;\n\n/**\n * The default implementation for PluginFactory.\n *

Get a {@link BasePlugin} instance from the {@link PluginApplicationContext}.

\n *\n * @author guqing\n * @author johnniang\n * @since 2.0.0\n */\n@Slf4j\npublic class SpringPluginFactory implements PluginFactory {\n\n private final PluginApplicationContextFactory contextFactory;\n private final PluginGetter pluginGetter;\n\n public SpringPluginFactory(PluginApplicationContextFactory contextFactory,\n PluginGetter pluginGetter) {\n this.contextFactory = contextFactory;\n this.pluginGetter = pluginGetter;\n }\n\n @Override\n public Plugin create(PluginWrapper pluginWrapper) {\n var plugin = pluginGetter.getPlugin(pluginWrapper.getPluginId());\n var pluginContext = PluginContext.builder()\n .name(pluginWrapper.getPluginId())\n .configMapName(plugin.getSpec().getConfigMapName())\n .version(pluginWrapper.getDescriptor().getVersion())\n .runtimeMode(pluginWrapper.getRuntimeMode())\n .build();\n return new DefaultSpringPlugin(contextFactory, pluginContext);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/SpringPluginManager.java", "content": "package run.halo.app.plugin;\n\nimport java.util.List;\nimport org.jspecify.annotations.NonNull;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.context.ApplicationContext;\n\n/**\n * Plugin manager for Spring-based applications.\n *\n * @author johnniang\n * @since 2.12.0\n */\npublic interface SpringPluginManager extends PluginManager {\n\n /**\n * Gets the root application context.\n *\n * @return the root application context\n */\n @NonNull\n ApplicationContext getRootContext();\n\n /**\n * Get the shared application context among plugins.\n *\n * @return the shared application context\n */\n @NonNull\n ApplicationContext getSharedContext();\n\n /**\n * Get all dependents recursively.\n *\n * @param pluginId plugin id\n * @return a list of plugin wrapper. The order of the list is from the farthest dependent to\n * the nearest dependent.\n * @since 2.16.0\n */\n @NonNull\n List getDependents(@NonNull String pluginId);\n\n /**\n * Gets all started plugins.\n *\n * @return a list of started plugins. Mutable.\n * @apiNote The plugin inside this list may not be really started\n */\n @Override\n List getStartedPlugins();\n\n /**\n * Gets all really started plugins.\n *\n * @return a list of really started plugins. Immutable.\n */\n List startedPlugins();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/YamlPluginDescriptorFinder.java", "content": "package run.halo.app.plugin;\n\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.List;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.pf4j.DefaultPluginDescriptor;\nimport org.pf4j.PluginDependency;\nimport org.pf4j.PluginDescriptor;\nimport org.pf4j.PluginDescriptorFinder;\nimport org.pf4j.util.FileUtils;\nimport org.springframework.util.CollectionUtils;\nimport run.halo.app.core.extension.Plugin;\n\n/**\n * Find a plugin descriptor for a plugin path.\n *\n * @author guqing\n * @see DefaultPluginDescriptor\n * @since 2.0.0\n */\n@Slf4j\nclass YamlPluginDescriptorFinder implements PluginDescriptorFinder {\n\n private final YamlPluginFinder yamlPluginFinder;\n\n public YamlPluginDescriptorFinder() {\n yamlPluginFinder = new YamlPluginFinder();\n }\n\n @Override\n public boolean isApplicable(Path pluginPath) {\n return Files.exists(pluginPath)\n && (Files.isDirectory(pluginPath)\n || FileUtils.isJarFile(pluginPath));\n }\n\n @Override\n public PluginDescriptor find(Path pluginPath) {\n Plugin plugin = yamlPluginFinder.find(pluginPath);\n return convert(plugin);\n }\n\n public static PluginDescriptor convert(Plugin plugin) {\n var pluginId = plugin.getMetadata().getName();\n var spec = plugin.getSpec();\n var author = spec.getAuthor();\n var provider = (author == null ? StringUtils.EMPTY : author.getName());\n\n var defaultPluginDescriptor = new DefaultPluginDescriptor(pluginId,\n spec.getDescription(),\n BasePlugin.class.getName(),\n spec.getVersion(),\n spec.getRequires(),\n provider,\n joinLicense(spec.getLicense()));\n // add dependencies\n spec.getPluginDependencies().forEach((pluginDepName, versionRequire) -> {\n PluginDependency dependency =\n new PluginDependency(String.format(\"%s@%s\", pluginDepName, versionRequire));\n defaultPluginDescriptor.addDependency(dependency);\n });\n return defaultPluginDescriptor;\n }\n\n private static String joinLicense(List licenses) {\n if (CollectionUtils.isEmpty(licenses)) {\n return StringUtils.EMPTY;\n }\n return licenses.stream()\n .map(Plugin.License::getName)\n .collect(Collectors.joining(\",\"));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/YamlPluginFinder.java", "content": "package run.halo.app.plugin;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.List;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.NonNull;\nimport org.pf4j.DevelopmentPluginClasspath;\nimport org.pf4j.PluginRuntimeException;\nimport org.pf4j.util.FileUtils;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\n/**\n *

Reading plugin descriptor data from plugin.yaml.

\n * Example:\n * 
\n * apiVersion: v1alpha1\n * kind: Plugin\n * metadata:\n *   name: plugin-1\n *   labels:\n *     extensions.guqing.xyz/category: attachment\n * spec:\n *   # 'version' is a valid semantic version string (see semver.org).\n *   version: 0.0.1\n *   requires: \">=2.0.0\"\n *   author: guqing\n *   logo: example.com/logo.png\n *   pluginClass: xyz.guqing.plugin.potatoes.PotatoesApp\n *   pluginDependencies:\n *    \"plugin-2\": 1.0.0\n *   # 'homepage' usually links to the GitHub repository of the plugin\n *   homepage: example.com\n *   # 'displayName' explains what the plugin does in only a few words\n *   displayName: \"a name to show\"\n *   description: \"Tell me more about this plugin.\"\n *   license:\n *     - name: MIT\n *
\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\npublic class YamlPluginFinder implements PluginFinder {\n static final DevelopmentPluginClasspath PLUGIN_CLASSPATH = new DevelopmentPluginClasspath();\n public static final String DEFAULT_PROPERTIES_FILE_NAME = \"plugin.yaml\";\n private final String propertiesFileName;\n\n public YamlPluginFinder() {\n this(DEFAULT_PROPERTIES_FILE_NAME);\n }\n\n public YamlPluginFinder(String propertiesFileName) {\n this.propertiesFileName = propertiesFileName;\n }\n\n @Override\n @NonNull\n public Plugin find(@NonNull Path pluginPath) {\n Plugin plugin = readPluginDescriptor(pluginPath);\n if (plugin.getStatus() == null) {\n Plugin.PluginStatus pluginStatus = new Plugin.PluginStatus();\n pluginStatus.setPhase(Plugin.Phase.PENDING);\n pluginStatus.setLoadLocation(pluginPath.toUri());\n plugin.setStatus(pluginStatus);\n }\n MetadataUtil.nullSafeAnnotations(plugin)\n .put(PluginConst.PLUGIN_PATH, pluginPath.toString());\n return plugin;\n }\n\n protected Plugin readPluginDescriptor(Path pluginPath) {\n Path propertiesPath = null;\n try {\n propertiesPath = getManifestPath(pluginPath, propertiesFileName);\n if (propertiesPath == null) {\n throw new PluginRuntimeException(\"Cannot find the plugin manifest path\");\n }\n\n log.debug(\"Lookup plugin descriptor in '{}'\", propertiesPath);\n if (Files.notExists(propertiesPath)) {\n throw new PluginRuntimeException(\"Cannot find '{}' path\", propertiesPath);\n }\n Resource propertyResource = new FileSystemResource(propertiesPath);\n return unstructuredToPlugin(propertyResource);\n } finally {\n FileUtils.closePath(propertiesPath);\n }\n }\n\n protected Plugin unstructuredToPlugin(Resource propertyResource) {\n YamlUnstructuredLoader yamlUnstructuredLoader =\n new YamlUnstructuredLoader(propertyResource);\n List unstructuredList = yamlUnstructuredLoader.load();\n if (unstructuredList.size() != 1) {\n throw new PluginRuntimeException(\"Unable to find plugin descriptor file '{}'\",\n propertiesFileName);\n }\n Unstructured unstructured = unstructuredList.get(0);\n return Unstructured.OBJECT_MAPPER.convertValue(unstructured,\n Plugin.class);\n }\n\n protected Path getManifestPath(Path pluginPath, String propertiesFileName) {\n if (Files.isDirectory(pluginPath)) {\n for (String location : PLUGIN_CLASSPATH.getClassesDirectories()) {\n var path = pluginPath.resolve(location).resolve(propertiesFileName);\n Resource propertyResource = new FileSystemResource(path);\n if (propertyResource.exists()) {\n return path;\n }\n }\n throw new PluginRuntimeException(\n \"Unable to find plugin descriptor file: \" + DEFAULT_PROPERTIES_FILE_NAME);\n } else {\n // it's a jar file\n try {\n return FileUtils.getPath(pluginPath, propertiesFileName);\n } catch (IOException e) {\n throw new PluginRuntimeException(e);\n }\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/HaloPluginBeforeStopEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.pf4j.PluginWrapper;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class HaloPluginBeforeStopEvent extends ApplicationEvent {\n private final PluginWrapper plugin;\n\n public HaloPluginBeforeStopEvent(Object source, PluginWrapper plugin) {\n super(source);\n this.plugin = plugin;\n }\n\n public PluginWrapper getPlugin() {\n return plugin;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/HaloPluginStartedEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport lombok.Getter;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.util.Assert;\n\n/**\n * This event will be published to application context once plugin is started.\n *\n * @author guqing\n */\n@Getter\npublic class HaloPluginStartedEvent extends ApplicationEvent {\n\n private final PluginWrapper plugin;\n\n public HaloPluginStartedEvent(Object source, PluginWrapper plugin) {\n super(source);\n Assert.notNull(plugin, \"Plugin must not be null.\");\n this.plugin = plugin;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/HaloPluginStoppedEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.context.ApplicationEvent;\n\n/**\n * This event will be published to plugin application context once plugin is stopped.\n *\n * @author guqing\n * @date 2021-11-02\n */\npublic class HaloPluginStoppedEvent extends ApplicationEvent {\n\n private final PluginWrapper plugin;\n\n public HaloPluginStoppedEvent(Object source, PluginWrapper plugin) {\n super(source);\n this.plugin = plugin;\n }\n\n public PluginWrapper getPlugin() {\n return plugin;\n }\n\n public PluginState getPluginState() {\n return plugin.getPluginState();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/SpringPluginStartedEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.plugin.SpringPlugin;\n\npublic class SpringPluginStartedEvent extends ApplicationEvent {\n\n private final SpringPlugin springPlugin;\n\n public SpringPluginStartedEvent(Object source, SpringPlugin springPlugin) {\n super(source);\n this.springPlugin = springPlugin;\n }\n\n public SpringPlugin getSpringPlugin() {\n return springPlugin;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/SpringPluginStartingEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.plugin.SpringPlugin;\n\npublic class SpringPluginStartingEvent extends ApplicationEvent {\n\n private final SpringPlugin springPlugin;\n\n public SpringPluginStartingEvent(Object source, SpringPlugin springPlugin) {\n super(source);\n this.springPlugin = springPlugin;\n }\n\n public SpringPlugin getSpringPlugin() {\n return springPlugin;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/SpringPluginStoppedEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.plugin.SpringPlugin;\n\npublic class SpringPluginStoppedEvent extends ApplicationEvent {\n\n private final SpringPlugin springPlugin;\n\n public SpringPluginStoppedEvent(Object source, SpringPlugin springPlugin) {\n super(source);\n this.springPlugin = springPlugin;\n }\n\n public SpringPlugin getSpringPlugin() {\n return springPlugin;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/event/SpringPluginStoppingEvent.java", "content": "package run.halo.app.plugin.event;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.plugin.SpringPlugin;\n\npublic class SpringPluginStoppingEvent extends ApplicationEvent {\n\n private final SpringPlugin springPlugin;\n\n public SpringPluginStoppingEvent(Object source, SpringPlugin springPlugin) {\n super(source);\n this.springPlugin = springPlugin;\n }\n\n public SpringPlugin getSpringPlugin() {\n return springPlugin;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/AbstractDefinitionGetter.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.beans.factory.DisposableBean;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\n\n@RequiredArgsConstructor\nabstract class AbstractDefinitionGetter\n implements Reconciler, DisposableBean {\n\n protected final ConcurrentMap cache = new ConcurrentHashMap<>();\n\n private final ExtensionClient client;\n\n private final E watchType;\n\n abstract void putCache(E definition);\n\n @Override\n @SuppressWarnings(\"unchecked\")\n public Result reconcile(Request request) {\n client.fetch((Class) watchType.getClass(), request.name())\n .ifPresent(this::putCache);\n return Result.doNotRetry();\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder.extension(watchType)\n .syncAllOnStart(true)\n .build();\n }\n\n @Override\n public void destroy() throws Exception {\n cache.clear();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/DefaultExtensionGetter.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport java.util.ArrayList;\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.pf4j.ExtensionPoint;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.beans.factory.BeanFactory;\nimport org.springframework.core.annotation.AnnotationAwareOrderComparator;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting.ExtensionPointEnabled;\nimport run.halo.app.plugin.SpringPlugin;\nimport run.halo.app.plugin.SpringPluginManager;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class DefaultExtensionGetter implements ExtensionGetter {\n\n private final SystemConfigFetcher systemConfigFetcher;\n\n private final SpringPluginManager pluginManager;\n\n private final BeanFactory beanFactory;\n\n private final ExtensionDefinitionGetter extensionDefinitionGetter;\n\n private final ExtensionPointDefinitionGetter extensionPointDefinitionGetter;\n\n @Override\n public Flux getExtensions(Class extensionPoint) {\n return Flux.fromIterable(lookExtensions(extensionPoint))\n .concatWith(\n Flux.fromStream(() -> beanFactory.getBeanProvider(extensionPoint).orderedStream())\n )\n .sort(new AnnotationAwareOrderComparator());\n }\n\n @Override\n public List getExtensionList(Class extensionPoint) {\n var extensions = new LinkedList();\n extensions.addAll(lookExtensions(extensionPoint));\n extensions.addAll(beanFactory.getBeanProvider(extensionPoint).orderedStream().toList());\n extensions.sort(new AnnotationAwareOrderComparator());\n return extensions;\n }\n\n @Override\n public Mono getEnabledExtension(Class extensionPoint) {\n return getEnabledExtensions(extensionPoint).next();\n }\n\n @Override\n public Flux getEnabledExtensions(\n Class extensionPoint) {\n return fetchExtensionPointDefinition(extensionPoint)\n .flatMapMany(epd -> {\n var epdName = epd.getMetadata().getName();\n var type = epd.getSpec().getType();\n if (type == ExtensionPointDefinition.ExtensionPointType.SINGLETON) {\n return getEnabledExtensions(epdName, extensionPoint).take(1);\n }\n // TODO If the type is sortable, may need to process the returned order.\n return getEnabledExtensions(epdName, extensionPoint);\n });\n }\n\n private Flux getEnabledExtensions(String epdName,\n Class extensionPoint) {\n return systemConfigFetcher.fetch(ExtensionPointEnabled.GROUP, ExtensionPointEnabled.class)\n .switchIfEmpty(Mono.fromSupplier(ExtensionPointEnabled::new))\n .flatMapMany(enabled -> {\n var extensionDefNames = enabled.getOrDefault(epdName, null);\n if (extensionDefNames == null) {\n // get all extensions if not specified\n return Flux.defer(() -> getExtensions(extensionPoint));\n }\n var extensions = getExtensions(extensionPoint).cache();\n return Flux.fromIterable(extensionDefNames)\n .flatMapSequential(extensionDefinitionGetter::get)\n .flatMapSequential(extensionDef -> {\n var className = extensionDef.getSpec().getClassName();\n return extensions.filter(\n extension -> Objects.equals(extension.getClass().getName(),\n className)\n );\n });\n });\n }\n\n private Mono fetchExtensionPointDefinition(\n Class extensionPoint) {\n return extensionPointDefinitionGetter.getByClassName(extensionPoint.getName());\n }\n\n @NonNull\n protected List lookExtensions(Class type) {\n List beans = new ArrayList<>();\n // avoid concurrent modification\n var startedPlugins = pluginManager.startedPlugins();\n for (PluginWrapper startedPlugin : startedPlugins) {\n if (startedPlugin.getPlugin() instanceof SpringPlugin springPlugin) {\n var pluginApplicationContext = springPlugin.getApplicationContext();\n try {\n pluginApplicationContext.getBeansOfType(type)\n .forEach((name, bean) -> beans.add(bean));\n } catch (Throwable e) {\n // Ignore\n log.error(\"Error while looking for extensions of type {}\", type, e);\n }\n } else {\n var extensions = pluginManager.getExtensions(type, startedPlugin.getPluginId());\n beans.addAll(extensions);\n }\n }\n return beans;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionDefinition.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * Extension definition.\n * An {@link ExtensionDefinition} is a type of metadata that provides additional information about\n * an extension. An extension is a way to add new functionality to an existing class, structure,\n * enumeration, or protocol type without needing to subclass it.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"plugin.halo.run\", version = \"v1alpha1\",\n kind = \"ExtensionDefinition\", singular = \"extensiondefinition\",\n plural = \"extensiondefinitions\")\npublic class ExtensionDefinition extends AbstractExtension {\n\n @Schema(requiredMode = REQUIRED)\n private ExtensionSpec spec;\n\n @Data\n public static class ExtensionSpec {\n @Schema(requiredMode = REQUIRED)\n private String className;\n\n @Schema(requiredMode = REQUIRED)\n private String extensionPointName;\n\n @Schema(requiredMode = REQUIRED)\n private String displayName;\n\n private String description;\n\n private String icon;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionDefinitionGetter.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport reactor.core.publisher.Mono;\n\npublic interface ExtensionDefinitionGetter {\n\n /**\n * Gets extension definition by extension definition name.\n *\n * @param name extension definition name\n */\n Mono get(String name);\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionDefinitionGetterImpl.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ExtensionClient;\n\n@Component\npublic class ExtensionDefinitionGetterImpl\n extends AbstractDefinitionGetter\n implements ExtensionDefinitionGetter {\n\n public ExtensionDefinitionGetterImpl(ExtensionClient client) {\n super(client, new ExtensionDefinition());\n }\n\n @Override\n public Mono get(String name) {\n return Mono.fromSupplier(() -> cache.get(name));\n }\n\n @Override\n void putCache(ExtensionDefinition definition) {\n cache.put(definition.getMetadata().getName(), definition);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionPointDefinition.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n/**\n * Extension point definition.\n * An {@link ExtensionPointDefinition} is a concept used in Halo to allow for the\n * dynamic extension of system. It defines a location within Halo where\n * additional functionality can be added through the use of plugins or extensions.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\n@GVK(group = \"plugin.halo.run\", version = \"v1alpha1\",\n kind = \"ExtensionPointDefinition\", singular = \"extensionpointdefinition\",\n plural = \"extensionpointdefinitions\")\npublic class ExtensionPointDefinition extends AbstractExtension {\n\n @Schema(requiredMode = REQUIRED)\n private ExtensionPointSpec spec;\n\n @Data\n public static class ExtensionPointSpec {\n @Schema(requiredMode = REQUIRED)\n private String className;\n\n @Schema(requiredMode = REQUIRED)\n private String displayName;\n\n @Schema(requiredMode = REQUIRED)\n private ExtensionPointType type;\n\n private String description;\n\n private String icon;\n }\n\n /**\n *

Types of extension points include.

\n * There are several types:\n *
    \n *
  • Singleton extension point: means that only one implementation class of the extension\n * point can be enabled. It is generally used for global core extension points, such as global\n * logging components. When using a singleton extension point, it is necessary to ensure that\n * only one implementation class is enabled, otherwise unexpected issues may occur.
    • \n *
  • Multi-instance extension point: means that there can be multiple implementation\n * classes of the extension point enabled, and the execution order of each implementation\n * class may be different. It is generally used for specific business logic extension points,\n * such as the selection of data sources or the use of caches. When using a multi-instance\n * extension point, it is necessary to consider the dependency relationship and execution\n * order between each implementation class to ensure the correctness of the business logic.
    • \n *
  • Ordered extension point: means that multiple implementation classes of the extension\n * point can be enabled, but they need to be executed in a specified order. It is generally\n * used in scenarios that require strict control of execution order, such as the execution\n * order of message listeners. When using an ordered extension point, it is necessary to\n * assign a priority for each implementation class to ensure that they can be executed in the\n * correct order.
    • \n *
  • Conditional extension point: means that multiple implementation classes of the extension\n * point can be enabled, but they need to meet specific conditions to be executed. For\n * example, some implementation classes can only be executed under specific operating systems\n * or specific runtime environments. When using a conditional extension point, it is\n * necessary to define appropriate conditions according to the actual scenario to ensure the\n * correctness and availability of the extension point.
    • \n *
\n * There are two kinds of definitions for the time being: SINGLETON and MULTI_INSTANCE.\n */\n public enum ExtensionPointType {\n SINGLETON,\n MULTI_INSTANCE;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionPointDefinitionGetter.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport reactor.core.publisher.Mono;\n\npublic interface ExtensionPointDefinitionGetter {\n\n /**\n * Gets extension point definition by extension point class.\n *

Retrieve by filedSelector: spec.className

\n *\n * @param className extension point class name\n */\n Mono getByClassName(String className);\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/extensionpoint/ExtensionPointDefinitionGetterImpl.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ExtensionClient;\n\n@Component\npublic class ExtensionPointDefinitionGetterImpl\n extends AbstractDefinitionGetter\n implements ExtensionPointDefinitionGetter {\n\n public ExtensionPointDefinitionGetterImpl(ExtensionClient client) {\n super(client, new ExtensionPointDefinition());\n }\n\n @Override\n public Mono getByClassName(String className) {\n return Mono.fromSupplier(() -> cache.get(className));\n }\n\n @Override\n void putCache(ExtensionPointDefinition definition) {\n var className = definition.getSpec().getClassName();\n cache.put(className, definition);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/resources/BundleResourceUtils.java", "content": "package run.halo.app.plugin.resources;\n\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport org.springframework.core.io.Resource;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport org.springframework.util.StringUtils;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.infra.utils.PathUtils;\n\n/**\n * Plugin bundle resources utils.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic abstract class BundleResourceUtils {\n private static final String CONSOLE_BUNDLE_LOCATION = \"console\";\n public static final String JS_BUNDLE = \"main.js\";\n public static final String CSS_BUNDLE = \"style.css\";\n\n /**\n * Gets js bundle resource by plugin name in console location.\n *\n * @return js bundle resource if exists, otherwise null\n */\n @Nullable\n public static Resource getJsBundleResource(PluginManager pluginManager, String pluginName,\n String bundleName) {\n Assert.hasText(pluginName, \"The pluginName must not be blank\");\n Assert.hasText(bundleName, \"Bundle name must not be blank\");\n\n DefaultResourceLoader resourceLoader = getResourceLoader(pluginManager, pluginName);\n if (resourceLoader == null) {\n return null;\n }\n String path = PathUtils.combinePath(CONSOLE_BUNDLE_LOCATION, bundleName);\n String simplifyPath = StringUtils.cleanPath(path);\n FileUtils.checkDirectoryTraversal(\"/\" + CONSOLE_BUNDLE_LOCATION, simplifyPath);\n Resource resource = resourceLoader.getResource(simplifyPath);\n return resource.exists() ? resource : null;\n }\n\n @Nullable\n public static DefaultResourceLoader getResourceLoader(PluginManager pluginManager,\n String pluginName) {\n Assert.notNull(pluginManager, \"Plugin manager must not be null\");\n PluginWrapper plugin = pluginManager.getPlugin(pluginName);\n if (plugin == null) {\n return null;\n }\n return new DefaultResourceLoader(plugin.getPluginClassLoader());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/plugin/resources/ReverseProxyRouterFunctionFactory.java", "content": "package run.halo.app.plugin.resources;\n\nimport static org.springframework.http.MediaType.ALL;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\n\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.time.Instant;\nimport java.util.List;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.pf4j.PluginManager;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.ResourceLoader;\nimport org.springframework.http.CacheControl;\nimport org.springframework.http.server.PathContainer;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.reactive.function.BodyInserters;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.reactive.resource.NoResourceFoundException;\nimport org.springframework.web.util.pattern.PathPatternParser;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.core.extension.ReverseProxy.FileReverseProxyProvider;\nimport run.halo.app.core.extension.ReverseProxy.ReverseProxyRule;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.plugin.PluginConst;\n\n/**\n *

Plugin's reverse proxy router factory.

\n *

It creates a {@link RouterFunction} based on the ReverseProxy rule configured by\n * the plugin.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@AllArgsConstructor\npublic class ReverseProxyRouterFunctionFactory {\n\n private final PluginManager pluginManager;\n private final ApplicationContext applicationContext;\n private final WebProperties webProperties;\n\n /**\n *

Create {@link RouterFunction} according to the {@link ReverseProxy} custom resource\n * configuration of the plugin.

\n *

Note that: returns {@code Null} if the plugin does not have a {@link ReverseProxy} custom\n * resource.

\n *\n * @param pluginName plugin name(nullable if system)\n * @return A reverse proxy RouterFunction handle(nullable)\n */\n @Nullable\n public RouterFunction create(ReverseProxy reverseProxy, String pluginName) {\n return createReverseProxyRouterFunction(reverseProxy, nullSafePluginName(pluginName));\n }\n\n @Nullable\n private RouterFunction createReverseProxyRouterFunction(\n ReverseProxy reverseProxy, @NonNull String pluginName) {\n Assert.notNull(reverseProxy, \"The reverseProxy must not be null.\");\n var rules = getReverseProxyRules(reverseProxy);\n var cacheProperties = webProperties.getResources().getCache();\n var useLastModified = cacheProperties.isUseLastModified();\n var cacheControl = cacheProperties.getCachecontrol().toHttpCacheControl();\n if (cacheControl == null) {\n cacheControl = CacheControl.empty();\n }\n var finalCacheControl = cacheControl;\n return rules.stream().map(rule -> {\n String routePath = buildRoutePath(pluginName, rule);\n log.debug(\"Plugin [{}] registered reverse proxy route path [{}]\", pluginName,\n routePath);\n return RouterFunctions.route(GET(routePath).and(accept(ALL)),\n request -> {\n var resource = loadResourceByFileRule(pluginName, rule, request);\n if (!resource.exists()) {\n return Mono.error(new NoResourceFoundException(request.uri(), routePath));\n }\n if (!useLastModified) {\n return ServerResponse.ok()\n .cacheControl(finalCacheControl)\n .body(BodyInserters.fromResource(resource));\n }\n Instant lastModified;\n try {\n lastModified = Instant.ofEpochMilli(resource.lastModified());\n } catch (IOException e) {\n if (e instanceof FileNotFoundException) {\n return Mono.error(\n new NoResourceFoundException(request.uri(), routePath)\n );\n }\n return Mono.error(e);\n }\n return request.checkNotModified(lastModified)\n .switchIfEmpty(Mono.defer(\n () -> ServerResponse.ok()\n .cacheControl(finalCacheControl)\n .lastModified(lastModified)\n .body(BodyInserters.fromResource(resource)))\n );\n });\n }).reduce(RouterFunction::and).orElse(null);\n }\n\n private String nullSafePluginName(String pluginName) {\n return pluginName == null ? PluginConst.SYSTEM_PLUGIN_NAME : pluginName;\n }\n\n private List getReverseProxyRules(ReverseProxy reverseProxy) {\n return reverseProxy.getRules();\n }\n\n public static String buildRoutePath(String pluginId, ReverseProxyRule reverseProxyRule) {\n return PathUtils.combinePath(PluginConst.assetsRoutePrefix(pluginId),\n reverseProxyRule.path());\n }\n\n /**\n *

File load rule: if the directory is configured but the file name is not configured, it\n * means access through wildcards. Otherwise, if only the file name is configured, this\n * method only returns the file pointed to by the rule.

\n *

You should only use {@link Resource#getInputStream()} to get resource content instead of\n * {@link Resource#getFile()},the resource is loaded from the plugin jar file using a\n * specific plugin class loader; if you use {@link Resource#getFile()}, you cannot get the\n * file.

\n *

Note that a returned Resource handle does not imply an existing resource; you need to\n * invoke {@link Resource#exists()} to check for existence

\n *\n * @param pluginName plugin to load file by name\n * @param rule reverse proxy rule\n * @param request client request\n * @return a Resource handle for the specified resource location by the plugin(never null);\n */\n @NonNull\n private Resource loadResourceByFileRule(String pluginName, ReverseProxyRule rule,\n ServerRequest request) {\n Assert.notNull(rule.file(), \"File rule must not be null.\");\n FileReverseProxyProvider file = rule.file();\n String directory = file.directory();\n\n // Decision file name\n String filename;\n String configuredFilename = file.filename();\n if (StringUtils.isNotBlank(configuredFilename)) {\n filename = configuredFilename;\n } else {\n String routePath = buildRoutePath(pluginName, rule);\n PathContainer pathContainer = PathPatternParser.defaultInstance.parse(routePath)\n .extractPathWithinPattern(PathContainer.parsePath(request.path()));\n filename = pathContainer.value();\n }\n\n String filePath = PathUtils.combinePath(directory, filename);\n return getResourceLoader(pluginName).getResource(filePath);\n }\n\n private ResourceLoader getResourceLoader(String pluginName) {\n if (PluginConst.SYSTEM_PLUGIN_NAME.equals(pluginName)) {\n return applicationContext;\n }\n DefaultResourceLoader resourceLoader =\n BundleResourceUtils.getResourceLoader(pluginManager, pluginName);\n if (resourceLoader == null) {\n throw new NotFoundException(\"Plugin [\" + pluginName + \"] not found.\");\n }\n return resourceLoader;\n }\n}\n\n" }, { "path": "application/src/main/java/run/halo/app/plugin/resources/ReverseProxyRouterFunctionRegistry.java", "content": "package run.halo.app.plugin.resources;\n\nimport com.google.common.collect.LinkedHashMultimap;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.concurrent.locks.StampedLock;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.plugin.PluginRouterFunctionRegistry;\n\n/**\n * A registry for {@link RouterFunction} of plugin.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class ReverseProxyRouterFunctionRegistry {\n\n private final PluginRouterFunctionRegistry pluginRouterFunctionRegistry;\n\n private final ReverseProxyRouterFunctionFactory reverseProxyRouterFunctionFactory;\n private final StampedLock lock = new StampedLock();\n private final Map> proxyNameRouterFunctionRegistry =\n new HashMap<>();\n private final LinkedHashMultimap pluginIdReverseProxyMap =\n LinkedHashMultimap.create();\n\n public ReverseProxyRouterFunctionRegistry(\n PluginRouterFunctionRegistry pluginRouterFunctionRegistry,\n ReverseProxyRouterFunctionFactory reverseProxyRouterFunctionFactory) {\n this.pluginRouterFunctionRegistry = pluginRouterFunctionRegistry;\n this.reverseProxyRouterFunctionFactory = reverseProxyRouterFunctionFactory;\n }\n\n /**\n * Register reverse proxy router function.\n *\n * @param pluginId plugin id\n * @param reverseProxy reverse proxy\n */\n public void register(String pluginId, ReverseProxy reverseProxy) {\n Assert.notNull(pluginId, \"The plugin id must not be null.\");\n final String proxyName = reverseProxy.getMetadata().getName();\n long stamp = lock.writeLock();\n try {\n pluginIdReverseProxyMap.put(pluginId, proxyName);\n var routerFunction = reverseProxyRouterFunctionFactory.create(reverseProxy, pluginId);\n if (routerFunction != null) {\n proxyNameRouterFunctionRegistry.put(proxyName, routerFunction);\n pluginRouterFunctionRegistry.register(Set.of(routerFunction));\n }\n } finally {\n lock.unlockWrite(stamp);\n }\n }\n\n /**\n * Only for test.\n */\n int reverseProxySize(String pluginId) {\n Set names = pluginIdReverseProxyMap.get(pluginId);\n return names.size();\n }\n\n /**\n * Remove reverse proxy router function by pluginId and reverse proxy name.\n */\n public void remove(String pluginId, String reverseProxyName) {\n long stamp = lock.writeLock();\n try {\n pluginIdReverseProxyMap.remove(pluginId, reverseProxyName);\n var removedRouterFunction = proxyNameRouterFunctionRegistry.remove(reverseProxyName);\n if (removedRouterFunction != null) {\n pluginRouterFunctionRegistry.unregister(Set.of(removedRouterFunction));\n }\n } finally {\n lock.unlockWrite(stamp);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/HaloDocumentEventsListener.java", "content": "package run.halo.app.search;\n\nimport java.time.Duration;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.search.event.HaloDocumentAddRequestEvent;\nimport run.halo.app.search.event.HaloDocumentDeleteRequestEvent;\nimport run.halo.app.search.event.HaloDocumentRebuildRequestEvent;\n\n@Component\npublic class HaloDocumentEventsListener {\n\n private final ExtensionGetter extensionGetter;\n\n private int bufferSize;\n\n public HaloDocumentEventsListener(ExtensionGetter extensionGetter) {\n this.extensionGetter = extensionGetter;\n this.bufferSize = 200;\n }\n\n /**\n * Only for testing.\n *\n * @param bufferSize new buffer size for rebuilding indices\n */\n void setBufferSize(int bufferSize) {\n this.bufferSize = bufferSize;\n }\n\n @EventListener\n @Async\n void onApplicationEvent(HaloDocumentRebuildRequestEvent event) {\n getSearchEngine()\n .doOnNext(SearchEngine::deleteAll)\n .flatMap(searchEngine -> extensionGetter.getExtensions(HaloDocumentsProvider.class)\n .flatMap(HaloDocumentsProvider::fetchAll)\n .buffer(this.bufferSize)\n .doOnNext(searchEngine::addOrUpdate)\n .then())\n .blockOptional(Duration.ofMinutes(1));\n }\n\n @EventListener\n @Async\n void onApplicationEvent(HaloDocumentAddRequestEvent event) {\n getSearchEngine()\n .doOnNext(searchEngine -> searchEngine.addOrUpdate(event.getDocuments()))\n .then()\n .blockOptional(Duration.ofMinutes(1));\n }\n\n @EventListener\n @Async\n void onApplicationEvent(HaloDocumentDeleteRequestEvent event) {\n getSearchEngine()\n .doOnNext(searchEngine -> searchEngine.deleteDocument(event.getDocIds()))\n .then()\n .blockOptional(Duration.ofMinutes(1));\n }\n\n private Mono getSearchEngine() {\n return extensionGetter.getEnabledExtension(SearchEngine.class)\n .filter(SearchEngine::available)\n .switchIfEmpty(Mono.error(SearchEngineUnavailableException::new));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/IndexEndpoint.java", "content": "package run.halo.app.search;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\n\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\n\n@Component\npublic class IndexEndpoint implements CustomEndpoint {\n\n private static final String API_VERSION = \"api.halo.run/v1alpha1\";\n\n private final SearchService searchService;\n\n public IndexEndpoint(SearchService searchService) {\n this.searchService = searchService;\n }\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"IndexV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .POST(\"/indices/-/search\", this::indicesSearch,\n builder -> builder.operationId(\"IndicesSearch\")\n .tag(tag)\n .description(\"Search indices.\")\n .requestBody(requestBodyBuilder().implementation(SearchOption.class)\n .description(\"\"\"\n Please note that the \"filterPublished\", \"filterExposed\" and \\\n \"filterRecycled\" fields are ignored in this endpoint.\\\n \"\"\")\n )\n .response(responseBuilder().implementation(SearchResult.class))\n )\n .build();\n }\n\n private Mono indicesSearch(ServerRequest serverRequest) {\n return serverRequest.bodyToMono(SearchOption.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required.\")))\n .flatMap(this::performSearch)\n .flatMap(result -> ServerResponse.ok().bodyValue(result));\n }\n\n private Mono performSearch(SearchOption option) {\n option.setFilterExposed(true);\n option.setFilterPublished(true);\n option.setFilterRecycled(false);\n return searchService.search(option);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(API_VERSION);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/IndicesEndpoint.java", "content": "package run.halo.app.search;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.search.event.HaloDocumentRebuildRequestEvent;\n\n@Component\n@Slf4j\npublic class IndicesEndpoint implements CustomEndpoint {\n\n private static final String API_VERSION = \"api.console.halo.run/v1alpha1\";\n\n private final ApplicationEventPublisher eventPublisher;\n\n public IndicesEndpoint(ApplicationEventPublisher eventPublisher) {\n this.eventPublisher = eventPublisher;\n }\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"IndicesV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .POST(\"/indices/-/rebuild\", this::rebuildIndices,\n builder -> builder.operationId(\"RebuildAllIndices\")\n .tag(tag)\n .description(\"Rebuild all indices\")\n )\n .build();\n }\n\n private Mono rebuildIndices(ServerRequest serverRequest) {\n return Mono.fromRunnable(\n () -> eventPublisher.publishEvent(new HaloDocumentRebuildRequestEvent(this))\n ).then(ServerResponse.accepted().build());\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(API_VERSION);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/SearchEngineUnavailableException.java", "content": "package run.halo.app.search;\n\nimport org.springframework.web.server.ServerWebInputException;\n\n/**\n * Search engine unavailable exception.\n *\n * @author johnniang\n */\npublic class SearchEngineUnavailableException extends ServerWebInputException {\n\n public SearchEngineUnavailableException() {\n super(\"Search Engine is unavailable.\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/SearchServiceImpl.java", "content": "package run.halo.app.search;\n\nimport org.springframework.stereotype.Service;\nimport org.springframework.validation.Validator;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.infra.exception.RequestBodyValidationException;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@Service\npublic class SearchServiceImpl implements SearchService {\n\n private final Validator validator;\n\n private final ExtensionGetter extensionGetter;\n\n public SearchServiceImpl(Validator validator, ExtensionGetter extensionGetter) {\n this.validator = validator;\n this.extensionGetter = extensionGetter;\n }\n\n @Override\n public Mono search(SearchOption option) {\n // validate the option\n var errors = validator.validateObject(option);\n if (errors.hasErrors()) {\n return Mono.error(new RequestBodyValidationException(errors));\n }\n return extensionGetter.getEnabledExtension(SearchEngine.class)\n .filter(SearchEngine::available)\n .switchIfEmpty(Mono.error(SearchEngineUnavailableException::new))\n .flatMap(searchEngine -> Mono.fromSupplier(() ->\n searchEngine.search(option)\n ).subscribeOn(Schedulers.boundedElastic()));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/lucene/LuceneSearchEngine.java", "content": "package run.halo.app.search.lucene;\n\nimport static org.apache.lucene.document.Field.Store.YES;\nimport static org.apache.lucene.index.IndexWriterConfig.OpenMode.CREATE_OR_APPEND;\nimport static org.apache.lucene.search.BooleanClause.Occur.FILTER;\nimport static org.apache.lucene.search.BooleanClause.Occur.MUST;\n\nimport java.io.ByteArrayInputStream;\nimport java.io.ByteArrayOutputStream;\nimport java.io.Closeable;\nimport java.io.IOException;\nimport java.io.ObjectInputStream;\nimport java.io.ObjectOutputStream;\nimport java.nio.file.Path;\nimport java.time.Instant;\nimport java.util.ArrayList;\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.lucene.analysis.Analyzer;\nimport org.apache.lucene.analysis.charfilter.HTMLStripCharFilterFactory;\nimport org.apache.lucene.analysis.cjk.CJKBigramFilterFactory;\nimport org.apache.lucene.analysis.cjk.CJKWidthCharFilterFactory;\nimport org.apache.lucene.analysis.cjk.CJKWidthFilterFactory;\nimport org.apache.lucene.analysis.core.LowerCaseFilterFactory;\nimport org.apache.lucene.analysis.custom.CustomAnalyzer;\nimport org.apache.lucene.analysis.standard.StandardTokenizerFactory;\nimport org.apache.lucene.document.Document;\nimport org.apache.lucene.document.FieldType;\nimport org.apache.lucene.document.LongField;\nimport org.apache.lucene.document.StoredField;\nimport org.apache.lucene.document.StringField;\nimport org.apache.lucene.document.TextField;\nimport org.apache.lucene.index.DocValuesType;\nimport org.apache.lucene.index.IndexNotFoundException;\nimport org.apache.lucene.index.IndexWriter;\nimport org.apache.lucene.index.IndexWriterConfig;\nimport org.apache.lucene.index.Term;\nimport org.apache.lucene.queryparser.flexible.core.QueryNodeException;\nimport org.apache.lucene.queryparser.flexible.standard.StandardQueryParser;\nimport org.apache.lucene.search.BooleanQuery;\nimport org.apache.lucene.search.FuzzyQuery;\nimport org.apache.lucene.search.IndexSearcher;\nimport org.apache.lucene.search.SearcherManager;\nimport org.apache.lucene.search.Sort;\nimport org.apache.lucene.search.TermInSetQuery;\nimport org.apache.lucene.search.TermQuery;\nimport org.apache.lucene.search.highlight.Highlighter;\nimport org.apache.lucene.search.highlight.InvalidTokenOffsetsException;\nimport org.apache.lucene.search.highlight.QueryTermScorer;\nimport org.apache.lucene.search.highlight.SimpleHTMLFormatter;\nimport org.apache.lucene.store.Directory;\nimport org.apache.lucene.store.FSDirectory;\nimport org.apache.lucene.util.BytesRef;\nimport org.apache.lucene.util.IOUtils;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.core.convert.converter.Converter;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.StopWatch;\nimport org.springframework.util.StringUtils;\nimport reactor.core.Exceptions;\nimport run.halo.app.search.HaloDocument;\nimport run.halo.app.search.SearchEngine;\nimport run.halo.app.search.SearchOption;\nimport run.halo.app.search.SearchResult;\n\n@Slf4j\npublic class LuceneSearchEngine implements SearchEngine, InitializingBean, DisposableBean {\n\n private final Path indexRootDir;\n\n private final Converter haloDocumentConverter =\n new HaloDocumentConverter();\n\n private final Converter documentConverter =\n new DocumentConverter();\n\n private Analyzer analyzer;\n\n private volatile SearcherManager searcherManager;\n\n private Directory directory;\n\n public LuceneSearchEngine(Path indexRootDir) {\n this.indexRootDir = indexRootDir;\n }\n\n @Override\n public boolean available() {\n return true;\n }\n\n @Override\n public void addOrUpdate(Iterable haloDocs) {\n var docs = new LinkedList();\n var terms = new LinkedList();\n haloDocs.forEach(haloDoc -> {\n var doc = this.haloDocumentConverter.convert(haloDoc);\n terms.add(new BytesRef(haloDoc.getId()));\n docs.add(doc);\n });\n var deleteQuery = new TermInSetQuery(\"id\", terms);\n\n var writerConfig = new IndexWriterConfig(this.analyzer)\n .setOpenMode(CREATE_OR_APPEND);\n synchronized (this) {\n try (var indexWriter = new IndexWriter(this.directory, writerConfig)) {\n indexWriter.updateDocuments(deleteQuery, docs);\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n } finally {\n this.refreshSearcherManager();\n }\n }\n }\n\n @Override\n public void deleteDocument(Iterable haloDocIds) {\n var terms = new LinkedList();\n haloDocIds.forEach(haloDocId -> terms.add(new BytesRef(haloDocId)));\n var deleteQuery = new TermInSetQuery(\"id\", terms);\n var writerConfig = new IndexWriterConfig(this.analyzer)\n .setOpenMode(CREATE_OR_APPEND);\n synchronized (this) {\n try (var indexWriter = new IndexWriter(this.directory, writerConfig)) {\n indexWriter.deleteDocuments(deleteQuery);\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n } finally {\n this.refreshSearcherManager();\n }\n }\n }\n\n @Override\n public void deleteAll() {\n var writerConfig = new IndexWriterConfig(this.analyzer)\n .setOpenMode(CREATE_OR_APPEND);\n synchronized (this) {\n try (var indexWriter = new IndexWriter(this.directory, writerConfig)) {\n indexWriter.deleteAll();\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n } finally {\n this.refreshSearcherManager();\n }\n }\n }\n\n @Override\n public SearchResult search(SearchOption option) {\n IndexSearcher searcher = null;\n var sm = obtainSearcherManager();\n if (sm.isEmpty()) {\n // indicate the index is empty\n var emptyResult = new SearchResult();\n emptyResult.setKeyword(option.getKeyword());\n emptyResult.setLimit(option.getLimit());\n emptyResult.setTotal(0L);\n emptyResult.setHits(List.of());\n return emptyResult;\n }\n try {\n searcher = searcherManager.acquire();\n var queryParser = new StandardQueryParser(analyzer);\n queryParser.setMultiFields(new String[] {\"title\", \"description\", \"content\"});\n queryParser.setFieldsBoost(Map.of(\"title\", 1.0f, \"description\", 0.5f, \"content\", 0.2f));\n queryParser.setFuzzyMinSim(FuzzyQuery.defaultMaxEdits);\n queryParser.setFuzzyPrefixLength(FuzzyQuery.defaultPrefixLength);\n\n var keyword = option.getKeyword();\n var query = queryParser.parse(keyword, null);\n var queryBuilder = new BooleanQuery.Builder()\n .add(query, MUST);\n\n var filterExposed = option.getFilterExposed();\n if (filterExposed != null) {\n queryBuilder.add(\n new TermQuery(new Term(\"exposed\", filterExposed.toString())), FILTER\n );\n }\n var filterRecycled = option.getFilterRecycled();\n if (filterRecycled != null) {\n queryBuilder.add(\n new TermQuery(new Term(\"recycled\", filterRecycled.toString())), FILTER\n );\n }\n var filterPublished = option.getFilterPublished();\n if (filterPublished != null) {\n queryBuilder.add(\n new TermQuery(new Term(\"published\", filterPublished.toString())), FILTER\n );\n }\n\n Optional.ofNullable(option.getIncludeTypes())\n .filter(types -> !types.isEmpty())\n .ifPresent(types -> {\n var typeTerms = types.stream()\n .distinct()\n .map(BytesRef::new)\n .toList();\n queryBuilder.add(new TermInSetQuery(\"type\", typeTerms), FILTER);\n });\n\n Optional.ofNullable(option.getIncludeOwnerNames())\n .filter(ownerNames -> !ownerNames.isEmpty())\n .ifPresent(ownerNames -> {\n var ownerTerms = ownerNames.stream()\n .distinct()\n .map(BytesRef::new)\n .toList();\n queryBuilder.add(new TermInSetQuery(\"ownerName\", ownerTerms), FILTER);\n });\n\n Optional.ofNullable(option.getIncludeTagNames())\n .filter(tagNames -> !tagNames.isEmpty())\n .ifPresent(tagNames -> tagNames\n .stream()\n .distinct()\n .forEach(tagName ->\n queryBuilder.add(new TermQuery(new Term(\"tag\", tagName)), FILTER)\n ));\n\n Optional.ofNullable(option.getIncludeCategoryNames())\n .filter(categoryNames -> !categoryNames.isEmpty())\n .ifPresent(categoryNames -> categoryNames\n .stream()\n .distinct()\n .forEach(categoryName ->\n queryBuilder.add(new TermQuery(new Term(\"category\", categoryName)), FILTER)\n ));\n\n var finalQuery = queryBuilder.build();\n var limit = option.getLimit();\n\n var stopWatch = new StopWatch(\"SearchWatch\");\n stopWatch.start(\"search \" + keyword);\n var hits = searcher.search(finalQuery, limit, Sort.RELEVANCE);\n stopWatch.stop();\n var formatter =\n new SimpleHTMLFormatter(option.getHighlightPreTag(), option.getHighlightPostTag());\n var queryScorer = new QueryTermScorer(query);\n var highlighter = new Highlighter(formatter, queryScorer);\n\n var haloDocs = new ArrayList(hits.scoreDocs.length);\n for (var hit : hits.scoreDocs) {\n var doc = searcher.storedFields().document(hit.doc);\n var haloDoc = documentConverter.convert(doc);\n\n var title = doc.get(\"title\");\n var hlTitle = highlighter.getBestFragment(this.analyzer, \"title\", title);\n if (!StringUtils.hasText(hlTitle)) {\n hlTitle = title;\n }\n\n var description = doc.get(\"description\");\n String hlDescription = null;\n if (description != null) {\n hlDescription =\n highlighter.getBestFragment(this.analyzer, \"description\", description);\n }\n\n var content = doc.get(\"content\");\n var hlContent = highlighter.getBestFragment(this.analyzer, \"content\", content);\n\n haloDoc.setTitle(hlTitle);\n haloDoc.setDescription(hlDescription);\n haloDoc.setContent(hlContent);\n haloDocs.add(haloDoc);\n }\n var result = new SearchResult();\n result.setHits(haloDocs);\n result.setTotal(hits.totalHits.value());\n result.setKeyword(keyword);\n result.setLimit(limit);\n result.setProcessingTimeMillis(stopWatch.getTotalTimeMillis());\n return result;\n } catch (IOException | QueryNodeException | InvalidTokenOffsetsException e) {\n throw new RuntimeException(e);\n } finally {\n if (searcher != null) {\n try {\n searcherManager.release(searcher);\n } catch (IOException e) {\n log.error(\"Failed to release searcher\", e);\n }\n }\n }\n }\n\n @Override\n public void afterPropertiesSet() throws Exception {\n this.analyzer = CustomAnalyzer.builder()\n .withTokenizer(StandardTokenizerFactory.class)\n .addCharFilter(HTMLStripCharFilterFactory.NAME)\n .addCharFilter(CJKWidthCharFilterFactory.NAME)\n .addTokenFilter(LowerCaseFilterFactory.NAME)\n .addTokenFilter(CJKWidthFilterFactory.NAME)\n .addTokenFilter(CJKBigramFilterFactory.NAME)\n .build();\n this.directory = FSDirectory.open(this.indexRootDir);\n log.info(\"Initialized lucene search engine\");\n }\n\n Optional obtainSearcherManager() {\n if (this.searcherManager != null) {\n return Optional.of(this.searcherManager);\n }\n synchronized (this) {\n // double check\n if (this.searcherManager != null) {\n return Optional.of(this.searcherManager);\n }\n try {\n this.searcherManager = new SearcherManager(this.directory, null);\n return Optional.of(this.searcherManager);\n } catch (IndexNotFoundException e) {\n log.warn(\"Index not ready for creating searcher manager\");\n } catch (IOException e) {\n log.error(\"Failed to create searcher manager\", e);\n }\n return Optional.empty();\n }\n }\n\n private void refreshSearcherManager() {\n this.obtainSearcherManager().ifPresent(sm -> {\n try {\n sm.maybeRefreshBlocking();\n } catch (IOException e) {\n log.warn(\"Failed to refresh searcher\", e);\n }\n });\n }\n\n Directory getDirectory() {\n return directory;\n }\n\n Analyzer getAnalyzer() {\n return analyzer;\n }\n\n void setDirectory(Directory directory) {\n this.directory = directory;\n }\n\n void setSearcherManager(SearcherManager searcherManager) {\n this.searcherManager = searcherManager;\n }\n\n void setAnalyzer(Analyzer analyzer) {\n this.analyzer = analyzer;\n }\n\n Converter getHaloDocumentConverter() {\n return haloDocumentConverter;\n }\n\n Converter getDocumentConverter() {\n return documentConverter;\n }\n\n @Override\n public void destroy() throws Exception {\n var closers = new ArrayList(4);\n if (this.analyzer != null) {\n closers.add(this.analyzer);\n }\n if (this.searcherManager != null) {\n closers.add(this.searcherManager);\n }\n if (this.directory != null) {\n closers.add(this.directory);\n }\n IOUtils.close(closers);\n this.analyzer = null;\n this.searcherManager = null;\n this.directory = null;\n log.info(\"Destroyed lucene search engine\");\n }\n\n private static class HaloDocumentConverter implements Converter {\n\n @Override\n @NonNull\n public Document convert(HaloDocument haloDoc) {\n var doc = new Document();\n doc.add(new StringField(\"id\", haloDoc.getId(), YES));\n doc.add(new StringField(\"name\", haloDoc.getMetadataName(), YES));\n doc.add(new StringField(\"type\", haloDoc.getType(), YES));\n doc.add(new StringField(\"ownerName\", haloDoc.getOwnerName(), YES));\n var categories = haloDoc.getCategories();\n if (categories != null) {\n categories.forEach(category -> doc.add(new StringField(\"category\", category, YES)));\n }\n var tags = haloDoc.getTags();\n if (tags != null) {\n tags.forEach(tag -> doc.add(new StringField(\"tag\", tag, YES)));\n }\n\n doc.add(new TextField(\"title\", haloDoc.getTitle(), YES));\n if (haloDoc.getDescription() != null) {\n doc.add(new TextField(\"description\", haloDoc.getDescription(), YES));\n }\n doc.add(new TextField(\"content\", haloDoc.getContent(), YES));\n doc.add(new StringField(\"recycled\", Boolean.toString(haloDoc.isRecycled()), YES));\n doc.add(new StringField(\"exposed\", Boolean.toString(haloDoc.isExposed()), YES));\n doc.add(new StringField(\"published\", Boolean.toString(haloDoc.isPublished()), YES));\n\n var annotations = haloDoc.getAnnotations();\n if (annotations != null) {\n try (var baos = new ByteArrayOutputStream();\n var oos = new ObjectOutputStream(baos)) {\n oos.writeObject(annotations);\n var type = new FieldType();\n type.setStored(true);\n type.setTokenized(false);\n type.setDocValuesType(DocValuesType.BINARY);\n type.freeze();\n doc.add(new StoredField(\"annotations\", new BytesRef(baos.toByteArray()), type));\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n\n var creationTimestamp = haloDoc.getCreationTimestamp();\n doc.add(new LongField(\"creationTimestamp\", creationTimestamp.toEpochMilli(), YES));\n var updateTimestamp = haloDoc.getUpdateTimestamp();\n if (updateTimestamp != null) {\n doc.add(new LongField(\"updateTimestamp\", updateTimestamp.toEpochMilli(), YES));\n }\n doc.add(new StringField(\"permalink\", haloDoc.getPermalink(), YES));\n return doc;\n }\n }\n\n private static class DocumentConverter implements Converter {\n\n @Override\n @NonNull\n public HaloDocument convert(Document doc) {\n var haloDoc = new HaloDocument();\n haloDoc.setId(doc.get(\"id\"));\n haloDoc.setType(doc.get(\"type\"));\n haloDoc.setMetadataName(doc.get(\"name\"));\n haloDoc.setTitle(doc.get(\"title\"));\n haloDoc.setDescription(doc.get(\"description\"));\n haloDoc.setPermalink(doc.get(\"permalink\"));\n haloDoc.setOwnerName(doc.get(\"ownerName\"));\n haloDoc.setCategories(List.of(doc.getValues(\"category\")));\n haloDoc.setTags(List.of(doc.getValues(\"tag\")));\n\n haloDoc.setRecycled(getBooleanValue(doc, \"recycled\", false));\n haloDoc.setPublished(getBooleanValue(doc, \"published\", false));\n haloDoc.setExposed(getBooleanValue(doc, \"exposed\", false));\n\n var annotationsBytesRef = doc.getBinaryValue(\"annotations\");\n if (annotationsBytesRef != null) {\n try (var bais = new ByteArrayInputStream(annotationsBytesRef.bytes);\n var ois = new ObjectInputStream(bais)) {\n @SuppressWarnings(\"unchecked\")\n var annotations = (Map) ois.readObject();\n haloDoc.setAnnotations(annotations);\n } catch (IOException | ClassNotFoundException e) {\n throw new RuntimeException(e);\n }\n }\n\n var creationTimestamp = doc.getField(\"creationTimestamp\").numericValue().longValue();\n haloDoc.setCreationTimestamp(Instant.ofEpochMilli(creationTimestamp));\n var updateTimestampField = doc.getField(\"updateTimestamp\");\n if (updateTimestampField != null) {\n var updateTimestamp = updateTimestampField.numericValue().longValue();\n haloDoc.setUpdateTimestamp(Instant.ofEpochMilli(updateTimestamp));\n }\n // handle content later\n return haloDoc;\n }\n\n private static boolean getBooleanValue(Document doc, String fieldName,\n boolean defaultValue) {\n var boolStr = doc.get(fieldName);\n return boolStr == null ? defaultValue : Boolean.parseBoolean(boolStr);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/post/PostEventsListener.java", "content": "package run.halo.app.search.post;\n\nimport static run.halo.app.search.post.PostHaloDocumentsProvider.POST_DOCUMENT_TYPE;\nimport static run.halo.app.search.post.PostHaloDocumentsProvider.convert;\n\nimport java.util.List;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.PostDeletedEvent;\nimport run.halo.app.event.post.PostUpdatedEvent;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.search.event.HaloDocumentAddRequestEvent;\nimport run.halo.app.search.event.HaloDocumentDeleteRequestEvent;\n\n@Component\npublic class PostEventsListener {\n\n private final ApplicationEventPublisher publisher;\n\n private final PostService postService;\n\n private final ReactiveExtensionClient client;\n\n public PostEventsListener(\n ApplicationEventPublisher publisher,\n PostService postService,\n ReactiveExtensionClient client) {\n this.publisher = publisher;\n this.postService = postService;\n this.client = client;\n }\n\n @EventListener\n Mono onApplicationEvent(PostUpdatedEvent event) {\n return addOrUpdateOrDelete(event.getName());\n }\n\n @EventListener\n void onApplicationEvent(PostDeletedEvent event) {\n delete(event.getName());\n }\n\n private Mono addOrUpdateOrDelete(String postName) {\n return client.fetch(Post.class, postName)\n .flatMap(post -> {\n if (ExtensionUtil.isDeleted(post)) {\n // if the post is deleted permanently, delete it.\n return Mono.fromRunnable(() -> delete(postName));\n }\n // convert the post into halo document and add it to the search engine.\n return postService.getReleaseContent(post)\n .map(content -> convert(post, content))\n .doOnNext(haloDoc -> publisher.publishEvent(\n new HaloDocumentAddRequestEvent(this, List.of(haloDoc))\n ));\n })\n .then();\n }\n\n private void delete(String postName) {\n publisher.publishEvent(\n new HaloDocumentDeleteRequestEvent(this, List.of(POST_DOCUMENT_TYPE + '-' + postName))\n );\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/search/post/PostHaloDocumentsProvider.java", "content": "package run.halo.app.search.post;\n\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.ReactiveExtensionPaginatedOperator;\nimport run.halo.app.search.HaloDocument;\nimport run.halo.app.search.HaloDocumentsProvider;\n\n@Component\npublic class PostHaloDocumentsProvider implements HaloDocumentsProvider {\n\n public static final String POST_DOCUMENT_TYPE = \"post.content.halo.run\";\n\n private final ReactiveExtensionPaginatedOperator paginatedOperator;\n\n private final PostService postService;\n\n public PostHaloDocumentsProvider(ReactiveExtensionPaginatedOperator paginatedOperator,\n PostService postService) {\n this.paginatedOperator = paginatedOperator;\n this.postService = postService;\n }\n\n @Override\n public Flux fetchAll() {\n // make sure the posts are published, public visible and not deleted.\n var options = new ListOptions();\n var noteDeleted = Queries.isNull(\"metadata.deletionTimestamp\");\n options.setFieldSelector(FieldSelector.of(noteDeleted));\n // get content\n return paginatedOperator.list(Post.class, options)\n .flatMap(post -> postService.getReleaseContent(post)\n .switchIfEmpty(Mono.fromSupplier(() -> ContentWrapper.builder()\n .content(\"\")\n .raw(\"\")\n .rawType(\"\")\n .build()))\n .map(contentWrapper -> convert(post, contentWrapper))\n );\n }\n\n @Override\n public String getType() {\n return POST_DOCUMENT_TYPE;\n }\n\n /**\n * Converts post to HaloDocument.\n *\n * @param post post detail\n * @param content post content\n * @return halo document\n */\n public static HaloDocument convert(Post post, ContentWrapper content) {\n var haloDoc = new HaloDocument();\n var spec = post.getSpec();\n haloDoc.setMetadataName(post.getMetadata().getName());\n haloDoc.setType(POST_DOCUMENT_TYPE);\n haloDoc.setId(POST_DOCUMENT_TYPE + '-' + post.getMetadata().getName());\n haloDoc.setTitle(spec.getTitle());\n haloDoc.setDescription(post.getStatus().getExcerpt());\n haloDoc.setPublished(Post.isPublished(post.getMetadata()));\n haloDoc.setRecycled(Post.isRecycled(post.getMetadata()));\n haloDoc.setExposed(Post.isPublic(spec));\n haloDoc.setContent(content.getContent());\n haloDoc.setTags(spec.getTags());\n haloDoc.setCategories(spec.getCategories());\n haloDoc.setOwnerName(spec.getOwner());\n haloDoc.setUpdateTimestamp(spec.getPublishTime());\n haloDoc.setCreationTimestamp(post.getMetadata().getCreationTimestamp());\n haloDoc.setPermalink(post.getStatus().getPermalink());\n return haloDoc;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/AuthProviderService.java", "content": "package run.halo.app.security;\n\nimport java.util.List;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.AuthProvider;\n\n/**\n * A service for {@link AuthProvider}.\n *\n * @author guqing\n * @since 2.4.0\n */\npublic interface AuthProviderService {\n\n Mono enable(String name);\n\n Mono disable(String name);\n\n Mono> listAll();\n\n /**\n * Return a list of enabled AuthProviders sorted by priority.\n */\n Flux getEnabledProviders();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/AuthProviderServiceImpl.java", "content": "package run.halo.app.security;\n\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.Comparator;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport lombok.experimental.Accessors;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.AuthProvider;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * A default implementation of {@link AuthProviderService}.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Component\n@RequiredArgsConstructor\npublic class AuthProviderServiceImpl implements AuthProviderService {\n private final ReactiveExtensionClient client;\n private final ObjectProvider environmentFetcherProvider;\n\n @Override\n public Mono enable(String name) {\n return client.get(AuthProvider.class, name)\n .flatMap(authProvider -> updateAuthProviderEnabled(name, true)\n .thenReturn(authProvider)\n );\n }\n\n @Override\n public Mono disable(String name) {\n return client.get(AuthProvider.class, name)\n // privileged auth provider cannot be disabled\n .filter(authProvider -> !privileged(authProvider))\n .flatMap(authProvider -> updateAuthProviderEnabled(name, false)\n .thenReturn(authProvider)\n );\n }\n\n @Override\n public Mono> listAll() {\n var listOptions = ListOptions.builder()\n .andQuery(ExtensionUtil.notDeleting())\n .build();\n var allProvidersMono =\n client.listAll(AuthProvider.class, listOptions, ExtensionUtil.defaultSort())\n .map(this::convertTo)\n .collectList()\n .subscribeOn(Schedulers.boundedElastic());\n\n var boundProvidersMono = listMyConnections()\n .map(connection -> connection.getSpec().getRegistrationId())\n .collect(Collectors.toSet())\n .subscribeOn(Schedulers.boundedElastic());\n\n return Mono.zip(allProvidersMono, boundProvidersMono, fetchProviderStates())\n .map(tuple3 -> {\n var allProviders = tuple3.getT1();\n var boundProviderNames = tuple3.getT2();\n var stateMap = tuple3.getT3().stream()\n .collect(Collectors.toMap(SystemSetting.AuthProviderState::getName,\n Function.identity()));\n return allProviders.stream()\n .peek(authProvider -> {\n authProvider.setIsBound(\n boundProviderNames.contains(authProvider.getName()));\n authProvider.setEnabled(false);\n // set enabled state and priority\n var state = stateMap.get(authProvider.getName());\n if (state != null) {\n authProvider.setEnabled(state.isEnabled());\n authProvider.setPriority(state.getPriority());\n }\n })\n .sorted(Comparator.comparingInt(ListedAuthProvider::getPriority)\n .thenComparing(ListedAuthProvider::getName))\n .toList();\n });\n }\n\n @Override\n public Flux getEnabledProviders() {\n return fetchProviderStates().flatMapMany(states -> {\n var namePriorityMap = states.stream()\n // filter enabled providers\n .filter(SystemSetting.AuthProviderState::isEnabled)\n .collect(Collectors.toMap(SystemSetting.AuthProviderState::getName,\n SystemSetting.AuthProviderState::getPriority));\n\n var listOptions = ListOptions.builder()\n .andQuery(Queries.in(\"metadata.name\", namePriorityMap.keySet()))\n .andQuery(ExtensionUtil.notDeleting())\n .build();\n return client.listAll(AuthProvider.class, listOptions, ExtensionUtil.defaultSort())\n .map(provider -> new AuthProviderWithPriority()\n .setAuthProvider(provider)\n .setPriority(namePriorityMap.getOrDefault(\n provider.getMetadata().getName(), 0)\n )\n )\n .sort(AuthProviderWithPriority::compareTo)\n .map(AuthProviderWithPriority::getAuthProvider);\n });\n }\n\n @Data\n @Accessors(chain = true)\n static class AuthProviderWithPriority implements Comparable {\n private AuthProvider authProvider;\n private int priority;\n\n public String getName() {\n return authProvider.getMetadata().getName();\n }\n\n @Override\n public int compareTo(@NonNull AuthProviderWithPriority o) {\n return Comparator.comparingInt(AuthProviderWithPriority::getPriority)\n .thenComparing(AuthProviderWithPriority::getName)\n .compare(this, o);\n }\n }\n\n private Mono> fetchProviderStates() {\n return getSystemConfigMap()\n .map(AuthProviderServiceImpl::getAuthProviderConfig)\n .map(SystemSetting.AuthProvider::getStates)\n .defaultIfEmpty(List.of())\n .subscribeOn(Schedulers.boundedElastic());\n }\n\n Flux listMyConnections() {\n return ReactiveSecurityContextHolder.getContext()\n .map(securityContext -> securityContext.getAuthentication().getName())\n .flatMapMany(username -> {\n var listOptions = ListOptions.builder()\n .andQuery(Queries.equal(\"spec.username\", username))\n .andQuery(ExtensionUtil.notDeleting())\n .build();\n return client.listAll(UserConnection.class, listOptions,\n ExtensionUtil.defaultSort());\n });\n }\n\n private ListedAuthProvider convertTo(AuthProvider authProvider) {\n return ListedAuthProvider.builder()\n .name(authProvider.getMetadata().getName())\n .displayName(authProvider.getSpec().getDisplayName())\n .logo(authProvider.getSpec().getLogo())\n .website(authProvider.getSpec().getWebsite())\n .description(authProvider.getSpec().getDescription())\n .authenticationUrl(authProvider.getSpec().getAuthenticationUrl())\n .helpPage(authProvider.getSpec().getHelpPage())\n .bindingUrl(authProvider.getSpec().getBindingUrl())\n .unbindingUrl(authProvider.getSpec().getUnbindUrl())\n .supportsBinding(supportsBinding(authProvider))\n .authType(authProvider.getSpec().getAuthType())\n .isBound(false)\n .enabled(false)\n .privileged(privileged(authProvider))\n .build();\n }\n\n private static boolean supportsBinding(AuthProvider authProvider) {\n return BooleanUtils.TRUE.equals(MetadataUtil.nullSafeLabels(authProvider)\n .get(AuthProvider.AUTH_BINDING_LABEL));\n }\n\n private boolean privileged(AuthProvider authProvider) {\n return BooleanUtils.TRUE.equals(MetadataUtil.nullSafeLabels(authProvider)\n .get(AuthProvider.PRIVILEGED_LABEL));\n }\n\n @NonNull\n private static SystemSetting.AuthProvider getAuthProviderConfig(ConfigMap configMap) {\n if (configMap.getData() == null) {\n configMap.setData(new HashMap<>());\n }\n final Map data = configMap.getData();\n String providerGroup = data.get(SystemSetting.AuthProvider.GROUP);\n\n SystemSetting.AuthProvider authProvider;\n if (StringUtils.isBlank(providerGroup)) {\n authProvider = new SystemSetting.AuthProvider();\n } else {\n authProvider =\n JsonUtils.jsonToObject(providerGroup, SystemSetting.AuthProvider.class);\n }\n if (authProvider.getStates() == null) {\n authProvider.setStates(new ArrayList<>());\n }\n\n return authProvider;\n }\n\n private Mono updateAuthProviderEnabled(String name, boolean enabled) {\n return Mono.defer(() -> getSystemConfigMap()\n .flatMap(configMap -> {\n var providerConfig = getAuthProviderConfig(configMap);\n var stateToFoundOpt = providerConfig.getStates()\n .stream()\n .filter(state -> state.getName().equals(name))\n .findFirst();\n if (stateToFoundOpt.isEmpty()) {\n var state = new SystemSetting.AuthProviderState()\n .setName(name)\n .setEnabled(enabled);\n providerConfig.getStates().add(state);\n } else {\n stateToFoundOpt.get().setEnabled(enabled);\n }\n\n configMap.getData().put(SystemSetting.AuthProvider.GROUP,\n JsonUtils.objectToJson(providerConfig));\n\n return client.update(configMap);\n })\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono getSystemConfigMap() {\n var systemFetcher = environmentFetcherProvider.getIfUnique();\n if (systemFetcher == null) {\n return Mono.error(\n new IllegalStateException(\"No SystemConfigurableEnvironmentFetcher found\"));\n }\n return systemFetcher.getConfigMap();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/CorsConfigurer.java", "content": "package run.halo.app.security;\n\nimport com.google.common.net.HttpHeaders;\nimport java.util.List;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.cors.CorsConfiguration;\nimport org.springframework.web.cors.reactive.CorsConfigurationSource;\nimport org.springframework.web.cors.reactive.UrlBasedCorsConfigurationSource;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.properties.SecurityProperties;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n@Component\n@Order(0)\npublic class CorsConfigurer implements SecurityConfigurer {\n\n private final SecurityProperties.CorsOptions corsOptions;\n\n public CorsConfigurer(HaloProperties haloProperties) {\n corsOptions = haloProperties.getSecurity().getCorsOptions();\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n http.cors(spec -> {\n if (corsOptions.isDisabled()) {\n spec.disable();\n return;\n }\n spec.configurationSource(apiCorsConfigSource());\n });\n }\n\n CorsConfigurationSource apiCorsConfigSource() {\n var source = new UrlBasedCorsConfigurationSource();\n // additional CORS configuration\n this.corsOptions.getConfigs().forEach(corsConfig -> source.registerCorsConfiguration(\n corsConfig.getPathPattern(), corsConfig.getConfig().toCorsConfiguration()\n ));\n\n // default CORS configuration\n var configuration = new CorsConfiguration();\n configuration.setAllowedOriginPatterns(List.of(\"*\"));\n configuration.setAllowedHeaders(\n List.of(HttpHeaders.AUTHORIZATION, HttpHeaders.CONTENT_TYPE, HttpHeaders.ACCEPT,\n \"X-XSRF-TOKEN\", HttpHeaders.COOKIE));\n configuration.setAllowCredentials(true);\n configuration.setAllowedMethods(List.of(\"GET\", \"POST\", \"PUT\", \"DELETE\", \"PATCH\"));\n source.registerCorsConfiguration(\"/api/**\", configuration);\n source.registerCorsConfiguration(\"/apis/**\", configuration);\n return source;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/CsrfConfigurer.java", "content": "package run.halo.app.security;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport org.springframework.core.annotation.Order;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.web.server.csrf.CookieServerCsrfTokenRepository;\nimport org.springframework.security.web.server.csrf.CsrfWebFilter;\nimport org.springframework.security.web.server.csrf.XorServerCsrfTokenRequestAttributeHandler;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.NegatedServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.security.authentication.pat.PatAuthenticationConverter;\n\n@Component\n@Order(0)\nclass CsrfConfigurer implements SecurityConfigurer {\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var csrfMatcher = new AndServerWebExchangeMatcher(\n CsrfWebFilter.DEFAULT_CSRF_MATCHER,\n new NegatedServerWebExchangeMatcher(pathMatchers(\n \"/api/**\",\n \"/apis/**\",\n \"/actuator/**\",\n \"/system/setup\"\n )),\n new NegatedServerWebExchangeMatcher(patAuthMatcher())\n );\n http.csrf(csrfSpec -> csrfSpec\n .csrfTokenRepository(new CookieServerCsrfTokenRepository())\n .csrfTokenRequestHandler(new XorServerCsrfTokenRequestAttributeHandler())\n .requireCsrfProtectionMatcher(csrfMatcher));\n }\n\n private static ServerWebExchangeMatcher patAuthMatcher() {\n var patConverter = new PatAuthenticationConverter();\n return exchange -> patConverter.convert(exchange)\n .flatMap(a -> ServerWebExchangeMatcher.MatchResult.match())\n .switchIfEmpty(Mono.defer(ServerWebExchangeMatcher.MatchResult::notMatch));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/DefaultServerAuthenticationEntryPoint.java", "content": "package run.halo.app.security;\n\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.security.core.AuthenticationException;\nimport org.springframework.security.web.server.ServerAuthenticationEntryPoint;\nimport org.springframework.security.web.server.authentication.RedirectServerAuthenticationEntryPoint;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher.MatchResult;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.utils.HaloUtils;\n\n/**\n * Default authentication entry point.\n * See \n * https://datatracker.ietf.org/doc/html/rfc7235#section-4.1\n * for more.\n *\n * @author johnniang\n */\npublic class DefaultServerAuthenticationEntryPoint implements ServerAuthenticationEntryPoint {\n\n private final ServerWebExchangeMatcher xhrMatcher = exchange -> {\n if (HaloUtils.isXhr(exchange.getRequest().getHeaders())) {\n return MatchResult.match();\n }\n return MatchResult.notMatch();\n };\n\n private final RedirectServerAuthenticationEntryPoint redirectEntryPoint;\n\n public DefaultServerAuthenticationEntryPoint(ServerRequestCache serverRequestCache) {\n var entryPoint =\n new RedirectServerAuthenticationEntryPoint(\"/login?authentication_required\");\n entryPoint.setRequestCache(serverRequestCache);\n this.redirectEntryPoint = entryPoint;\n }\n\n @Override\n public Mono commence(ServerWebExchange exchange, AuthenticationException ex) {\n return xhrMatcher.matches(exchange)\n .filter(MatchResult::isMatch)\n .switchIfEmpty(\n Mono.defer(() -> this.redirectEntryPoint.commence(exchange, ex).then(Mono.empty()))\n )\n .flatMap(match -> Mono.defer(\n () -> {\n var response = exchange.getResponse();\n var wwwAuthenticate = \"FormLogin realm=\\\"console\\\"\";\n response.getHeaders().set(HttpHeaders.WWW_AUTHENTICATE, wwwAuthenticate);\n response.setStatusCode(HttpStatus.UNAUTHORIZED);\n return response.setComplete();\n }).then(Mono.empty())\n );\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/DefaultSuperAdminInitializer.java", "content": "package run.halo.app.security;\n\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.extension.RoleBinding.RoleRef;\nimport run.halo.app.core.extension.RoleBinding.Subject;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.User.UserSpec;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class DefaultSuperAdminInitializer implements SuperAdminInitializer {\n\n private final ReactiveExtensionClient client;\n private final PasswordEncoder passwordEncoder;\n\n @Override\n public Mono initialize(InitializationParam param) {\n return client.fetch(User.class, param.getUsername())\n .switchIfEmpty(Mono.defer(() -> client.create(\n createAdmin(param.getUsername(), param.getPassword(), param.getEmail())))\n .flatMap(admin -> {\n var binding = bindAdminAndSuperRole(admin);\n return client.create(binding).thenReturn(admin);\n })\n )\n .then();\n }\n\n RoleBinding bindAdminAndSuperRole(User admin) {\n String adminUserName = admin.getMetadata().getName();\n var metadata = new Metadata();\n String name =\n String.join(\"-\", adminUserName, SUPER_ROLE_NAME, \"binding\");\n metadata.setName(name);\n var roleRef = new RoleRef();\n roleRef.setName(SUPER_ROLE_NAME);\n roleRef.setApiGroup(Role.GROUP);\n roleRef.setKind(Role.KIND);\n\n var subject = new Subject();\n subject.setName(adminUserName);\n subject.setApiGroup(admin.groupVersionKind().group());\n subject.setKind(admin.groupVersionKind().kind());\n\n var roleBinding = new RoleBinding();\n roleBinding.setMetadata(metadata);\n roleBinding.setRoleRef(roleRef);\n roleBinding.setSubjects(List.of(subject));\n\n return roleBinding;\n }\n\n User createAdmin(String username, String password, String email) {\n var metadata = new Metadata();\n metadata.setName(username);\n metadata.setFinalizers(Set.of(MetadataUtil.SYSTEM_FINALIZER));\n\n var spec = new UserSpec();\n spec.setDisplayName(\"Administrator\");\n spec.setDisabled(false);\n spec.setRegisteredAt(Instant.now());\n spec.setTwoFactorAuthEnabled(false);\n spec.setEmail(email);\n spec.setPassword(passwordEncoder.encode(password));\n\n var user = new User();\n user.setMetadata(metadata);\n user.setSpec(spec);\n return user;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/DefaultUserDetailService.java", "content": "package run.halo.app.security;\n\nimport static java.util.Objects.requireNonNullElse;\nimport static run.halo.app.security.authorization.AuthorityUtils.ANONYMOUS_ROLE_NAME;\nimport static run.halo.app.security.authorization.AuthorityUtils.AUTHENTICATED_ROLE_NAME;\nimport static run.halo.app.security.authorization.AuthorityUtils.ROLE_PREFIX;\n\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.security.core.authority.SimpleGrantedAuthority;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsPasswordService;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.core.userdetails.User;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.infra.exception.UserNotFoundException;\nimport run.halo.app.security.authentication.login.HaloUser;\nimport run.halo.app.security.authentication.twofactor.TwoFactorUtils;\n\n@Slf4j\npublic class DefaultUserDetailService\n implements ReactiveUserDetailsService, ReactiveUserDetailsPasswordService {\n\n private final UserService userService;\n\n private final RoleService roleService;\n\n /**\n * Indicates whether two-factor authentication is disabled.\n */\n @Setter\n private boolean twoFactorAuthDisabled;\n\n public DefaultUserDetailService(UserService userService, RoleService roleService) {\n this.userService = userService;\n this.roleService = roleService;\n }\n\n @Override\n public Mono updatePassword(UserDetails user, String newPassword) {\n return userService.updatePassword(user.getUsername(), newPassword)\n .map(u -> withNewPassword(user, newPassword));\n }\n\n @Override\n public Mono findByUsername(String username) {\n var getUser = Mono.defer(() -> {\n var isEmail = username.contains(\"@\");\n if (isEmail) {\n log.debug(\"Try to authenticate by email: {}\", username);\n return userService.findUserByVerifiedEmail(username);\n } else {\n log.debug(\"Try to authenticate by username: {}\", username);\n return userService.getUser(username);\n }\n });\n return getUser.switchIfEmpty(Mono.error(() -> new UserNotFoundException(username)))\n .onErrorMap(UserNotFoundException.class,\n ignored -> new BadCredentialsException(\"Invalid Credentials\"))\n .flatMap(user -> {\n var name = user.getMetadata().getName();\n var userBuilder = User.withUsername(name)\n .password(user.getSpec().getPassword())\n .disabled(requireNonNullElse(user.getSpec().getDisabled(), false));\n var setAuthorities = roleService.getRolesByUsername(name)\n // every authenticated user should have authenticated and anonymous roles.\n .concatWithValues(AUTHENTICATED_ROLE_NAME, ANONYMOUS_ROLE_NAME)\n .map(roleName -> new SimpleGrantedAuthority(ROLE_PREFIX + roleName))\n .distinct()\n .collectList()\n .doOnNext(userBuilder::authorities);\n\n return setAuthorities.then(Mono.fromSupplier(() -> {\n var twoFactorAuthSettings = TwoFactorUtils.getTwoFactorAuthSettings(user);\n return new HaloUser.Builder(userBuilder.build())\n .twoFactorAuthEnabled(\n (!twoFactorAuthDisabled) && twoFactorAuthSettings.isAvailable()\n )\n .totpEncryptedSecret(user.getSpec().getTotpEncryptedSecret())\n .build();\n }));\n });\n }\n\n private UserDetails withNewPassword(UserDetails userDetails, String newPassword) {\n return User.withUserDetails(userDetails)\n .password(newPassword)\n .build();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/ExceptionSecurityConfigurer.java", "content": "package run.halo.app.security;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.anyExchange;\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport java.util.ArrayList;\nimport org.springframework.context.MessageSource;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.oauth2.server.resource.web.access.server.BearerTokenServerAccessDeniedHandler;\nimport org.springframework.security.oauth2.server.resource.web.server.authentication.ServerBearerTokenAuthenticationConverter;\nimport org.springframework.security.web.server.DelegatingServerAuthenticationEntryPoint;\nimport org.springframework.security.web.server.authentication.AuthenticationConverterServerWebExchangeMatcher;\nimport org.springframework.security.web.server.authorization.HttpStatusServerAccessDeniedHandler;\nimport org.springframework.security.web.server.authorization.ServerWebExchangeDelegatingServerAccessDeniedHandler;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthenticationEntryPoint;\n\n@Component\n@Order(0)\npublic class ExceptionSecurityConfigurer implements SecurityConfigurer {\n\n private final MessageSource messageSource;\n\n private final ServerResponse.Context context;\n\n private final ServerRequestCache serverRequestCache;\n\n public ExceptionSecurityConfigurer(MessageSource messageSource,\n ServerResponse.Context context,\n ServerRequestCache serverRequestCache) {\n this.messageSource = messageSource;\n this.context = context;\n this.serverRequestCache = serverRequestCache;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n http.exceptionHandling(exception -> {\n var accessDeniedHandlers =\n new ArrayList(\n 3\n );\n accessDeniedHandlers.add(\n new ServerWebExchangeDelegatingServerAccessDeniedHandler.DelegateEntry(\n new AuthenticationConverterServerWebExchangeMatcher(\n new ServerBearerTokenAuthenticationConverter()\n ),\n new BearerTokenServerAccessDeniedHandler()\n ));\n accessDeniedHandlers.add(\n new ServerWebExchangeDelegatingServerAccessDeniedHandler.DelegateEntry(\n pathMatchers(HttpMethod.GET, \"/login\", \"/signup\"),\n new RedirectAccessDeniedHandler(\"/uc\")\n ));\n accessDeniedHandlers.add(\n new ServerWebExchangeDelegatingServerAccessDeniedHandler.DelegateEntry(\n anyExchange(),\n new HttpStatusServerAccessDeniedHandler(HttpStatus.FORBIDDEN)\n )\n );\n\n var entryPoints =\n new ArrayList(2);\n entryPoints.add(new DelegatingServerAuthenticationEntryPoint.DelegateEntry(\n TwoFactorAuthenticationEntryPoint.MATCHER,\n new TwoFactorAuthenticationEntryPoint(messageSource, context)\n ));\n entryPoints.add(new DelegatingServerAuthenticationEntryPoint.DelegateEntry(\n anyExchange(),\n new DefaultServerAuthenticationEntryPoint(serverRequestCache)\n ));\n\n exception.authenticationEntryPoint(\n new DelegatingServerAuthenticationEntryPoint(entryPoints)\n )\n .accessDeniedHandler(\n new ServerWebExchangeDelegatingServerAccessDeniedHandler(accessDeniedHandlers)\n );\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/HaloRedirectAuthenticationSuccessHandler.java", "content": "package run.halo.app.security;\n\nimport static run.halo.app.security.HaloServerRequestCache.uriInApplication;\n\nimport java.net.URI;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.ServerAuthenticationSuccessHandler;\nimport reactor.core.publisher.Mono;\n\n/**\n * This class is responsible for handling the redirection after a successful authentication.\n * It checks if a valid 'redirect_uri' query parameter is present in the request. If it is,\n * the user is redirected to the specified URI. Otherwise, the user is redirected to a default\n * location.\n *\n * @author johnniang\n */\n@Slf4j\npublic class HaloRedirectAuthenticationSuccessHandler\n implements ServerAuthenticationSuccessHandler {\n\n private final ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n private final URI location;\n\n public HaloRedirectAuthenticationSuccessHandler(String location) {\n this.location = URI.create(location);\n }\n\n @Override\n public Mono onAuthenticationSuccess(WebFilterExchange webFilterExchange,\n Authentication authentication) {\n var request = webFilterExchange.getExchange().getRequest();\n var redirectUriQuery = request.getQueryParams()\n .getFirst(\"redirect_uri\");\n if (redirectUriQuery == null || redirectUriQuery.isBlank()) {\n return redirectStrategy.sendRedirect(webFilterExchange.getExchange(), location);\n }\n var redirectUri = uriInApplication(request, URI.create(redirectUriQuery));\n if (log.isDebugEnabled()) {\n log.debug(\n \"Redirecting to: {} after switching to {}\",\n redirectUri, authentication.getName()\n );\n }\n return redirectStrategy.sendRedirect(\n webFilterExchange.getExchange(), URI.create(redirectUri)\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/HaloServerRequestCache.java", "content": "package run.halo.app.security;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport java.net.URI;\nimport java.util.Collections;\nimport java.util.Objects;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.server.RequestPath;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.security.web.server.savedrequest.WebSessionServerRequestCache;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.MediaTypeServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.NegatedServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebSession;\nimport reactor.core.publisher.Mono;\n\n/**\n * Halo server request cache implementation for saving redirect URI from query.\n *\n * @author johnniang\n */\npublic class HaloServerRequestCache extends WebSessionServerRequestCache {\n\n /**\n * Currently, we have no idea to customize the sessionAttributeName in\n * WebSessionServerRequestCache, so we have to copy the attr into here.\n */\n private static final String DEFAULT_SAVED_REQUEST_ATTR = \"SPRING_SECURITY_SAVED_REQUEST\";\n\n private static final String REDIRECT_URI_QUERY = \"redirect_uri\";\n\n private final String sessionAttrName = DEFAULT_SAVED_REQUEST_ATTR;\n\n public HaloServerRequestCache() {\n super();\n setSaveRequestMatcher(createDefaultRequestMatcher());\n }\n\n @Override\n public Mono saveRequest(ServerWebExchange exchange) {\n var redirectUriQuery = exchange.getRequest().getQueryParams().getFirst(REDIRECT_URI_QUERY);\n if (StringUtils.isNotBlank(redirectUriQuery)) {\n // the query value is decoded, so we don't need to decode it again\n var redirectUri = URI.create(redirectUriQuery);\n return saveRedirectUri(exchange, redirectUri);\n }\n return super.saveRequest(exchange);\n }\n\n @Override\n public Mono getRedirectUri(ServerWebExchange exchange) {\n return super.getRedirectUri(exchange);\n }\n\n @Override\n public Mono removeMatchingRequest(ServerWebExchange exchange) {\n return getRedirectUri(exchange)\n .flatMap(redirectUri -> {\n if (redirectUri.getFragment() != null) {\n var redirectUriInApplication =\n uriInApplication(exchange.getRequest(), redirectUri, false);\n var uriInApplication =\n uriInApplication(exchange.getRequest(), exchange.getRequest().getURI());\n // compare the path and query only\n if (!Objects.equals(redirectUriInApplication, uriInApplication)) {\n return Mono.empty();\n }\n // remove the exchange\n return exchange.getSession().map(WebSession::getAttributes)\n .doOnNext(attributes -> attributes.remove(this.sessionAttrName))\n .thenReturn(exchange.getRequest());\n }\n return super.removeMatchingRequest(exchange);\n });\n }\n\n private Mono saveRedirectUri(ServerWebExchange exchange, URI redirectUri) {\n var redirectUriInApplication = uriInApplication(exchange.getRequest(), redirectUri);\n return exchange.getSession()\n .map(WebSession::getAttributes)\n .doOnNext(attributes -> attributes.put(this.sessionAttrName, redirectUriInApplication))\n .then();\n }\n\n public static String uriInApplication(ServerHttpRequest request, URI uri) {\n return uriInApplication(request, uri, true);\n }\n\n public static String uriInApplication(\n ServerHttpRequest request, URI uri, boolean appendFragment\n ) {\n var path = RequestPath.parse(uri, request.getPath().contextPath().value());\n var query = uri.getRawQuery();\n var fragment = uri.getRawFragment();\n return path.pathWithinApplication().value()\n + (query == null ? \"\" : \"?\" + query)\n + (fragment == null || !appendFragment ? \"\" : \"#\" + fragment);\n }\n\n private static ServerWebExchangeMatcher createDefaultRequestMatcher() {\n var get = pathMatchers(HttpMethod.GET, \"/**\");\n var notFavicon = new NegatedServerWebExchangeMatcher(\n pathMatchers(\n \"/favicon.*\", \"/login/**\", \"/signup/**\", \"/password-reset/**\", \"/challenges/**\",\n \"/oauth2/**\", \"/social/**\"\n ));\n var html = new MediaTypeServerWebExchangeMatcher(MediaType.TEXT_HTML);\n html.setIgnoredMediaTypes(Collections.singleton(MediaType.ALL));\n return new AndServerWebExchangeMatcher(get, notFavicon, html);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/HaloUserDetails.java", "content": "package run.halo.app.security;\n\nimport org.springframework.security.core.userdetails.UserDetails;\n\npublic interface HaloUserDetails extends UserDetails {\n\n /**\n * Checks if two-factor authentication is enabled.\n *\n * @return true if two-factor authentication is enabled, false otherwise.\n */\n boolean isTwoFactorAuthEnabled();\n\n /**\n * Gets the encrypted secret of TOTP.\n *\n * @return encrypted secret of TOTP.\n */\n String getTotpEncryptedSecret();\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/InitializeRedirectionWebFilter.java", "content": "package run.halo.app.security;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport java.net.URI;\nimport java.util.Set;\nimport lombok.Getter;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.MediaTypeServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.InitializationStateGetter;\n\n/**\n * A web filter that will redirect user to set up page if system is not initialized.\n *\n * @author guqing\n * @since 2.5.2\n */\n@Component\nclass InitializeRedirectionWebFilter implements WebFilter {\n private final URI location = URI.create(\"/system/setup\");\n private final ServerWebExchangeMatcher redirectMatcher;\n\n private final InitializationStateGetter initializationStateGetter;\n\n @Getter\n private ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n InitializeRedirectionWebFilter(InitializationStateGetter initializationStateGetter) {\n this.initializationStateGetter = initializationStateGetter;\n\n var html = new MediaTypeServerWebExchangeMatcher(MediaType.TEXT_HTML);\n html.setIgnoredMediaTypes(Set.of(MediaType.ALL));\n this.redirectMatcher = new AndServerWebExchangeMatcher(\n pathMatchers(HttpMethod.GET, \"/\", \"/console/**\", \"/uc/**\", \"/login\", \"/signup\"),\n html\n );\n }\n\n @Override\n @NonNull\n public Mono filter(@NonNull ServerWebExchange exchange, @NonNull WebFilterChain chain) {\n return redirectMatcher.matches(exchange)\n .flatMap(matched -> {\n if (!matched.isMatch()) {\n return chain.filter(exchange);\n }\n return initializationStateGetter.userInitialized()\n .defaultIfEmpty(false)\n .flatMap(initialized -> {\n if (initialized) {\n return chain.filter(exchange);\n }\n // Redirect to set up page if system is not initialized.\n return redirectStrategy.sendRedirect(exchange, location);\n });\n });\n }\n\n public void setRedirectStrategy(ServerRedirectStrategy redirectStrategy) {\n Assert.notNull(redirectStrategy, \"redirectStrategy cannot be null\");\n this.redirectStrategy = redirectStrategy;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/ListedAuthProvider.java", "content": "package run.halo.app.security;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Builder;\nimport lombok.Data;\nimport run.halo.app.core.extension.AuthProvider;\n\n/**\n * A listed value object for {@link run.halo.app.core.extension.AuthProvider}.\n *\n * @author guqing\n * @since 2.4.0\n */\n@Data\n@Builder\npublic class ListedAuthProvider {\n @Schema(requiredMode = REQUIRED)\n String name;\n\n @Schema(requiredMode = REQUIRED)\n String displayName;\n\n String description;\n\n String logo;\n\n String website;\n\n String authenticationUrl;\n\n String helpPage;\n\n String bindingUrl;\n\n String unbindingUrl;\n\n AuthProvider.AuthType authType;\n\n Boolean isBound;\n\n Boolean enabled;\n\n int priority;\n\n Boolean supportsBinding;\n\n Boolean privileged;\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/LoginHandlerEnhancerImpl.java", "content": "package run.halo.app.security;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.AuthenticationException;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.UserLoginOrLogoutProcessing;\nimport run.halo.app.security.authentication.oauth2.OAuth2LoginHandlerEnhancer;\nimport run.halo.app.security.authentication.rememberme.RememberMeRequestCache;\nimport run.halo.app.security.authentication.rememberme.RememberMeServices;\nimport run.halo.app.security.authentication.rememberme.WebSessionRememberMeRequestCache;\nimport run.halo.app.security.device.DeviceService;\n\n/**\n * A default implementation for {@link LoginHandlerEnhancer} to handle device management and\n * remember me.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Component\n@RequiredArgsConstructor\npublic class LoginHandlerEnhancerImpl implements LoginHandlerEnhancer {\n\n private final RememberMeServices rememberMeServices;\n\n private final DeviceService deviceService;\n\n private final RememberMeRequestCache rememberMeRequestCache =\n new WebSessionRememberMeRequestCache();\n\n private final OAuth2LoginHandlerEnhancer oauth2LoginHandlerEnhancer;\n\n private final UserLoginOrLogoutProcessing userLoginOrLogoutProcessing;\n\n @Override\n public Mono onLoginSuccess(ServerWebExchange exchange,\n Authentication successfulAuthentication) {\n return Mono.when(\n rememberMeServices.loginSuccess(exchange, successfulAuthentication),\n deviceService.loginSuccess(exchange, successfulAuthentication),\n rememberMeRequestCache.removeRememberMe(exchange),\n oauth2LoginHandlerEnhancer.loginSuccess(exchange, successfulAuthentication),\n userLoginOrLogoutProcessing.loginProcessing(successfulAuthentication.getName())\n );\n }\n\n @Override\n public Mono onLoginFailure(ServerWebExchange exchange,\n AuthenticationException exception) {\n return rememberMeServices.loginFail(exchange);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/LogoutSecurityConfigurer.java", "content": "package run.halo.app.security;\n\nimport static run.halo.app.security.authentication.WebExchangeMatchers.ignoringMediaTypeAll;\n\nimport java.net.URI;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.logout.DelegatingServerLogoutHandler;\nimport org.springframework.security.web.server.authentication.logout.SecurityContextServerLogoutHandler;\nimport org.springframework.security.web.server.authentication.logout.ServerLogoutHandler;\nimport org.springframework.security.web.server.authentication.logout.ServerLogoutSuccessHandler;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport org.springframework.security.web.server.savedrequest.WebSessionServerRequestCache;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.UserLoginOrLogoutProcessing;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.infra.actuator.GlobalInfoService;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.theme.router.ModelConst;\n\n@Component\n@RequiredArgsConstructor\n@Order(0)\nclass LogoutSecurityConfigurer implements SecurityConfigurer {\n\n private final ApplicationContext applicationContext;\n\n private final UserLoginOrLogoutProcessing userLoginOrLogoutProcessing;\n\n private final ServerRequestCache serverRequestCache = new HaloServerRequestCache();\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n @Override\n public void configure(ServerHttpSecurity http) {\n http.logout(logout -> logout\n .logoutHandler(getLogoutHandler())\n .logoutSuccessHandler(new LogoutSuccessHandler())\n );\n }\n\n private ServerLogoutHandler getLogoutHandler() {\n var defaultLogoutHandler = new SecurityContextServerLogoutHandler();\n defaultLogoutHandler.setSecurityContextRepository(securityContextRepository);\n var logoutHandlers = new ArrayList();\n logoutHandlers.add(defaultLogoutHandler);\n applicationContext.getBeanProvider(ServerLogoutHandler.class)\n .forEach(logoutHandlers::add);\n if (logoutHandlers.size() == 1) {\n return logoutHandlers.getFirst();\n }\n return new DelegatingServerLogoutHandler(logoutHandlers);\n }\n\n @Bean\n RouterFunction logoutPage(\n UserService userService,\n GlobalInfoService globalInfoService\n ) {\n return RouterFunctions.route()\n .GET(\"/logout\", request -> {\n var user = ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName)\n .flatMap(userService::getUser);\n var exchange = request.exchange();\n var contextPath = exchange.getRequest().getPath().contextPath().value();\n\n return ServerResponse.ok().render(\"logout\", Map.of(\n \"globalInfo\", globalInfoService.getGlobalInfo(),\n \"action\", contextPath + \"/logout\",\n \"user\", user\n ));\n })\n .before(request -> {\n request.exchange().getAttributes().put(ModelConst.NO_CACHE, true);\n return request;\n })\n .filter((request, next) ->\n // Save request before handling the logout\n serverRequestCache.saveRequest(request.exchange()).then(next.handle(request))\n )\n .build();\n }\n\n\n private class LogoutSuccessHandler implements ServerLogoutSuccessHandler {\n\n private final ServerLogoutSuccessHandler defaultHandler;\n\n public LogoutSuccessHandler() {\n var redirectHandler = new RequestCacheRedirectLogoutSuccessHandler();\n redirectHandler.setRequestCache(serverRequestCache);\n this.defaultHandler = redirectHandler;\n }\n\n @Override\n public Mono onLogoutSuccess(WebFilterExchange exchange,\n Authentication authentication) {\n return userLoginOrLogoutProcessing.logoutProcessing(authentication.getName())\n .then(ignoringMediaTypeAll(MediaType.APPLICATION_JSON)\n .matches(exchange.getExchange())\n .filter(ServerWebExchangeMatcher.MatchResult::isMatch)\n .switchIfEmpty(Mono.defer(() ->\n defaultHandler.onLogoutSuccess(exchange, authentication).then(Mono.empty())\n ))\n .flatMap(match -> {\n var response = exchange.getExchange().getResponse();\n response.setStatusCode(HttpStatus.NO_CONTENT);\n return response.setComplete();\n })\n );\n }\n }\n\n private static class RequestCacheRedirectLogoutSuccessHandler\n implements ServerLogoutSuccessHandler {\n\n private final ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n private URI location = URI.create(\"/login?logout\");\n\n private ServerRequestCache requestCache = new WebSessionServerRequestCache();\n\n public RequestCacheRedirectLogoutSuccessHandler() {\n }\n\n public RequestCacheRedirectLogoutSuccessHandler(String location) {\n this.location = URI.create(location);\n }\n\n public void setRequestCache(@NonNull ServerRequestCache requestCache) {\n Assert.notNull(requestCache, \"requestCache cannot be null\");\n this.requestCache = requestCache;\n }\n\n @Override\n public Mono onLogoutSuccess(\n WebFilterExchange exchange, Authentication authentication\n ) {\n return this.requestCache.getRedirectUri(exchange.getExchange())\n .defaultIfEmpty(this.location)\n .flatMap(location ->\n this.redirectStrategy.sendRedirect(exchange.getExchange(), location)\n );\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/RedirectAccessDeniedHandler.java", "content": "package run.halo.app.security;\n\nimport java.net.URI;\nimport org.springframework.security.access.AccessDeniedException;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.authorization.ServerAccessDeniedHandler;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * Redirect access denied handler.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class RedirectAccessDeniedHandler implements ServerAccessDeniedHandler {\n\n private final ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n private final URI redirectUri;\n\n public RedirectAccessDeniedHandler(String redirectUri) {\n this.redirectUri = URI.create(redirectUri);\n }\n\n @Override\n public Mono handle(ServerWebExchange exchange, AccessDeniedException denied) {\n return redirectStrategy.sendRedirect(exchange, redirectUri);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/SecurityWebFiltersConfigurer.java", "content": "package run.halo.app.security;\n\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.ANONYMOUS_AUTHENTICATION;\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.AUTHENTICATION;\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.FIRST;\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.FORM_LOGIN;\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.HTTP_BASIC;\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.LAST;\nimport static org.springframework.security.config.web.server.SecurityWebFiltersOrder.OAUTH2_AUTHORIZATION_CODE;\n\nimport lombok.Setter;\nimport org.pf4j.ExtensionPoint;\nimport org.springframework.core.annotation.AnnotationAwareOrderComparator;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.web.server.WebFilterChainProxy;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n@Component\n// Specific an order here to control the order or security configurer initialization\n@Order(100)\npublic class SecurityWebFiltersConfigurer implements SecurityConfigurer {\n\n private final ExtensionGetter extensionGetter;\n\n public SecurityWebFiltersConfigurer(ExtensionGetter extensionGetter) {\n this.extensionGetter = extensionGetter;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n http\n .addFilterAt(\n new SecurityWebFilterChainProxy(BeforeSecurityWebFilter.class),\n FIRST\n )\n .addFilterAt(\n new SecurityWebFilterChainProxy(HttpBasicSecurityWebFilter.class),\n HTTP_BASIC\n )\n .addFilterAt(\n new SecurityWebFilterChainProxy(FormLoginSecurityWebFilter.class),\n FORM_LOGIN\n )\n .addFilterAt(\n new SecurityWebFilterChainProxy(AuthenticationSecurityWebFilter.class),\n AUTHENTICATION\n )\n .addFilterAt(\n new SecurityWebFilterChainProxy(AnonymousAuthenticationSecurityWebFilter.class),\n ANONYMOUS_AUTHENTICATION\n )\n .addFilterAt(\n new SecurityWebFilterChainProxy(OAuth2AuthorizationCodeSecurityWebFilter.class),\n OAUTH2_AUTHORIZATION_CODE\n )\n .addFilterAt(\n new SecurityWebFilterChainProxy(AfterSecurityWebFilter.class),\n LAST\n )\n ;\n }\n\n public class SecurityWebFilterChainProxy implements WebFilter {\n\n @Setter\n private WebFilterChainProxy.WebFilterChainDecorator filterChainDecorator;\n\n private final Class extensionPointClass;\n\n public SecurityWebFilterChainProxy(Class extensionPointClass) {\n this.extensionPointClass = extensionPointClass;\n this.filterChainDecorator = new WebFilterChainProxy.DefaultWebFilterChainDecorator();\n }\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n return extensionGetter.getExtensions(this.extensionPointClass)\n .sort(AnnotationAwareOrderComparator.INSTANCE)\n .cast(WebFilter.class)\n .collectList()\n .map(filters -> filterChainDecorator.decorate(chain, filters))\n .flatMap(decoratedChain -> decoratedChain.filter(exchange));\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/SuperAdminInitializer.java", "content": "package run.halo.app.security;\n\nimport lombok.Builder;\nimport lombok.Data;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n/**\n * Super admin initializer.\n *\n * @author guqing\n * @since 2.9.0\n */\npublic interface SuperAdminInitializer {\n\n String SUPER_ROLE_NAME = AuthorityUtils.SUPER_ROLE_NAME;\n\n /**\n * Initialize super admin.\n *\n * @param param super admin initialization param\n */\n Mono initialize(InitializationParam param);\n\n @Data\n @Builder\n class InitializationParam {\n private String username;\n private String password;\n private String email;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/SecurityConfigurer.java", "content": "package run.halo.app.security.authentication;\n\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\n\npublic interface SecurityConfigurer {\n\n void configure(ServerHttpSecurity http);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/WebExchangeMatchers.java", "content": "package run.halo.app.security.authentication;\n\nimport java.util.Set;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.web.server.util.matcher.MediaTypeServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\n\npublic enum WebExchangeMatchers {\n ;\n\n public static ServerWebExchangeMatcher ignoringMediaTypeAll(MediaType... matchingMediaTypes) {\n var matcher = new MediaTypeServerWebExchangeMatcher(matchingMediaTypes);\n matcher.setIgnoredMediaTypes(Set.of(MediaType.ALL));\n return matcher;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/exception/TooManyRequestsException.java", "content": "package run.halo.app.security.authentication.exception;\n\nimport org.springframework.lang.Nullable;\nimport org.springframework.security.core.AuthenticationException;\nimport run.halo.app.infra.exception.RateLimitExceededException;\n\n/**\n * Too many requests exception while authenticating. Because\n * {@link RateLimitExceededException} is not a subclass of\n * {@link AuthenticationException}, we need to create a new exception class to map it.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class TooManyRequestsException extends AuthenticationException {\n\n public TooManyRequestsException(@Nullable Throwable throwable) {\n super(\"Too many requests.\", throwable);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/exception/TwoFactorAuthException.java", "content": "package run.halo.app.security.authentication.exception;\n\nimport org.springframework.security.core.AuthenticationException;\n\npublic class TwoFactorAuthException extends AuthenticationException {\n\n public TwoFactorAuthException(String msg, Throwable cause) {\n super(msg, cause);\n }\n\n public TwoFactorAuthException(String msg) {\n super(msg);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/impl/RsaKeyService.java", "content": "package run.halo.app.security.authentication.impl;\n\nimport static com.nimbusds.jose.jwk.KeyOperation.SIGN;\nimport static com.nimbusds.jose.jwk.KeyOperation.VERIFY;\nimport static java.nio.file.StandardOpenOption.TRUNCATE_EXISTING;\n\nimport com.nimbusds.jose.JOSEException;\nimport com.nimbusds.jose.JWSAlgorithm;\nimport com.nimbusds.jose.jwk.JWK;\nimport com.nimbusds.jose.jwk.KeyUse;\nimport com.nimbusds.jose.jwk.RSAKey;\nimport com.nimbusds.jose.jwk.gen.RSAKeyGenerator;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.security.InvalidKeyException;\nimport java.security.KeyFactory;\nimport java.security.KeyPair;\nimport java.security.MessageDigest;\nimport java.security.NoSuchAlgorithmException;\nimport java.security.PublicKey;\nimport java.security.interfaces.RSAPublicKey;\nimport java.security.spec.InvalidKeySpecException;\nimport java.security.spec.PKCS8EncodedKeySpec;\nimport java.security.spec.X509EncodedKeySpec;\nimport java.util.Set;\nimport javax.crypto.BadPaddingException;\nimport javax.crypto.Cipher;\nimport javax.crypto.IllegalBlockSizeException;\nimport javax.crypto.NoSuchPaddingException;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.security.crypto.codec.Hex;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.login.InvalidEncryptedMessageException;\n\n@Slf4j\npublic class RsaKeyService implements CryptoService, InitializingBean {\n\n public static final String TRANSFORMATION = \"RSA/ECB/PKCS1Padding\";\n\n public static final String ALGORITHM = \"RSA\";\n\n private final Path keysRoot;\n\n private KeyPair keyPair;\n\n private String keyId;\n\n private JWK jwk;\n\n public RsaKeyService(Path dir) {\n this.keysRoot = dir;\n }\n\n @Override\n public void afterPropertiesSet() throws JOSEException {\n this.keyPair = this.getRsaKeyPairOrCreate();\n this.keyId = sha256(keyPair.getPrivate().getEncoded());\n this.jwk = new RSAKey.Builder((RSAPublicKey) keyPair.getPublic())\n .privateKey(keyPair.getPrivate())\n .keyUse(KeyUse.SIGNATURE)\n .keyOperations(Set.of(SIGN, VERIFY))\n .keyIDFromThumbprint()\n .algorithm(JWSAlgorithm.RS256)\n .build();\n }\n\n private KeyPair getRsaKeyPairOrCreate() {\n var privKeyPath = keysRoot.resolve(\"pat_id_rsa\");\n var pubKeyPath = keysRoot.resolve(\"pat_id_rsa.pub\");\n try {\n if (Files.exists(privKeyPath) && Files.exists(pubKeyPath)) {\n log.debug(\"Skip initializing RSA Keys for PAT due to existence.\");\n\n var keyFactory = KeyFactory.getInstance(ALGORITHM);\n\n var privKeyBytes = Files.readAllBytes(privKeyPath);\n var privKeySpec = new PKCS8EncodedKeySpec(privKeyBytes);\n var privKey = keyFactory.generatePrivate(privKeySpec);\n\n var pubKeyBytes = Files.readAllBytes(pubKeyPath);\n var pubKeySpec = new X509EncodedKeySpec(pubKeyBytes);\n var pubKey = keyFactory.generatePublic(pubKeySpec);\n\n return new KeyPair(pubKey, privKey);\n }\n\n if (Files.notExists(keysRoot)) {\n Files.createDirectories(keysRoot);\n }\n Files.createFile(privKeyPath);\n Files.createFile(pubKeyPath);\n\n log.info(\"Generating RSA keys for PAT.\");\n var rsaKey = new RSAKeyGenerator(4096).generate();\n var pubKey = rsaKey.toRSAPublicKey();\n var privKey = rsaKey.toRSAPrivateKey();\n Files.write(privKeyPath, privKey.getEncoded(), TRUNCATE_EXISTING);\n Files.write(pubKeyPath, pubKey.getEncoded(), TRUNCATE_EXISTING);\n log.info(\"Wrote RSA keys for PAT into {} and {}\", privKeyPath, pubKeyPath);\n return new KeyPair(pubKey, privKey);\n } catch (JOSEException | IOException\n | InvalidKeySpecException | NoSuchAlgorithmException e) {\n throw new RuntimeException(\"Failed to generate or read RSA key pair\", e);\n }\n }\n\n @Override\n public Mono decrypt(byte[] encryptedMessage) {\n return Mono.just(this.keyPair)\n .map(KeyPair::getPrivate)\n .flatMap(privateKey -> {\n try {\n var cipher = Cipher.getInstance(TRANSFORMATION);\n cipher.init(Cipher.DECRYPT_MODE, privateKey);\n return Mono.just(cipher.doFinal(encryptedMessage));\n } catch (NoSuchAlgorithmException\n | NoSuchPaddingException\n | InvalidKeyException e) {\n return Mono.error(new RuntimeException(\n \"Failed to read private key or the key was invalid.\", e\n ));\n } catch (IllegalBlockSizeException | BadPaddingException e) {\n return Mono.error(new InvalidEncryptedMessageException(\n \"Invalid encrypted message.\"\n ));\n }\n })\n .subscribeOn(Schedulers.boundedElastic());\n }\n\n @Override\n public Mono readPublicKey() {\n return Mono.just(keyPair)\n .map(KeyPair::getPublic)\n .map(PublicKey::getEncoded);\n }\n\n @Override\n public String getKeyId() {\n return this.keyId;\n }\n\n @Override\n public JWK getJwk() {\n return this.jwk;\n }\n\n private static String sha256(byte[] data) {\n try {\n var md = MessageDigest.getInstance(\"SHA-256\");\n return new String(Hex.encode(md.digest(data)));\n } catch (NoSuchAlgorithmException e) {\n // should never happen\n throw new RuntimeException(\"Cannot obtain SHA-256 algorithm for message digest.\", e);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/HaloUser.java", "content": "package run.halo.app.security.authentication.login;\n\nimport java.util.Collection;\nimport java.util.Objects;\nimport org.springframework.security.core.CredentialsContainer;\nimport org.springframework.security.core.GrantedAuthority;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport org.springframework.util.Assert;\nimport run.halo.app.security.HaloUserDetails;\n\npublic class HaloUser implements HaloUserDetails, CredentialsContainer {\n\n private final UserDetails delegate;\n\n private final boolean twoFactorAuthEnabled;\n\n private String totpEncryptedSecret;\n\n public HaloUser(UserDetails delegate,\n boolean twoFactorAuthEnabled,\n String totpEncryptedSecret) {\n Assert.notNull(delegate, \"Delegate user must not be null\");\n this.delegate = delegate;\n this.twoFactorAuthEnabled = twoFactorAuthEnabled;\n this.totpEncryptedSecret = totpEncryptedSecret;\n }\n\n @Override\n public Collection getAuthorities() {\n return delegate.getAuthorities();\n }\n\n @Override\n public String getPassword() {\n return delegate.getPassword();\n }\n\n @Override\n public String getUsername() {\n return delegate.getUsername();\n }\n\n @Override\n public boolean isAccountNonExpired() {\n return delegate.isAccountNonExpired();\n }\n\n @Override\n public boolean isAccountNonLocked() {\n return delegate.isAccountNonLocked();\n }\n\n @Override\n public boolean isCredentialsNonExpired() {\n return delegate.isCredentialsNonExpired();\n }\n\n @Override\n public boolean isEnabled() {\n return delegate.isEnabled();\n }\n\n @Override\n public void eraseCredentials() {\n if (delegate instanceof CredentialsContainer container) {\n container.eraseCredentials();\n }\n this.totpEncryptedSecret = null;\n }\n\n @Override\n public boolean equals(Object obj) {\n if (obj instanceof HaloUser user) {\n return Objects.equals(this.delegate, user.delegate);\n }\n return false;\n }\n\n @Override\n public int hashCode() {\n return this.delegate.hashCode();\n }\n\n @Override\n public boolean isTwoFactorAuthEnabled() {\n return this.twoFactorAuthEnabled;\n }\n\n @Override\n public String getTotpEncryptedSecret() {\n return this.totpEncryptedSecret;\n }\n\n public static class Builder {\n\n private final UserDetails user;\n\n private boolean twoFactorAuthEnabled;\n\n private String totpEncryptedSecret;\n\n public Builder(UserDetails user) {\n this.user = user;\n }\n\n public Builder twoFactorAuthEnabled(boolean twoFactorAuthEnabled) {\n this.twoFactorAuthEnabled = twoFactorAuthEnabled;\n return this;\n }\n\n public Builder totpEncryptedSecret(String totpEncryptedSecret) {\n this.totpEncryptedSecret = totpEncryptedSecret;\n return this;\n }\n\n public HaloUserDetails build() {\n return new HaloUser(user, twoFactorAuthEnabled, totpEncryptedSecret);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/InvalidEncryptedMessageException.java", "content": "package run.halo.app.security.authentication.login;\n\n/**\n * InvalidEncryptedMessageException indicates the encrypted message is invalid.\n *\n * @author johnniang\n */\npublic class InvalidEncryptedMessageException extends RuntimeException {\n\n public InvalidEncryptedMessageException(String message) {\n super(message);\n }\n\n public InvalidEncryptedMessageException(String message, Throwable cause) {\n super(message, cause);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/LoginAuthenticationConverter.java", "content": "package run.halo.app.security.authentication.login;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\n\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport io.github.resilience4j.ratelimiter.RequestNotPermitted;\nimport io.github.resilience4j.reactor.ratelimiter.operator.RateLimiterOperator;\nimport java.util.Base64;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.security.authentication.UsernamePasswordAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.web.server.authentication.ServerFormLoginAuthenticationConverter;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.utils.IpAddressUtils;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.exception.TooManyRequestsException;\n\n@Slf4j\npublic class LoginAuthenticationConverter extends ServerFormLoginAuthenticationConverter {\n\n private final CryptoService cryptoService;\n\n private final RateLimiterRegistry rateLimiterRegistry;\n\n public LoginAuthenticationConverter(CryptoService cryptoService,\n RateLimiterRegistry rateLimiterRegistry) {\n this.cryptoService = cryptoService;\n this.rateLimiterRegistry = rateLimiterRegistry;\n }\n\n @Override\n public Mono convert(ServerWebExchange exchange) {\n return super.convert(exchange)\n // validate the password\n .flatMap(token -> {\n if (token.getCredentials() == null) {\n return Mono.error(new BadCredentialsException(\"Empty credentials.\"));\n }\n var credentials = (String) token.getCredentials();\n byte[] credentialsBytes;\n try {\n credentialsBytes = Base64.getDecoder().decode(credentials);\n } catch (IllegalArgumentException e) {\n // the credentials are not in valid Base64 scheme\n return Mono.error(new BadCredentialsException(\"Invalid Base64 scheme.\"));\n }\n return cryptoService.decrypt(credentialsBytes)\n .onErrorMap(InvalidEncryptedMessageException.class,\n error -> new BadCredentialsException(\"Invalid credential.\", error))\n .map(decryptedCredentials -> new UsernamePasswordAuthenticationToken(\n token.getPrincipal(),\n new String(decryptedCredentials, UTF_8)));\n })\n .transformDeferred(createIpBasedRateLimiter(exchange))\n // We have to remap the exception to an AuthenticationException\n // for using in failure handler\n .onErrorMap(RequestNotPermitted.class, TooManyRequestsException::new);\n }\n\n private RateLimiterOperator createIpBasedRateLimiter(ServerWebExchange exchange) {\n var clientIp = IpAddressUtils.getClientIp(exchange.getRequest());\n var rateLimiter = rateLimiterRegistry.rateLimiter(\"authentication-from-ip-\" + clientIp,\n \"authentication\");\n if (log.isDebugEnabled()) {\n var metrics = rateLimiter.getMetrics();\n log.debug(\n \"Authentication with Rate Limiter: {}, available permissions: {}, number of \"\n + \"waiting threads: {}\",\n rateLimiter, metrics.getAvailablePermissions(),\n metrics.getNumberOfWaitingThreads());\n }\n return RateLimiterOperator.of(rateLimiter);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/LoginSecurityConfigurer.java", "content": "package run.halo.app.security.authentication.login;\n\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport io.micrometer.observation.ObservationRegistry;\nimport org.springframework.context.MessageSource;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.security.authentication.ObservationReactiveAuthenticationManager;\nimport org.springframework.security.authentication.ReactiveAuthenticationManager;\nimport org.springframework.security.authentication.UserDetailsRepositoryReactiveAuthenticationManager;\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsPasswordService;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.AuthenticationWebFilter;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.security.HaloUserDetails;\nimport run.halo.app.security.LoginHandlerEnhancer;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\n@Component\n@Order(0)\npublic class LoginSecurityConfigurer implements SecurityConfigurer {\n\n private final ObservationRegistry observationRegistry;\n\n private final ReactiveUserDetailsService userDetailsService;\n\n private final ReactiveUserDetailsPasswordService passwordService;\n\n private final PasswordEncoder passwordEncoder;\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n private final CryptoService cryptoService;\n\n private final ExtensionGetter extensionGetter;\n private final ServerResponse.Context context;\n private final MessageSource messageSource;\n private final RateLimiterRegistry rateLimiterRegistry;\n\n private final LoginHandlerEnhancer loginHandlerEnhancer;\n\n public LoginSecurityConfigurer(ObservationRegistry observationRegistry,\n ReactiveUserDetailsService userDetailsService,\n ReactiveUserDetailsPasswordService passwordService, PasswordEncoder passwordEncoder,\n ServerSecurityContextRepository securityContextRepository, CryptoService cryptoService,\n ExtensionGetter extensionGetter, ServerResponse.Context context,\n MessageSource messageSource, RateLimiterRegistry rateLimiterRegistry,\n LoginHandlerEnhancer loginHandlerEnhancer) {\n this.observationRegistry = observationRegistry;\n this.userDetailsService = userDetailsService;\n this.passwordService = passwordService;\n this.passwordEncoder = passwordEncoder;\n this.securityContextRepository = securityContextRepository;\n this.cryptoService = cryptoService;\n this.extensionGetter = extensionGetter;\n this.context = context;\n this.messageSource = messageSource;\n this.rateLimiterRegistry = rateLimiterRegistry;\n this.loginHandlerEnhancer = loginHandlerEnhancer;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var filter = new AuthenticationWebFilter(authenticationManager()) {\n @Override\n protected Mono onAuthenticationSuccess(Authentication authentication,\n WebFilterExchange webFilterExchange) {\n // check if 2FA is enabled after authenticating successfully.\n if (authentication.getPrincipal() instanceof HaloUserDetails userDetails\n && userDetails.isTwoFactorAuthEnabled()) {\n authentication = new TwoFactorAuthentication(authentication);\n }\n return super.onAuthenticationSuccess(authentication, webFilterExchange);\n }\n };\n var requiresMatcher = ServerWebExchangeMatchers.pathMatchers(HttpMethod.POST, \"/login\");\n var handler = new UsernamePasswordHandler(context, messageSource, loginHandlerEnhancer);\n var authConverter = new LoginAuthenticationConverter(cryptoService, rateLimiterRegistry);\n filter.setRequiresAuthenticationMatcher(requiresMatcher);\n filter.setAuthenticationFailureHandler(handler);\n filter.setAuthenticationSuccessHandler(handler);\n filter.setServerAuthenticationConverter(authConverter);\n filter.setSecurityContextRepository(securityContextRepository);\n\n http.addFilterAt(filter, SecurityWebFiltersOrder.FORM_LOGIN);\n }\n\n ReactiveAuthenticationManager authenticationManager() {\n var manager = new UsernamePasswordDelegatingAuthenticationManager(extensionGetter,\n defaultAuthenticationManager());\n return new ObservationReactiveAuthenticationManager(observationRegistry, manager);\n }\n\n ReactiveAuthenticationManager defaultAuthenticationManager() {\n var manager = new UserDetailsRepositoryReactiveAuthenticationManager(userDetailsService);\n manager.setPasswordEncoder(passwordEncoder);\n manager.setUserDetailsPasswordService(passwordService);\n return manager;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/PublicKeyRouteBuilder.java", "content": "package run.halo.app.security.authentication.login;\n\nimport java.util.Base64;\nimport lombok.Data;\nimport org.springdoc.core.fn.builders.apiresponse.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.security.authentication.CryptoService;\n\npublic class PublicKeyRouteBuilder {\n\n private final CryptoService cryptoService;\n\n public PublicKeyRouteBuilder(CryptoService cryptoService) {\n this.cryptoService = cryptoService;\n }\n\n /**\n * Builds public key router function.\n *\n * @return public key router function.\n */\n public RouterFunction build() {\n return SpringdocRouteBuilder.route()\n .GET(\"/login/public-key\", request -> cryptoService.readPublicKey()\n .flatMap(publicKey -> {\n var base64Format = Base64.getEncoder().encodeToString(publicKey);\n var response = new PublicKeyResponse();\n response.setBase64Format(base64Format);\n return ServerResponse.ok()\n .bodyValue(response);\n }),\n builder -> builder.operationId(\"GetPublicKey\")\n .description(\"Read public key for encrypting password.\")\n .tag(\"Login\")\n .response(Builder.responseBuilder()\n .implementation(PublicKeyResponse.class))).build();\n }\n\n @Data\n public static class PublicKeyResponse {\n\n private String base64Format;\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/UsernamePasswordDelegatingAuthenticationManager.java", "content": "package run.halo.app.security.authentication.login;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.authentication.ReactiveAuthenticationManager;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.AuthenticationException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@Slf4j\npublic class UsernamePasswordDelegatingAuthenticationManager\n implements ReactiveAuthenticationManager {\n\n private final ExtensionGetter extensionGetter;\n\n private final ReactiveAuthenticationManager defaultAuthenticationManager;\n\n public UsernamePasswordDelegatingAuthenticationManager(ExtensionGetter extensionGetter,\n ReactiveAuthenticationManager defaultAuthenticationManager) {\n this.extensionGetter = extensionGetter;\n this.defaultAuthenticationManager = defaultAuthenticationManager;\n }\n\n @Override\n public Mono authenticate(Authentication authentication) {\n return extensionGetter\n .getEnabledExtensions(UsernamePasswordAuthenticationManager.class)\n .next()\n .flatMap(authenticationManager -> authenticationManager.authenticate(authentication)\n .doOnError(t -> log.error(\n \"failed to authenticate with {}, fallback to default username password \"\n + \"authentication.\", authenticationManager.getClass(), t)\n )\n .onErrorResume(\n t -> !(t instanceof AuthenticationException),\n t -> Mono.empty()\n )\n )\n .switchIfEmpty(\n Mono.defer(() -> defaultAuthenticationManager.authenticate(authentication))\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/login/UsernamePasswordHandler.java", "content": "package run.halo.app.security.authentication.login;\n\nimport static org.springframework.http.HttpStatus.UNAUTHORIZED;\nimport static org.springframework.http.MediaType.APPLICATION_JSON;\nimport static run.halo.app.infra.exception.Exceptions.createErrorResponse;\nimport static run.halo.app.security.authentication.WebExchangeMatchers.ignoringMediaTypeAll;\n\nimport java.net.URI;\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.MessageSource;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.security.authentication.DisabledException;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.AuthenticationException;\nimport org.springframework.security.core.CredentialsContainer;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.RedirectServerAuthenticationSuccessHandler;\nimport org.springframework.security.web.server.authentication.ServerAuthenticationFailureHandler;\nimport org.springframework.security.web.server.authentication.ServerAuthenticationSuccessHandler;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.web.ErrorResponse;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.LoginHandlerEnhancer;\nimport run.halo.app.security.authentication.exception.TooManyRequestsException;\nimport run.halo.app.security.authentication.rememberme.RememberMeRequestCache;\nimport run.halo.app.security.authentication.rememberme.WebSessionRememberMeRequestCache;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\n@Slf4j\npublic class UsernamePasswordHandler implements ServerAuthenticationSuccessHandler,\n ServerAuthenticationFailureHandler {\n\n private final ServerResponse.Context context;\n\n private final MessageSource messageSource;\n\n private final LoginHandlerEnhancer loginHandlerEnhancer;\n\n private final ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n @Setter\n private RememberMeRequestCache rememberMeRequestCache = new WebSessionRememberMeRequestCache();\n\n private final ServerAuthenticationSuccessHandler defaultSuccessHandler =\n new RedirectServerAuthenticationSuccessHandler(\"/uc\");\n\n public UsernamePasswordHandler(ServerResponse.Context context, MessageSource messageSource,\n LoginHandlerEnhancer loginHandlerEnhancer) {\n this.context = context;\n this.messageSource = messageSource;\n this.loginHandlerEnhancer = loginHandlerEnhancer;\n }\n\n @Override\n public Mono onAuthenticationFailure(WebFilterExchange webFilterExchange,\n AuthenticationException exception) {\n var exchange = webFilterExchange.getExchange();\n return loginHandlerEnhancer.onLoginFailure(exchange, exception)\n .then(ignoringMediaTypeAll(APPLICATION_JSON)\n .matches(exchange)\n .filter(ServerWebExchangeMatcher.MatchResult::isMatch)\n .switchIfEmpty(Mono.defer(\n () -> {\n var location = URI.create(\"/login?error&method=local\");\n if (exception instanceof DisabledException) {\n location = URI.create(\"/login?error=account-disabled&method=local\");\n }\n if (exception instanceof BadCredentialsException) {\n location = URI.create(\"/login?error=invalid-credential&method=local\");\n }\n if (exception instanceof TooManyRequestsException) {\n location = URI.create(\"/login?error=rate-limit-exceeded&method=local\");\n }\n return redirectStrategy.sendRedirect(exchange, location);\n }).then(Mono.empty())\n )\n .flatMap(matchResult -> handleAuthenticationException(exception, exchange)));\n }\n\n @Override\n public Mono onAuthenticationSuccess(WebFilterExchange webFilterExchange,\n Authentication authentication) {\n if (authentication instanceof TwoFactorAuthentication) {\n return rememberMeRequestCache.saveRememberMe(webFilterExchange.getExchange())\n // Do not use RedirectServerAuthenticationSuccessHandler to redirect\n // because it will use request cache to redirect\n .then(redirectStrategy.sendRedirect(webFilterExchange.getExchange(),\n URI.create(\"/challenges/two-factor/totp\"))\n );\n }\n\n if (authentication instanceof CredentialsContainer container) {\n container.eraseCredentials();\n }\n\n ServerWebExchangeMatcher xhrMatcher = exchange -> {\n if (exchange.getRequest().getHeaders().getOrEmpty(\"X-Requested-With\")\n .contains(\"XMLHttpRequest\")) {\n return ServerWebExchangeMatcher.MatchResult.match();\n }\n return ServerWebExchangeMatcher.MatchResult.notMatch();\n };\n\n var exchange = webFilterExchange.getExchange();\n return loginHandlerEnhancer.onLoginSuccess(webFilterExchange.getExchange(), authentication)\n .then(xhrMatcher.matches(exchange)\n .filter(ServerWebExchangeMatcher.MatchResult::isMatch)\n .switchIfEmpty(Mono.defer(\n () -> defaultSuccessHandler.onAuthenticationSuccess(webFilterExchange,\n authentication)\n .then(Mono.empty())))\n .flatMap(isXhr -> ServerResponse.ok()\n .bodyValue(authentication.getPrincipal())\n .flatMap(response -> response.writeTo(exchange, context))));\n }\n\n private Mono handleAuthenticationException(Throwable exception,\n ServerWebExchange exchange) {\n var errorResponse = createErrorResponse(exception, UNAUTHORIZED, exchange, messageSource);\n return writeErrorResponse(errorResponse, exchange);\n }\n\n private Mono writeErrorResponse(ErrorResponse errorResponse,\n ServerWebExchange exchange) {\n return ServerResponse.status(errorResponse.getStatusCode())\n .contentType(APPLICATION_JSON)\n .bodyValue(errorResponse.getBody())\n .flatMap(response -> response.writeTo(exchange, context));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/oauth2/DefaultOAuth2LoginHandlerEnhancer.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.UserConnectionService;\n\n/**\n * Default implementation of {@link OAuth2LoginHandlerEnhancer}.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Slf4j\n@Component\npublic class DefaultOAuth2LoginHandlerEnhancer implements OAuth2LoginHandlerEnhancer {\n\n private final UserConnectionService connectionService;\n\n @Setter\n private OAuth2AuthenticationTokenCache oauth2TokenCache =\n new WebSessionOAuth2AuthenticationTokenCache();\n\n private final AuthenticationTrustResolver authenticationTrustResolver =\n new AuthenticationTrustResolverImpl();\n\n public DefaultOAuth2LoginHandlerEnhancer(UserConnectionService connectionService) {\n this.connectionService = connectionService;\n }\n\n @Override\n public Mono loginSuccess(ServerWebExchange exchange, Authentication authentication) {\n if (!authenticationTrustResolver.isFullyAuthenticated(authentication)) {\n // Should never happen\n // Remove token directly if not fully authenticated\n return oauth2TokenCache.removeToken(exchange).then();\n }\n return oauth2TokenCache.getToken(exchange)\n .flatMap(oauth2Token -> {\n var oauth2User = oauth2Token.getPrincipal();\n var username = authentication.getName();\n var registrationId = oauth2Token.getAuthorizedClientRegistrationId();\n return connectionService.updateUserConnectionIfPresent(registrationId, oauth2User)\n .doOnNext(connection -> {\n if (log.isDebugEnabled()) {\n log.debug(\n \"User connection already exists, skip creating. connection: [{}]\",\n connection\n );\n }\n })\n .switchIfEmpty(Mono.defer(() -> connectionService.createUserConnection(\n username,\n registrationId,\n oauth2User\n )))\n .then(oauth2TokenCache.removeToken(exchange));\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/oauth2/MapOAuth2AuthenticationFilter.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport static run.halo.app.security.authentication.oauth2.HaloOAuth2AuthenticationToken.authenticated;\n\nimport java.net.URI;\nimport lombok.Setter;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.core.context.SecurityContextImpl;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.oauth2.client.authentication.OAuth2AuthenticationToken;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.logout.SecurityContextServerLogoutHandler;\nimport org.springframework.security.web.server.authentication.logout.ServerLogoutHandler;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.UserConnectionService;\nimport run.halo.app.security.LoginHandlerEnhancer;\n\n/**\n * A filter to map OAuth2 authentication to authenticated user.\n *\n * @author johnniang\n * @since 2.20.0\n */\nclass MapOAuth2AuthenticationFilter implements WebFilter {\n\n private static final String PRE_AUTHENTICATION =\n MapOAuth2AuthenticationFilter.class.getName() + \".PRE_AUTHENTICATION\";\n\n private final UserConnectionService connectionService;\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n @Setter\n private OAuth2AuthenticationTokenCache authenticationCache =\n new WebSessionOAuth2AuthenticationTokenCache();\n\n private final ReactiveUserDetailsService userDetailsService;\n\n private final ServerLogoutHandler logoutHandler;\n\n private final LoginHandlerEnhancer loginHandlerEnhancer;\n\n private final ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n @Setter\n private AuthenticationTrustResolver authenticationTrustResolver\n = new AuthenticationTrustResolverImpl();\n\n public MapOAuth2AuthenticationFilter(\n ServerSecurityContextRepository securityContextRepository,\n UserConnectionService connectionService,\n ReactiveUserDetailsService userDetailsService,\n LoginHandlerEnhancer loginHandlerEnhancer) {\n this.connectionService = connectionService;\n this.securityContextRepository = securityContextRepository;\n this.userDetailsService = userDetailsService;\n this.loginHandlerEnhancer = loginHandlerEnhancer;\n var logoutHandler = new SecurityContextServerLogoutHandler();\n logoutHandler.setSecurityContextRepository(securityContextRepository);\n this.logoutHandler = logoutHandler;\n }\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(authenticationTrustResolver::isAuthenticated)\n .doOnNext(\n // cache the pre-authentication\n authentication -> exchange.getAttributes().put(PRE_AUTHENTICATION, authentication)\n )\n .then(chain.filter(exchange))\n .then(Mono.defer(() -> ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(OAuth2AuthenticationToken.class::isInstance)\n .cast(OAuth2AuthenticationToken.class)\n .flatMap(oauth2Token -> {\n var registrationId = oauth2Token.getAuthorizedClientRegistrationId();\n var oauth2User = oauth2Token.getPrincipal();\n // check the connection\n return connectionService.updateUserConnectionIfPresent(\n registrationId, oauth2User\n )\n .switchIfEmpty(Mono.defer(() -> {\n var preAuthenticationObject = exchange.getAttribute(PRE_AUTHENTICATION);\n if (preAuthenticationObject instanceof Authentication preAuth\n && authenticationTrustResolver.isAuthenticated(preAuth)) {\n // check the authentication again\n // try to bind the user automatically\n return connectionService.createUserConnection(\n preAuth.getName(), registrationId, oauth2User\n );\n }\n // save the OAuth2Authentication into session\n return authenticationCache.saveToken(exchange, oauth2Token)\n .then(Mono.defer(() -> {\n var webFilterExchange = new WebFilterExchange(exchange, chain);\n // clear the security context\n return logoutHandler.logout(webFilterExchange, oauth2Token);\n }))\n .then(Mono.defer(() -> redirectStrategy.sendRedirect(exchange,\n URI.create(\"/login?oauth2_bind\")\n )))\n // skip handling\n .then(Mono.empty());\n }))\n // user bound and remap the authentication\n .flatMap(connection ->\n userDetailsService.findByUsername(connection.getSpec().getUsername())\n )\n .map(userDetails -> authenticated(userDetails, oauth2Token))\n .flatMap(haloOAuth2Token -> {\n var securityContext = new SecurityContextImpl(haloOAuth2Token);\n return securityContextRepository.save(exchange, securityContext)\n .then(\n loginHandlerEnhancer.onLoginSuccess(exchange, haloOAuth2Token)\n );\n // because this happens after the filter, there is no need to\n // write SecurityContext to the context\n });\n })\n .then())\n );\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/oauth2/OAuth2AuthenticationTokenCache.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport org.springframework.security.oauth2.client.authentication.OAuth2AuthenticationToken;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * OAuth2 authentication token cache. Saving OAuth2AuthenticationToken is mainly for further binding\n * to Halo user.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface OAuth2AuthenticationTokenCache {\n\n /**\n * Save OAuth2AuthenticationToken into cache.\n *\n * @param exchange Server web exchange\n * @param oauth2Token OAuth2AuthenticationToken\n * @return empty\n */\n Mono saveToken(ServerWebExchange exchange, OAuth2AuthenticationToken oauth2Token);\n\n /**\n * Get OAuth2AuthenticationToken from cache.\n *\n * @param exchange Server web exchange\n * @return an {@link OAuth2AuthenticationToken} if present, empty otherwise\n */\n Mono getToken(ServerWebExchange exchange);\n\n /**\n * Remove OAuth2AuthenticationToken from cache.\n *\n * @param exchange Server web exchange\n * @return empty\n */\n Mono removeToken(ServerWebExchange exchange);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/oauth2/OAuth2LoginHandlerEnhancer.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport org.springframework.security.core.Authentication;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * OAuth2 login handler enhancer.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface OAuth2LoginHandlerEnhancer {\n\n Mono loginSuccess(ServerWebExchange exchange, Authentication authentication);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/oauth2/OAuth2SecurityConfigurer.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport org.springframework.core.annotation.Order;\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.user.service.UserConnectionService;\nimport run.halo.app.security.LoginHandlerEnhancer;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n/**\n * OAuth2 security configurer.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\n@Order(0)\nclass OAuth2SecurityConfigurer implements SecurityConfigurer {\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n private final UserConnectionService connectionService;\n\n private final ReactiveUserDetailsService userDetailsService;\n\n private final LoginHandlerEnhancer loginHandlerEnhancer;\n\n public OAuth2SecurityConfigurer(ServerSecurityContextRepository securityContextRepository,\n UserConnectionService connectionService, ReactiveUserDetailsService userDetailsService,\n LoginHandlerEnhancer loginHandlerEnhancer) {\n this.securityContextRepository = securityContextRepository;\n this.connectionService = connectionService;\n this.userDetailsService = userDetailsService;\n this.loginHandlerEnhancer = loginHandlerEnhancer;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var mapOAuth2Filter = new MapOAuth2AuthenticationFilter(\n securityContextRepository, connectionService, userDetailsService, loginHandlerEnhancer\n );\n http.addFilterBefore(mapOAuth2Filter, SecurityWebFiltersOrder.AUTHENTICATION);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/oauth2/WebSessionOAuth2AuthenticationTokenCache.java", "content": "package run.halo.app.security.authentication.oauth2;\n\nimport org.springframework.security.oauth2.client.authentication.OAuth2AuthenticationToken;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * WebSession cache implementation of {@link OAuth2AuthenticationTokenCache}.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class WebSessionOAuth2AuthenticationTokenCache implements OAuth2AuthenticationTokenCache {\n\n private static final String SESSION_ATTRIBUTE_KEY =\n OAuth2AuthenticationTokenCache.class + \".OAUTH2_TOKEN\";\n\n @Override\n public Mono saveToken(ServerWebExchange exchange, OAuth2AuthenticationToken oauth2Token) {\n return exchange.getSession()\n .doOnNext(session -> {\n session.getAttributes().put(SESSION_ATTRIBUTE_KEY, oauth2Token);\n })\n .then();\n }\n\n @Override\n public Mono getToken(ServerWebExchange exchange) {\n return exchange.getSession()\n .mapNotNull(session -> session.getAttribute(SESSION_ATTRIBUTE_KEY))\n .filter(OAuth2AuthenticationToken.class::isInstance)\n .cast(OAuth2AuthenticationToken.class);\n }\n\n @Override\n public Mono removeToken(ServerWebExchange exchange) {\n return exchange.getSession()\n .doOnNext(session -> session.getAttributes().remove(SESSION_ATTRIBUTE_KEY))\n .then();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/pat/PatAuthenticationConverter.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport static run.halo.app.security.PersonalAccessToken.PAT_TOKEN_PREFIX;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.oauth2.server.resource.authentication.BearerTokenAuthenticationToken;\nimport org.springframework.security.oauth2.server.resource.web.server.authentication.ServerBearerTokenAuthenticationConverter;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * PAT authentication converter.\n *\n * @author johnniang\n * @since 2.20.4\n */\npublic class PatAuthenticationConverter extends ServerBearerTokenAuthenticationConverter {\n\n @Override\n public Mono convert(ServerWebExchange exchange) {\n return super.convert(exchange)\n .cast(BearerTokenAuthenticationToken.class)\n .map(BearerTokenAuthenticationToken::getToken)\n .filter(token -> StringUtils.startsWith(token, PAT_TOKEN_PREFIX))\n .map(token -> StringUtils.removeStart(token, PAT_TOKEN_PREFIX))\n .map(BearerTokenAuthenticationToken::new);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/pat/PatAuthenticationManager.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport static org.springframework.security.oauth2.jwt.NimbusReactiveJwtDecoder.withJwkSource;\nimport static run.halo.app.security.authorization.AuthorityUtils.ANONYMOUS_ROLE_NAME;\nimport static run.halo.app.security.authorization.AuthorityUtils.AUTHENTICATED_ROLE_NAME;\nimport static run.halo.app.security.authorization.AuthorityUtils.ROLE_PREFIX;\n\nimport com.nimbusds.jwt.JWTClaimNames;\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.Objects;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.security.authentication.DisabledException;\nimport org.springframework.security.authentication.ReactiveAuthenticationManager;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.authority.SimpleGrantedAuthority;\nimport org.springframework.security.oauth2.server.resource.InvalidBearerTokenException;\nimport org.springframework.security.oauth2.server.resource.authentication.JwtAuthenticationToken;\nimport org.springframework.security.oauth2.server.resource.authentication.JwtReactiveAuthenticationManager;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.security.PersonalAccessToken;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\nclass PatAuthenticationManager implements ReactiveAuthenticationManager {\n\n /**\n * Minimal duration gap of personal access token update.\n */\n private static final Duration MIN_UPDATE_GAP = Duration.ofMinutes(1);\n\n private final JwtReactiveAuthenticationManager delegate;\n\n private final ReactiveExtensionClient client;\n\n private final CryptoService cryptoService;\n\n private Clock clock;\n\n public PatAuthenticationManager(ReactiveExtensionClient client, CryptoService cryptoService) {\n this.client = client;\n this.cryptoService = cryptoService;\n this.delegate = getDelegate();\n this.clock = Clock.systemDefaultZone();\n }\n\n private JwtReactiveAuthenticationManager getDelegate() {\n var jwtDecoder = withJwkSource(signedJWT -> Flux.just(cryptoService.getJwk()))\n .build();\n return new JwtReactiveAuthenticationManager(jwtDecoder);\n }\n\n /**\n * Set new clock. Only for testing.\n *\n * @param clock new clock\n */\n void setClock(Clock clock) {\n this.clock = clock;\n }\n\n @Override\n public Mono authenticate(Authentication authentication) {\n return delegate.authenticate(authentication)\n .cast(JwtAuthenticationToken.class)\n .flatMap(this::checkAndRebuild);\n }\n\n private Mono checkAndRebuild(JwtAuthenticationToken jat) {\n var jwt = jat.getToken();\n var patName = jwt.getClaimAsString(\"pat_name\");\n var jwtId = jwt.getClaimAsString(JWTClaimNames.JWT_ID);\n if (patName == null || jwtId == null) {\n // Not a valid PAT\n return Mono.error(new InvalidBearerTokenException(\"Missing claim pat_name or jti\"));\n }\n return client.fetch(PersonalAccessToken.class, patName)\n .switchIfEmpty(\n Mono.error(() -> new DisabledException(\"Personal access token has been deleted.\"))\n )\n .flatMap(pat -> patChecks(pat, jwtId).and(updateLastUsed(patName)).thenReturn(pat))\n .map(pat -> {\n // Make sure the authorities modifiable\n var authorities = new ArrayList<>(jat.getAuthorities());\n authorities.add(new SimpleGrantedAuthority(ROLE_PREFIX + ANONYMOUS_ROLE_NAME));\n authorities.add(new SimpleGrantedAuthority(ROLE_PREFIX + AUTHENTICATED_ROLE_NAME));\n var roles = pat.getSpec().getRoles();\n if (roles != null) {\n roles.stream()\n .map(role -> AuthorityUtils.ROLE_PREFIX + role)\n .map(SimpleGrantedAuthority::new)\n .forEach(authorities::add);\n }\n return new JwtAuthenticationToken(jat.getToken(), authorities, jat.getName());\n });\n }\n\n private Mono updateLastUsed(String patName) {\n // we try our best to update the last used timestamp.\n\n // the now should be outside the retry cycle because we don't want a fresh timestamp at\n // every retry.\n var now = clock.instant();\n return Mono.defer(\n // we have to obtain a fresh PAT and retry the update.\n () -> client.fetch(PersonalAccessToken.class, patName)\n .filter(pat -> {\n var lastUsed = pat.getSpec().getLastUsed();\n if (lastUsed == null) {\n return true;\n }\n var diff = Duration.between(lastUsed, now);\n return !diff.minus(MIN_UPDATE_GAP).isNegative();\n })\n .doOnNext(pat -> pat.getSpec().setLastUsed(now))\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(3, Duration.ofMillis(50))\n .filter(OptimisticLockingFailureException.class::isInstance))\n .onErrorComplete()\n .then();\n }\n\n private Mono patChecks(PersonalAccessToken pat, String tokenId) {\n if (ExtensionUtil.isDeleted(pat)) {\n return Mono.error(\n new InvalidBearerTokenException(\"Personal access token is being deleted.\"));\n }\n var spec = pat.getSpec();\n if (!Objects.equals(spec.getTokenId(), tokenId)) {\n return Mono.error(new InvalidBearerTokenException(\n \"Token ID does not match the token ID of personal access token.\"));\n }\n if (spec.isRevoked()) {\n return Mono.error(new InvalidBearerTokenException(\"Token has been revoked.\"));\n }\n return Mono.empty();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/pat/PatEndpoint.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.webflux.core.fn.SpringdocRouteBuilder.route;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.security.PersonalAccessToken;\n\n@Component\nclass PatEndpoint implements CustomEndpoint {\n\n private final UserScopedPatHandler patHandler;\n\n public PatEndpoint(UserScopedPatHandler patHandler) {\n this.patHandler = patHandler;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = PersonalAccessToken.KIND + \"V1alpha1Uc\";\n return route().nest(path(\"/personalaccesstokens\"),\n () -> route()\n .POST(patHandler::create,\n builder -> builder\n .tag(tag)\n .operationId(\"GeneratePat\")\n .description(\"Generate a PAT.\")\n .requestBody(requestBodyBuilder()\n .required(true)\n .implementation(PersonalAccessToken.class))\n .response(responseBuilder().implementation(PersonalAccessToken.class))\n )\n .GET(patHandler::list,\n builder -> builder\n .tag(tag)\n .operationId(\"ObtainPats\")\n .description(\"Obtain PAT list.\")\n .response(responseBuilder()\n .implementationArray(PersonalAccessToken.class)\n )\n )\n .GET(\"/{name}\", patHandler::get,\n builder -> builder\n .tag(tag)\n .operationId(\"ObtainPat\")\n .description(\"Obtain a PAT.\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .required(true)\n .name(\"name\")))\n .PUT(\"/{name}/actions/revocation\",\n patHandler::revoke,\n builder -> builder.tag(tag)\n .operationId(\"RevokePat\")\n .description(\"Revoke a PAT\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .required(true)\n .name(\"name\"))\n )\n .PUT(\"/{name}/actions/restoration\",\n patHandler::restore,\n builder -> builder.tag(tag)\n .operationId(\"RestorePat\")\n .description(\"Restore a PAT.\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .required(true)\n .name(\"name\")\n )\n )\n .DELETE(\"/{name}\",\n patHandler::delete,\n builder -> builder.tag(tag)\n .operationId(\"DeletePat\")\n .description(\"Delete a PAT\")\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .required(true)\n .name(\"name\")\n ))\n .build()\n )\n .build();\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.security.halo.run/v1alpha1\");\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/pat/PatSecurityConfigurer.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport org.springframework.core.annotation.Order;\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.oauth2.server.resource.web.server.BearerTokenServerAuthenticationEntryPoint;\nimport org.springframework.security.web.server.authentication.AuthenticationWebFilter;\nimport org.springframework.security.web.server.authentication.ServerAuthenticationEntryPointFailureHandler;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n/**\n * PAT security configurer.\n *\n * @author johnniang\n * @since 2.20.4\n */\n@Component\n// Specific an order here to control the order or security configurer initialization\n@Order(0)\nclass PatSecurityConfigurer implements SecurityConfigurer {\n\n private final ReactiveExtensionClient client;\n\n private final CryptoService cryptoService;\n\n public PatSecurityConfigurer(ReactiveExtensionClient client, CryptoService cryptoService) {\n this.client = client;\n this.cryptoService = cryptoService;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var filter =\n new AuthenticationWebFilter(new PatAuthenticationManager(client, cryptoService));\n filter.setServerAuthenticationConverter(new PatAuthenticationConverter());\n var entryPoint = new BearerTokenServerAuthenticationEntryPoint();\n var failureHandler = new ServerAuthenticationEntryPointFailureHandler(entryPoint);\n filter.setAuthenticationFailureHandler(failureHandler);\n http.addFilterAt(filter, SecurityWebFiltersOrder.AUTHENTICATION);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/pat/UserScopedPatHandler.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\n\npublic interface UserScopedPatHandler {\n\n Mono create(ServerRequest request);\n\n Mono list(ServerRequest request);\n\n Mono get(ServerRequest request);\n\n Mono revoke(ServerRequest request);\n\n Mono delete(ServerRequest request);\n\n Mono restore(ServerRequest request);\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/pat/UserScopedPatHandlerImpl.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport static run.halo.app.extension.Comparators.compareCreationTimestamp;\n\nimport java.util.HashMap;\nimport java.util.Objects;\nimport java.util.function.Predicate;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Service;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.PatService;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.exception.AccessDeniedException;\nimport run.halo.app.security.PersonalAccessToken;\n\n@Service\nclass UserScopedPatHandlerImpl implements UserScopedPatHandler {\n\n private static final String ACCESS_TOKEN_ANNO_NAME = \"security.halo.run/access-token\";\n\n private final ReactiveExtensionClient client;\n\n private final PatService patService;\n\n private final AuthenticationTrustResolver authTrustResolver =\n new AuthenticationTrustResolverImpl();\n\n public UserScopedPatHandlerImpl(ReactiveExtensionClient client,\n PatService patService) {\n this.client = client;\n this.patService = patService;\n }\n\n private Mono mustBeAuthenticated(Mono authentication) {\n return authentication.filter(authTrustResolver::isAuthenticated)\n // Non-username-password authentication could not access the API at any time.\n .switchIfEmpty(Mono.error(AccessDeniedException::new));\n }\n\n @Override\n public Mono create(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .transform(this::mustBeAuthenticated)\n .flatMap(auth -> request.bodyToMono(PersonalAccessToken.class))\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Missing request body.\")))\n .flatMap(patService::create)\n .flatMap(pat -> patService.generateToken(pat)\n .doOnNext(token -> {\n if (pat.getMetadata().getAnnotations() == null) {\n pat.getMetadata().setAnnotations(new HashMap<>());\n }\n pat.getMetadata().getAnnotations()\n .put(ACCESS_TOKEN_ANNO_NAME, token);\n })\n .thenReturn(pat)\n )\n .flatMap(pat -> ServerResponse.ok().bodyValue(pat));\n }\n\n @Override\n public Mono list(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .flatMap(auth -> {\n Predicate predicate =\n pat -> Objects.equals(auth.getName(), pat.getSpec().getUsername());\n var pats = client.list(PersonalAccessToken.class, predicate,\n compareCreationTimestamp(false));\n return ServerResponse.ok().body(pats, PersonalAccessToken.class);\n });\n }\n\n @Override\n public Mono get(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .flatMap(auth -> {\n var name = request.pathVariable(\"name\");\n return patService.get(name, auth.getName());\n })\n .flatMap(pat -> ServerResponse.ok().bodyValue(pat));\n }\n\n @Override\n public Mono revoke(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .flatMap(auth -> {\n var name = request.pathVariable(\"name\");\n return patService.revoke(name, auth.getName());\n })\n .flatMap(revokedPat -> ServerResponse.ok().bodyValue(revokedPat));\n }\n\n @Override\n public Mono delete(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .flatMap(auth -> {\n var name = request.pathVariable(\"name\");\n return patService.delete(name, auth.getName());\n })\n .flatMap(pat -> ServerResponse.ok().bodyValue(pat));\n }\n\n @Override\n public Mono restore(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .transform(this::mustBeAuthenticated)\n .flatMap(auth -> {\n var name = request.pathVariable(\"name\");\n return patService.restore(name, auth.getName());\n })\n .flatMap(pat -> ServerResponse.ok().bodyValue(pat));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/CookieSignatureKeyResolver.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport reactor.core.publisher.Mono;\n\n@FunctionalInterface\npublic interface CookieSignatureKeyResolver {\n Mono resolveSigningKey();\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/DefaultCookieSignatureKeyResolver.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.authentication.CryptoService;\n\n@Component\n@RequiredArgsConstructor\npublic class DefaultCookieSignatureKeyResolver implements CookieSignatureKeyResolver {\n private final CryptoService cryptoService;\n\n @Override\n public Mono resolveSigningKey() {\n return Mono.fromSupplier(cryptoService::getKeyId);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/PersistentRememberMeTokenRepository.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport java.time.Instant;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.web.authentication.rememberme.PersistentRememberMeToken;\nimport reactor.core.publisher.Mono;\n\npublic interface PersistentRememberMeTokenRepository {\n Mono createNewToken(PersistentRememberMeToken token);\n\n Mono updateToken(String series, String tokenValue, Instant lastUsed);\n\n Mono getTokenForSeries(String seriesId);\n\n Mono removeUserTokens(String username);\n\n Mono removeToken(@NonNull String series);\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/PersistentRememberMeTokenRepositoryImpl.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Date;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.web.authentication.rememberme.PersistentRememberMeToken;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.RememberMeToken;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.ReactiveExtensionPaginatedOperatorImpl;\n\n/**\n * Extension based persistent remember me token repository implementation.\n *\n * @see RememberMeToken\n */\n@Component\n@RequiredArgsConstructor\npublic class PersistentRememberMeTokenRepositoryImpl\n implements PersistentRememberMeTokenRepository {\n private final ReactiveExtensionClient client;\n private final ReactiveExtensionPaginatedOperatorImpl paginatedOperator;\n\n @Override\n public Mono createNewToken(PersistentRememberMeToken token) {\n var rememberMeToken = new RememberMeToken();\n var metadata = new Metadata();\n rememberMeToken.setMetadata(metadata);\n metadata.setGenerateName(\"token-\");\n var creationTime = Instant.ofEpochMilli(token.getDate().getTime());\n metadata.setCreationTimestamp(creationTime);\n\n rememberMeToken.setSpec(new RememberMeToken.Spec());\n rememberMeToken.getSpec()\n .setUsername(token.getUsername())\n .setSeries(token.getSeries())\n .setTokenValue(token.getTokenValue());\n return client.create(rememberMeToken).then();\n }\n\n @Override\n public Mono updateToken(String series, String tokenValue, Instant lastUsed) {\n return Mono.defer(() -> getTokenExtensionForSeries(series)\n .flatMap(token -> {\n token.getSpec().setTokenValue(tokenValue)\n .setLastUsed(lastUsed);\n return client.update(token);\n })\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance))\n .then();\n }\n\n @Override\n public Mono getTokenForSeries(String seriesId) {\n return getTokenExtensionForSeries(seriesId)\n .map(token -> new PersistentRememberMeToken(\n token.getSpec().getUsername(),\n token.getSpec().getSeries(),\n token.getSpec().getTokenValue(),\n new Date(token.getMetadata().getCreationTimestamp().toEpochMilli())\n ));\n }\n\n @Override\n public Mono removeUserTokens(String username) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(equal(\"spec.username\", username)));\n return paginatedOperator.deleteInitialBatch(RememberMeToken.class, listOptions).then();\n }\n\n @Override\n public Mono removeToken(@NonNull String series) {\n return getTokenExtensionForSeries(series)\n .flatMap(client::delete)\n .then();\n }\n\n private Mono getTokenExtensionForSeries(String seriesId) {\n var listOptions = ListOptions.builder()\n .fieldQuery(and(equal(\"spec.series\", seriesId),\n isNull(\"metadata.deletionTimestamp\")\n ))\n .build();\n return client.listBy(RememberMeToken.class, listOptions, PageRequestImpl.ofSize(1))\n .flatMap(result -> Mono.justOrEmpty(ListResult.first(result)));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/PersistentTokenBasedRememberMeServices.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport java.security.SecureRandom;\nimport java.time.Instant;\nimport java.util.Arrays;\nimport java.util.Base64;\nimport java.util.Date;\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport org.springframework.security.web.authentication.rememberme.CookieTheftException;\nimport org.springframework.security.web.authentication.rememberme.InvalidCookieException;\nimport org.springframework.security.web.authentication.rememberme.PersistentRememberMeToken;\nimport org.springframework.security.web.authentication.rememberme.PersistentTokenRepository;\nimport org.springframework.security.web.authentication.rememberme.RememberMeAuthenticationException;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n *

{@link RememberMeServices} implementation based on Barry Jaspan's Improved\n * Persistent Login Cookie Best Practice.

\n *

There is a slight modification to the described approach, in that the username is not\n * stored as part of the cookie but obtained from the persistent store via an\n * implementation of {@link PersistentTokenRepository}. The latter should place a unique\n * constraint on the series identifier, so that it is impossible for the same identifier\n * to be allocated to two different users.

\n *

User management such as changing passwords, removing users and setting user status\n * should be combined with maintenance of the user's persistent tokens.

\n *

\n * Note that while this class will use the date a token was created to check whether a\n * presented cookie is older than the configured tokenValiditySeconds property\n * and deny authentication in this case, it will not delete these tokens from storage. A\n * suitable batch process should be run periodically to remove expired tokens from the\n * database.\n *

\n *\n * @author guqing\n * @see\n * PersistentTokenBasedRememberMeServices\n * @since 2.17.0\n */\n@Slf4j\n@Setter\n@Component\npublic class PersistentTokenBasedRememberMeServices extends TokenBasedRememberMeServices\n implements RememberMeServices {\n\n public static final String REMEMBER_ME_SERIES_REQUEST_NAME = \"remember-me-series\";\n\n public static final int DEFAULT_SERIES_LENGTH = 16;\n\n public static final int DEFAULT_TOKEN_LENGTH = 16;\n\n private final SecureRandom random;\n\n private final int seriesLength = DEFAULT_SERIES_LENGTH;\n\n private final int tokenLength = DEFAULT_TOKEN_LENGTH;\n\n private final PersistentRememberMeTokenRepository tokenRepository;\n\n public PersistentTokenBasedRememberMeServices(\n CookieSignatureKeyResolver cookieSignatureKeyResolver,\n ReactiveUserDetailsService userDetailsService,\n RememberMeCookieResolver rememberMeCookieResolver,\n PersistentRememberMeTokenRepository tokenRepository) {\n super(cookieSignatureKeyResolver, userDetailsService, rememberMeCookieResolver);\n this.random = new SecureRandom();\n this.tokenRepository = tokenRepository;\n }\n\n @Override\n protected Mono processAutoLoginCookie(String[] cookieTokens,\n ServerWebExchange exchange) {\n if (cookieTokens.length != 2) {\n throw new InvalidCookieException(\n \"Cookie token did not contain \" + 2 + \" tokens, but contained '\"\n + Arrays.asList(cookieTokens) + \"'\");\n }\n String presentedSeries = cookieTokens[0];\n String presentedToken = cookieTokens[1];\n return this.tokenRepository.getTokenForSeries(presentedSeries)\n // No series match, so we can't authenticate using this cookie\n .switchIfEmpty(Mono.error(new RememberMeAuthenticationException(\n \"No persistent token found for series id: \" + presentedSeries))\n )\n .flatMap(token -> {\n // We have a match for this user/series combination\n if (!presentedToken.equals(token.getTokenValue())) {\n // Token doesn't match series value. Delete all logins for this user and throw\n // an exception to warn them.\n return this.tokenRepository.removeUserTokens(token.getUsername())\n .then(Mono.error(new CookieTheftException(\n \"Invalid remember-me token (Series/token) mismatch. Implies previous \"\n + \"cookie theft\"\n + \" attack.\")));\n }\n\n if (isTokenExpired(token)) {\n return Mono.error(\n new RememberMeAuthenticationException(\"Remember-me login has expired\"));\n }\n\n // Token also matches, so login is valid. Update the token value, keeping the\n // *same* series number.\n log.debug(\"Refreshing persistent login token for user '{}', series '{}'\",\n token.getUsername(), token.getSeries());\n var newToken = new PersistentRememberMeToken(token.getUsername(), token.getSeries(),\n token.getTokenValue(), new Date());\n return Mono.just(newToken);\n })\n .flatMap(newToken -> updateToken(newToken)\n .doOnSuccess(unused -> addCookie(newToken, exchange))\n .onErrorMap(ex -> {\n log.error(\"Failed to update token: \", ex);\n return new RememberMeAuthenticationException(\n \"Autologin failed due to data access problem\");\n })\n .then(getUserDetailsService().findByUsername(newToken.getUsername()))\n );\n }\n\n private boolean isTokenExpired(PersistentRememberMeToken token) {\n return isTokenExpired(token.getDate().getTime() + getTokenValidityMillis());\n }\n\n private Mono updateToken(PersistentRememberMeToken newToken) {\n return this.tokenRepository.updateToken(newToken.getSeries(),\n newToken.getTokenValue(), dateToInstant(newToken.getDate()));\n }\n\n Instant dateToInstant(Date date) {\n return Instant.ofEpochMilli(date.getTime());\n }\n\n /**\n * Creates a new persistent login token with a new series number, stores the data in\n * the persistent token repository and adds the corresponding cookie to the response.\n */\n @Override\n protected Mono onLoginSuccess(ServerWebExchange exchange,\n Authentication successfulAuthentication) {\n String username = successfulAuthentication.getName();\n log.debug(\"Creating new persistent login for user {}\", username);\n PersistentRememberMeToken persistentToken =\n new PersistentRememberMeToken(username, generateSeriesData(),\n generateTokenData(), new Date());\n return this.tokenRepository.createNewToken(persistentToken)\n .doOnSuccess(unused -> addCookie(persistentToken, exchange))\n .onErrorResume(Throwable.class, ex -> {\n log.error(\"Failed to save persistent token \", ex);\n return Mono.empty();\n });\n }\n\n @Override\n protected Mono onLogout(WebFilterExchange exchange, Authentication authentication) {\n if (authentication != null) {\n return this.tokenRepository.removeUserTokens(authentication.getName());\n }\n return Mono.empty();\n }\n\n private void addCookie(PersistentRememberMeToken token, ServerWebExchange exchange) {\n setCookie(new String[] {token.getSeries(), token.getTokenValue()}, exchange);\n exchange.getAttributes().put(REMEMBER_ME_SERIES_REQUEST_NAME, token.getSeries());\n }\n\n protected String generateSeriesData() {\n byte[] newSeries = new byte[this.seriesLength];\n this.random.nextBytes(newSeries);\n return new String(Base64.getEncoder().encode(newSeries));\n }\n\n protected String generateTokenData() {\n byte[] newToken = new byte[this.tokenLength];\n this.random.nextBytes(newToken);\n return new String(Base64.getEncoder().encode(newToken));\n }\n\n private long getTokenValidityMillis() {\n return rememberMeCookieResolver.getCookieMaxAge().toMillis();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeAuthenticationManager.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport lombok.NonNull;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.context.MessageSource;\nimport org.springframework.context.MessageSourceAware;\nimport org.springframework.context.support.MessageSourceAccessor;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.security.authentication.ReactiveAuthenticationManager;\nimport org.springframework.security.authentication.RememberMeAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.SpringSecurityMessageSource;\nimport org.springframework.util.Assert;\nimport reactor.core.publisher.Mono;\n\n@RequiredArgsConstructor\npublic class RememberMeAuthenticationManager implements ReactiveAuthenticationManager,\n InitializingBean, MessageSourceAware {\n\n private final CookieSignatureKeyResolver cookieSignatureKeyResolver;\n protected MessageSourceAccessor messages = SpringSecurityMessageSource.getAccessor();\n\n @Override\n public Mono authenticate(Authentication authentication) {\n if (authentication instanceof RememberMeAuthenticationToken rememberMeAuthenticationToken) {\n return doAuthenticate(rememberMeAuthenticationToken);\n }\n return Mono.empty();\n }\n\n @Override\n public void afterPropertiesSet() {\n Assert.notNull(this.messages, \"A message source must be set\");\n }\n\n @Override\n public void setMessageSource(@NonNull MessageSource messageSource) {\n this.messages = new MessageSourceAccessor(messageSource);\n }\n\n private Mono doAuthenticate(RememberMeAuthenticationToken token) {\n return cookieSignatureKeyResolver.resolveSigningKey()\n .flatMap(key -> {\n if (key.hashCode() != token.getKeyHash()) {\n return Mono.error(new BadCredentialsException(badCredentialMessage()));\n }\n return Mono.just(token);\n });\n }\n\n private String badCredentialMessage() {\n return this.messages.getMessage(\"RememberMeAuthenticationProvider.incorrectKey\",\n \"The presented RememberMeAuthenticationToken does not contain the expected key\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeConfigurer.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher.MatchResult;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.web.server.authentication.AuthenticationWebFilter;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n@Component\n@RequiredArgsConstructor\n@Order(0)\npublic class RememberMeConfigurer implements SecurityConfigurer {\n\n private final RememberMeServices rememberMeServices;\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n private final CookieSignatureKeyResolver cookieSignatureKeyResolver;\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var authManager = new RememberMeAuthenticationManager(cookieSignatureKeyResolver);\n var filter = new AuthenticationWebFilter(authManager);\n filter.setSecurityContextRepository(securityContextRepository);\n filter.setAuthenticationFailureHandler(\n (exchange, exception) -> rememberMeServices.loginFail(exchange.getExchange())\n );\n filter.setServerAuthenticationConverter(rememberMeServices::autoLogin);\n filter.setRequiresAuthenticationMatcher(\n exchange -> ReactiveSecurityContextHolder.getContext()\n .flatMap(securityContext -> MatchResult.notMatch())\n .switchIfEmpty(MatchResult.match())\n );\n http.addFilterAt(filter, SecurityWebFiltersOrder.AUTHENTICATION);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeCookieResolver.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport java.time.Duration;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebExchange;\n\npublic interface RememberMeCookieResolver {\n\n @Nullable\n HttpCookie resolveRememberMeCookie(ServerWebExchange exchange);\n\n void setRememberMeCookie(ServerWebExchange exchange, String value);\n\n void expireCookie(ServerWebExchange exchange);\n\n String getCookieName();\n\n Duration getCookieMaxAge();\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeCookieResolverImpl.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport java.time.Duration;\nimport lombok.Getter;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.http.ResponseCookie;\nimport org.springframework.lang.Nullable;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebExchange;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@Getter\n@Component\npublic class RememberMeCookieResolverImpl implements RememberMeCookieResolver {\n public static final String SPRING_SECURITY_REMEMBER_ME_COOKIE_KEY = \"remember-me\";\n\n private final String cookieName = SPRING_SECURITY_REMEMBER_ME_COOKIE_KEY;\n\n private final Duration cookieMaxAge;\n\n public RememberMeCookieResolverImpl(HaloProperties haloProperties) {\n this.cookieMaxAge = haloProperties.getSecurity().getRememberMe().getTokenValidity();\n }\n\n @Override\n @Nullable\n public HttpCookie resolveRememberMeCookie(ServerWebExchange exchange) {\n return exchange.getRequest().getCookies().getFirst(getCookieName());\n }\n\n @Override\n public void setRememberMeCookie(ServerWebExchange exchange, String value) {\n Assert.notNull(value, \"'value' is required\");\n exchange.getResponse().getCookies()\n .set(getCookieName(), initCookie(exchange, value).build());\n }\n\n @Override\n public void expireCookie(ServerWebExchange exchange) {\n ResponseCookie cookie = initCookie(exchange, \"\").maxAge(0).build();\n exchange.getResponse().getCookies().set(this.cookieName, cookie);\n }\n\n private ResponseCookie.ResponseCookieBuilder initCookie(ServerWebExchange exchange,\n String value) {\n return ResponseCookie.from(this.cookieName, value)\n .path(exchange.getRequest().getPath().contextPath().value() + \"/\")\n .maxAge(getCookieMaxAge())\n .httpOnly(true)\n .secure(\"https\".equalsIgnoreCase(exchange.getRequest().getURI().getScheme()))\n .sameSite(\"Lax\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeRequestCache.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * An interface for caching remember-me parameter in request for further handling. Especially\n * useful for two-factor authentication.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface RememberMeRequestCache {\n\n /**\n * Save remember-me parameter or form into cache.\n *\n * @param exchange exchange\n * @return empty to return\n */\n Mono saveRememberMe(ServerWebExchange exchange);\n\n /**\n * Check if remember-me parameter exists in cache.\n *\n * @param exchange exchange\n * @return true if remember-me exists, false otherwise\n */\n Mono isRememberMe(ServerWebExchange exchange);\n\n /**\n * Remove remember-me parameter from cache.\n *\n * @param exchange exchange\n * @return empty to return\n */\n Mono removeRememberMe(ServerWebExchange exchange);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeServices.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport org.springframework.security.core.Authentication;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\npublic interface RememberMeServices {\n\n Mono autoLogin(ServerWebExchange exchange);\n\n Mono loginFail(ServerWebExchange exchange);\n\n Mono loginSuccess(ServerWebExchange exchange, Authentication successfulAuthentication);\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberMeTokenRevoker.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport java.time.Duration;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.event.user.PasswordChangedEvent;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * Remember me token revoker.\n *

\n * Listen to password changed event and revoke remember me token.\n *

\n * Maybe you should consider revoke remember me token when user logout or username changed.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Component\n@RequiredArgsConstructor\npublic class RememberMeTokenRevoker {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private final PersistentRememberMeTokenRepository tokenRepository;\n\n @Async\n @EventListener(PasswordChangedEvent.class)\n public void onPasswordChanged(PasswordChangedEvent event) {\n tokenRepository.removeUserTokens(event.getUsername())\n .block(BLOCKING_TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/RememberTokenCleaner.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.extension.index.query.Queries.lessThan;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.scheduling.annotation.Scheduled;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.RememberMeToken;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.ReactiveExtensionPaginatedOperator;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * A cleaner for remember me tokens that cleans up expired tokens periodically.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class RememberTokenCleaner {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private final ReactiveExtensionPaginatedOperator paginatedOperator;\n private final RememberMeCookieResolver rememberMeCookieResolver;\n\n /**\n * Clean up expired tokens every day at 3:00 AM.\n */\n @Scheduled(cron = \"0 0 3 * * ?\")\n public void cleanUpExpiredTokens() {\n paginatedOperator.deleteInitialBatch(RememberMeToken.class, getExpiredTokensListOptions())\n .then().block(BLOCKING_TIMEOUT);\n log.info(\"Expired remember me tokens have been cleaned up.\");\n }\n\n ListOptions getExpiredTokensListOptions() {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n and(isNull(\"metadata.deletionTimestamp\"),\n lessThan(\"metadata.creationTimestamp\", getExpirationThreshold().toString())\n )\n ));\n return listOptions;\n }\n\n protected Instant getExpirationThreshold() {\n return Instant.now().minus(getTokenValidity());\n }\n\n protected Duration getTokenValidity() {\n return rememberMeCookieResolver.getCookieMaxAge();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/TokenBasedRememberMeServices.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport java.net.URLDecoder;\nimport java.net.URLEncoder;\nimport java.nio.charset.StandardCharsets;\nimport java.security.MessageDigest;\nimport java.security.NoSuchAlgorithmException;\nimport java.time.Instant;\nimport java.util.Arrays;\nimport java.util.Base64;\nimport java.util.Date;\nimport lombok.Getter;\nimport lombok.RequiredArgsConstructor;\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.authentication.AccountStatusException;\nimport org.springframework.security.authentication.AccountStatusUserDetailsChecker;\nimport org.springframework.security.authentication.RememberMeAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.authority.mapping.GrantedAuthoritiesMapper;\nimport org.springframework.security.core.authority.mapping.NullAuthoritiesMapper;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport org.springframework.security.core.userdetails.UserDetailsChecker;\nimport org.springframework.security.core.userdetails.UsernameNotFoundException;\nimport org.springframework.security.crypto.codec.Hex;\nimport org.springframework.security.crypto.codec.Utf8;\nimport org.springframework.security.web.authentication.rememberme.CookieTheftException;\nimport org.springframework.security.web.authentication.rememberme.InvalidCookieException;\nimport org.springframework.security.web.authentication.rememberme.RememberMeAuthenticationException;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.logout.ServerLogoutHandler;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n *

An {@link org.springframework.security.core.userdetails.UserDetailsService} is required\n * by this implementation, so that it can construct a valid Authentication\n * from the returned {@link org.springframework.security.core.userdetails.UserDetails}.

\n *

This is also necessary so that the user's password is available and can be checked as\n * part of the encoded cookie.

\n *

The cookie encoded by this implementation adopts the following form:\n * 

\n * username + \":\" + expiryTime + \":\" + algorithmName + \":\"\n *   + algorithmHex(username + \":\" + expiryTime + \":\" + password + \":\" + key)\n *
\n *

\n *\n * @see org.springframework.security.web.authentication.rememberme.TokenBasedRememberMeServices\n */\n@Slf4j\n@Setter\n@Getter\n@RequiredArgsConstructor\npublic class TokenBasedRememberMeServices implements ServerLogoutHandler, RememberMeServices {\n\n public static final String DEFAULT_ALGORITHM = \"SHA-256\";\n\n private static final String DELIMITER = \":\";\n\n protected final CookieSignatureKeyResolver cookieSignatureKeyResolver;\n\n private final ReactiveUserDetailsService userDetailsService;\n\n protected final RememberMeCookieResolver rememberMeCookieResolver;\n\n private UserDetailsChecker userDetailsChecker = new AccountStatusUserDetailsChecker();\n\n private GrantedAuthoritiesMapper authoritiesMapper = new NullAuthoritiesMapper();\n\n private RememberMeRequestCache rememberMeRequestCache = new WebSessionRememberMeRequestCache();\n\n private static boolean equals(String expected, String actual) {\n byte[] expectedBytes = bytesUtf8(expected);\n byte[] actualBytes = bytesUtf8(actual);\n return MessageDigest.isEqual(expectedBytes, actualBytes);\n }\n\n private static byte[] bytesUtf8(String s) {\n return (s != null) ? Utf8.encode(s) : null;\n }\n\n @Override\n public Mono autoLogin(ServerWebExchange exchange) {\n var rememberMeCookie = rememberMeCookieResolver.resolveRememberMeCookie(exchange);\n if (rememberMeCookie == null) {\n return Mono.empty();\n }\n log.debug(\"Remember-me cookie detected\");\n return Mono.defer(\n () -> {\n String[] cookieTokens = decodeCookie(rememberMeCookie.getValue());\n return processAutoLoginCookie(cookieTokens, exchange);\n })\n .flatMap(user -> {\n this.userDetailsChecker.check(user);\n log.debug(\"Remember-me cookie accepted\");\n return createSuccessfulAuthentication(exchange, user);\n })\n .onErrorResume(ex -> handleError(exchange, ex));\n }\n\n private Mono handleError(ServerWebExchange exchange, Throwable ex) {\n cancelCookie(exchange);\n if (ex instanceof CookieTheftException) {\n log.error(\"Cookie theft detected\", ex);\n return Mono.error(ex);\n } else if (ex instanceof UsernameNotFoundException) {\n log.debug(\"Remember-me login was valid but corresponding user not found.\", ex);\n } else if (ex instanceof InvalidCookieException) {\n log.debug(\"Invalid remember-me cookie: {}\", ex.getMessage());\n } else if (ex instanceof AccountStatusException) {\n log.debug(\"Invalid UserDetails: {}\", ex.getMessage());\n } else if (ex instanceof RememberMeAuthenticationException) {\n log.debug(ex.getMessage());\n }\n return Mono.empty();\n }\n\n protected void cancelCookie(ServerWebExchange exchange) {\n rememberMeCookieResolver.expireCookie(exchange);\n }\n\n protected Mono processAutoLoginCookie(String[] cookieTokens,\n ServerWebExchange exchange) {\n if (!isValidCookieTokensLength(cookieTokens)) {\n throw new InvalidCookieException(\n \"Cookie token did not contain 3 or 4 tokens, but contained '\" + Arrays.asList(\n cookieTokens) + \"'\");\n }\n\n long tokenExpiryTime = getTokenExpiryTime(cookieTokens);\n if (isTokenExpired(tokenExpiryTime)) {\n throw new InvalidCookieException(\n \"Cookie token[1] has expired (expired on '\" + new Date(tokenExpiryTime)\n + \"'; current time is '\" + new Date() + \"')\");\n }\n\n // Check the user exists. Defer lookup until after expiry time checked, to\n // possibly avoid expensive database call.\n return getUserDetailsService().findByUsername(cookieTokens[0])\n .switchIfEmpty(Mono.error(new UsernameNotFoundException(\"User '\" + cookieTokens[0]\n + \"' not found\")))\n .flatMap(userDetails -> {\n // Check signature of token matches remaining details. Must do this after user\n // lookup, as we need the DAO-derived password. If efficiency was a major issue,\n // just add in a UserCache implementation, but recall that this method is usually\n // only called once per HttpSession - if the token is valid, it will cause\n // SecurityContextHolder population, whilst if invalid, will cause the cookie to\n // be cancelled.\n String actualTokenSignature;\n String actualAlgorithm = DEFAULT_ALGORITHM;\n // If the cookie value contains the algorithm, we use that algorithm to check the\n // signature\n if (cookieTokens.length == 4) {\n actualTokenSignature = cookieTokens[3];\n actualAlgorithm = cookieTokens[2];\n } else {\n actualTokenSignature = cookieTokens[2];\n }\n return makeTokenSignature(tokenExpiryTime, userDetails.getUsername(),\n userDetails.getPassword(), actualAlgorithm)\n .doOnNext(expectedTokenSignature -> {\n if (!equals(expectedTokenSignature, actualTokenSignature)) {\n throw new InvalidCookieException(\n \"Cookie contained signature '\" + actualTokenSignature\n + \"' but expected '\"\n + expectedTokenSignature + \"'\");\n }\n })\n .thenReturn(userDetails);\n });\n }\n\n protected boolean isTokenExpired(long tokenExpiryTime) {\n return tokenExpiryTime < System.currentTimeMillis();\n }\n\n private long getTokenExpiryTime(String[] cookieTokens) {\n try {\n return Long.parseLong(cookieTokens[1]);\n } catch (NumberFormatException nfe) {\n throw new InvalidCookieException(\n \"Cookie token[1] did not contain a valid number (contained '\" + cookieTokens[1]\n + \"')\");\n }\n }\n\n protected Mono createSuccessfulAuthentication(ServerWebExchange exchange,\n UserDetails user) {\n return getKey()\n .map(key -> new RememberMeAuthenticationToken(key, user,\n this.authoritiesMapper.mapAuthorities(user.getAuthorities()))\n );\n }\n\n private boolean isValidCookieTokensLength(String[] cookieTokens) {\n return cookieTokens.length == 3 || cookieTokens.length == 4;\n }\n\n @Override\n public Mono loginFail(ServerWebExchange exchange) {\n log.debug(\"Interactive login attempt was unsuccessful.\");\n cancelCookie(exchange);\n return rememberMeRequestCache.saveRememberMe(exchange);\n }\n\n @Override\n public Mono loginSuccess(ServerWebExchange exchange,\n Authentication successfulAuthentication) {\n return rememberMeRequestCache.isRememberMe(exchange)\n .filter(Boolean::booleanValue)\n .switchIfEmpty(Mono.fromRunnable(() -> {\n log.debug(\"Remember-me login not requested.\");\n }))\n .flatMap(rememberMe -> onLoginSuccess(exchange, successfulAuthentication));\n }\n\n protected Mono onLoginSuccess(ServerWebExchange exchange,\n Authentication successfulAuthentication) {\n return Mono.defer(() -> retrieveUsernamePassword(successfulAuthentication))\n .flatMap(pair -> {\n var username = pair.username();\n var password = pair.password();\n var expiryTimeMs = calculateExpireTime(exchange, successfulAuthentication);\n return makeTokenSignature(expiryTimeMs, username, password, DEFAULT_ALGORITHM)\n .doOnNext(signatureValue -> {\n setCookie(\n new String[] {username, Long.toString(expiryTimeMs), DEFAULT_ALGORITHM,\n signatureValue},\n exchange);\n if (log.isDebugEnabled()) {\n log.debug(\"Added remember-me cookie for user '{}', expiry: '{}'\",\n username,\n new Date(expiryTimeMs));\n }\n });\n })\n .then();\n }\n\n private Mono retrieveUsernamePassword(\n Authentication successfulAuthentication) {\n return Mono.defer(() -> {\n String username = retrieveUserName(successfulAuthentication);\n String password = retrievePassword(successfulAuthentication);\n // If unable to find a username and password, just abort as\n // TokenBasedRememberMeServices is\n // unable to construct a valid token in this case.\n if (!StringUtils.hasLength(username)) {\n log.debug(\"Unable to retrieve username\");\n return Mono.empty();\n }\n if (!StringUtils.hasLength(password)) {\n return getUserDetailsService().findByUsername(username)\n .flatMap(user -> {\n String existingPassword = user.getPassword();\n if (!StringUtils.hasLength(existingPassword)) {\n log.debug(\"Unable to obtain password for user: {}\", username);\n return Mono.empty();\n }\n return Mono.just(new UsernamePassword(username, existingPassword));\n });\n }\n return Mono.just(new UsernamePassword(username, password));\n });\n }\n\n void setCookie(String[] cookieTokens, ServerWebExchange exchange) {\n String cookieValue = encodeCookie(cookieTokens);\n rememberMeCookieResolver.setRememberMeCookie(exchange, cookieValue);\n }\n\n protected long calculateExpireTime(ServerWebExchange exchange,\n Authentication authentication) {\n var tokenLifetime = rememberMeCookieResolver.getCookieMaxAge().toSeconds();\n return Instant.now().plusSeconds(tokenLifetime).toEpochMilli();\n }\n\n protected String[] decodeCookie(String cookieValue) throws InvalidCookieException {\n int paddingCount = 4 - (cookieValue.length() % 4);\n if (paddingCount < 4) {\n char[] padding = new char[paddingCount];\n Arrays.fill(padding, '=');\n cookieValue += new String(padding);\n }\n String cookieAsPlainText;\n try {\n cookieAsPlainText = new String(Base64.getDecoder().decode(cookieValue.getBytes()));\n } catch (IllegalArgumentException ex) {\n throw new InvalidCookieException(\n \"Cookie token was not Base64 encoded; value was '\" + cookieValue + \"'\");\n }\n String[] tokens = StringUtils.delimitedListToStringArray(cookieAsPlainText, DELIMITER);\n for (int i = 0; i < tokens.length; i++) {\n tokens[i] = URLDecoder.decode(tokens[i], StandardCharsets.UTF_8);\n }\n return tokens;\n }\n\n /**\n * Inverse operation of decodeCookie.\n *\n * @param cookieTokens the tokens to be encoded.\n * @return base64 encoding of the tokens concatenated with the \":\" delimiter.\n */\n protected String encodeCookie(String[] cookieTokens) {\n StringBuilder sb = new StringBuilder();\n for (int i = 0; i < cookieTokens.length; i++) {\n sb.append(URLEncoder.encode(cookieTokens[i], StandardCharsets.UTF_8));\n if (i < cookieTokens.length - 1) {\n sb.append(DELIMITER);\n }\n }\n String value = sb.toString();\n sb = new StringBuilder(new String(Base64.getEncoder().encode(value.getBytes())));\n while (sb.charAt(sb.length() - 1) == '=') {\n sb.deleteCharAt(sb.length() - 1);\n }\n return sb.toString();\n }\n\n protected Mono makeTokenSignature(long tokenExpiryTime, String username,\n String password, String algorithm) {\n return getKey()\n .handle((key, sink) -> {\n String data = username + \":\" + tokenExpiryTime + \":\" + password + \":\" + key;\n try {\n MessageDigest digest = MessageDigest.getInstance(algorithm);\n sink.next(new String(Hex.encode(digest.digest(data.getBytes()))));\n } catch (NoSuchAlgorithmException ex) {\n sink.error(\n new IllegalStateException(\"No \" + algorithm + \" algorithm available!\"));\n }\n });\n }\n\n protected String retrieveUserName(Authentication authentication) {\n if (isInstanceOfUserDetails(authentication)) {\n return ((UserDetails) authentication.getPrincipal()).getUsername();\n }\n return authentication.getPrincipal().toString();\n }\n\n protected String retrievePassword(Authentication authentication) {\n if (isInstanceOfUserDetails(authentication)) {\n return ((UserDetails) authentication.getPrincipal()).getPassword();\n }\n if (authentication.getCredentials() != null) {\n return authentication.getCredentials().toString();\n }\n return null;\n }\n\n private boolean isInstanceOfUserDetails(Authentication authentication) {\n return authentication.getPrincipal() instanceof UserDetails;\n }\n\n protected Mono getKey() {\n return cookieSignatureKeyResolver.resolveSigningKey();\n }\n\n @Override\n public Mono logout(WebFilterExchange exchange, Authentication authentication) {\n if (log.isDebugEnabled()) {\n log.debug(\"Logout of user {}\", (authentication != null) ? authentication.getName()\n : \"Unknown\");\n }\n return loginFail(exchange.getExchange()).then(onLogout(exchange, authentication));\n }\n\n protected Mono onLogout(WebFilterExchange exchange, Authentication authentication) {\n return Mono.empty();\n }\n\n record UsernamePassword(String username, String password) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/rememberme/WebSessionRememberMeRequestCache.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebSession;\nimport reactor.core.publisher.Mono;\n\n/**\n * An implementation of {@link RememberMeRequestCache} that stores remember-me parameter in\n * {@link WebSession}.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class WebSessionRememberMeRequestCache implements RememberMeRequestCache {\n\n private static final String SESSION_ATTRIBUTE_NAME =\n RememberMeRequestCache.class + \".REMEMBER_ME\";\n\n private static final String DEFAULT_PARAMETER = \"remember-me\";\n\n @Override\n public Mono saveRememberMe(ServerWebExchange exchange) {\n return resolveFromQuery(exchange)\n .switchIfEmpty(resolveFromForm(exchange))\n .flatMap(rememberMe -> exchange.getSession().doOnNext(\n session -> session.getAttributes().put(SESSION_ATTRIBUTE_NAME, rememberMe))\n )\n .then();\n }\n\n @Override\n public Mono isRememberMe(ServerWebExchange exchange) {\n return resolveFromQuery(exchange)\n .switchIfEmpty(resolveFromForm(exchange))\n .switchIfEmpty(resolveFromSession(exchange))\n .defaultIfEmpty(false);\n }\n\n @Override\n public Mono removeRememberMe(ServerWebExchange exchange) {\n return exchange.getSession()\n .doOnNext(session -> session.getAttributes().remove(SESSION_ATTRIBUTE_NAME))\n .then();\n }\n\n private Mono resolveFromQuery(ServerWebExchange exchange) {\n return Mono.justOrEmpty(exchange.getRequest().getQueryParams().getFirst(DEFAULT_PARAMETER))\n .map(Boolean::parseBoolean);\n }\n\n private Mono resolveFromForm(ServerWebExchange exchange) {\n return exchange.getFormData()\n .mapNotNull(form -> form.getFirst(DEFAULT_PARAMETER))\n .map(Boolean::parseBoolean);\n }\n\n private Mono resolveFromSession(ServerWebExchange exchange) {\n return exchange.getSession()\n .mapNotNull(session -> session.getAttribute(SESSION_ATTRIBUTE_NAME))\n .filter(Boolean.class::isInstance)\n .cast(Boolean.class);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TotpAuthenticationSuccessHandler.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport org.springframework.security.web.server.authentication.RedirectServerAuthenticationSuccessHandler;\nimport org.springframework.security.web.server.authentication.ServerAuthenticationSuccessHandler;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.LoginHandlerEnhancer;\n\n@Slf4j\npublic class TotpAuthenticationSuccessHandler implements ServerAuthenticationSuccessHandler {\n\n private final LoginHandlerEnhancer loginEnhancer;\n\n private final ServerAuthenticationSuccessHandler successHandler;\n\n public TotpAuthenticationSuccessHandler(LoginHandlerEnhancer loginEnhancer,\n ServerRequestCache serverRequestCache) {\n this.loginEnhancer = loginEnhancer;\n var successHandler = new RedirectServerAuthenticationSuccessHandler(\"/uc\");\n successHandler.setRequestCache(serverRequestCache);\n this.successHandler = successHandler;\n }\n\n @Override\n public Mono onAuthenticationSuccess(WebFilterExchange webFilterExchange,\n Authentication authentication) {\n return loginEnhancer.onLoginSuccess(webFilterExchange.getExchange(), authentication)\n .then(successHandler.onAuthenticationSuccess(webFilterExchange, authentication));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthEndpoint.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.webflux.core.fn.SpringdocRouteBuilder.route;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\n\nimport jakarta.validation.constraints.NotBlank;\nimport jakarta.validation.constraints.NotNull;\nimport java.net.URI;\nimport lombok.Data;\nimport org.springframework.security.authentication.AnonymousAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.stereotype.Component;\nimport org.springframework.validation.Validator;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.ValidationUtils;\nimport run.halo.app.infra.exception.AccessDeniedException;\nimport run.halo.app.infra.exception.RequestBodyValidationException;\nimport run.halo.app.security.authentication.twofactor.totp.TotpAuthService;\n\n@Component\npublic class TwoFactorAuthEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n\n private final UserService userService;\n\n private final TotpAuthService totpAuthService;\n\n private final Validator validator;\n\n private final PasswordEncoder passwordEncoder;\n\n private final ExternalUrlSupplier externalUrl;\n\n public TwoFactorAuthEndpoint(ReactiveExtensionClient client,\n UserService userService,\n TotpAuthService totpAuthService,\n Validator validator,\n PasswordEncoder passwordEncoder,\n ExternalUrlSupplier externalUrl) {\n this.client = client;\n this.userService = userService;\n this.totpAuthService = totpAuthService;\n this.validator = validator;\n this.passwordEncoder = passwordEncoder;\n this.externalUrl = externalUrl;\n }\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"TwoFactorAuthV1alpha1Uc\";\n return route().nest(path(\"/authentications/two-factor\"),\n () -> route()\n .GET(\"/settings\", this::getTwoFactorSettings,\n builder -> builder.operationId(\"GetTwoFactorAuthenticationSettings\")\n .tag(tag)\n .description(\"Get Two-factor authentication settings.\")\n .response(responseBuilder().implementation(TwoFactorAuthSettings.class)))\n .PUT(\"/settings/enabled\", this::enableTwoFactor,\n builder -> builder.operationId(\"EnableTwoFactor\")\n .tag(tag)\n .description(\"Enable Two-factor authentication\")\n .requestBody(requestBodyBuilder().implementation(PasswordRequest.class))\n .response(responseBuilder().implementation(TwoFactorAuthSettings.class)))\n .PUT(\"/settings/disabled\", this::disableTwoFactor,\n builder -> builder.operationId(\"DisableTwoFactor\")\n .tag(tag)\n .description(\"Disable Two-factor authentication\")\n .requestBody(requestBodyBuilder().implementation(PasswordRequest.class))\n .response(responseBuilder().implementation(TwoFactorAuthSettings.class)))\n .POST(\"/totp\", this::configureTotp,\n builder -> builder.operationId(\"ConfigurerTotp\")\n .tag(tag)\n .description(\"Configure a TOTP\")\n .requestBody(requestBodyBuilder().implementation(TotpRequest.class))\n .response(responseBuilder().implementation(TwoFactorAuthSettings.class)))\n .DELETE(\"/totp/-\", this::deleteTotp,\n builder -> builder.operationId(\"DeleteTotp\")\n .tag(tag)\n .requestBody(requestBodyBuilder().implementation(PasswordRequest.class))\n .response(responseBuilder().implementation(TwoFactorAuthSettings.class)))\n .GET(\"/totp/auth-link\", this::getTotpAuthLink,\n builder -> builder.operationId(\"GetTotpAuthLink\")\n .tag(tag)\n .description(\"Get TOTP auth link, including secret\")\n .response(responseBuilder().implementation(TotpAuthLinkResponse.class)))\n .build()\n ).build();\n }\n\n private Mono deleteTotp(ServerRequest request) {\n var totpDeleteRequestMono = request.bodyToMono(PasswordRequest.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required\")))\n .doOnNext(passwordRequest -> this.validateRequest(passwordRequest, \"passwordRequest\",\n request)\n );\n\n var twoFactorAuthSettings =\n totpDeleteRequestMono.flatMap(passwordRequest -> getCurrentUser()\n .filter(user -> {\n var rawPassword = passwordRequest.getPassword();\n var encodedPassword = user.getSpec().getPassword();\n return this.passwordEncoder.matches(rawPassword, encodedPassword);\n })\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Invalid password\")))\n .doOnNext(user -> {\n var spec = user.getSpec();\n spec.setTotpEncryptedSecret(null);\n })\n .flatMap(client::update)\n .map(TwoFactorUtils::getTwoFactorAuthSettings));\n return ServerResponse.ok().body(twoFactorAuthSettings, TwoFactorAuthSettings.class);\n }\n\n @Data\n public static class PasswordRequest {\n\n @NotBlank\n private String password;\n\n }\n\n private Mono disableTwoFactor(ServerRequest request) {\n return toggleTwoFactor(request, false);\n }\n\n private Mono enableTwoFactor(ServerRequest request) {\n return toggleTwoFactor(request, true);\n }\n\n private Mono toggleTwoFactor(ServerRequest request, boolean enabled) {\n return request.bodyToMono(PasswordRequest.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required\")))\n .doOnNext(passwordRequest -> this.validateRequest(passwordRequest,\n \"passwordRequest\", request))\n .flatMap(passwordRequest -> getCurrentUser()\n .filter(user -> {\n var encodedPassword = user.getSpec().getPassword();\n var rawPassword = passwordRequest.getPassword();\n return passwordEncoder.matches(rawPassword, encodedPassword);\n })\n .switchIfEmpty(\n Mono.error(() -> new ServerWebInputException(\"Invalid password\")))\n .doOnNext(user -> user.getSpec().setTwoFactorAuthEnabled(enabled))\n .flatMap(client::update)\n .map(TwoFactorUtils::getTwoFactorAuthSettings))\n .flatMap(twoFactorAuthSettings -> ServerResponse.ok().bodyValue(twoFactorAuthSettings));\n }\n\n private Mono getTotpAuthLink(ServerRequest request) {\n var authLinkResponse = getCurrentUser()\n .map(user -> {\n var username = user.getMetadata().getName();\n var url = externalUrl.getURL(request.exchange().getRequest());\n var authority = url.getAuthority();\n var authKeyId = username + \":\" + authority;\n var rawSecret = totpAuthService.generateTotpSecret();\n var authLink = UriComponentsBuilder.fromUriString(\"otpauth://totp\")\n .path(authKeyId)\n .queryParam(\"secret\", rawSecret)\n .queryParam(\"digits\", 6)\n .build().toUri();\n var authLinkResp = new TotpAuthLinkResponse();\n authLinkResp.setAuthLink(authLink);\n authLinkResp.setRawSecret(rawSecret);\n return authLinkResp;\n });\n\n return ServerResponse.ok().body(authLinkResponse, TotpAuthLinkResponse.class);\n }\n\n @Data\n public static class TotpAuthLinkResponse {\n\n /**\n * QR Code with base64 encoded.\n */\n private URI authLink;\n\n private String rawSecret;\n }\n\n private Mono configureTotp(ServerRequest request) {\n var totpRequestMono = request.bodyToMono(TotpRequest.class)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Request body required.\")))\n .doOnNext(totpRequest -> this.validateRequest(totpRequest, \"totp\", request));\n\n var configuredUser = totpRequestMono.flatMap(totpRequest -> {\n // validate password\n return getCurrentUser()\n .filter(user -> {\n var encodedPassword = user.getSpec().getPassword();\n var rawPassword = totpRequest.getPassword();\n return passwordEncoder.matches(rawPassword, encodedPassword);\n })\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\"Invalid password\")))\n .doOnNext(user -> {\n // TimeBasedOneTimePasswordUtil.\n var rawSecret = totpRequest.getSecret();\n int code;\n try {\n code = Integer.parseInt(totpRequest.getCode());\n } catch (NumberFormatException e) {\n throw new ServerWebInputException(\"Invalid code\");\n }\n var validated = totpAuthService.validateTotp(rawSecret, code);\n if (!validated) {\n throw new ServerWebInputException(\"Invalid secret or code\");\n }\n var encryptedSecret = totpAuthService.encryptSecret(rawSecret);\n user.getSpec().setTotpEncryptedSecret(encryptedSecret);\n })\n .flatMap(client::update);\n });\n\n var twoFactorAuthSettings =\n configuredUser.map(TwoFactorUtils::getTwoFactorAuthSettings);\n\n return ServerResponse.ok().body(twoFactorAuthSettings, TwoFactorAuthSettings.class);\n }\n\n private void validateRequest(Object target, String name, ServerRequest request) {\n var bindingResult =\n ValidationUtils.validate(target, name, validator, request.exchange());\n if (bindingResult.hasErrors()) {\n throw new RequestBodyValidationException(bindingResult);\n }\n }\n\n @Data\n public static class TotpRequest {\n\n @NotBlank\n private String secret;\n\n @NotNull\n private String code;\n\n @NotBlank\n private String password;\n\n }\n\n private Mono getTwoFactorSettings(ServerRequest request) {\n return getCurrentUser()\n .map(TwoFactorUtils::getTwoFactorAuthSettings)\n .flatMap(settings -> ServerResponse.ok().bodyValue(settings));\n }\n\n private Mono getCurrentUser() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(TwoFactorAuthEndpoint::isAuthenticatedUser)\n .switchIfEmpty(Mono.error(AccessDeniedException::new))\n .map(Authentication::getName)\n .flatMap(userService::getUser);\n }\n\n private static boolean isAuthenticatedUser(Authentication authentication) {\n return authentication != null && !(authentication instanceof AnonymousAuthenticationToken);\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.security.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthRequiredException.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport java.net.URI;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.server.ResponseStatusException;\n\npublic class TwoFactorAuthRequiredException extends ResponseStatusException {\n\n private static final URI type = URI.create(\"https://halo.run/probs/2fa-required\");\n\n public TwoFactorAuthRequiredException(URI redirectURI) {\n super(HttpStatus.UNAUTHORIZED, \"Two-factor authentication required\");\n setType(type);\n getBody().setProperty(\"redirectURI\", redirectURI);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthSecurityConfigurer.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.web.server.authentication.AuthenticationWebFilter;\nimport org.springframework.security.web.server.authentication.RedirectServerAuthenticationFailureHandler;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.security.LoginHandlerEnhancer;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.security.authentication.twofactor.totp.TotpAuthService;\nimport run.halo.app.security.authentication.twofactor.totp.TotpAuthenticationManager;\nimport run.halo.app.security.authentication.twofactor.totp.TotpCodeAuthenticationConverter;\n\n@Component\n@Order(0)\npublic class TwoFactorAuthSecurityConfigurer implements SecurityConfigurer {\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n private final TotpAuthService totpAuthService;\n\n private final LoginHandlerEnhancer loginHandlerEnhancer;\n\n private final ServerRequestCache serverRequestCache;\n\n public TwoFactorAuthSecurityConfigurer(\n ServerSecurityContextRepository securityContextRepository,\n TotpAuthService totpAuthService, LoginHandlerEnhancer loginHandlerEnhancer,\n ServerRequestCache serverRequestCache\n ) {\n this.securityContextRepository = securityContextRepository;\n this.totpAuthService = totpAuthService;\n this.loginHandlerEnhancer = loginHandlerEnhancer;\n this.serverRequestCache = serverRequestCache;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var authManager = new TotpAuthenticationManager(totpAuthService);\n var filter = new AuthenticationWebFilter(authManager);\n filter.setRequiresAuthenticationMatcher(\n pathMatchers(HttpMethod.POST, \"/challenges/two-factor/totp\")\n );\n filter.setSecurityContextRepository(securityContextRepository);\n filter.setServerAuthenticationConverter(new TotpCodeAuthenticationConverter());\n filter.setAuthenticationSuccessHandler(\n new TotpAuthenticationSuccessHandler(loginHandlerEnhancer, serverRequestCache)\n );\n filter.setAuthenticationFailureHandler(\n new RedirectServerAuthenticationFailureHandler(\"/challenges/two-factor/totp?error\")\n );\n http.addFilterAt(filter, SecurityWebFiltersOrder.AUTHENTICATION);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthSettings.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport lombok.Data;\n\n@Data\npublic class TwoFactorAuthSettings {\n\n private boolean enabled;\n\n private boolean emailVerified;\n\n private boolean totpConfigured;\n\n /**\n * Check if 2FA is available.\n *\n * @return true if 2FA is enabled and configured, false otherwise.\n */\n public boolean isAvailable() {\n return enabled && totpConfigured;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthentication.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport static run.halo.app.security.authorization.AuthorityUtils.ANONYMOUS_ROLE_NAME;\n\nimport java.util.List;\nimport org.springframework.security.authentication.AbstractAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.authority.SimpleGrantedAuthority;\n\n/**\n * Authentication token for two-factor authentication.\n *\n * @author johnniang\n */\npublic class TwoFactorAuthentication extends AbstractAuthenticationToken {\n\n private final Authentication previous;\n\n /**\n * Creates a token with the supplied array of authorities.\n *\n * @param previous the previous authentication\n */\n public TwoFactorAuthentication(Authentication previous) {\n super(List.of(new SimpleGrantedAuthority(ANONYMOUS_ROLE_NAME)));\n this.previous = previous;\n }\n\n @Override\n public Object getCredentials() {\n return previous.getCredentials();\n }\n\n @Override\n public Object getPrincipal() {\n return previous.getPrincipal();\n }\n\n @Override\n public boolean isAuthenticated() {\n // for further authentication\n return false;\n }\n\n public Authentication getPrevious() {\n return previous;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthenticationEntryPoint.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport java.net.URI;\nimport org.springframework.context.MessageSource;\nimport org.springframework.security.core.AuthenticationException;\nimport org.springframework.security.web.server.DefaultServerRedirectStrategy;\nimport org.springframework.security.web.server.ServerAuthenticationEntryPoint;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.exception.Exceptions;\n\npublic class TwoFactorAuthenticationEntryPoint implements ServerAuthenticationEntryPoint {\n\n public static ServerWebExchangeMatcher MATCHER = exchange -> exchange.getPrincipal()\n .filter(TwoFactorAuthentication.class::isInstance)\n .flatMap(a -> ServerWebExchangeMatcher.MatchResult.match())\n .switchIfEmpty(ServerWebExchangeMatcher.MatchResult.notMatch());\n\n private static final URI REDIRECT_LOCATION = URI.create(\"/challenges/two-factor/totp\");\n\n /**\n * Because we don't want to cache the request before redirecting to the 2FA page,\n * ServerRedirectStrategy is used to redirect the request.\n */\n private final ServerRedirectStrategy redirectStrategy = new DefaultServerRedirectStrategy();\n\n private final MessageSource messageSource;\n\n private final ServerResponse.Context context;\n\n private static final ServerWebExchangeMatcher XHR_MATCHER = exchange -> {\n if (exchange.getRequest().getHeaders().getOrEmpty(\"X-Requested-With\")\n .contains(\"XMLHttpRequest\")) {\n return ServerWebExchangeMatcher.MatchResult.match();\n }\n return ServerWebExchangeMatcher.MatchResult.notMatch();\n };\n\n public TwoFactorAuthenticationEntryPoint(MessageSource messageSource,\n ServerResponse.Context context) {\n this.messageSource = messageSource;\n this.context = context;\n }\n\n @Override\n public Mono commence(ServerWebExchange exchange, AuthenticationException ex) {\n return XHR_MATCHER.matches(exchange)\n .filter(ServerWebExchangeMatcher.MatchResult::isMatch)\n .switchIfEmpty(\n redirectStrategy.sendRedirect(exchange, REDIRECT_LOCATION).then(Mono.empty())\n )\n .flatMap(isXhr -> {\n var errorResponse = Exceptions.createErrorResponse(\n new TwoFactorAuthRequiredException(REDIRECT_LOCATION),\n null, exchange, messageSource);\n return ServerResponse.status(errorResponse.getStatusCode())\n .bodyValue(errorResponse.getBody())\n .flatMap(response -> response.writeTo(exchange, context));\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/TwoFactorUtils.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport org.apache.commons.lang3.StringUtils;\nimport run.halo.app.core.extension.User;\n\npublic enum TwoFactorUtils {\n ;\n\n public static TwoFactorAuthSettings getTwoFactorAuthSettings(User user) {\n var spec = user.getSpec();\n var tfaEnabled = defaultIfNull(spec.getTwoFactorAuthEnabled(), false);\n var emailVerified = spec.isEmailVerified();\n var totpEncryptedSecret = spec.getTotpEncryptedSecret();\n var settings = new TwoFactorAuthSettings();\n settings.setEnabled(tfaEnabled);\n settings.setEmailVerified(emailVerified);\n settings.setTotpConfigured(StringUtils.isNotBlank(totpEncryptedSecret));\n return settings;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/totp/DefaultTotpAuthService.java", "content": "package run.halo.app.security.authentication.twofactor.totp;\n\nimport static com.j256.twofactorauth.TimeBasedOneTimePasswordUtil.generateBase32Secret;\nimport static com.j256.twofactorauth.TimeBasedOneTimePasswordUtil.validateCurrentNumber;\nimport static java.nio.file.StandardOpenOption.APPEND;\nimport static java.nio.file.StandardOpenOption.CREATE;\nimport static java.nio.file.StandardOpenOption.READ;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.security.GeneralSecurityException;\nimport java.security.KeyStore;\nimport java.security.KeyStoreException;\nimport java.security.NoSuchAlgorithmException;\nimport java.security.UnrecoverableEntryException;\nimport java.security.cert.CertificateException;\nimport javax.crypto.KeyGenerator;\nimport javax.crypto.SecretKey;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.crypto.codec.Hex;\nimport org.springframework.security.crypto.encrypt.AesBytesEncryptor;\nimport org.springframework.security.crypto.encrypt.BytesEncryptor;\nimport org.springframework.security.crypto.keygen.KeyGenerators;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@Slf4j\n@Component\npublic class DefaultTotpAuthService implements TotpAuthService {\n\n private final BytesEncryptor encryptor;\n\n public DefaultTotpAuthService(HaloProperties haloProperties) {\n // init secret key\n var keysRoot = haloProperties.getWorkDir().resolve(\"keys\");\n this.encryptor = loadOrCreateEncryptor(keysRoot);\n }\n\n private BytesEncryptor loadOrCreateEncryptor(Path keysRoot) {\n try {\n if (Files.notExists(keysRoot)) {\n Files.createDirectories(keysRoot);\n }\n var keyStorePath = keysRoot.resolve(\"halo.keystore\");\n var password = \"changeit\".toCharArray();\n var keyStore = KeyStore.getInstance(KeyStore.getDefaultType());\n if (Files.notExists(keyStorePath)) {\n keyStore.load(null, password);\n } else {\n try (var is = Files.newInputStream(keyStorePath, READ)) {\n keyStore.load(is, password);\n }\n }\n\n var alias = \"totp-secret-key\";\n var entry = keyStore.getEntry(alias, new KeyStore.PasswordProtection(password));\n SecretKey secretKey = null;\n if (entry instanceof KeyStore.SecretKeyEntry secretKeyEntry) {\n if (\"AES\".equalsIgnoreCase(secretKeyEntry.getSecretKey().getAlgorithm())) {\n secretKey = secretKeyEntry.getSecretKey();\n }\n }\n if (secretKey == null) {\n var generator = KeyGenerator.getInstance(\"AES\");\n generator.init(128);\n secretKey = generator.generateKey();\n var secretKeyEntry = new KeyStore.SecretKeyEntry(secretKey);\n keyStore.setEntry(alias, secretKeyEntry, new KeyStore.PasswordProtection(password));\n try (var os = Files.newOutputStream(keyStorePath, CREATE, APPEND)) {\n keyStore.store(os, password);\n }\n }\n return new AesBytesEncryptor(secretKey,\n KeyGenerators.secureRandom(32),\n AesBytesEncryptor.CipherAlgorithm.GCM);\n } catch (IOException | KeyStoreException | CertificateException | NoSuchAlgorithmException\n | UnrecoverableEntryException e) {\n throw new RuntimeException(\"Failed to initialize AesBytesEncryptor\", e);\n }\n }\n\n @Override\n public boolean validateTotp(String rawSecret, int code) {\n try {\n return validateCurrentNumber(rawSecret, code, 10 * 1000);\n } catch (GeneralSecurityException e) {\n log.warn(\"Error occurred when validate TOTP code\", e);\n return false;\n }\n }\n\n @Override\n public String generateTotpSecret() {\n return generateBase32Secret(32);\n }\n\n @Override\n public String encryptSecret(String rawSecret) {\n return new String(Hex.encode(encryptor.encrypt(rawSecret.getBytes())));\n }\n\n @Override\n public String decryptSecret(String encryptedSecret) {\n return new String(encryptor.decrypt(Hex.decode(encryptedSecret)));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/totp/TotpAuthService.java", "content": "package run.halo.app.security.authentication.twofactor.totp;\n\npublic interface TotpAuthService {\n\n boolean validateTotp(String rawSecret, int code);\n\n String generateTotpSecret();\n\n String encryptSecret(String rawSecret);\n\n String decryptSecret(String encryptedSecret);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/totp/TotpAuthenticationManager.java", "content": "package run.halo.app.security.authentication.twofactor.totp;\n\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.authentication.ReactiveAuthenticationManager;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.CredentialsContainer;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.HaloUserDetails;\nimport run.halo.app.security.authentication.exception.TwoFactorAuthException;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\n/**\n * TOTP authentication manager.\n *\n * @author johnniang\n */\n@Slf4j\npublic class TotpAuthenticationManager implements ReactiveAuthenticationManager {\n\n private final TotpAuthService totpAuthService;\n\n public TotpAuthenticationManager(TotpAuthService totpAuthService) {\n this.totpAuthService = totpAuthService;\n }\n\n @Override\n public Mono authenticate(Authentication authentication) {\n // it should be TotpAuthenticationToken\n var code = (Integer) authentication.getCredentials();\n log.debug(\"Got TOTP code {}\", code);\n\n // get user details\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .cast(TwoFactorAuthentication.class)\n .map(TwoFactorAuthentication::getPrevious)\n .flatMap(previousAuth -> {\n var principal = previousAuth.getPrincipal();\n if (!(principal instanceof HaloUserDetails user)) {\n return Mono.error(\n new TwoFactorAuthException(\"Invalid authentication principal.\")\n );\n }\n var totpEncryptedSecret = user.getTotpEncryptedSecret();\n if (StringUtils.isBlank(totpEncryptedSecret)) {\n return Mono.error(\n new TwoFactorAuthException(\"TOTP secret not configured.\")\n );\n }\n var rawSecret = totpAuthService.decryptSecret(totpEncryptedSecret);\n var validated = totpAuthService.validateTotp(rawSecret, code);\n if (!validated) {\n return Mono.error(new TwoFactorAuthException(\"Invalid TOTP code \" + code));\n }\n if (log.isDebugEnabled()) {\n log.debug(\n \"TOTP authentication for {} with code {} successfully.\",\n previousAuth.getName(), code);\n }\n if (previousAuth instanceof CredentialsContainer container) {\n container.eraseCredentials();\n }\n return Mono.just(previousAuth);\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/totp/TotpAuthenticationToken.java", "content": "package run.halo.app.security.authentication.twofactor.totp;\n\nimport java.util.List;\nimport org.springframework.security.authentication.AbstractAuthenticationToken;\n\npublic class TotpAuthenticationToken extends AbstractAuthenticationToken {\n\n private final int code;\n\n public TotpAuthenticationToken(int code) {\n super(List.of());\n this.code = code;\n }\n\n public int getCode() {\n return code;\n }\n\n @Override\n public Object getCredentials() {\n return getCode();\n }\n\n @Override\n public Object getPrincipal() {\n return getCode();\n }\n\n @Override\n public boolean isAuthenticated() {\n return false;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authentication/twofactor/totp/TotpCodeAuthenticationConverter.java", "content": "package run.halo.app.security.authentication.twofactor.totp;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.web.server.authentication.ServerAuthenticationConverter;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.authentication.exception.TwoFactorAuthException;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\n/**\n * TOTP code authentication converter.\n *\n * @author johnniang\n */\npublic class TotpCodeAuthenticationConverter implements ServerAuthenticationConverter {\n\n private final String codeParameter = \"code\";\n\n @Override\n public Mono convert(ServerWebExchange exchange) {\n // Check the request is authenticated before.\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(TwoFactorAuthentication.class::isInstance)\n .switchIfEmpty(Mono.error(\n () -> new TwoFactorAuthException(\n \"MFA Authentication required.\"\n ))\n )\n .flatMap(authentication -> exchange.getFormData())\n .handle((formData, sink) -> {\n var codeStr = formData.getFirst(codeParameter);\n if (StringUtils.isBlank(codeStr)) {\n sink.error(new TwoFactorAuthException(\n \"Empty code parameter.\"\n ));\n return;\n }\n try {\n var code = Integer.parseInt(codeStr);\n sink.next(new TotpAuthenticationToken(code));\n } catch (NumberFormatException e) {\n sink.error(new TwoFactorAuthException(\n \"Invalid code parameter \" + codeStr + '.')\n );\n }\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/Attributes.java", "content": "package run.halo.app.security.authorization;\n\n/**\n * Attributes is used by an Authorizer to get information about a request\n * that is used to make an authorization decision.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface Attributes {\n\n /**\n * @return the verb associated with API requests(this includes get, list,\n * watch, create, update, patch, delete, deletecollection, and proxy)\n * or the lower-cased HTTP verb associated with non-API requests(this\n * includes get, put, post, patch, and delete)\n */\n String getVerb();\n\n /**\n * @return when isReadOnly() == true, the request has no side effects, other than\n * caching, logging, and other incidentals.\n */\n boolean isReadOnly();\n\n /**\n * @return The kind of object, if a request is for a REST object.\n */\n String getResource();\n\n /**\n * @return the subresource being requested, if present.\n */\n String getSubresource();\n\n /**\n * @return the name of the object as parsed off the request. This will not be\n * present for all request types, but will be present for: get, update, delete\n */\n String getName();\n\n /**\n * @return The group of the resource, if a request is for a REST object.\n */\n String getApiGroup();\n\n /**\n * @return the version of the group requested, if a request is for a REST object.\n */\n String getApiVersion();\n\n /**\n * @return true for requests to API resources, like /api/v1/nodes,\n * and false for non-resource endpoints like /api, /healthz\n */\n boolean isResourceRequest();\n\n /**\n * @return returns the path of the request\n */\n String getPath();\n\n String getSubName();\n\n String getUserSpace();\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/AttributesRecord.java", "content": "package run.halo.app.security.authorization;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class AttributesRecord implements Attributes {\n private final RequestInfo requestInfo;\n\n public AttributesRecord(RequestInfo requestInfo) {\n this.requestInfo = requestInfo;\n }\n\n @Override\n public String getVerb() {\n return requestInfo.getVerb();\n }\n\n @Override\n public boolean isReadOnly() {\n String verb = requestInfo.getVerb();\n return \"get\".equals(verb)\n || \"list\".equals(verb)\n || \"watch\".equals(verb);\n }\n\n @Override\n public String getResource() {\n return requestInfo.getResource();\n }\n\n @Override\n public String getSubresource() {\n return requestInfo.getSubresource();\n }\n\n @Override\n public String getName() {\n return requestInfo.getName();\n }\n\n @Override\n public String getApiGroup() {\n return requestInfo.getApiGroup();\n }\n\n @Override\n public String getApiVersion() {\n return requestInfo.getApiVersion();\n }\n\n @Override\n public boolean isResourceRequest() {\n return requestInfo.isResourceRequest();\n }\n\n @Override\n public String getPath() {\n return requestInfo.getPath();\n }\n\n @Override\n public String getSubName() {\n return requestInfo.getSubName();\n }\n\n @Override\n public String getUserSpace() {\n return requestInfo.getUserspace();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/AuthorityUtils.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.Collection;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.core.GrantedAuthority;\n\n/**\n * Utility methods for manipulating GrantedAuthority collection.\n *\n * @author johnniang\n */\npublic enum AuthorityUtils {\n ;\n\n public static final String SCOPE_PREFIX = \"SCOPE_\";\n\n public static final String ROLE_PREFIX = \"ROLE_\";\n\n public static final String SUPER_ROLE_NAME = \"super-role\";\n\n public static final String AUTHENTICATED_ROLE_NAME = \"authenticated\";\n\n public static final String ANONYMOUS_ROLE_NAME = \"anonymous\";\n\n public static final String COMMENT_MANAGEMENT_ROLE_NAME = \"role-template-manage-comments\";\n\n public static final String POST_CONTRIBUTOR_ROLE_NAME = \"role-template-post-contributor\";\n\n public static final String THEME_MANAGEMENT_ROLE_NAME = \"role-template-manage-themes\";\n\n /**\n * Converts an array of GrantedAuthority objects to a role set.\n *\n * @return a Set of the Strings obtained from each call to\n * GrantedAuthority.getAuthority() and filtered by prefix \"ROLE_\".\n */\n public static Set authoritiesToRoles(\n Collection authorities) {\n return authorities.stream()\n .map(GrantedAuthority::getAuthority)\n .filter(authority -> StringUtils.startsWith(authority, ROLE_PREFIX))\n .map(authority -> {\n authority = StringUtils.removeStart(authority, ROLE_PREFIX);\n return authority;\n })\n .collect(Collectors.toSet());\n }\n\n public static boolean containsSuperRole(Collection roles) {\n return roles.contains(SUPER_ROLE_NAME);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/AuthorizationExchangeConfigurers.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.Collections;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.authorization.AuthorizationDecision;\nimport org.springframework.security.authorization.AuthorizationResult;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.web.server.authentication.SwitchUserWebFilter;\nimport org.springframework.security.web.server.util.matcher.AndServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.MediaTypeServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.NegatedServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.security.authentication.SecurityConfigurer;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\n/**\n * Authorization exchange configurers.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\nclass AuthorizationExchangeConfigurers {\n\n private final AuthenticationTrustResolver authenticationTrustResolver =\n new AuthenticationTrustResolverImpl();\n\n @Bean\n @Order(0)\n SecurityConfigurer apiAuthorizationConfigurer(RoleService roleService) {\n return http -> http.authorizeExchange(\n spec -> spec.pathMatchers(\"/api/**\", \"/apis/**\", \"/actuator/**\")\n .access(new RequestInfoAuthorizationManager(roleService)));\n }\n\n @Bean\n @Order(100)\n SecurityConfigurer unauthenticatedAuthorizationConfigurer() {\n return http -> http.authorizeExchange(spec -> {\n spec.pathMatchers(HttpMethod.GET, \"/login\", \"/signup\")\n .access((authentication, context) -> authentication.map(\n a -> !authenticationTrustResolver.isAuthenticated(a)\n )\n .defaultIfEmpty(true)\n .map(AuthorizationDecision::new));\n });\n }\n\n @Bean\n @Order(200)\n SecurityConfigurer preAuthenticationAuthorizationConfigurer() {\n return http -> http.authorizeExchange(spec -> spec\n .pathMatchers(\"/login/impersonate\")\n .hasRole(AuthorityUtils.SUPER_ROLE_NAME)\n .pathMatchers(\"/logout/impersonate\")\n .hasAuthority(SwitchUserWebFilter.ROLE_PREVIOUS_ADMINISTRATOR)\n .pathMatchers(\"/challenges/**\")\n .access((authentication, context) ->\n authentication.map(TwoFactorAuthentication.class::isInstance)\n .map(AuthorizationDecision::new)\n .switchIfEmpty(Mono.fromSupplier(() -> new AuthorizationDecision(false)))\n )\n .pathMatchers(\n \"/login/**\",\n \"/password-reset/**\",\n \"/signup\"\n )\n .permitAll()\n .pathMatchers(\"/logout\")\n .access((authentication, context) ->\n authentication.map(a -> !authenticationTrustResolver.isAnonymous(a))\n .map(AuthorizationDecision::new)\n .switchIfEmpty(Mono.fromSupplier(() -> new AuthorizationDecision(false)))\n )\n );\n }\n\n @Bean\n @Order(300)\n SecurityConfigurer authenticatedAuthorizationConfigurer() {\n // Anonymous user is not allowed\n return http -> http.authorizeExchange(\n spec -> spec.pathMatchers(\n \"/console/**\",\n \"/uc/**\"\n )\n .authenticated()\n );\n }\n\n @Bean\n @Order(400)\n SecurityConfigurer anonymousOrAuthenticatedAuthorizationConfigurer() {\n return http -> http.authorizeExchange(\n spec -> spec.matchers(createHtmlMatcher()).access((authentication, context) ->\n // we only need to check the authentication is authenticated\n // because we treat anonymous user as authenticated\n authentication.map(Authentication::isAuthenticated)\n .map(AuthorizationDecision::new)\n .switchIfEmpty(Mono.fromSupplier(() -> new AuthorizationDecision(false)))\n )\n );\n }\n\n @Bean\n @Order\n SecurityConfigurer permitAllAuthorizationConfigurer() {\n return http -> http.authorizeExchange(spec -> spec.anyExchange().permitAll());\n }\n\n private static ServerWebExchangeMatcher createHtmlMatcher() {\n ServerWebExchangeMatcher get =\n ServerWebExchangeMatchers.pathMatchers(HttpMethod.GET, \"/**\");\n ServerWebExchangeMatcher notFavicon = new NegatedServerWebExchangeMatcher(\n ServerWebExchangeMatchers.pathMatchers(\"/favicon.*\"));\n MediaTypeServerWebExchangeMatcher html =\n new MediaTypeServerWebExchangeMatcher(MediaType.TEXT_HTML);\n html.setIgnoredMediaTypes(Collections.singleton(MediaType.ALL));\n return new AndServerWebExchangeMatcher(get, notFavicon, html);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/AuthorizationRuleResolver.java", "content": "package run.halo.app.security.authorization;\n\nimport org.springframework.security.core.Authentication;\nimport reactor.core.publisher.Mono;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic interface AuthorizationRuleResolver {\n\n Mono visitRules(Authentication authentication, RequestInfo requestInfo);\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/AuthorizingVisitor.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport run.halo.app.core.extension.Role;\n\n/**\n * authorizing visitor short-circuits once allowed, and collects any resolution errors encountered.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class AuthorizingVisitor implements RuleAccumulator {\n private final RbacRequestEvaluation requestEvaluation = new RbacRequestEvaluation();\n\n private final Attributes requestAttributes;\n\n private boolean allowed;\n\n private String reason;\n\n private final List errors = new ArrayList<>(4);\n\n public AuthorizingVisitor(Attributes requestAttributes) {\n this.requestAttributes = requestAttributes;\n }\n\n @Override\n public boolean visit(String source, Role.PolicyRule rule, Throwable error) {\n if (rule != null && requestEvaluation.ruleAllows(requestAttributes, rule)) {\n this.allowed = true;\n this.reason = String.format(\"RBAC: allowed by %s\", source);\n return false;\n }\n if (error != null) {\n this.errors.add(error);\n }\n return true;\n }\n\n public boolean isAllowed() {\n return allowed;\n }\n\n public String getReason() {\n return reason;\n }\n\n public List getErrors() {\n return errors;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/DefaultRuleResolver.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport lombok.Data;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.RoleService;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Slf4j\npublic class DefaultRuleResolver implements AuthorizationRuleResolver {\n\n private RoleService roleService;\n\n public DefaultRuleResolver(RoleService roleService) {\n this.roleService = roleService;\n }\n\n @Override\n public Mono visitRules(Authentication authentication,\n RequestInfo requestInfo) {\n var roleNames = AuthorityUtils.authoritiesToRoles(authentication.getAuthorities());\n var record = new AttributesRecord(requestInfo);\n var visitor = new AuthorizingVisitor(record);\n\n // If the request is an userspace scoped request,\n // then we should check whether the user is the owner of the userspace.\n if (StringUtils.isNotBlank(requestInfo.getUserspace())) {\n if (!authentication.getName().equals(requestInfo.getUserspace())) {\n return Mono.fromSupplier(() -> {\n visitor.visit(null, null, null);\n return visitor;\n });\n }\n }\n\n var stopVisiting = new AtomicBoolean(false);\n return roleService.listDependenciesFlux(roleNames)\n .filter(role -> !CollectionUtils.isEmpty(role.getRules()))\n .doOnNext(role -> {\n if (stopVisiting.get()) {\n return;\n }\n String roleName = role.getMetadata().getName();\n var rules = role.getRules();\n var source = roleBindingDescriber(roleName, authentication.getName());\n for (var rule : rules) {\n if (!visitor.visit(source, rule, null)) {\n stopVisiting.set(true);\n return;\n }\n }\n })\n .takeUntil(item -> stopVisiting.get())\n .onErrorResume(t -> visitor.visit(null, null, t), t -> {\n log.error(\"Error occurred when visiting rules\", t);\n //Do nothing here\n return Mono.empty();\n })\n .then(Mono.just(visitor));\n }\n\n String roleBindingDescriber(String roleName, String subject) {\n return String.format(\"Binding role [%s] to [%s]\", roleName, subject);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/PolicyRuleList.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.ArrayList;\nimport java.util.LinkedList;\nimport java.util.List;\nimport run.halo.app.core.extension.Role;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class PolicyRuleList extends LinkedList {\n private final List errors = new ArrayList<>(4);\n\n /**\n * @return true if an error occurred when parsing PolicyRules\n */\n public boolean hasErrors() {\n return !errors.isEmpty();\n }\n\n public List getErrors() {\n return errors;\n }\n\n public PolicyRuleList addError(Throwable error) {\n errors.add(error);\n return this;\n }\n\n public PolicyRuleList addErrors(List errors) {\n this.errors.addAll(errors);\n return this;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/RbacRequestEvaluation.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.List;\nimport java.util.Objects;\nimport org.apache.commons.lang3.ArrayUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport run.halo.app.core.extension.Role;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class RbacRequestEvaluation {\n interface WildCard {\n String APIGroupAll = \"*\";\n String ResourceAll = \"*\";\n String VerbAll = \"*\";\n String NonResourceAll = \"*\";\n }\n\n public boolean rulesAllow(Attributes requestAttributes, List rules) {\n for (Role.PolicyRule rule : rules) {\n if (ruleAllows(requestAttributes, rule)) {\n return true;\n }\n }\n return false;\n }\n\n protected boolean ruleAllows(Attributes requestAttributes, Role.PolicyRule rule) {\n if (requestAttributes.isResourceRequest()) {\n String combinedResource = requestAttributes.getResource();\n if (StringUtils.isNotBlank(requestAttributes.getSubresource())) {\n combinedResource =\n requestAttributes.getResource() + \"/\" + requestAttributes.getSubresource();\n }\n return verbMatches(rule, requestAttributes.getVerb())\n && apiGroupMatches(rule, requestAttributes.getApiGroup())\n && resourceMatches(rule, combinedResource, requestAttributes.getSubresource())\n && resourceNameMatches(rule,\n combineResourceName(requestAttributes.getName(), requestAttributes.getSubName()));\n }\n return verbMatches(rule, requestAttributes.getVerb())\n && nonResourceURLMatches(rule, requestAttributes.getPath());\n }\n\n private String combineResourceName(String name, String subName) {\n if (StringUtils.isBlank(name)) {\n return subName;\n }\n if (StringUtils.isBlank(subName)) {\n return name;\n }\n return name + \"/\" + subName;\n }\n\n protected boolean verbMatches(Role.PolicyRule rule, String requestedVerb) {\n for (String ruleVerb : rule.getVerbs()) {\n if (Objects.equals(ruleVerb, WildCard.VerbAll)) {\n return true;\n }\n if (Objects.equals(ruleVerb, requestedVerb)) {\n return true;\n }\n }\n return false;\n }\n\n protected boolean apiGroupMatches(Role.PolicyRule rule, String requestedGroup) {\n for (String ruleGroup : rule.getApiGroups()) {\n if (Objects.equals(ruleGroup, WildCard.APIGroupAll)) {\n return true;\n }\n if (Objects.equals(ruleGroup, requestedGroup)) {\n return true;\n }\n }\n return false;\n }\n\n protected boolean resourceMatches(Role.PolicyRule rule, String combinedRequestedResource,\n String requestedSubresource) {\n for (String ruleResource : rule.getResources()) {\n // if everything is allowed, we match\n if (Objects.equals(ruleResource, WildCard.ResourceAll)) {\n return true;\n }\n // if we have an exact match, we match\n if (Objects.equals(ruleResource, combinedRequestedResource)) {\n return true;\n }\n\n // We can also match a */subresource.\n // if there isn't a subresource, then continue\n if (StringUtils.isBlank(requestedSubresource)) {\n continue;\n }\n // if the rule isn't in the format */subresource, then we don't match, continue\n if (StringUtils.length(ruleResource) == StringUtils.length(requestedSubresource) + 2\n && StringUtils.startsWith(ruleResource, \"*/\")\n && StringUtils.startsWith(ruleResource, requestedSubresource)) {\n return true;\n }\n }\n return false;\n }\n\n protected boolean resourceNameMatches(Role.PolicyRule rule, String requestedName) {\n if (ArrayUtils.isEmpty(rule.getResourceNames())) {\n return true;\n }\n String[] requestedNameParts = ArrayUtils.nullToEmpty(StringUtils.split(requestedName, \"/\"));\n for (String ruleName : rule.getResourceNames()) {\n String[] patternParts = StringUtils.split(ruleName, \"/\");\n\n for (int i = 0; i < patternParts.length; i++) {\n String patternPart = patternParts[i];\n String textPart = StringUtils.EMPTY;\n if (requestedNameParts.length > i) {\n textPart = requestedNameParts[i];\n }\n\n if (!matchPart(patternPart, textPart)) {\n return false;\n }\n }\n\n return true;\n }\n return false;\n }\n\n private static boolean matchPart(String patternPart, String textPart) {\n if (patternPart.equals(\"*\")) {\n return true;\n } else if (patternPart.startsWith(\"*\")) {\n return textPart.endsWith(patternPart.substring(1));\n } else if (patternPart.endsWith(\"*\")) {\n return textPart.startsWith(patternPart.substring(0, patternPart.length() - 1));\n } else {\n return patternPart.equals(textPart);\n }\n }\n\n protected boolean nonResourceURLMatches(Role.PolicyRule rule, String requestedURL) {\n for (String ruleURL : rule.getNonResourceURLs()) {\n if (Objects.equals(ruleURL, WildCard.NonResourceAll)) {\n return true;\n }\n if (Objects.equals(ruleURL, requestedURL)) {\n return true;\n }\n if (StringUtils.endsWith(ruleURL, WildCard.NonResourceAll)\n && StringUtils.startsWith(requestedURL,\n StringUtils.stripEnd(ruleURL, WildCard.NonResourceAll))) {\n return true;\n }\n }\n return false;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/RequestInfo.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.Objects;\nimport lombok.Getter;\nimport lombok.ToString;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\n\n/**\n * RequestInfo holds information parsed from the {@link ServerHttpRequest}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Getter\n@ToString\npublic class RequestInfo {\n boolean isResourceRequest;\n final String path;\n String namespace;\n String userspace;\n String verb;\n String apiPrefix;\n String apiGroup;\n String apiVersion;\n String resource;\n\n String name;\n\n String subresource;\n\n String subName;\n\n String[] parts;\n\n public RequestInfo(boolean isResourceRequest, String path, String verb) {\n this(isResourceRequest, path, null, null, verb, null, null, null, null, null, null, null,\n null);\n }\n\n public RequestInfo(boolean isResourceRequest, String path, String namespace, String userspace,\n String verb,\n String apiPrefix,\n String apiGroup,\n String apiVersion, String resource, String name, String subresource, String subName,\n String[] parts) {\n this.isResourceRequest = isResourceRequest;\n this.path = StringUtils.defaultString(path);\n this.namespace = StringUtils.defaultString(namespace);\n this.userspace = StringUtils.defaultString(userspace);\n this.verb = StringUtils.defaultString(verb);\n this.apiPrefix = StringUtils.defaultString(apiPrefix);\n this.apiGroup = StringUtils.defaultString(apiGroup);\n this.apiVersion = StringUtils.defaultString(apiVersion);\n this.resource = StringUtils.defaultString(resource);\n this.subresource = StringUtils.defaultString(subresource);\n this.subName = StringUtils.defaultString(subName);\n this.name = StringUtils.defaultString(name);\n this.parts = Objects.requireNonNullElseGet(parts, () -> new String[] {});\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/RequestInfoAuthorizationManager.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.List;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.security.authorization.AuthorizationDecision;\nimport org.springframework.security.authorization.AuthorizationResult;\nimport org.springframework.security.authorization.ReactiveAuthorizationManager;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.web.server.authorization.AuthorizationContext;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.RoleService;\n\n@Slf4j\npublic class RequestInfoAuthorizationManager\n implements ReactiveAuthorizationManager {\n\n private final AuthorizationRuleResolver ruleResolver;\n\n public RequestInfoAuthorizationManager(RoleService roleService) {\n this.ruleResolver = new DefaultRuleResolver(roleService);\n }\n\n @Override\n public Mono authorize(Mono authentication,\n AuthorizationContext context) {\n var request = context.getExchange().getRequest();\n var requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n\n // We allow anonymous user to access some resources\n // so we don't invoke AuthenticationTrustResolver.isAuthenticated\n // to check if the user is authenticated\n return authentication.filter(Authentication::isAuthenticated)\n .flatMap(auth -> ruleResolver.visitRules(auth, requestInfo))\n .doOnNext(visitor -> showErrorMessage(visitor.getErrors()))\n .map(AuthorizingVisitor::isAllowed)\n .defaultIfEmpty(false)\n .map(AuthorizationDecision::new);\n }\n\n private void showErrorMessage(List errors) {\n if (errors != null) {\n errors.forEach(error -> log.error(\"Access decision error\", error));\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/RequestInfoFactory.java", "content": "package run.halo.app.security.authorization;\n\nimport java.util.Arrays;\nimport java.util.Objects;\nimport java.util.Set;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.http.server.PathContainer;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport run.halo.app.infra.ui.WebSocketUtils;\n\n/**\n * Creates {@link RequestInfo} from {@link ServerHttpRequest}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class RequestInfoFactory {\n public static final RequestInfoFactory INSTANCE =\n new RequestInfoFactory(Set.of(\"api\", \"apis\"), Set.of(\"api\"));\n\n /**\n * without leading and trailing slashes.\n */\n final Set apiPrefixes;\n\n /**\n * without leading and trailing slashes.\n */\n final Set grouplessApiPrefixes;\n\n /**\n * special verbs no subresources.\n */\n final Set specialVerbs;\n\n public RequestInfoFactory(Set apiPrefixes, Set grouplessApiPrefixes) {\n this(apiPrefixes, grouplessApiPrefixes, Set.of(\"proxy\", \"watch\"));\n }\n\n public RequestInfoFactory(Set apiPrefixes, Set grouplessApiPrefixes,\n Set specialVerbs) {\n this.apiPrefixes = apiPrefixes;\n this.grouplessApiPrefixes = grouplessApiPrefixes;\n this.specialVerbs = specialVerbs;\n }\n\n /**\n *

newRequestInfo returns the information from the http request. If error is not occurred,\n * RequestInfo holds the information as best it is known before the failure\n * It handles both resource and non-resource requests and fills in all the pertinent\n * information.

\n *

for each.

\n * Valid Inputs:\n *

Resource paths

\n * 
\n     * /apis/{api-group}/{version}/namespaces\n     * /api/{version}/namespaces\n     * /api/{version}/namespaces/{namespace}\n     * /api/{version}/namespaces/{namespace}/{resource}\n     * /api/{version}/namespaces/{namespace}/{resource}/{resourceName}\n     * /api/{version}/userspaces/{userspace}/{resource}\n     * /api/{version}/userspaces/{userspace}/{resource}/{resourceName}\n     * /api/{version}/{resource}\n     * /api/{version}/{resource}/{resourceName}\n     *
\n *

Special verbs without subresources:

\n * 
\n     * /api/{version}/proxy/{resource}/{resourceName}\n     * /api/{version}/proxy/namespaces/{namespace}/{resource}/{resourceName}\n     *
\n *\n *

Special verbs with subresources:

\n * 
\n     * /api/{version}/watch/{resource}\n     * /api/{version}/watch/namespaces/{namespace}/{resource}\n     *
\n *\n *

NonResource paths:

\n * 
\n     * /apis/{api-group}/{version}\n     * /apis/{api-group}\n     * /apis\n     * /api/{version}\n     * /api\n     * /healthz\n     *
\n *\n * @param request http request\n * @return request holds the information of both resource and non-resource requests\n */\n public RequestInfo newRequestInfo(ServerHttpRequest request) {\n // non-resource request default\n PathContainer path = request.getPath().pathWithinApplication();\n RequestInfo requestInfo =\n new RequestInfo(false, path.value(), request.getMethod().name().toLowerCase());\n\n String[] currentParts = splitPath(path.value());\n\n if (currentParts.length < 3) {\n // return a non-resource request\n return requestInfo;\n }\n\n if (!apiPrefixes.contains(currentParts[0])) {\n // return a non-resource request\n return requestInfo;\n }\n requestInfo.apiPrefix = currentParts[0];\n currentParts = Arrays.copyOfRange(currentParts, 1, currentParts.length);\n\n if (!grouplessApiPrefixes.contains(requestInfo.apiPrefix)) {\n // one part (APIPrefix) has already been consumed, so this is actually \"do we have\n // four parts?\"\n if (currentParts.length < 3) {\n // return a non-resource request\n return requestInfo;\n }\n\n requestInfo.apiGroup = StringUtils.defaultString(currentParts[0]);\n currentParts = Arrays.copyOfRange(currentParts, 1, currentParts.length);\n }\n requestInfo.isResourceRequest = true;\n requestInfo.apiVersion = currentParts[0];\n currentParts = Arrays.copyOfRange(currentParts, 1, currentParts.length);\n // handle input of form /{specialVerb}/*\n Set specialVerbs = Set.of(\"proxy\", \"watch\");\n if (specialVerbs.contains(currentParts[0])) {\n if (currentParts.length < 2) {\n throw new IllegalArgumentException(\n String.format(\"unable to determine kind and namespace from url, %s\",\n request.getPath()));\n }\n requestInfo.verb = currentParts[0];\n currentParts = Arrays.copyOfRange(currentParts, 1, currentParts.length);\n } else {\n requestInfo.verb = switch (request.getMethod().name().toUpperCase()) {\n case \"POST\" -> \"create\";\n case \"GET\", \"HEAD\" -> \"get\";\n case \"PUT\" -> \"update\";\n case \"PATCH\" -> \"patch\";\n case \"DELETE\" -> \"delete\";\n default -> \"\";\n };\n }\n // URL forms: /namespaces/{namespace}/{kind}/*, where parts are adjusted to be relative\n // to kind\n Set namespaceSubresources = Set.of(\"status\", \"finalize\");\n if (Objects.equals(currentParts[0], \"namespaces\")) {\n if (currentParts.length > 1) {\n requestInfo.namespace = currentParts[1];\n\n // if there is another step after the namespace name and it is not a known\n // namespace subresource\n // move currentParts to include it as a resource in its own right\n if (currentParts.length > 2 && !namespaceSubresources.contains(currentParts[2])) {\n currentParts = Arrays.copyOfRange(currentParts, 2, currentParts.length);\n }\n }\n } else if (\"userspaces\".equals(currentParts[0])) {\n if (currentParts.length > 1) {\n requestInfo.userspace = currentParts[1];\n\n // if there is another step after the userspace name\n // move currentParts to include it as a resource in its own right\n if (currentParts.length > 2) {\n currentParts = Arrays.copyOfRange(currentParts, 2, currentParts.length);\n }\n }\n } else {\n requestInfo.userspace = \"\";\n requestInfo.namespace = \"\";\n }\n\n // parsing successful, so we now know the proper value for .Parts\n requestInfo.parts = currentParts;\n // special verbs no subresources\n // parts look like: resource/resourceName/subresource/other/stuff/we/don't/interpret\n if (requestInfo.parts.length >= 3 && !specialVerbs.contains(\n requestInfo.verb)) {\n requestInfo.subresource = requestInfo.parts[2];\n // if there is another step after the subresource name and it is not a known\n if (requestInfo.parts.length >= 4) {\n requestInfo.subName = requestInfo.parts[3];\n }\n }\n\n if (requestInfo.parts.length >= 2) {\n requestInfo.name = requestInfo.parts[1];\n }\n\n if (requestInfo.parts.length >= 1) {\n requestInfo.resource = requestInfo.parts[0];\n }\n\n // has name and no subresource but verb=create, then this is a non-resource request\n if (StringUtils.isNotBlank(requestInfo.name) && StringUtils.isBlank(requestInfo.subresource)\n && \"create\".equals(requestInfo.verb)) {\n requestInfo.isResourceRequest = false;\n }\n\n // if there's no name on the request and we thought it was a get before, then the actual\n // verb is a list or a watch\n if (requestInfo.name.isEmpty() && \"get\".equals(requestInfo.verb)) {\n var watch = request.getQueryParams().getFirst(\"watch\");\n if (Boolean.parseBoolean(watch)) {\n requestInfo.verb = \"watch\";\n } else {\n requestInfo.verb = \"list\";\n }\n }\n // if there's no name on the request and we thought it was a deleted before, then the\n // actual verb is deletecollection\n if (Objects.equals(requestInfo.verb, \"delete\")) {\n var deleteAll = request.getQueryParams().getFirst(\"all\");\n if (Boolean.parseBoolean(deleteAll)) {\n requestInfo.verb = \"deletecollection\";\n }\n }\n if (\"list\".equals(requestInfo.verb)\n && WebSocketUtils.isWebSocketUpgrade(request.getHeaders())) {\n requestInfo.verb = \"watch\";\n }\n return requestInfo;\n }\n\n private String[] splitPath(String path) {\n path = StringUtils.strip(path, \"/\");\n if (StringUtils.isEmpty(path)) {\n return new String[] {};\n }\n return StringUtils.split(path, \"/\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/authorization/RuleAccumulator.java", "content": "package run.halo.app.security.authorization;\n\nimport run.halo.app.core.extension.Role;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic interface RuleAccumulator {\n boolean visit(String source, Role.PolicyRule rule, Throwable err);\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceCookieResolver.java", "content": "package run.halo.app.security.device;\n\nimport java.time.Duration;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.lang.Nullable;\nimport org.springframework.web.server.ServerWebExchange;\n\npublic interface DeviceCookieResolver {\n @Nullable\n HttpCookie resolveCookie(ServerWebExchange exchange);\n\n void setCookie(ServerWebExchange exchange, String value);\n\n void expireCookie(ServerWebExchange exchange);\n\n String getCookieName();\n\n Duration getCookieMaxAge();\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceCookieResolverImpl.java", "content": "package run.halo.app.security.device;\n\nimport java.time.Duration;\nimport lombok.Getter;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.http.ResponseCookie;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebExchange;\n\n@Getter\n@Component\npublic class DeviceCookieResolverImpl implements DeviceCookieResolver {\n public static final String DEVICE_COOKIE_KEY = \"device_id\";\n\n private final String cookieName = DEVICE_COOKIE_KEY;\n\n private final Duration cookieMaxAge = Duration.ofDays(100);\n\n @Override\n public HttpCookie resolveCookie(ServerWebExchange exchange) {\n return exchange.getRequest().getCookies().getFirst(getCookieName());\n }\n\n @Override\n public void setCookie(ServerWebExchange exchange, String value) {\n Assert.notNull(value, \"'value' is required\");\n exchange.getResponse().getCookies()\n .set(getCookieName(), initCookie(exchange, value).build());\n }\n\n @Override\n public void expireCookie(ServerWebExchange exchange) {\n ResponseCookie cookie = initCookie(exchange, \"\").maxAge(0).build();\n exchange.getResponse().getCookies().set(this.cookieName, cookie);\n }\n\n private ResponseCookie.ResponseCookieBuilder initCookie(ServerWebExchange exchange,\n String value) {\n return ResponseCookie.from(this.cookieName, value)\n .path(exchange.getRequest().getPath().contextPath().value() + \"/\")\n .maxAge(getCookieMaxAge())\n .httpOnly(true)\n .secure(\"https\".equalsIgnoreCase(exchange.getRequest().getURI().getScheme()))\n .sameSite(\"Lax\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceEndpoint.java", "content": "package run.halo.app.security.device;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.security.Principal;\nimport java.util.Comparator;\nimport java.util.Map;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport lombok.experimental.Accessors;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.session.ReactiveFindByIndexNameSessionRepository;\nimport org.springframework.session.Session;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Device;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\n\n/**\n * Device endpoint for user profile,every user can only manage their own devices.\n *\n * @author guqing\n * @since 2.17.0\n */\n@Component\n@RequiredArgsConstructor\npublic class DeviceEndpoint implements CustomEndpoint {\n private final ReactiveExtensionClient client;\n private final ReactiveFindByIndexNameSessionRepository sessionRepository;\n private final DeviceService deviceService;\n\n @Override\n public RouterFunction endpoint() {\n final var tag = \"DeviceV1alpha1Uc\";\n return SpringdocRouteBuilder.route()\n .GET(\"devices\", this::listDevices,\n builder -> builder.operationId(\"ListDevices\")\n .description(\"List all user devices\")\n .tag(tag)\n .response(responseBuilder().implementationArray(DeviceDto.class))\n )\n .DELETE(\"devices/{deviceId}\", this::revokeDevice, builder -> builder\n .operationId(\"RevokeDevice\")\n .description(\"Revoke a own device\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"deviceId\")\n .description(\"Device ID\")\n .required(true)\n )\n .response(responseBuilder()\n .responseCode(String.valueOf(HttpStatus.NO_CONTENT))\n )\n )\n .build();\n }\n\n private Mono revokeDevice(ServerRequest request) {\n final var deviceId = request.pathVariable(\"deviceId\");\n return principalName()\n .flatMap(principalName -> deviceService.revoke(principalName, deviceId))\n .then(ServerResponse.noContent().build());\n }\n\n private Mono listDevices(ServerRequest request) {\n return getRequestContext(request)\n .flatMapMany(context -> {\n var listOptions = new ListOptions();\n var query = equal(\"spec.principalName\", context.username());\n listOptions.setFieldSelector(FieldSelector.of(query));\n return client.listAll(Device.class, listOptions,\n Sort.by(\"metadata.creationTimestamp\"))\n .map(device -> {\n var sessionId = device.getSpec().getSessionId();\n var session = context.sessionMap().get(sessionId);\n if (session != null) {\n device.getSpec().setLastAccessedTime(session.getLastAccessedTime());\n }\n return new DeviceDto()\n .setDevice(device)\n .setCurrentDevice(context.sessionId().equals(sessionId))\n .setActive(session != null && !session.isExpired());\n })\n .sort(deviceDtoComparator());\n })\n .collectList()\n .flatMap(deviceDto -> ServerResponse.ok().bodyValue(deviceDto));\n }\n\n Comparator deviceDtoComparator() {\n return Comparator.comparing(DeviceDto::isCurrentDevice)\n .thenComparing(DeviceDto::isActive)\n .thenComparing(DeviceDto::getDevice, Comparator.comparing(device -> {\n var accessedTime = device.getSpec().getLastAccessedTime();\n return accessedTime == null ? device.getMetadata().getCreationTimestamp()\n : accessedTime;\n }))\n .reversed();\n }\n\n private Mono getRequestContext(ServerRequest request) {\n return principalName()\n .flatMap(principalName -> {\n var builder = RequestContext.builder()\n .sessionMap(Map.of())\n .username(principalName);\n var sessionMapMono = sessionRepository.findByPrincipalName(principalName)\n .doOnNext(builder::sessionMap);\n var sessionMono = request.exchange().getSession()\n .doOnNext(session -> builder.sessionId(session.getId()));\n return Mono.when(sessionMapMono, sessionMono)\n .then(Mono.fromSupplier(builder::build));\n });\n }\n\n @Builder\n record RequestContext(String username, String sessionId,\n Map sessionMap) {\n }\n\n Mono principalName() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName);\n }\n\n @Data\n @Accessors(chain = true)\n @Schema(name = \"UserDevice\")\n static class DeviceDto {\n @Schema(requiredMode = REQUIRED)\n private Device device;\n\n @Schema(requiredMode = REQUIRED)\n boolean currentDevice;\n\n @Schema(requiredMode = REQUIRED)\n boolean active;\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"uc.api.security.halo.run/v1alpha1\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceReconciler.java", "content": "package run.halo.app.security.device;\n\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\nimport static run.halo.app.extension.ExtensionUtil.isDeleted;\nimport static run.halo.app.extension.ExtensionUtil.removeFinalizers;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.time.Duration;\nimport java.util.Set;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.session.ReactiveSessionRepository;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.Device;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n@Component\n@RequiredArgsConstructor\npublic class DeviceReconciler implements Reconciler {\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n private static final int MAX_DEVICES = 10;\n static final String FINALIZER_NAME = \"device-protection\";\n private final ReactiveSessionRepository sessionRepository;\n private final ExtensionClient client;\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(Device.class, request.name())\n .ifPresent(device -> {\n if (isDeleted(device)) {\n if (removeFinalizers(device.getMetadata(), Set.of(FINALIZER_NAME))) {\n sessionRepository.deleteById(device.getSpec().getSessionId())\n .block(BLOCKING_TIMEOUT);\n client.update(device);\n }\n return;\n }\n if (addFinalizers(device.getMetadata(), Set.of(FINALIZER_NAME))) {\n client.update(device);\n }\n revokeInactiveDevices(device.getSpec().getPrincipalName());\n });\n return Result.doNotRetry();\n }\n\n private void revokeInactiveDevices(String principalName) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n equal(\"spec.principalName\", principalName))\n );\n client.listAll(Device.class, listOptions,\n Sort.by(\"metadata.creationTimestamp\").descending())\n .stream()\n .skip(MAX_DEVICES)\n .filter(device -> sessionRepository.findById(device.getSpec().getSessionId())\n .blockOptional(BLOCKING_TIMEOUT)\n .isEmpty()\n )\n .forEach(client::delete);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new Device())\n .syncAllOnStart(false)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceSecurityConfigurer.java", "content": "package run.halo.app.security.device;\n\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n@Component\n@RequiredArgsConstructor\nclass DeviceSecurityConfigurer implements SecurityConfigurer {\n\n private final DeviceService deviceService;\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var filter = new DeviceSessionFilter(deviceService);\n http.addFilterAfter(filter, SecurityWebFiltersOrder.REACTOR_CONTEXT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceServiceImpl.java", "content": "package run.halo.app.security.device;\n\nimport static run.halo.app.extension.ExtensionUtil.defaultSort;\nimport static run.halo.app.infra.utils.IpAddressUtils.getClientIp;\nimport static run.halo.app.security.authentication.rememberme.PersistentTokenBasedRememberMeServices.REMEMBER_ME_SERIES_REQUEST_NAME;\n\nimport java.security.Principal;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.UUID;\nimport java.util.function.Function;\nimport java.util.regex.Matcher;\nimport java.util.regex.Pattern;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.security.authentication.AuthenticationTrustResolver;\nimport org.springframework.security.authentication.AuthenticationTrustResolverImpl;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.session.ReactiveSessionRepository;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Device;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.security.authentication.rememberme.PersistentRememberMeTokenRepository;\n\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class DeviceServiceImpl implements DeviceService {\n private final ReactiveExtensionClient client;\n private final DeviceCookieResolver deviceCookieResolver;\n private final ReactiveSessionRepository sessionRepository;\n private final ApplicationEventPublisher eventPublisher;\n private final PersistentRememberMeTokenRepository rememberMeTokenRepository;\n private final AuthenticationTrustResolver trustResolver = new AuthenticationTrustResolverImpl();\n\n @Override\n public Mono loginSuccess(ServerWebExchange exchange, Authentication authentication) {\n return updateExistingDevice(exchange, authentication)\n .switchIfEmpty(createDevice(exchange, authentication)\n .flatMap(client::create)\n .doOnNext(device -> {\n deviceCookieResolver.setCookie(exchange, device.getMetadata().getName());\n eventPublisher.publishEvent(new NewDeviceLoginEvent(this, device));\n })\n )\n .then();\n }\n\n @Override\n public Mono changeSessionId(ServerWebExchange exchange) {\n var deviceIdCookie = deviceCookieResolver.resolveCookie(exchange);\n if (deviceIdCookie == null) {\n return Mono.empty();\n }\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(trustResolver::isAuthenticated)\n .map(Principal::getName)\n .flatMap(username -> {\n var deviceId = deviceIdCookie.getValue();\n return updateWithRetry(deviceId, username, device -> {\n var oldSessionId = device.getSpec().getSessionId();\n return exchange.getSession()\n .filter(session -> !session.getId().equals(oldSessionId))\n .flatMap(session -> {\n device.getSpec().setSessionId(session.getId());\n device.getSpec().setLastAccessedTime(session.getLastAccessTime());\n return sessionRepository.deleteById(oldSessionId);\n })\n .thenReturn(device);\n }).then();\n });\n }\n\n private Mono updateWithRetry(String deviceId, String username,\n Function> updateFunction) {\n return Mono.defer(() -> client.fetch(Device.class, deviceId)\n .filter(device -> device.getSpec().getPrincipalName().equals(username))\n .flatMap(updateFunction)\n .flatMap(client::update)\n )\n .retryWhen(Retry.backoff(8, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n private Mono updateExistingDevice(ServerWebExchange exchange,\n Authentication authentication) {\n var deviceIdCookie = deviceCookieResolver.resolveCookie(exchange);\n if (deviceIdCookie == null) {\n return Mono.empty();\n }\n var principalName = authentication.getName();\n return updateWithRetry(deviceIdCookie.getValue(), principalName,\n (Device existingDevice) -> {\n var sessionId = existingDevice.getSpec().getSessionId();\n return exchange.getSession()\n .flatMap(session -> {\n var userAgent =\n exchange.getRequest().getHeaders().getFirst(HttpHeaders.USER_AGENT);\n var deviceUa = existingDevice.getSpec().getUserAgent();\n if (!StringUtils.equals(deviceUa, userAgent)) {\n // User agent changed, create a new device\n return Mono.empty();\n }\n return Mono.just(session);\n })\n .flatMap(session -> {\n if (session.getId().equals(sessionId)) {\n return Mono.just(session);\n }\n return sessionRepository.deleteById(sessionId).thenReturn(session);\n })\n .map(session -> {\n existingDevice.getSpec().setSessionId(session.getId());\n existingDevice.getSpec().setLastAccessedTime(session.getLastAccessTime());\n existingDevice.getSpec().setLastAuthenticatedTime(Instant.now());\n return existingDevice;\n })\n .flatMap(this::removeRememberMeToken);\n });\n }\n\n @Override\n public Mono revoke(String principalName, String deviceId) {\n return client.fetch(Device.class, deviceId)\n .filter(device -> device.getSpec().getPrincipalName().equals(principalName))\n .flatMap(this::removeRememberMeToken)\n .flatMap(client::delete)\n .flatMap(revoked -> sessionRepository.deleteById(revoked.getSpec().getSessionId()));\n }\n\n @Override\n public Mono revoke(String username) {\n var listOptions = ListOptions.builder()\n .andQuery(Queries.equal(\"spec.principalName\", username))\n .build();\n return client.listAll(Device.class, listOptions, defaultSort())\n .flatMap(this::removeRememberMeToken)\n .flatMap(device -> sessionRepository.deleteById(device.getSpec().getSessionId())\n .thenReturn(device)\n )\n .flatMap(client::delete)\n .then();\n }\n\n private Mono removeRememberMeToken(Device device) {\n var seriesId = device.getSpec().getRememberMeSeriesId();\n if (StringUtils.isBlank(seriesId)) {\n return Mono.just(device);\n }\n log.debug(\"Removing remember-me token for seriesId: {}\", seriesId);\n return rememberMeTokenRepository.removeToken(seriesId)\n .thenReturn(device);\n }\n\n Mono createDevice(ServerWebExchange exchange, Authentication authentication) {\n Assert.notNull(authentication, \"Authentication must not be null.\");\n return Mono.fromSupplier(\n () -> {\n var device = new Device();\n device.setMetadata(new Metadata());\n device.getMetadata().setName(generateDeviceId());\n\n var userAgent =\n exchange.getRequest().getHeaders().getFirst(HttpHeaders.USER_AGENT);\n var deviceInfo = DeviceInfo.parse(userAgent);\n device.setSpec(new Device.Spec()\n .setUserAgent(userAgent)\n .setPrincipalName(authentication.getName())\n .setLastAuthenticatedTime(Instant.now())\n .setIpAddress(getClientIp(exchange.getRequest()))\n .setRememberMeSeriesId(\n exchange.getAttribute(REMEMBER_ME_SERIES_REQUEST_NAME))\n );\n device.getStatus()\n .setOs(deviceInfo.os())\n .setBrowser(deviceInfo.browser());\n return device;\n })\n .flatMap(device -> exchange.getSession()\n .doOnNext(session -> {\n device.getSpec().setSessionId(session.getId());\n device.getSpec().setLastAccessedTime(session.getLastAccessTime());\n })\n .thenReturn(device)\n );\n }\n\n String generateDeviceId() {\n return UUID.randomUUID().toString()\n .replace(\"-\", \"\").toLowerCase();\n }\n\n record DeviceInfo(String browser, String os) {\n static final String UNKNOWN = \"Unknown\";\n static final Pattern BROWSER_REGEX =\n Pattern.compile(\"(MSIE|Trident|Edge|Edg|OPR|Opera|Chrome|Safari|Firefox\"\n + \"|FxiOS|SamsungBrowser|UCBrowser|UCWEB|CriOS|Silk|Raven\\\\|Raven\\\\|)\",\n Pattern.CASE_INSENSITIVE);\n static final Pattern BROWSER_VERSION_REGEX =\n Pattern.compile(\"(?:version/|chrome/|firefox/|safari/|msie \"\n + \"|rv:|opr/|edg/|ucbrowser/|samsungbrowser/|crios/|silk/)(\\\\d+\\\\.\\\\d+)\",\n Pattern.CASE_INSENSITIVE);\n\n static final Pattern OS_REGEX =\n Pattern.compile(\n \"(Windows NT|Mac OS X|Android|Linux|iPhone|iPad|Windows Phone|OpenHarmony)\");\n static final Pattern[] osRegexes = {\n Pattern.compile(\"Windows NT (\\\\d+\\\\.\\\\d+)\"),\n Pattern.compile(\"Mac OS X (\\\\d+[\\\\._]\\\\d+([\\\\._]\\\\d+)?)\"),\n Pattern.compile(\"iPhone OS (\\\\d+_\\\\d+(_\\\\d+)?)\"),\n Pattern.compile(\"Android (\\\\d+\\\\.\\\\d+(\\\\.\\\\d+)?)\"),\n Pattern.compile(\"OpenHarmony (\\\\d+\\\\.\\\\d+(\\\\.\\\\d+)?)\")\n };\n\n public static DeviceInfo parse(String userAgent) {\n return new DeviceInfo(concat(parseBrowser(userAgent).name(),\n parseBrowser(userAgent).version()),\n concat(parseOperatingSystem(userAgent).name(),\n parseOperatingSystem(userAgent).version())\n );\n }\n\n private static Pair parseBrowser(String userAgent) {\n Matcher matcher = BROWSER_REGEX.matcher(userAgent);\n if (matcher.find()) {\n String browserName = matcher.group(1);\n matcher = BROWSER_VERSION_REGEX.matcher(userAgent);\n\n if (matcher.find()) {\n String browserVersion = matcher.group(1);\n return new Pair(browserName, browserVersion);\n } else {\n return new Pair(browserName, null);\n }\n } else {\n return new Pair(UNKNOWN, null);\n }\n }\n\n record Pair(String name, String version) {\n }\n\n private static Pair parseOperatingSystem(String userAgent) {\n Matcher matcher = OS_REGEX.matcher(userAgent);\n var osName = UNKNOWN;\n if (matcher.find()) {\n osName = matcher.group(1);\n }\n var osVersion = parseOsVersion(userAgent);\n return new Pair(osName, osVersion);\n }\n\n private static String parseOsVersion(String userAgent) {\n for (Pattern pattern : osRegexes) {\n Matcher matcher = pattern.matcher(userAgent);\n if (matcher.find()) {\n return matcher.group(1).replace(\"_\", \".\");\n }\n }\n return \"\";\n }\n\n private static String concat(String name, String version) {\n return StringUtils.isBlank(version) ? name : name + \" \" + version;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/DeviceSessionFilter.java", "content": "package run.halo.app.security.device;\n\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\n\n@Slf4j\n@RequiredArgsConstructor\nclass DeviceSessionFilter implements WebFilter {\n\n private final DeviceService deviceService;\n\n @Override\n @NonNull\n public Mono filter(@NonNull ServerWebExchange exchange, @NonNull WebFilterChain chain) {\n return exchange.getSession().flatMap(session -> {\n var previousId = session.getId();\n return chain.filter(exchange)\n .then(Mono.defer(() -> {\n var currentId = session.getId();\n if (Objects.equals(previousId, currentId)) {\n return Mono.empty();\n }\n // only when session id changed\n log.debug(\"Session ID changed from {} to {}, updating device info.\",\n previousId, currentId);\n return deviceService.changeSessionId(exchange);\n }));\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/NewDeviceLoginEvent.java", "content": "package run.halo.app.security.device;\n\nimport lombok.Getter;\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.core.extension.Device;\n\n@Getter\npublic class NewDeviceLoginEvent extends ApplicationEvent {\n private final Device device;\n\n public NewDeviceLoginEvent(Object source, Device device) {\n super(source);\n this.device = device;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/device/NewDeviceLoginListener.java", "content": "package run.halo.app.security.device;\n\nimport java.time.ZoneOffset;\nimport java.time.format.DateTimeFormatter;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Device;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.notification.NotificationReasonEmitter;\nimport run.halo.app.notification.ReasonAttributes;\nimport run.halo.app.notification.UserIdentity;\n\n/**\n *

Sends a notification when a new device login,It listens for {@link NewDeviceLoginEvent}\n * asynchronously.

\n *\n * @author guqing\n * @since 2.17.0\n */\n@Component\n@RequiredArgsConstructor\npublic class NewDeviceLoginListener {\n private static final String REASON_TYPE = \"new-device-login\";\n private static final DateTimeFormatter DATE_TIME_FORMATTER =\n DateTimeFormatter.ofPattern(\"yyyy-MM-dd HH:mm:ss O\").withZone(ZoneOffset.systemDefault());\n private final NotificationCenter notificationCenter;\n private final NotificationReasonEmitter notificationReasonEmitter;\n\n @EventListener\n Mono onApplicationEvent(@NonNull NewDeviceLoginEvent event) {\n return subscribeForNewDeviceLoginReason(event.getDevice())\n .then(sendNewDeviceNotification(event.getDevice()));\n }\n\n Mono sendNewDeviceNotification(Device device) {\n return notificationReasonEmitter.emit(REASON_TYPE, builder -> {\n var attributes = new ReasonAttributes();\n attributes.put(\"principalName\", device.getSpec().getPrincipalName());\n attributes.put(\"os\", device.getStatus().getOs());\n attributes.put(\"browser\", device.getStatus().getBrowser());\n attributes.put(\"ipAddress\", device.getSpec().getIpAddress());\n attributes.put(\"loginTime\",\n DATE_TIME_FORMATTER.format(device.getSpec().getLastAuthenticatedTime()));\n builder.attributes(attributes)\n .author(UserIdentity.of(device.getSpec().getPrincipalName()))\n .subject(Reason.Subject.builder()\n .apiVersion(Device.GROUP + \"/\" + Device.VERSION)\n .kind(Device.KIND)\n .name(device.getMetadata().getName())\n .title(\"在新设备上登录\")\n .build());\n });\n }\n\n Mono subscribeForNewDeviceLoginReason(Device device) {\n var principalName = device.getSpec().getPrincipalName();\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(principalName);\n\n var reason = new Subscription.InterestReason();\n reason.setReasonType(REASON_TYPE);\n reason.setExpression(\"props.principalName == '%s'\".formatted(principalName));\n return notificationCenter.subscribe(subscriber, reason)\n .then();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/jackson2/HaloOAuth2AuthenticationTokenMixin.java", "content": "package run.halo.app.security.jackson2;\n\nimport com.fasterxml.jackson.annotation.JsonAutoDetect;\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonIgnoreProperties;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport com.fasterxml.jackson.annotation.JsonTypeInfo;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport org.springframework.security.oauth2.client.authentication.OAuth2AuthenticationToken;\nimport run.halo.app.security.authentication.oauth2.HaloOAuth2AuthenticationToken;\n\n/**\n * Mixin for {@link HaloOAuth2AuthenticationToken}.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)\n@JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY,\n getterVisibility = JsonAutoDetect.Visibility.NONE,\n isGetterVisibility = JsonAutoDetect.Visibility.NONE)\n@JsonIgnoreProperties(ignoreUnknown = true)\nabstract class HaloOAuth2AuthenticationTokenMixin {\n\n @JsonCreator\n HaloOAuth2AuthenticationTokenMixin(\n @JsonProperty(\"userDetails\") UserDetails userDetails,\n @JsonProperty(\"original\") OAuth2AuthenticationToken original\n ) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/jackson2/HaloSecurityJackson2Module.java", "content": "package run.halo.app.security.jackson2;\n\nimport com.fasterxml.jackson.core.Version;\nimport com.fasterxml.jackson.databind.module.SimpleModule;\nimport org.springframework.security.jackson2.SecurityJackson2Modules;\nimport org.springframework.security.web.authentication.switchuser.SwitchUserGrantedAuthority;\nimport run.halo.app.security.authentication.login.HaloUser;\nimport run.halo.app.security.authentication.oauth2.HaloOAuth2AuthenticationToken;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\n/**\n * Halo security Jackson2 module.\n *\n * @author johnniang\n */\npublic class HaloSecurityJackson2Module extends SimpleModule {\n\n public HaloSecurityJackson2Module() {\n super(HaloSecurityJackson2Module.class.getName(), new Version(1, 0, 0, null, null, null));\n }\n\n @Override\n public void setupModule(SetupContext context) {\n SecurityJackson2Modules.enableDefaultTyping(context.getOwner());\n context.setMixInAnnotations(HaloUser.class, HaloUserMixin.class);\n context.setMixInAnnotations(\n TwoFactorAuthentication.class, TwoFactorAuthenticationMixin.class\n );\n context.setMixInAnnotations(\n HaloOAuth2AuthenticationToken.class, HaloOAuth2AuthenticationTokenMixin.class\n );\n context.setMixInAnnotations(\n SwitchUserGrantedAuthority.class, SwitchUserGrantedAuthorityMixIn.class\n );\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/jackson2/HaloUserMixin.java", "content": "package run.halo.app.security.jackson2;\n\nimport com.fasterxml.jackson.annotation.JsonAutoDetect;\nimport com.fasterxml.jackson.annotation.JsonIgnoreProperties;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport com.fasterxml.jackson.annotation.JsonTypeInfo;\nimport org.springframework.security.core.userdetails.UserDetails;\n\n@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)\n@JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY, getterVisibility =\n JsonAutoDetect.Visibility.NONE, isGetterVisibility = JsonAutoDetect.Visibility.NONE)\n@JsonIgnoreProperties(ignoreUnknown = true)\nabstract class HaloUserMixin {\n\n HaloUserMixin(@JsonProperty(\"delegate\") UserDetails delegate,\n @JsonProperty(\"twoFactorAuthEnabled\") boolean twoFactorAuthEnabled,\n @JsonProperty(\"totpEncryptedSecret\") String totpEncryptedSecret) {\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/jackson2/SwitchUserGrantedAuthorityMixIn.java", "content": "/*\n * Copyright 2002-2024 the original author or authors.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\npackage run.halo.app.security.jackson2;\n\nimport com.fasterxml.jackson.annotation.JsonAutoDetect;\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonIgnoreProperties;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport com.fasterxml.jackson.annotation.JsonTypeInfo;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.web.authentication.switchuser.SwitchUserGrantedAuthority;\nimport org.springframework.security.web.jackson2.WebServletJackson2Module;\n\n/**\n * Jackson mixin class to serialize/deserialize {@link SwitchUserGrantedAuthority}.\n * This class is copied from repository spring-projects/spring-security.\n *\n * @author Markus Heiden\n * @see WebServletJackson2Module\n * @see org.springframework.security.jackson2.SecurityJackson2Modules\n * @since 6.3\n */\n@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)\n@JsonAutoDetect(\n fieldVisibility = JsonAutoDetect.Visibility.ANY,\n getterVisibility = JsonAutoDetect.Visibility.NONE,\n isGetterVisibility = JsonAutoDetect.Visibility.NONE\n)\n@JsonIgnoreProperties(ignoreUnknown = true)\nabstract class SwitchUserGrantedAuthorityMixIn {\n\n @JsonCreator\n SwitchUserGrantedAuthorityMixIn(\n @JsonProperty(\"role\") String role,\n @JsonProperty(\"source\") Authentication source\n ) {\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/jackson2/TwoFactorAuthenticationMixin.java", "content": "package run.halo.app.security.jackson2;\n\nimport com.fasterxml.jackson.annotation.JsonAutoDetect;\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonIgnoreProperties;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport com.fasterxml.jackson.annotation.JsonTypeInfo;\nimport org.springframework.security.core.Authentication;\n\n/**\n * This mixin class is used to serialize/deserialize TwoFactorAuthentication.\n *\n * @author johnniang\n */\n@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)\n@JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY,\n getterVisibility = JsonAutoDetect.Visibility.NONE,\n isGetterVisibility = JsonAutoDetect.Visibility.NONE)\n@JsonIgnoreProperties(ignoreUnknown = true)\nabstract class TwoFactorAuthenticationMixin {\n\n @JsonCreator\n TwoFactorAuthenticationMixin(\n @JsonProperty(\"previous\") Authentication previous\n ) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/DefaultPasswordResetAvailabilityProviders.java", "content": "package run.halo.app.security.preauth;\n\nimport java.util.List;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.properties.SecurityProperties;\nimport run.halo.app.infra.properties.SecurityProperties.PasswordResetMethod;\n\n/**\n * Default password reset availability providers.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\npublic class DefaultPasswordResetAvailabilityProviders\n implements PasswordResetAvailabilityProviders {\n\n private final SecurityProperties securityProperties;\n\n private final List providers;\n\n public DefaultPasswordResetAvailabilityProviders(HaloProperties haloProperties,\n ObjectProvider providers) {\n this.securityProperties = haloProperties.getSecurity();\n this.providers = providers.orderedStream().toList();\n }\n\n @Override\n public Flux getAvailableMethods() {\n return Flux.fromIterable(securityProperties.getPasswordResetMethods())\n .filterWhen(method -> providers.stream()\n .filter(provider -> provider.support(method.getName()))\n .findFirst()\n .map(provider -> provider.isAvailable(method))\n .orElseGet(() -> Mono.just(false))\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/EmailPasswordResetAvailabilityProvider.java", "content": "package run.halo.app.security.preauth;\n\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.properties.SecurityProperties;\n\n/**\n * Email password reset availability provider.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\npublic class EmailPasswordResetAvailabilityProvider implements PasswordResetAvailabilityProvider {\n\n @Override\n public Mono isAvailable(SecurityProperties.PasswordResetMethod method) {\n // TODO Check the email notifier is available in the future\n return Mono.just(true);\n }\n\n @Override\n public boolean support(String name) {\n return \"email\".equals(name);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/PasswordResetAvailabilityProvider.java", "content": "package run.halo.app.security.preauth;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.properties.SecurityProperties;\n\n/**\n * Password reset availability provider.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface PasswordResetAvailabilityProvider {\n\n /**\n * Check if the password reset method is available.\n *\n * @param method password reset method\n * @return true if available, false otherwise\n */\n Mono isAvailable(SecurityProperties.PasswordResetMethod method);\n\n /**\n * Check if the provider supports the name.\n *\n * @param name password reset method name\n * @return true if supports, false otherwise\n */\n boolean support(String name);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/PasswordResetAvailabilityProviders.java", "content": "package run.halo.app.security.preauth;\n\nimport reactor.core.publisher.Flux;\nimport run.halo.app.infra.properties.SecurityProperties.PasswordResetMethod;\n\n/**\n * Password reset availability providers.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic interface PasswordResetAvailabilityProviders {\n\n /**\n * Get available password reset methods.\n *\n * @return available password reset methods\n */\n Flux getAvailableMethods();\n\n /**\n * Get other available password reset methods.\n *\n * @param methodName method name\n * @return other available password reset methods\n */\n default Flux getOtherAvailableMethods(String methodName) {\n return getAvailableMethods().filter(method -> !method.getName().equals(methodName));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/PreAuthEmailPasswordResetEndpoint.java", "content": "package run.halo.app.security.preauth;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\nimport static run.halo.app.infra.ValidationUtils.validate;\n\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport io.github.resilience4j.ratelimiter.RequestNotPermitted;\nimport io.github.resilience4j.reactor.ratelimiter.operator.RateLimiterOperator;\nimport jakarta.validation.constraints.Email;\nimport jakarta.validation.constraints.NotBlank;\nimport jakarta.validation.constraints.Pattern;\nimport jakarta.validation.constraints.Size;\nimport java.net.URI;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Objects;\nimport lombok.Data;\nimport org.springframework.context.MessageSource;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.stereotype.Component;\nimport org.springframework.validation.Validator;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.EmailPasswordRecoveryService;\nimport run.halo.app.core.user.service.InvalidResetTokenException;\nimport run.halo.app.infra.ValidationUtils;\nimport run.halo.app.infra.actuator.GlobalInfoService;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.IpAddressUtils;\n\n/**\n * Pre-auth password reset endpoint.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\nclass PreAuthEmailPasswordResetEndpoint {\n\n private static final String SEND_TEMPLATE = \"password-reset/email/send\";\n private static final String RESET_TEMPLATE = \"password-reset/email/reset\";\n\n private final RateLimiterRegistry rateLimiterRegistry;\n\n public PreAuthEmailPasswordResetEndpoint(\n RateLimiterRegistry rateLimiterRegistry\n ) {\n this.rateLimiterRegistry = rateLimiterRegistry;\n }\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE + 100)\n RouterFunction preAuthPasswordResetEndpoints(\n GlobalInfoService globalInfoService,\n PasswordResetAvailabilityProviders availabilityProviders,\n MessageSource messageSource,\n EmailPasswordRecoveryService emailService,\n Validator validator\n ) {\n return RouterFunctions.nest(path(\"/password-reset/email\"), RouterFunctions.route()\n .GET(\"\", request -> request.bind(SendForm.class)\n .flatMap(sendForm -> ServerResponse.ok().render(SEND_TEMPLATE, Map.of(\n \"otherMethods\", availabilityProviders.getOtherAvailableMethods(\"email\"),\n \"globalInfo\", globalInfoService.getGlobalInfo(),\n \"form\", sendForm\n )))\n )\n .GET(\"/{resetToken}\",\n request -> {\n var token = request.pathVariable(\"resetToken\");\n return request.bind(ResetForm.class)\n .flatMap(resetForm -> {\n var model = new HashMap();\n model.put(\"form\", resetForm);\n model.put(\"globalInfo\", globalInfoService.getGlobalInfo());\n return emailService.getValidResetToken(token)\n .flatMap(resetToken -> {\n // TODO Check the 2FA of the user\n model.put(\"username\", resetToken.username());\n return ServerResponse.ok().render(RESET_TEMPLATE, model);\n })\n .transformDeferred(rateLimiterForPasswordResetVerification(\n request.exchange().getRequest()\n ))\n .onErrorResume(InvalidResetTokenException.class, e ->\n ServerResponse.status(HttpStatus.FOUND)\n .location(URI.create(\n \"/password-reset/email?error=invalid_reset_token\")\n )\n .build()\n )\n .onErrorResume(RequestNotPermitted.class, e -> {\n model.put(\"error\", \"rate_limit_exceeded\");\n return ServerResponse.status(HttpStatus.TOO_MANY_REQUESTS)\n .render(RESET_TEMPLATE, model);\n });\n });\n }\n )\n .POST(\"/{resetToken}\", request -> {\n var token = request.pathVariable(\"resetToken\");\n return request.bind(ResetForm.class)\n .flatMap(resetForm -> emailService.getValidResetToken(token)\n .flatMap(resetToken -> {\n var bindingResult = validate(resetForm, validator, request.exchange());\n var model = bindingResult.getModel();\n model.put(\"globalInfo\", globalInfoService.getGlobalInfo());\n model.put(\"username\", resetToken.username());\n if (!Objects.equals(\n resetForm.getPassword(), resetForm.getConfirmPassword()\n )) {\n bindingResult.rejectValue(\n \"confirmPassword\",\n \"validation.error.password.confirmPassword.mismatch\",\n \"Password and confirm password mismatch\"\n );\n }\n if (bindingResult.hasErrors()) {\n return ServerResponse.badRequest().render(RESET_TEMPLATE, model);\n }\n return emailService.changePassword(resetForm.getPassword(), token)\n .then(ServerResponse.status(HttpStatus.FOUND)\n .location(URI.create(\"/login?password_reset\"))\n .build()\n )\n .transformDeferred(rateLimiterForPasswordResetVerification(\n request.exchange().getRequest()\n ))\n .onErrorResume(RequestNotPermitted.class, e -> {\n model.put(\"error\", \"rate_limit_exceeded\");\n return ServerResponse.status(HttpStatus.TOO_MANY_REQUESTS)\n .render(RESET_TEMPLATE, model);\n });\n })\n .onErrorResume(InvalidResetTokenException.class,\n e -> ServerResponse.status(HttpStatus.FOUND)\n .location(URI.create(\n \"/password-reset/email?error=invalid_reset_token\"\n ))\n .build()\n )\n );\n })\n .POST(\"\", contentType(MediaType.APPLICATION_FORM_URLENCODED),\n request -> request.bind(SendForm.class)\n .flatMap(sendForm -> {\n // validate the send form\n var bindingResult = validate(sendForm, validator, request.exchange());\n var model = bindingResult.getModel();\n model.put(\"globalInfo\", globalInfoService.getGlobalInfo());\n if (bindingResult.hasErrors()) {\n return ServerResponse.badRequest().render(SEND_TEMPLATE, model);\n }\n var email = sendForm.getEmail().toLowerCase();\n return emailService.sendPasswordResetEmail(email)\n .then(Mono.defer(() -> {\n model.put(\"sent\", true);\n return ServerResponse.ok().render(SEND_TEMPLATE, model);\n }))\n .transformDeferred(rateLimiterForSendPasswordResetEmail(\n request.exchange().getRequest()\n ))\n .onErrorResume(RequestNotPermitted.class, e -> {\n model.put(\"error\", \"rate_limit_exceeded\");\n return ServerResponse.status(HttpStatus.TOO_MANY_REQUESTS)\n .render(SEND_TEMPLATE, model);\n });\n })\n )\n .before(HaloUtils.noCache())\n .build());\n }\n\n RateLimiterOperator rateLimiterForSendPasswordResetEmail(ServerHttpRequest request) {\n var clientIp = IpAddressUtils.getClientIp(request);\n var rateLimiterKey = \"send-password-reset-email-from-\" + clientIp;\n var rateLimiter =\n rateLimiterRegistry.rateLimiter(rateLimiterKey, \"send-password-reset-email\");\n return RateLimiterOperator.of(rateLimiter);\n }\n\n RateLimiterOperator rateLimiterForPasswordResetVerification(ServerHttpRequest request) {\n var clientIp = IpAddressUtils.getClientIp(request);\n var rateLimiterKey = \"password-reset-email-verify-from-\" + clientIp;\n var rateLimiter =\n rateLimiterRegistry.rateLimiter(rateLimiterKey, \"password-reset-verification\");\n return RateLimiterOperator.of(rateLimiter);\n }\n\n @Data\n static class ResetForm {\n\n @NotBlank\n @Pattern(\n regexp = ValidationUtils.PASSWORD_REGEX,\n message = \"{validation.error.password.pattern}\"\n )\n @Size(min = 5, max = 257)\n private String password;\n\n @NotBlank\n private String confirmPassword;\n\n }\n\n @Data\n static class SendForm {\n\n @NotBlank\n @Email\n private String email;\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/PreAuthLoginEndpoint.java", "content": "package run.halo.app.security.preauth;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\n\nimport java.net.URI;\nimport java.util.Base64;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.AuthProvider;\nimport run.halo.app.infra.actuator.GlobalInfoService;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.plugin.PluginConst;\nimport run.halo.app.security.AuthProviderService;\nimport run.halo.app.security.HaloServerRequestCache;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.rememberme.RememberMeRequestCache;\nimport run.halo.app.security.authentication.rememberme.WebSessionRememberMeRequestCache;\n\n/**\n * Pre-auth login endpoints.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\nclass PreAuthLoginEndpoint {\n\n private final CryptoService cryptoService;\n\n private final GlobalInfoService globalInfoService;\n\n private final AuthProviderService authProviderService;\n\n private final ServerRequestCache serverRequestCache = new HaloServerRequestCache();\n\n private final RememberMeRequestCache rememberMeRequestCache =\n new WebSessionRememberMeRequestCache();\n\n PreAuthLoginEndpoint(CryptoService cryptoService, GlobalInfoService globalInfoService,\n AuthProviderService authProviderService) {\n this.cryptoService = cryptoService;\n this.globalInfoService = globalInfoService;\n this.authProviderService = authProviderService;\n }\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE + 100)\n RouterFunction preAuthLoginEndpoints() {\n return RouterFunctions.nest(path(\"/login\"), RouterFunctions.route()\n .GET(\"\", request -> {\n var exchange = request.exchange();\n var contextPath = exchange.getRequest().getPath().contextPath().value();\n var publicKey = cryptoService.readPublicKey()\n .map(key -> Base64.getEncoder().encodeToString(key));\n var globalInfo = globalInfoService.getGlobalInfo().cache();\n var authProviders = authProviderService.getEnabledProviders().cache();\n\n var allFormProviders = authProviders\n .filter(ap -> AuthProvider.AuthType.FORM.equals(ap.getSpec().getAuthType()))\n .cache();\n\n var authProvider = Mono.justOrEmpty(request.queryParam(\"method\"))\n .flatMap(method -> allFormProviders\n .filter(ap -> Objects.equals(method, ap.getMetadata().getName()))\n .next()\n .switchIfEmpty(Mono.error(\n () -> new ServerWebInputException(\"Invalid login method \" + method))\n )\n )\n .switchIfEmpty(allFormProviders.next())\n .cache();\n\n var fragmentTemplateName = authProvider.map(ap -> {\n var templateName = \"login_\" + ap.getMetadata().getName();\n return Optional.ofNullable(ap.getMetadata().getLabels())\n .map(labels -> labels.get(PluginConst.PLUGIN_NAME_LABEL_NAME))\n .filter(StringUtils::isNotBlank)\n .map(pluginName -> String.join(\":\", \"plugin\", pluginName, templateName))\n .orElse(templateName);\n });\n\n var socialAuthProviders = authProviders\n .filter(ap -> !AuthProvider.AuthType.FORM.equals(ap.getSpec().getAuthType()))\n .cache();\n var formAuthProviders = allFormProviders\n .filterWhen(ap -> authProvider\n .map(provider -> !Objects.equals(provider.getMetadata().getName(),\n ap.getMetadata().getName())\n )\n )\n .cache();\n\n return serverRequestCache.saveRequest(exchange).then(Mono.defer(() ->\n ServerResponse.ok().render(\"login\", Map.of(\n \"action\", contextPath + \"/login\",\n \"publicKey\", publicKey,\n \"globalInfo\", globalInfo,\n \"authProvider\", authProvider,\n \"fragmentTemplateName\", fragmentTemplateName,\n \"socialAuthProviders\", socialAuthProviders,\n \"formAuthProviders\", formAuthProviders,\n \"rememberMe\", rememberMeRequestCache.isRememberMe(exchange)\n // TODO Add more models here\n ))\n ));\n })\n .POST(\"/social/{authProviderName}\", request -> {\n var authProviderName = request.pathVariable(\"authProviderName\");\n return authProviderService.getEnabledProviders()\n .filter(ap -> Objects.equals(authProviderName, ap.getMetadata().getName()))\n .filter(ap -> !AuthProvider.AuthType.FORM.equals(ap.getSpec().getAuthType()))\n .next()\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"Auth provider \" + authProviderName + \" not found or not enabled.\"\n )))\n .flatMap(ap -> {\n var authenticationUrl = ap.getSpec().getAuthenticationUrl();\n return rememberMeRequestCache.saveRememberMe(request.exchange())\n .then(Mono.defer(() -> ServerResponse.status(HttpStatus.FOUND)\n .location(URI.create(authenticationUrl))\n .build()\n ));\n });\n })\n .before(HaloUtils.noCache())\n .build());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/PreAuthSignUpEndpoint.java", "content": "package run.halo.app.security.preauth;\n\nimport static org.springframework.http.MediaType.APPLICATION_FORM_URLENCODED;\nimport static org.springframework.http.MediaType.APPLICATION_JSON;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\nimport static run.halo.app.infra.ValidationUtils.validate;\n\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport io.github.resilience4j.ratelimiter.RequestNotPermitted;\nimport io.github.resilience4j.reactor.ratelimiter.operator.RateLimiterOperator;\nimport jakarta.validation.constraints.Email;\nimport jakarta.validation.constraints.NotBlank;\nimport java.net.URI;\nimport lombok.Data;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.stereotype.Component;\nimport org.springframework.validation.BeanPropertyBindingResult;\nimport org.springframework.validation.FieldError;\nimport org.springframework.validation.Validator;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.EmailVerificationService;\nimport run.halo.app.core.user.service.SignUpData;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.infra.actuator.GlobalInfoService;\nimport run.halo.app.infra.exception.DuplicateNameException;\nimport run.halo.app.infra.exception.EmailAlreadyTakenException;\nimport run.halo.app.infra.exception.EmailVerificationFailed;\nimport run.halo.app.infra.exception.RateLimitExceededException;\nimport run.halo.app.infra.exception.RequestBodyValidationException;\nimport run.halo.app.infra.exception.RestrictedNameException;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.IpAddressUtils;\n\n/**\n * Pre-auth sign up endpoint.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\nclass PreAuthSignUpEndpoint {\n\n private final GlobalInfoService globalInfoService;\n\n private final Validator validator;\n\n private final UserService userService;\n\n private final EmailVerificationService emailVerificationService;\n\n private final RateLimiterRegistry rateLimiterRegistry;\n\n PreAuthSignUpEndpoint(GlobalInfoService globalInfoService,\n Validator validator,\n UserService userService,\n EmailVerificationService emailVerificationService,\n RateLimiterRegistry rateLimiterRegistry) {\n this.globalInfoService = globalInfoService;\n this.validator = validator;\n this.userService = userService;\n this.emailVerificationService = emailVerificationService;\n this.rateLimiterRegistry = rateLimiterRegistry;\n }\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE + 100)\n RouterFunction preAuthSignUpEndpoints() {\n return RouterFunctions.nest(path(\"/signup\"), RouterFunctions.route()\n .GET(\"\", request -> {\n var signUpData = new SignUpData();\n var bindingResult = new BeanPropertyBindingResult(signUpData, \"form\");\n var model = bindingResult.getModel();\n model.put(\"globalInfo\", globalInfoService.getGlobalInfo());\n return ServerResponse.ok().render(\"signup\", model);\n })\n .POST(\n \"\",\n contentType(APPLICATION_FORM_URLENCODED),\n request -> request.bind(SignUpData.class)\n .flatMap(signUpData -> {\n // sign up\n var bindingResult = validate(signUpData, validator, request.exchange());\n var model = bindingResult.getModel();\n model.put(\"globalInfo\", globalInfoService.getGlobalInfo());\n if (bindingResult.hasErrors()) {\n return ServerResponse.ok().render(\"signup\", model);\n }\n return userService.signUp(signUpData)\n .flatMap(user -> ServerResponse.status(HttpStatus.FOUND)\n .location(URI.create(\"/login?signup\"))\n .build()\n )\n .doOnError(t -> {\n model.put(\"error\", \"unknown\");\n model.put(\"errorMessage\", t.getMessage());\n })\n .doOnError(EmailVerificationFailed.class,\n e -> {\n bindingResult.addError(new FieldError(\"form\",\n \"emailCode\",\n signUpData.getEmailCode(),\n true,\n new String[] {\"signup.error.email-code.invalid\"},\n null,\n \"Invalid Email Code\"));\n }\n )\n .doOnError(EmailAlreadyTakenException.class, e -> {\n bindingResult.addError(new FieldError(\"form\",\n \"email\",\n signUpData.getEmail(),\n true,\n new String[] {\"signup.error.email.already-taken\"},\n null,\n \"Email Already Taken\"));\n })\n .doOnError(RateLimitExceededException.class,\n e -> model.put(\"error\", \"rate-limit-exceeded\")\n )\n .doOnError(DuplicateNameException.class,\n e -> model.put(\"error\", \"duplicate-username\")\n )\n .doOnError(RestrictedNameException.class,\n e -> model.put(\"error\", \"restricted-username\")\n )\n .onErrorResume(e -> ServerResponse.ok().render(\"signup\", model));\n })\n )\n .POST(\"/send-email-code\", contentType(APPLICATION_JSON),\n request -> request.bodyToMono(SendEmailCodeBody.class)\n .flatMap(body -> {\n var bindingResult = validate(body, \"body\", validator, request.exchange());\n if (bindingResult.hasErrors()) {\n return Mono.error(new RequestBodyValidationException(bindingResult));\n }\n var email = body.getEmail();\n return emailVerificationService.sendRegisterVerificationCode(email)\n .transformDeferred(\n rateLimiterForSendingEmailCode(request.exchange().getRequest())\n )\n .onErrorMap(RequestNotPermitted.class, RateLimitExceededException::new);\n })\n .then(ServerResponse.accepted().build())\n )\n .before(HaloUtils.noCache())\n .build());\n }\n\n private RateLimiterOperator rateLimiterForSendingEmailCode(ServerHttpRequest request) {\n var clientIp = IpAddressUtils.getClientIp(request);\n var rateLimiterKey = \"send-email-code-for-signing-up-from-\" + clientIp;\n var rateLimiter =\n rateLimiterRegistry.rateLimiter(rateLimiterKey, \"send-email-verification-code\");\n return RateLimiterOperator.of(rateLimiter);\n }\n\n\n @Data\n public static class SendEmailCodeBody {\n\n @Email\n @NotBlank\n String email;\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/PreAuthTwoFactorEndpoint.java", "content": "package run.halo.app.security.preauth;\n\nimport java.util.Map;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.infra.actuator.GlobalInfoService;\nimport run.halo.app.infra.utils.HaloUtils;\n\n/**\n * Pre-auth two-factor endpoints.\n *\n * @author johnniang\n * @since 2.20.0\n */\n@Component\nclass PreAuthTwoFactorEndpoint {\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE + 100)\n RouterFunction preAuthTwoFactorEndpoints(GlobalInfoService globalInfoService) {\n return RouterFunctions.route()\n .GET(\"/challenges/two-factor/totp\",\n request -> ServerResponse.ok().render(\"challenges/two-factor/totp\", Map.of(\n \"globalInfo\", globalInfoService.getGlobalInfo()\n ))\n )\n .before(HaloUtils.noCache())\n .build();\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/preauth/SystemSetupEndpoint.java", "content": "package run.halo.app.security.preauth;\n\nimport static io.r2dbc.spi.ConnectionFactoryOptions.DRIVER;\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.path;\nimport static run.halo.app.infra.ValidationUtils.validate;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport jakarta.validation.constraints.Email;\nimport jakarta.validation.constraints.NotBlank;\nimport jakarta.validation.constraints.NotNull;\nimport jakarta.validation.constraints.Pattern;\nimport jakarta.validation.constraints.Size;\nimport java.net.URI;\nimport java.nio.charset.StandardCharsets;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.Properties;\nimport lombok.Data;\nimport lombok.RequiredArgsConstructor;\nimport org.hibernate.validator.constraints.URL;\nimport org.springdoc.core.fn.builders.content.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.beans.factory.config.PlaceholderConfigurerSupport;\nimport org.springframework.boot.r2dbc.autoconfigure.R2dbcConnectionDetails;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.core.io.ClassPathResource;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.util.InMemoryResource;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.PropertyPlaceholderHelper;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.validation.BeanPropertyBindingResult;\nimport org.springframework.validation.BindingResult;\nimport org.springframework.validation.Validator;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.ExternalUrlChangedEvent;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.InitializationStateGetter;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemState;\nimport run.halo.app.infra.ValidationUtils;\nimport run.halo.app.infra.exception.RequestBodyValidationException;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\nimport run.halo.app.plugin.PluginService;\nimport run.halo.app.security.SuperAdminInitializer;\nimport run.halo.app.theme.service.ThemeService;\n\n@Component\n@RequiredArgsConstructor\npublic class SystemSetupEndpoint {\n static final String SETUP_TEMPLATE = \"setup\";\n static final PropertyPlaceholderHelper PROPERTY_PLACEHOLDER_HELPER =\n new PropertyPlaceholderHelper(\n PlaceholderConfigurerSupport.DEFAULT_PLACEHOLDER_PREFIX,\n PlaceholderConfigurerSupport.DEFAULT_PLACEHOLDER_SUFFIX\n );\n\n private final InitializationStateGetter initializationStateGetter;\n private final SystemConfigFetcher systemConfigFetcher;\n private final SuperAdminInitializer superAdminInitializer;\n private final ReactiveExtensionClient client;\n private final PluginService pluginService;\n private final ThemeService themeService;\n private final Validator validator;\n private final ObjectProvider connectionDetails;\n private final ExternalUrlSupplier externalUrl;\n private final ApplicationEventPublisher eventPublisher;\n\n @Bean\n @Order(Ordered.HIGHEST_PRECEDENCE + 100)\n RouterFunction setupPageRouter() {\n final var tag = \"SystemV1alpha1Public\";\n return SpringdocRouteBuilder.route()\n .GET(path(\"/system/setup\").and(accept(MediaType.TEXT_HTML)), this::setupPage,\n builder -> builder.operationId(\"JumpToSetupPage\")\n .description(\"Jump to setup page\")\n .tag(tag)\n .response(responseBuilder()\n .content(Builder.contentBuilder()\n .mediaType(MediaType.TEXT_HTML_VALUE))\n .implementation(String.class)\n )\n )\n .POST(\"/system/setup\", contentType(MediaType.APPLICATION_FORM_URLENCODED), this::setup,\n builder -> builder\n .operationId(\"SetupSystem\")\n .description(\"Setup system\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(SetupRequest.class))\n )\n )\n .response(responseBuilder()\n .responseCode(String.valueOf(HttpStatus.NO_CONTENT.value()))\n .implementation(Void.class)\n )\n )\n .before(HaloUtils.noCache())\n .build();\n }\n\n private Mono setup(ServerRequest request) {\n return initializationStateGetter.userInitialized()\n .filter(initialized -> !initialized)\n .flatMap(ignored -> request.bind(SetupRequest.class)\n .flatMap(setupRequest -> {\n // validate it\n var bindingResult = validate(setupRequest, validator, request.exchange());\n if (bindingResult.hasErrors()) {\n return handleValidationErrors(bindingResult, request);\n }\n return doInitialization(setupRequest).then(handleSetupSuccessfully(request));\n })\n )\n .switchIfEmpty(redirectToConsole());\n }\n\n private static Mono handleSetupSuccessfully(ServerRequest request) {\n if (isHtmlRequest(request)) {\n return redirectToConsole();\n }\n return ServerResponse.noContent().build();\n }\n\n private Mono handleValidationErrors(BindingResult bindingResult,\n ServerRequest request) {\n if (isHtmlRequest(request)) {\n var model = bindingResult.getModel();\n model.put(\"usingH2database\", usingH2database());\n return ServerResponse.status(HttpStatus.BAD_REQUEST)\n .render(SETUP_TEMPLATE, model);\n }\n return Mono.error(new RequestBodyValidationException(bindingResult));\n }\n\n private static boolean isHtmlRequest(ServerRequest request) {\n return request.headers().accept().contains(MediaType.TEXT_HTML)\n && !HaloUtils.isXhr(request.headers().asHttpHeaders());\n }\n\n private static Mono redirectToConsole() {\n return ServerResponse.status(HttpStatus.FOUND).location(URI.create(\"/console\")).build();\n }\n\n private Mono doInitialization(SetupRequest body) {\n var superUserMono = superAdminInitializer.initialize(\n SuperAdminInitializer.InitializationParam.builder()\n .username(body.getUsername())\n .password(body.getPassword())\n .email(body.getEmail())\n .build()\n )\n .subscribeOn(Schedulers.boundedElastic());\n\n var basicConfigMono = Mono.defer(() -> systemConfigFetcher.getConfigMap()\n .flatMap(configMap -> {\n mergeToBasicConfig(body, configMap);\n return client.update(configMap);\n })\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException)\n )\n .subscribeOn(Schedulers.boundedElastic())\n .then(Mono.fromCallable(() -> {\n eventPublisher.publishEvent(\n new ExternalUrlChangedEvent(this, URI.create(body.getExternalUrl()).toURL())\n );\n return null;\n }));\n return Mono.when(\n basicConfigMono,\n superUserMono,\n initializeNecessaryData(body.getUsername()),\n pluginService.installPresetPlugins(),\n themeService.installPresetTheme()\n )\n .then(SystemState.upsetSystemState(client, state -> state.setIsSetup(true)));\n }\n\n private Mono initializeNecessaryData(String username) {\n return loadPresetExtensions(username)\n .concatMap(client::create)\n .subscribeOn(Schedulers.boundedElastic())\n .then();\n }\n\n private static void mergeToBasicConfig(SetupRequest body, ConfigMap configMap) {\n Map data = configMap.getData();\n if (data == null) {\n data = new LinkedHashMap<>();\n configMap.setData(data);\n }\n String basic = data.getOrDefault(SystemSetting.Basic.GROUP, \"{}\");\n var basicSetting = JsonUtils.jsonToObject(basic, SystemSetting.Basic.class);\n basicSetting.setTitle(body.getSiteTitle());\n basicSetting.setLanguage(body.getLanguage());\n basicSetting.setExternalUrl(body.getExternalUrl());\n data.put(SystemSetting.Basic.GROUP, JsonUtils.objectToJson(basicSetting));\n }\n\n private Mono setupPage(ServerRequest request) {\n return initializationStateGetter.userInitialized()\n .flatMap(initialized -> {\n if (initialized) {\n return redirectToConsole();\n }\n var setupRequest = new SetupRequest();\n setupRequest.setExternalUrl(\n externalUrl.getURL(request.exchange().getRequest()).toString()\n );\n var bindingResult = new BeanPropertyBindingResult(setupRequest, \"form\");\n var model = bindingResult.getModel();\n model.put(\"usingH2database\", usingH2database());\n return ServerResponse.ok().render(SETUP_TEMPLATE, model);\n });\n }\n\n private boolean usingH2database() {\n var rcd = connectionDetails.getIfUnique();\n if (rcd == null) {\n // If no R2dbcConnectionDetails is available, we assume H2(mem) is used.\n return true;\n }\n var options = rcd.getConnectionFactoryOptions();\n return Optional.ofNullable(options.getValue(DRIVER))\n .map(Object::toString)\n .map(\"h2\"::equalsIgnoreCase)\n .orElse(false);\n }\n\n @Data\n static class SetupRequest {\n\n @Schema(requiredMode = REQUIRED, minLength = 4, maxLength = 63)\n @NotBlank\n @Size(min = 4, max = 63)\n @Pattern(regexp = ValidationUtils.NAME_REGEX,\n message = \"{validation.error.username.pattern}\")\n private String username;\n\n @Schema(requiredMode = REQUIRED, minLength = 5, maxLength = 257)\n @NotBlank\n @Pattern(regexp = ValidationUtils.PASSWORD_REGEX,\n message = \"{validation.error.password.pattern}\")\n @Size(min = 5, max = 257)\n private String password;\n\n @Email\n private String email;\n\n @NotBlank\n @Size(max = 80)\n private String siteTitle;\n\n @Pattern(regexp = \"^(zh-CN|zh-TW|en|es)$\")\n private String language;\n\n @NotNull\n @URL(regexp = \"^(http|https).*\")\n private String externalUrl;\n }\n\n Flux loadPresetExtensions(String username) {\n return Mono.fromCallable(\n () -> {\n // read initial-data.yaml to string\n var classPathResource = new ClassPathResource(\"initial-data.yaml\");\n String rawContent = StreamUtils.copyToString(classPathResource.getInputStream(),\n StandardCharsets.UTF_8);\n // build properties\n var properties = new Properties();\n properties.setProperty(\"username\", username);\n properties.setProperty(\"timestamp\", Instant.now().toString());\n // replace placeholders\n var processedContent =\n PROPERTY_PLACEHOLDER_HELPER.replacePlaceholders(rawContent, properties);\n // load yaml to unstructured\n var stringResource =\n new InMemoryResource(processedContent.getBytes(StandardCharsets.UTF_8));\n var loader = new YamlUnstructuredLoader(stringResource);\n return loader.load();\n })\n .flatMapMany(Flux::fromIterable)\n .subscribeOn(Schedulers.boundedElastic());\n }\n}" }, { "path": "application/src/main/java/run/halo/app/security/session/InMemoryReactiveIndexedSessionRepository.java", "content": "package run.halo.app.security.session;\n\nimport com.google.common.cache.Cache;\nimport com.google.common.cache.CacheBuilder;\nimport java.time.Duration;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ConcurrentMap;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.session.DelegatingIndexResolver;\nimport org.springframework.session.IndexResolver;\nimport org.springframework.session.MapSession;\nimport org.springframework.session.PrincipalNameIndexResolver;\nimport org.springframework.session.ReactiveMapSessionRepository;\nimport org.springframework.session.Session;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\n\npublic class InMemoryReactiveIndexedSessionRepository extends ReactiveMapSessionRepository\n implements ReactiveIndexedSessionRepository, DisposableBean {\n\n final IndexResolver indexResolver =\n new DelegatingIndexResolver<>(new PrincipalNameIndexResolver<>(PRINCIPAL_NAME_INDEX_NAME));\n\n private final ConcurrentMap> sessionIdIndexMap =\n new ConcurrentHashMap<>();\n private final ConcurrentMap> indexSessionIdMap =\n new ConcurrentHashMap<>();\n\n /**\n * Prevent other requests from being parsed and acquiring the session during its deletion,\n * which could result in an unintended renewal. Currently, it acts as a buffer, and having a\n * slightly prolonged expiration period is sufficient.\n */\n private final Cache invalidateSessionIds = CacheBuilder.newBuilder()\n .expireAfterWrite(Duration.ofMinutes(10))\n .maximumSize(10_000)\n .build();\n\n public InMemoryReactiveIndexedSessionRepository(Map sessions) {\n super(sessions);\n }\n\n @Override\n public Mono save(MapSession session) {\n if (invalidateSessionIds.getIfPresent(session.getId()) != null) {\n return this.deleteById(session.getId());\n }\n return super.save(session)\n .then(updateIndex(session));\n }\n\n @Override\n public Mono deleteById(String id) {\n return removeIndex(id)\n .then(Mono.defer(() -> {\n invalidateSessionIds.put(id, true);\n return super.deleteById(id);\n }));\n }\n\n @Override\n public Mono> findByIndexNameAndIndexValue(String indexName,\n String indexValue) {\n var indexKey = new IndexKey(indexName, indexValue);\n return Flux.fromStream((() -> indexSessionIdMap.getOrDefault(indexKey, Set.of()).stream()))\n .flatMap(this::findById)\n .collectMap(Session::getId);\n }\n\n @Override\n public Mono> findByPrincipalName(String principalName) {\n return this.findByIndexNameAndIndexValue(PRINCIPAL_NAME_INDEX_NAME, principalName);\n }\n\n @Override\n public void destroy() {\n sessionIdIndexMap.clear();\n indexSessionIdMap.clear();\n invalidateSessionIds.invalidateAll();\n }\n\n Mono removeIndex(String sessionId) {\n return getIndexes(sessionId)\n .doOnNext(indexKey -> indexSessionIdMap.computeIfPresent(indexKey,\n (key, sessionIdSet) -> {\n sessionIdSet.remove(sessionId);\n return sessionIdSet.isEmpty() ? null : sessionIdSet;\n })\n )\n .then(Mono.defer(() -> {\n sessionIdIndexMap.remove(sessionId);\n return Mono.empty();\n }))\n .then();\n }\n\n Mono updateIndex(MapSession session) {\n return removeIndex(session.getId())\n .then(Mono.defer(() -> {\n if (!session.getId().equals(session.getOriginalId())) {\n return removeIndex(session.getOriginalId());\n }\n return Mono.empty();\n }))\n .then(Mono.defer(() -> {\n indexResolver.resolveIndexesFor(session)\n .forEach((name, value) -> {\n IndexKey indexKey = new IndexKey(name, value);\n indexSessionIdMap.computeIfAbsent(indexKey,\n unusedSet -> ConcurrentHashMap.newKeySet())\n .add(session.getId());\n // Update sessionIdIndexMap\n sessionIdIndexMap.computeIfAbsent(session.getId(),\n unusedSet -> ConcurrentHashMap.newKeySet())\n .add(indexKey);\n });\n return Mono.empty();\n }))\n .then();\n }\n\n Flux getIndexes(String sessionId) {\n return Flux.fromIterable(sessionIdIndexMap.getOrDefault(sessionId, Set.of()));\n }\n\n /**\n * For testing purpose.\n */\n ConcurrentMap> getSessionIdIndexMap() {\n return sessionIdIndexMap;\n }\n\n /**\n * For testing purpose.\n */\n ConcurrentMap> getIndexSessionIdMap() {\n return indexSessionIdMap;\n }\n\n record IndexKey(String attributeName, String attributeValue) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/session/ReactiveIndexedSessionRepository.java", "content": "package run.halo.app.security.session;\n\nimport org.springframework.session.ReactiveFindByIndexNameSessionRepository;\nimport org.springframework.session.ReactiveSessionRepository;\nimport org.springframework.session.Session;\n\npublic interface ReactiveIndexedSessionRepository\n extends ReactiveSessionRepository, ReactiveFindByIndexNameSessionRepository {\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/session/SessionInvalidationListener.java", "content": "package run.halo.app.security.session;\n\nimport java.time.Duration;\nimport java.util.Map;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.event.EventListener;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.session.ReactiveFindByIndexNameSessionRepository;\nimport org.springframework.session.ReactiveSessionRepository;\nimport org.springframework.session.Session;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.event.user.PasswordChangedEvent;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n@Component\n@RequiredArgsConstructor\npublic class SessionInvalidationListener {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final ReactiveFindByIndexNameSessionRepository\n indexedSessionRepository;\n private final ReactiveSessionRepository sessionRepository;\n\n @Async\n @EventListener\n public void onPasswordChanged(PasswordChangedEvent event) {\n String username = event.getUsername();\n // Invalidate session\n invalidateUserSessions(username);\n }\n\n private void invalidateUserSessions(String username) {\n indexedSessionRepository.findByPrincipalName(username)\n .map(Map::keySet)\n .flatMapMany(Flux::fromIterable)\n .flatMap(sessionRepository::deleteById)\n .then()\n .block(BLOCKING_TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/security/switchuser/SwitchUserConfigurer.java", "content": "package run.halo.app.security.switchuser;\n\nimport org.springframework.security.config.web.server.SecurityWebFiltersOrder;\nimport org.springframework.security.config.web.server.ServerHttpSecurity;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.web.server.authentication.RedirectServerAuthenticationFailureHandler;\nimport org.springframework.security.web.server.authentication.SwitchUserWebFilter;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.security.HaloRedirectAuthenticationSuccessHandler;\nimport run.halo.app.security.authentication.SecurityConfigurer;\n\n/**\n * Switch user configurer.\n *\n * @author johnniang\n */\n@Component\nclass SwitchUserConfigurer implements SecurityConfigurer {\n\n private final ReactiveUserDetailsService userDetailsService;\n\n SwitchUserConfigurer(ReactiveUserDetailsService userDetailsService) {\n this.userDetailsService = userDetailsService;\n }\n\n @Override\n public void configure(ServerHttpSecurity http) {\n var successHandler = new HaloRedirectAuthenticationSuccessHandler(\"/console\");\n var failureHandler =\n new RedirectServerAuthenticationFailureHandler(\"/login?error=impersonate\");\n var filter = new SwitchUserWebFilter(userDetailsService, successHandler, failureHandler);\n http.addFilterAfter(filter, SecurityWebFiltersOrder.AUTHORIZATION);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/CompositeTemplateResolver.java", "content": "package run.halo.app.theme;\n\nimport static java.util.Comparator.comparing;\nimport static java.util.Comparator.naturalOrder;\nimport static java.util.Comparator.nullsLast;\n\nimport java.util.Collection;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.stream.Collectors;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.templateresolver.ITemplateResolver;\nimport org.thymeleaf.templateresolver.TemplateResolution;\nimport run.halo.app.infra.exception.NotFoundException;\n\n/**\n * Composite template resolver to control execution flow of multiple template resolvers.\n *\n * @author johnniang\n */\nclass CompositeTemplateResolver implements ITemplateResolver {\n\n private final List resolvers;\n\n public CompositeTemplateResolver(Collection resolvers) {\n this.resolvers = Optional.ofNullable(resolvers).orElseGet(List::of)\n .stream()\n .distinct()\n // we keep the same order comparison as\n // org.thymeleaf.EngineConfiguration.TemplateResolverComparator\n .sorted(comparing(ITemplateResolver::getOrder, nullsLast(naturalOrder())))\n .toList();\n }\n\n @Override\n public String getName() {\n return resolvers.stream()\n .map(ITemplateResolver::getName)\n .collect(Collectors.joining(\", \"));\n }\n\n @Override\n public Integer getOrder() {\n // null order means to be the end of the resolvers.\n return null;\n }\n\n @Override\n public TemplateResolution resolveTemplate(IEngineConfiguration configuration,\n String ownerTemplate, String template, Map templateResolutionAttributes) {\n return resolvers.stream()\n .map(resolver -> resolver.resolveTemplate(\n configuration, ownerTemplate, template, templateResolutionAttributes)\n )\n .filter(Objects::nonNull)\n .findFirst()\n .orElseThrow(() -> new NotFoundException(\"Template \" + template + \" was not found.\"));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/DefaultTemplateEnum.java", "content": "package run.halo.app.theme;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic enum DefaultTemplateEnum {\n INDEX(\"index\"),\n\n CATEGORIES(\"categories\"),\n\n CATEGORY(\"category\"),\n\n ARCHIVES(\"archives\"),\n\n POST(\"post\"),\n\n TAG(\"tag\"),\n\n TAGS(\"tags\"),\n\n SINGLE_PAGE(\"page\"),\n\n AUTHOR(\"author\");\n\n private final String value;\n\n DefaultTemplateEnum(String value) {\n this.value = value;\n }\n\n public String getValue() {\n return value;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/DefaultTemplateNameResolver.java", "content": "package run.halo.app.theme;\n\nimport static run.halo.app.plugin.PluginConst.SYSTEM_PLUGIN_NAME;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.PluginApplicationContext;\n\n/**\n * A default implementation of {@link TemplateNameResolver}, It will be provided for plugins to\n * resolve template name.\n *\n * @author guqing\n * @since 2.11.0\n */\npublic class DefaultTemplateNameResolver implements TemplateNameResolver {\n\n private final ApplicationContext applicationContext;\n private final ViewNameResolver viewNameResolver;\n\n public DefaultTemplateNameResolver(ViewNameResolver viewNameResolver,\n ApplicationContext applicationContext) {\n this.applicationContext = applicationContext;\n this.viewNameResolver = viewNameResolver;\n }\n\n @Override\n public Mono resolveTemplateNameOrDefault(ServerWebExchange exchange, String name) {\n if (applicationContext instanceof PluginApplicationContext pluginApplicationContext) {\n var pluginName = pluginApplicationContext.getPluginId();\n return this.resolveTemplateNameOrDefault(exchange, name,\n pluginClassPathTemplate(pluginName, name));\n }\n return resolveTemplateNameOrDefault(exchange, name,\n pluginClassPathTemplate(SYSTEM_PLUGIN_NAME, name));\n }\n\n @Override\n public Mono resolveTemplateNameOrDefault(ServerWebExchange exchange, String name,\n String defaultName) {\n return viewNameResolver.resolveViewNameOrDefault(exchange, name, defaultName);\n }\n\n @Override\n public Mono isTemplateAvailableInTheme(ServerWebExchange exchange, String name) {\n return this.resolveTemplateNameOrDefault(exchange, name, \"\")\n .filter(StringUtils::isNotBlank)\n .hasElement();\n }\n\n String pluginClassPathTemplate(String pluginName, String templateName) {\n return \"plugin:\" + pluginName + \":\" + templateName;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/DefaultViewNameResolver.java", "content": "package run.halo.app.theme;\n\nimport java.nio.file.Files;\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.boot.thymeleaf.autoconfigure.ThymeleafProperties;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * The {@link DefaultViewNameResolver} is used to resolve view name.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class DefaultViewNameResolver implements ViewNameResolver {\n private static final String TEMPLATES = \"templates\";\n private final ThemeResolver themeResolver;\n private final ThymeleafProperties thymeleafProperties;\n\n /**\n * Resolves view name.\n * If the {@param #name} cannot be resolved to the view, the {@param #defaultName} is returned.\n */\n @Override\n public Mono resolveViewNameOrDefault(ServerWebExchange exchange, String name,\n String defaultName) {\n if (StringUtils.isBlank(name)) {\n return Mono.justOrEmpty(defaultName);\n }\n return themeResolver.getTheme(exchange)\n .mapNotNull(themeContext -> {\n String templateResourceName = computeResourceName(name);\n var resourcePath = themeContext.getPath()\n .resolve(TEMPLATES)\n .resolve(templateResourceName);\n return Files.exists(resourcePath) ? name : defaultName;\n })\n .switchIfEmpty(Mono.justOrEmpty(defaultName));\n }\n\n @Override\n public Mono resolveViewNameOrDefault(ServerRequest request, String name,\n String defaultName) {\n return resolveViewNameOrDefault(request.exchange(), name, defaultName);\n }\n\n String computeResourceName(String name) {\n Assert.notNull(name, \"Name must not be null\");\n return StringUtils.endsWith(name, thymeleafProperties.getSuffix())\n ? name : name + thymeleafProperties.getSuffix();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/HaloViewResolver.java", "content": "package run.halo.app.theme;\n\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.attoparser.ParseException;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.context.properties.PropertyMapper;\nimport org.springframework.boot.thymeleaf.autoconfigure.ThymeleafProperties;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.core.Ordered;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.unit.DataSize;\nimport org.springframework.web.ErrorResponse;\nimport org.springframework.web.reactive.result.view.View;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.thymeleaf.exceptions.TemplateInputException;\nimport org.thymeleaf.exceptions.TemplateProcessingException;\nimport org.thymeleaf.spring6.view.reactive.ThymeleafReactiveView;\nimport org.thymeleaf.spring6.view.reactive.ThymeleafReactiveViewResolver;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.finders.FinderRegistry;\nimport run.halo.app.theme.router.ModelConst;\n\n@Component(\"thymeleafReactiveViewResolver\")\npublic class HaloViewResolver extends ThymeleafReactiveViewResolver implements InitializingBean {\n\n private final FinderRegistry finderRegistry;\n\n private final ThymeleafProperties thymeleafProperties;\n\n public HaloViewResolver(FinderRegistry finderRegistry,\n ThymeleafProperties thymeleafProperties) {\n this.finderRegistry = finderRegistry;\n this.thymeleafProperties = thymeleafProperties;\n }\n\n @Override\n protected Mono loadView(String viewName, Locale locale) {\n return super.loadView(viewName, locale)\n .cast(HaloView.class)\n .map(view -> {\n // populate finders to view static variables\n finderRegistry.getFinders().forEach(view::addStaticVariable);\n return view;\n });\n }\n\n @Override\n public void afterPropertiesSet() throws Exception {\n setViewClass(HaloView.class);\n var map = PropertyMapper.get();\n map.from(thymeleafProperties::getEncoding)\n .to(this::setDefaultCharset);\n map.from(thymeleafProperties::getExcludedViewNames)\n .to(this::setExcludedViewNames);\n map.from(thymeleafProperties::getViewNames)\n .to(this::setViewNames);\n\n var reactive = thymeleafProperties.getReactive();\n map.from(reactive::getMediaTypes)\n .to(this::setSupportedMediaTypes);\n map.from(reactive::getFullModeViewNames)\n .to(this::setFullModeViewNames);\n map.from(reactive::getChunkedModeViewNames)\n .to(this::setChunkedModeViewNames);\n map.from(reactive::getMaxChunkSize)\n .asInt(DataSize::toBytes)\n .when(size -> size > 0)\n .to(this::setResponseMaxChunkSizeBytes);\n setOrder(Ordered.LOWEST_PRECEDENCE - 5);\n }\n\n public static class HaloView extends ThymeleafReactiveView {\n\n public static final String CONTEXT_VIEW_KEY = \"reactorContextView\";\n\n @Autowired\n private TemplateEngineManager engineManager;\n\n @Autowired\n private ThemeResolver themeResolver;\n\n @Override\n public Mono render(Map model, MediaType contentType,\n ServerWebExchange exchange) {\n return themeResolver.getTheme(exchange).flatMap(theme -> {\n // calculate the engine before rendering\n setTemplateEngine(engineManager.getTemplateEngine(theme));\n var noCache = (Boolean) exchange.getAttributes()\n .getOrDefault(ModelConst.NO_CACHE, false);\n exchange.getAttributes()\n .put(ModelConst.POWERED_BY_HALO_TEMPLATE_ENGINE, !noCache);\n return super.render(model, contentType, exchange)\n .onErrorMap(TemplateProcessingException.class::isInstance, tee -> {\n if (tee instanceof TemplateInputException) {\n // map the error response exception while fragment not found\n return Optional.of(tee)\n .map(Throwable::getCause)\n .filter(ParseException.class::isInstance)\n .map(Throwable::getCause)\n .filter(TemplateProcessingException.class::isInstance)\n .map(Throwable::getCause)\n .filter(ErrorResponse.class::isInstance)\n .orElse(tee);\n }\n // map the error response exception while template not found\n return Optional.of(tee)\n .map(Throwable::getCause)\n .filter(ErrorResponse.class::isInstance)\n .orElse(tee);\n });\n\n });\n }\n\n @Override\n @NonNull\n protected Mono> getModelAttributes(Map model,\n @NonNull ServerWebExchange exchange) {\n Mono> contextBasedStaticVariables =\n getContextBasedStaticVariables(exchange);\n Mono> modelAttributes = super.getModelAttributes(model, exchange);\n return Mono.deferContextual(\n contextView -> Flux.merge(modelAttributes, contextBasedStaticVariables)\n .collectList()\n .map(modelMapList -> {\n Map result = new HashMap<>();\n modelMapList.forEach(result::putAll);\n return result;\n })\n .doOnNext(attributes -> attributes.put(CONTEXT_VIEW_KEY, contextView))\n );\n }\n\n @NonNull\n private Mono> getContextBasedStaticVariables(\n ServerWebExchange exchange) {\n ApplicationContext applicationContext = obtainApplicationContext();\n\n return Mono.just(new HashMap())\n .flatMap(staticVariables -> {\n List>> monoList = applicationContext.getBeansOfType(\n ViewContextBasedVariablesAcquirer.class)\n .values()\n .stream()\n .map(acquirer -> acquirer.acquire(exchange))\n .toList();\n return Flux.merge(monoList)\n .collectList()\n .map(modelList -> {\n Map mergedModel = new HashMap<>();\n modelList.forEach(mergedModel::putAll);\n return mergedModel;\n })\n .map(mergedModel -> {\n staticVariables.putAll(mergedModel);\n return staticVariables;\n });\n });\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ReactiveSpelVariableExpressionEvaluator.java", "content": "package run.halo.app.theme;\n\nimport static run.halo.app.theme.HaloViewResolver.HaloView.CONTEXT_VIEW_KEY;\n\nimport java.util.Optional;\nimport org.thymeleaf.context.IExpressionContext;\nimport org.thymeleaf.spring6.expression.SPELVariableExpressionEvaluator;\nimport org.thymeleaf.standard.expression.IStandardVariableExpression;\nimport org.thymeleaf.standard.expression.IStandardVariableExpressionEvaluator;\nimport org.thymeleaf.standard.expression.StandardExpressionExecutionContext;\nimport reactor.util.context.ContextView;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * Reactive SPEL variable expression evaluator.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class ReactiveSpelVariableExpressionEvaluator\n implements IStandardVariableExpressionEvaluator {\n\n private final IStandardVariableExpressionEvaluator delegate;\n\n public static final ReactiveSpelVariableExpressionEvaluator INSTANCE =\n new ReactiveSpelVariableExpressionEvaluator();\n\n public ReactiveSpelVariableExpressionEvaluator(IStandardVariableExpressionEvaluator delegate) {\n this.delegate = delegate;\n }\n\n public ReactiveSpelVariableExpressionEvaluator() {\n this(SPELVariableExpressionEvaluator.INSTANCE);\n }\n\n @Override\n public Object evaluate(IExpressionContext context, IStandardVariableExpression expression,\n StandardExpressionExecutionContext expContext) {\n var returnValue = delegate.evaluate(context, expression, expContext);\n\n var contextView = (ContextView) Optional.ofNullable(context.getVariable(CONTEXT_VIEW_KEY))\n .filter(ContextView.class::isInstance)\n .orElse(null);\n\n return Optional.ofNullable(returnValue)\n .map(value -> ReactiveUtils.blockReactiveValue(value, contextView))\n .orElse(null);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/SiteSettingVariablesAcquirer.java", "content": "package run.halo.app.theme;\n\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.theme.finders.vo.SiteSettingVo;\n\n/**\n * Site setting variables acquirer.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class SiteSettingVariablesAcquirer implements ViewContextBasedVariablesAcquirer {\n\n private final SystemConfigFetcher environmentFetcher;\n private final ExternalUrlSupplier externalUrlSupplier;\n private final SystemVersionSupplier systemVersionSupplier;\n\n @Override\n public Mono> acquire(ServerWebExchange exchange) {\n return environmentFetcher.getConfig()\n .map(config -> {\n var siteSettingVo = SiteSettingVo.from(config)\n .withUrl(externalUrlSupplier.getURL(exchange.getRequest()))\n .withVersion(systemVersionSupplier.get().toString());\n return Map.of(\"site\", siteSettingVo);\n });\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/TemplateEngineManager.java", "content": "package run.halo.app.theme;\n\nimport lombok.NonNull;\nimport org.pf4j.PluginManager;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.thymeleaf.autoconfigure.ThymeleafProperties;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.ConcurrentLruCache;\nimport org.thymeleaf.dialect.IDialect;\nimport org.thymeleaf.spring6.ISpringWebFluxTemplateEngine;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.standard.expression.IStandardVariableExpressionEvaluator;\nimport org.thymeleaf.templateresolver.FileTemplateResolver;\nimport org.thymeleaf.templateresolver.ITemplateResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.theme.dialect.HaloProcessorDialect;\nimport run.halo.app.theme.engine.HaloTemplateEngine;\nimport run.halo.app.theme.engine.PluginClassloaderTemplateResolver;\nimport run.halo.app.theme.message.ThemeMessageResolver;\n\n/**\n *

The {@link TemplateEngineManager} uses an {@link ConcurrentLruCache LRU cache} to manage\n * theme's {@link ISpringWebFluxTemplateEngine}.

\n *

The default limit size of the {@link ConcurrentLruCache LRU cache} is\n * {@link TemplateEngineManager#CACHE_SIZE_LIMIT} to prevent unnecessary memory occupation.

\n *

If theme's {@link ISpringWebFluxTemplateEngine} already exists, it returns.

\n *

Otherwise, it checks whether the theme exists and creates the\n * {@link ISpringWebFluxTemplateEngine} into the LRU cache according to the {@link ThemeContext}\n * .

\n *

It is thread safe.

\n *\n * @author johnniang\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class TemplateEngineManager {\n private static final int CACHE_SIZE_LIMIT = 5;\n private final ConcurrentLruCache engineCache;\n\n private final ThymeleafProperties thymeleafProperties;\n\n private final ExternalUrlSupplier externalUrlSupplier;\n\n private final PluginManager pluginManager;\n\n private final ObjectProvider templateResolvers;\n\n private final ObjectProvider dialects;\n\n private final ThemeResolver themeResolver;\n\n public TemplateEngineManager(ThymeleafProperties thymeleafProperties,\n ExternalUrlSupplier externalUrlSupplier,\n PluginManager pluginManager, ObjectProvider templateResolvers,\n ObjectProvider dialects, ThemeResolver themeResolver) {\n this.thymeleafProperties = thymeleafProperties;\n this.externalUrlSupplier = externalUrlSupplier;\n this.pluginManager = pluginManager;\n this.templateResolvers = templateResolvers;\n this.dialects = dialects;\n this.themeResolver = themeResolver;\n engineCache = new ConcurrentLruCache<>(CACHE_SIZE_LIMIT, this::templateEngineGenerator);\n }\n\n public ISpringWebFluxTemplateEngine getTemplateEngine(ThemeContext theme) {\n CacheKey cacheKey = buildCacheKey(theme);\n return engineCache.get(cacheKey);\n }\n\n public Mono clearCache(String themeName) {\n return themeResolver.getThemeContext(themeName)\n .doOnNext(themeContext -> engineCache.remove(buildCacheKey(themeContext)))\n .then();\n }\n\n /**\n * TemplateEngine LRU cache key.\n *\n * @param name from {@link #context}\n * @param active from {@link #context}\n * @param context must not be null\n */\n private record CacheKey(String name, boolean active, ThemeContext context) {\n }\n\n CacheKey buildCacheKey(ThemeContext context) {\n return new CacheKey(context.getName(), context.isActive(), context);\n }\n\n private ISpringWebFluxTemplateEngine templateEngineGenerator(CacheKey cacheKey) {\n\n var engine = new HaloTemplateEngine(new ThemeMessageResolver(cacheKey.context()));\n engine.setEnableSpringELCompiler(thymeleafProperties.isEnableSpringElCompiler());\n engine.setLinkBuilder(new ThemeLinkBuilder(cacheKey.context(), externalUrlSupplier));\n engine.setRenderHiddenMarkersBeforeCheckboxes(\n thymeleafProperties.isRenderHiddenMarkersBeforeCheckboxes());\n\n var mainResolver = haloTemplateResolver();\n mainResolver.setPrefix(cacheKey.context().getPath().resolve(\"templates\") + \"/\");\n engine.addTemplateResolver(mainResolver);\n var pluginTemplateResolver = createPluginClassloaderTemplateResolver();\n engine.addTemplateResolver(pluginTemplateResolver);\n // replace StandardDialect with SpringStandardDialect\n engine.setDialect(new SpringStandardDialect() {\n @Override\n public IStandardVariableExpressionEvaluator getVariableExpressionEvaluator() {\n return ReactiveSpelVariableExpressionEvaluator.INSTANCE;\n }\n });\n engine.addDialect(new HaloProcessorDialect());\n\n templateResolvers.orderedStream().forEach(engine::addTemplateResolver);\n\n // we collect all template resolvers and add them into composite template resolver\n // to control the resolution flow\n var compositeTemplateResolver =\n new CompositeTemplateResolver(engine.getTemplateResolvers());\n engine.setTemplateResolver(compositeTemplateResolver);\n\n dialects.orderedStream().forEach(engine::addDialect);\n\n return engine;\n }\n\n @NonNull\n private PluginClassloaderTemplateResolver createPluginClassloaderTemplateResolver() {\n var pluginTemplateResolver = new PluginClassloaderTemplateResolver(pluginManager);\n pluginTemplateResolver.setPrefix(thymeleafProperties.getPrefix());\n pluginTemplateResolver.setSuffix(thymeleafProperties.getSuffix());\n pluginTemplateResolver.setTemplateMode(thymeleafProperties.getMode());\n pluginTemplateResolver.setOrder(1);\n if (thymeleafProperties.getEncoding() != null) {\n pluginTemplateResolver.setCharacterEncoding(thymeleafProperties.getEncoding().name());\n }\n return pluginTemplateResolver;\n }\n\n FileTemplateResolver haloTemplateResolver() {\n final var resolver = new FileTemplateResolver();\n resolver.setTemplateMode(thymeleafProperties.getMode());\n resolver.setPrefix(thymeleafProperties.getPrefix());\n resolver.setSuffix(thymeleafProperties.getSuffix());\n resolver.setCacheable(thymeleafProperties.isCache());\n resolver.setCheckExistence(thymeleafProperties.isCheckTemplate());\n if (thymeleafProperties.getEncoding() != null) {\n resolver.setCharacterEncoding(thymeleafProperties.getEncoding().name());\n }\n return resolver;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ThemeContext.java", "content": "package run.halo.app.theme;\n\nimport java.nio.file.Path;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\n@EqualsAndHashCode(of = \"name\")\npublic class ThemeContext {\n\n public static final String THEME_PREVIEW_PARAM_NAME = \"preview-theme\";\n\n private String name;\n\n private Path path;\n\n private boolean active;\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ThemeContextBasedVariablesAcquirer.java", "content": "package run.halo.app.theme;\n\nimport java.util.Map;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.finders.ThemeFinder;\n\n/**\n * Theme context based variables acquirer.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class ThemeContextBasedVariablesAcquirer implements ViewContextBasedVariablesAcquirer {\n private final ThemeFinder themeFinder;\n private final ThemeResolver themeResolver;\n\n public ThemeContextBasedVariablesAcquirer(ThemeFinder themeFinder,\n ThemeResolver themeResolver) {\n this.themeFinder = themeFinder;\n this.themeResolver = themeResolver;\n }\n\n @Override\n public Mono> acquire(ServerWebExchange exchange) {\n return themeResolver.getTheme(exchange)\n .flatMap(themeContext -> {\n String name = themeContext.getName();\n return themeFinder.getByName(name);\n })\n .map(themeVo -> Map.of(\"theme\", themeVo))\n .defaultIfEmpty(Map.of());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ThemeLinkBuilder.java", "content": "package run.halo.app.theme;\n\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.lang.NonNull;\nimport org.springframework.web.util.UriComponentsBuilder;\nimport org.thymeleaf.context.IExpressionContext;\nimport org.thymeleaf.linkbuilder.StandardLinkBuilder;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.utils.PathUtils;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class ThemeLinkBuilder extends StandardLinkBuilder {\n public static final String THEME_ASSETS_PREFIX = \"/assets\";\n public static final String THEME_PREVIEW_PREFIX = \"/themes\";\n\n private final ThemeContext theme;\n private final ExternalUrlSupplier externalUrlSupplier;\n\n public ThemeLinkBuilder(ThemeContext theme, ExternalUrlSupplier externalUrlSupplier) {\n this.theme = theme;\n this.externalUrlSupplier = externalUrlSupplier;\n }\n\n @Override\n protected String processLink(IExpressionContext context, String link) {\n if (link == null || !linkInSite(externalUrlSupplier.get(), link)) {\n return link;\n }\n\n if (StringUtils.isBlank(link)) {\n link = \"/\";\n }\n\n if (isAssetsRequest(link)) {\n return PathUtils.combinePath(THEME_PREVIEW_PREFIX, theme.getName(), link);\n }\n\n // not assets link\n if (theme.isActive()) {\n return link;\n }\n\n return UriComponentsBuilder.fromUriString(link)\n .queryParam(ThemeContext.THEME_PREVIEW_PARAM_NAME, theme.getName())\n .build().toString();\n }\n\n static boolean linkInSite(@NonNull URI externalUri, @NonNull String link) {\n if (!PathUtils.isAbsoluteUri(link)) {\n // relative uri is always in site\n return true;\n }\n try {\n URI requestUri = new URI(link);\n return StringUtils.equals(externalUri.getAuthority(), requestUri.getAuthority());\n } catch (URISyntaxException e) {\n // ignore this link\n }\n return false;\n }\n\n private boolean isAssetsRequest(String link) {\n String assetsPrefix = externalUrlSupplier.get().resolve(THEME_ASSETS_PREFIX).toString();\n return link.startsWith(assetsPrefix) || link.startsWith(THEME_ASSETS_PREFIX);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ThemeLocaleContextResolver.java", "content": "package run.halo.app.theme;\n\nimport java.util.Locale;\nimport java.util.Optional;\nimport java.util.TimeZone;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.LocaleUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.i18n.LocaleContext;\nimport org.springframework.context.i18n.SimpleTimeZoneAwareLocaleContext;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.adapter.WebHttpHandlerBuilder;\nimport org.springframework.web.server.i18n.AcceptHeaderLocaleContextResolver;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component(WebHttpHandlerBuilder.LOCALE_CONTEXT_RESOLVER_BEAN_NAME)\npublic class ThemeLocaleContextResolver extends AcceptHeaderLocaleContextResolver {\n\n public static final String LANGUAGE_PARAMETER_NAME = \"language\";\n\n public static final String LANGUAGE_COOKIE_NAME = LANGUAGE_PARAMETER_NAME;\n\n public static final String TIME_ZONE_COOKIE_NAME = \"time_zone\";\n\n\n @Override\n @NonNull\n public LocaleContext resolveLocaleContext(@NonNull ServerWebExchange exchange) {\n var request = exchange.getRequest();\n var locale = getLocaleFromQueryParameter(request)\n .or(() -> getLocaleFromCookie(request))\n .or(() -> UserLocaleRequestAttributeWriteFilter.getUserLocale(request))\n .orElseGet(() -> super.resolveLocaleContext(exchange).getLocale());\n\n if (LocaleUtils.isLanguageUndetermined(locale)) {\n locale = null;\n }\n\n var timeZone = getTimeZoneFromCookie(request)\n .orElseGet(TimeZone::getDefault);\n\n return new SimpleTimeZoneAwareLocaleContext(locale, timeZone);\n }\n\n private Optional getLocaleFromCookie(ServerHttpRequest request) {\n return Optional.ofNullable(request.getCookies().getFirst(LANGUAGE_COOKIE_NAME))\n .map(HttpCookie::getValue)\n .filter(StringUtils::isNotBlank)\n .map(Locale::forLanguageTag);\n }\n\n private Optional getLocaleFromQueryParameter(ServerHttpRequest request) {\n return Optional.ofNullable(request.getQueryParams().getFirst(LANGUAGE_PARAMETER_NAME))\n .filter(StringUtils::isNotBlank)\n .map(Locale::forLanguageTag);\n }\n\n private Optional getTimeZoneFromCookie(ServerHttpRequest request) {\n return Optional.ofNullable(request.getCookies().getFirst(TIME_ZONE_COOKIE_NAME))\n .map(HttpCookie::getValue)\n .filter(StringUtils::isNotBlank)\n .map(TimeZone::getTimeZone);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ThemeResolver.java", "content": "package run.halo.app.theme;\n\nimport static run.halo.app.security.authorization.AuthorityUtils.authoritiesToRoles;\n\nimport java.util.Collection;\nimport java.util.Set;\nimport lombok.AllArgsConstructor;\nimport lombok.Builder;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting.Theme;\nimport run.halo.app.infra.SystemSetting.ThemeRouteRules;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n/**\n * @author johnniang\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class ThemeResolver {\n\n private final SystemConfigFetcher environmentFetcher;\n\n private final ThemeRootGetter themeRoot;\n private final RoleService roleService;\n\n public Mono getThemeContext(String themeName) {\n Assert.hasText(themeName, \"Theme name cannot be empty\");\n var path = themeRoot.get().resolve(themeName);\n return Mono.just(ThemeContext.builder().name(themeName).path(path))\n .flatMap(builder -> environmentFetcher.fetch(Theme.GROUP, Theme.class)\n .mapNotNull(Theme::getActive)\n .map(activatedTheme -> {\n boolean active = StringUtils.equals(activatedTheme, themeName);\n return builder.active(active);\n })\n .defaultIfEmpty(builder.active(false))\n )\n .map(ThemeContext.ThemeContextBuilder::build);\n }\n\n public Mono getTheme(ServerWebExchange exchange) {\n return fetchThemeFromExchange(exchange)\n .switchIfEmpty(Mono.defer(() -> fetchActivationState()\n .map(themeState -> {\n var activatedTheme = themeState.activatedTheme();\n var builder = ThemeContext.builder();\n var themeName = exchange.getRequest().getQueryParams()\n .getFirst(ThemeContext.THEME_PREVIEW_PARAM_NAME);\n\n if (StringUtils.isBlank(themeName) || !themeState.supportsPreviewTheme()) {\n themeName = activatedTheme;\n }\n\n boolean active = StringUtils.equals(activatedTheme, themeName);\n var path = themeRoot.get().resolve(themeName);\n return builder.name(themeName)\n .path(path)\n .active(active)\n .build();\n })\n .doOnNext(themeContext ->\n exchange.getAttributes().put(ThemeContext.class.getName(), themeContext))\n ));\n }\n\n public Mono fetchThemeFromExchange(ServerWebExchange exchange) {\n return Mono.justOrEmpty(exchange)\n .map(ServerWebExchange::getAttributes)\n .filter(attrs -> attrs.containsKey(ThemeContext.class.getName()))\n .map(attrs -> attrs.get(ThemeContext.class.getName()))\n .cast(ThemeContext.class);\n }\n\n private Mono fetchActivationState() {\n var builder = ThemeActivationState.builder();\n\n var activatedMono = environmentFetcher.fetch(Theme.GROUP, Theme.class)\n .map(Theme::getActive)\n .switchIfEmpty(Mono.error(() -> new IllegalArgumentException(\"No theme activated\")))\n .doOnNext(builder::activatedTheme);\n\n var preivewDisabledMono = environmentFetcher.fetch(ThemeRouteRules.GROUP,\n ThemeRouteRules.class)\n .map(ThemeRouteRules::isDisableThemePreview)\n .defaultIfEmpty(false)\n .doOnNext(builder::previewDisabled);\n\n var themeManageMono = ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .filter(au -> !AnonymousUserConst.isAnonymousUser(au.getName()))\n .flatMap(au -> supportsPreviewTheme(authoritiesToRoles(au.getAuthorities())))\n .doOnNext(builder::hasThemeManagementRole);\n\n return Mono.when(activatedMono, preivewDisabledMono, themeManageMono)\n .then(Mono.fromSupplier(builder::build));\n }\n\n private Mono supportsPreviewTheme(Collection authorities) {\n return roleService.contains(authorities, Set.of(AuthorityUtils.THEME_MANAGEMENT_ROLE_NAME))\n .defaultIfEmpty(false);\n }\n\n @Builder\n record ThemeActivationState(String activatedTheme, boolean previewDisabled,\n boolean hasThemeManagementRole) {\n\n private boolean supportsPreviewTheme() {\n if (hasThemeManagementRole) {\n return true;\n }\n return !previewDisabled;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/UserLocaleRequestAttributeWriteFilter.java", "content": "package run.halo.app.theme;\n\nimport java.util.Locale;\nimport java.util.Optional;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilter;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n@Component\n@Order(Ordered.HIGHEST_PRECEDENCE)\n@RequiredArgsConstructor\npublic class UserLocaleRequestAttributeWriteFilter implements WebFilter {\n public static final String USER_LOCALE_ATTRIBUTE =\n UserLocaleRequestAttributeWriteFilter.class.getName() + \".USER_LOCALE_ATTRIBUTE\";\n\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n @NonNull\n public Mono filter(@NonNull ServerWebExchange exchange, @NonNull WebFilterChain chain) {\n return environmentFetcher.getBasic()\n .map(SystemSetting.Basic::useSystemLocale)\n .doOnNext(localeOpt -> localeOpt\n .ifPresent(locale -> exchange.getAttributes().put(USER_LOCALE_ATTRIBUTE, locale))\n )\n .then(chain.filter(exchange));\n }\n\n public static Optional getUserLocale(ServerHttpRequest request) {\n return Optional.ofNullable((Locale) request.getAttributes()\n .get(USER_LOCALE_ATTRIBUTE));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ViewContextBasedVariablesAcquirer.java", "content": "package run.halo.app.theme;\n\nimport java.util.Map;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n@FunctionalInterface\npublic interface ViewContextBasedVariablesAcquirer {\n\n Mono> acquire(ServerWebExchange exchange);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/ViewNameResolver.java", "content": "package run.halo.app.theme;\n\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * The {@link ViewNameResolver} is used to resolve view name if the view name cannot be resolved\n * to the view, the default view name is returned.\n *\n * @author guqing\n * @since 2.10.2\n */\npublic interface ViewNameResolver {\n Mono resolveViewNameOrDefault(ServerWebExchange exchange, String name,\n String defaultName);\n\n Mono resolveViewNameOrDefault(ServerRequest request, String name,\n String defaultName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/config/ThemeConfiguration.java", "content": "package run.halo.app.theme.config;\n\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;\nimport org.springframework.boot.info.BuildProperties;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.security.access.expression.method.MethodSecurityExpressionHandler;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.thymeleaf.extras.springsecurity6.dialect.SpringSecurityDialect;\nimport run.halo.app.theme.dialect.GeneratorMetaProcessor;\nimport run.halo.app.theme.dialect.HaloSpringSecurityDialect;\nimport run.halo.app.theme.dialect.LinkExpressionObjectDialect;\nimport run.halo.app.theme.dialect.TemplateHeadProcessor;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\n@Configuration\npublic class ThemeConfiguration {\n\n @Bean\n LinkExpressionObjectDialect linkExpressionObjectDialect() {\n return new LinkExpressionObjectDialect();\n }\n\n @Bean\n SpringSecurityDialect springSecurityDialect(\n ServerSecurityContextRepository securityContextRepository,\n ObjectProvider expressionHandler) {\n return new HaloSpringSecurityDialect(securityContextRepository, expressionHandler);\n }\n\n @Bean\n @ConditionalOnProperty(name = \"halo.theme.generator-meta-disabled\",\n havingValue = \"false\",\n matchIfMissing = true)\n TemplateHeadProcessor generatorMetaProcessor(ObjectProvider buildProperties) {\n return new GeneratorMetaProcessor(buildProperties);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/config/ThemeWebFluxConfigurer.java", "content": "package run.halo.app.theme.config;\n\nimport java.nio.file.Path;\nimport java.util.List;\nimport java.util.Map;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.http.CacheControl;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.HandlerMapping;\nimport org.springframework.web.reactive.config.ResourceHandlerRegistry;\nimport org.springframework.web.reactive.config.WebFluxConfigurer;\nimport org.springframework.web.reactive.resource.AbstractResourceResolver;\nimport org.springframework.web.reactive.resource.EncodedResourceResolver;\nimport org.springframework.web.reactive.resource.ResourceResolverChain;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.infra.utils.FileUtils;\n\n@Component\npublic class ThemeWebFluxConfigurer implements WebFluxConfigurer {\n\n private final ThemeRootGetter themeRootGetter;\n\n private final WebProperties.Resources resourcesProperties;\n\n public ThemeWebFluxConfigurer(ThemeRootGetter themeRootGetter,\n WebProperties webProperties) {\n this.themeRootGetter = themeRootGetter;\n this.resourcesProperties = webProperties.getResources();\n }\n\n @Override\n public void addResourceHandlers(ResourceHandlerRegistry registry) {\n var cacheControl = resourcesProperties.getCache().getCachecontrol().toHttpCacheControl();\n if (cacheControl == null) {\n cacheControl = CacheControl.empty();\n }\n var useLastModified = resourcesProperties.getCache().isUseLastModified();\n registry.addResourceHandler(\"/themes/{themeName}/assets/{*resourcePaths}\")\n .setCacheControl(cacheControl)\n .setUseLastModified(useLastModified)\n .resourceChain(true)\n .addResolver(new EncodedResourceResolver())\n .addResolver(new ThemePathResourceResolver(themeRootGetter.get()));\n }\n\n /**\n * Theme path resource resolver. The resolver is used to resolve theme assets from the request\n * path.\n *\n * @author johnniang\n */\n private static class ThemePathResourceResolver extends AbstractResourceResolver {\n\n private final Path themeRoot;\n\n private ThemePathResourceResolver(Path themeRoot) {\n this.themeRoot = themeRoot;\n }\n\n @Override\n protected Mono resolveResourceInternal(ServerWebExchange exchange,\n String requestPath, List locations, ResourceResolverChain chain) {\n if (exchange == null) {\n return Mono.empty();\n }\n Map requiredAttribute =\n exchange.getRequiredAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);\n var themeName = requiredAttribute.get(\"themeName\");\n var resourcePaths = requiredAttribute.get(\"resourcePaths\");\n\n if (StringUtils.isAnyBlank(themeName, resourcePaths)) {\n return Mono.empty();\n }\n\n var assetsPath = themeRoot.resolve(themeName + \"/templates/assets/\" + resourcePaths);\n FileUtils.checkDirectoryTraversal(themeRoot, assetsPath);\n var location = new FileSystemResource(assetsPath);\n if (!location.isReadable()) {\n return Mono.empty();\n }\n return Mono.just(location);\n }\n\n @Override\n protected Mono resolveUrlPathInternal(String resourceUrlPath,\n List locations, ResourceResolverChain chain) {\n throw new UnsupportedOperationException();\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/CommentElementTagProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.element.AbstractElementTagProcessor;\nimport org.thymeleaf.processor.element.IElementTagStructureHandler;\nimport org.thymeleaf.templatemode.TemplateMode;\n\n/**\n *

Comment element tag processor.

\n *

Replace the comment tag <halo:comment /> with the given content.

\n *\n * @author guqing\n * @see CommentEnabledVariableProcessor\n * @since 2.0.0\n */\npublic class CommentElementTagProcessor extends AbstractElementTagProcessor {\n\n private static final String TAG_NAME = \"comment\";\n\n private static final int PRECEDENCE = 1000;\n\n /**\n * Constructor footer element tag processor with HTML mode, dialect prefix, comment tag name.\n *\n * @param dialectPrefix dialect prefix\n */\n public CommentElementTagProcessor(final String dialectPrefix) {\n super(\n TemplateMode.HTML, // This processor will apply only to HTML mode\n dialectPrefix, // Prefix to be applied to name for matching\n TAG_NAME, // Tag name: match specifically this tag\n true, // Apply dialect prefix to tag name\n null, // No attribute name: will match by tag name\n false, // No prefix to be applied to attribute name\n PRECEDENCE); // Precedence (inside dialect's own precedence)\n }\n\n @Override\n protected void doProcess(ITemplateContext context, IProcessableElementTag tag,\n IElementTagStructureHandler structureHandler) {\n var commentWidget = (CommentWidget) context.getVariable(\n CommentEnabledVariableProcessor.COMMENT_WIDGET_OBJECT_VARIABLE);\n if (commentWidget == null) {\n structureHandler.replaceWith(\"\", false);\n return;\n }\n commentWidget.render(SecureTemplateContextWrapper.wrap(context), tag, structureHandler);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/CommentEnabledVariableProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.apache.commons.lang3.BooleanUtils.isFalse;\nimport static org.apache.commons.lang3.BooleanUtils.isTrue;\n\nimport java.time.Duration;\nimport java.util.Optional;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.core.convert.support.DefaultConversionService;\nimport org.thymeleaf.context.Contexts;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.context.IWebContext;\nimport org.thymeleaf.model.ITemplateEnd;\nimport org.thymeleaf.model.ITemplateStart;\nimport org.thymeleaf.processor.templateboundaries.AbstractTemplateBoundariesProcessor;\nimport org.thymeleaf.processor.templateboundaries.ITemplateBoundariesStructureHandler;\nimport org.thymeleaf.spring6.context.SpringContextUtils;\nimport org.thymeleaf.standard.StandardDialect;\nimport org.thymeleaf.templatemode.TemplateMode;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Comment enabled variable processor.\n *

Compute comment enabled state and set it to the model when the template is start rendering

\n *

It is not suitable for scenarios where there are multiple comment components on the same page\n * and some of them need to be controlled to be closed.

\n *\n * @author guqing\n * @since 2.9.0\n */\npublic class CommentEnabledVariableProcessor extends AbstractTemplateBoundariesProcessor {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n public static final String COMMENT_WIDGET_OBJECT_VARIABLE = CommentWidget.class.getName();\n public static final String COMMENT_ENABLED_MODEL_ATTRIBUTE = \"haloCommentEnabled\";\n\n public CommentEnabledVariableProcessor() {\n super(TemplateMode.HTML, StandardDialect.PROCESSOR_PRECEDENCE);\n }\n\n @Override\n public void doProcessTemplateStart(ITemplateContext context, ITemplateStart templateStart,\n ITemplateBoundariesStructureHandler structureHandler) {\n getCommentWidget(context).ifPresentOrElse(commentWidget -> {\n populateAllowCommentAttribute(context, true);\n structureHandler.setLocalVariable(COMMENT_WIDGET_OBJECT_VARIABLE, commentWidget);\n }, () -> populateAllowCommentAttribute(context, false));\n }\n\n @Override\n public void doProcessTemplateEnd(ITemplateContext context, ITemplateEnd templateEnd,\n ITemplateBoundariesStructureHandler structureHandler) {\n structureHandler.removeLocalVariable(COMMENT_WIDGET_OBJECT_VARIABLE);\n }\n\n static void populateAllowCommentAttribute(ITemplateContext context, boolean allowComment) {\n if (Contexts.isWebContext(context)) {\n IWebContext webContext = Contexts.asWebContext(context);\n webContext.getExchange()\n .setAttributeValue(COMMENT_ENABLED_MODEL_ATTRIBUTE, allowComment);\n }\n }\n\n static Optional getCommentWidget(ITemplateContext context) {\n final ApplicationContext appCtx = SpringContextUtils.getApplicationContext(context);\n SystemConfigFetcher environmentFetcher =\n appCtx.getBean(SystemConfigFetcher.class);\n var commentSetting = environmentFetcher.fetchComment()\n .blockOptional(BLOCKING_TIMEOUT)\n .orElseThrow();\n var globalEnabled = isTrue(commentSetting.getEnable());\n if (!globalEnabled) {\n return Optional.empty();\n }\n\n if (Contexts.isWebContext(context)) {\n IWebContext webContext = Contexts.asWebContext(context);\n Object attributeValue = webContext.getExchange()\n .getAttributeValue(CommentWidget.ENABLE_COMMENT_ATTRIBUTE);\n Boolean enabled = DefaultConversionService.getSharedInstance()\n .convert(attributeValue, Boolean.class);\n if (isFalse(enabled)) {\n return Optional.empty();\n }\n }\n\n ExtensionGetter extensionGetter = appCtx.getBean(ExtensionGetter.class);\n return extensionGetter.getEnabledExtensions(CommentWidget.class)\n .next()\n .blockOptional(BLOCKING_TIMEOUT);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/ContentTemplateHeadProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static org.apache.commons.lang3.StringUtils.defaultIfBlank;\nimport static org.thymeleaf.model.AttributeValueQuotes.DOUBLE;\n\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.stream.Collectors;\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.util.HtmlUtils;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.model.ITemplateEvent;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n *

The head html snippet injection processor for content template such as post\n * and page.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@Order(1)\n@AllArgsConstructor\npublic class ContentTemplateHeadProcessor implements TemplateHeadProcessor {\n private static final String POST_NAME_VARIABLE = \"name\";\n private final PostFinder postFinder;\n private final SinglePageFinder singlePageFinder;\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n Mono nameMono = Mono.justOrEmpty((String) context.getVariable(POST_NAME_VARIABLE));\n\n Mono>> htmlMetasMono = Mono.empty();\n if (isPostTemplate(context)) {\n htmlMetasMono = nameMono.flatMap(postFinder::getByName)\n .map(post -> {\n List> htmlMetas = post.getSpec().getHtmlMetas();\n String excerpt =\n post.getStatus() == null ? null : post.getStatus().getExcerpt();\n return excerptToMetaDescriptionIfAbsent(htmlMetas, excerpt);\n });\n } else if (isPageTemplate(context)) {\n htmlMetasMono = nameMono.flatMap(singlePageFinder::getByName)\n .map(page -> {\n List> htmlMetas = page.getSpec().getHtmlMetas();\n String excerpt =\n page.getStatus() == null ? null : page.getStatus().getExcerpt();\n return excerptToMetaDescriptionIfAbsent(htmlMetas, excerpt);\n });\n }\n\n return htmlMetasMono\n .doOnNext(\n htmlMetas -> buildMetas(context.getModelFactory(), htmlMetas).forEach(model::add)\n )\n .then();\n }\n\n static List> excerptToMetaDescriptionIfAbsent(\n List> htmlMetas,\n String excerpt) {\n String excerptNullSafe = StringUtils.defaultString(excerpt);\n final String excerptSafe = HtmlUtils.htmlEscape(excerptNullSafe);\n List> metas = new ArrayList<>(defaultIfNull(htmlMetas, List.of()));\n metas.stream()\n .filter(map -> Meta.DESCRIPTION.equals(map.get(Meta.NAME)))\n .distinct()\n .findFirst()\n .ifPresentOrElse(map ->\n map.put(Meta.CONTENT, defaultIfBlank(map.get(Meta.CONTENT), excerptSafe)),\n () -> {\n Map map = new HashMap<>();\n map.put(Meta.NAME, Meta.DESCRIPTION);\n map.put(Meta.CONTENT, excerptSafe);\n metas.add(map);\n });\n return metas;\n }\n\n interface Meta {\n String DESCRIPTION = \"description\";\n String NAME = \"name\";\n String CONTENT = \"content\";\n }\n\n private List buildMetas(IModelFactory modelFactory,\n List> metas) {\n return metas.stream()\n .map(metaMap ->\n modelFactory.createStandaloneElementTag(\"meta\", metaMap, DOUBLE, false, true)\n ).collect(Collectors.toList());\n }\n\n private boolean isPostTemplate(ITemplateContext context) {\n return DefaultTemplateEnum.POST.getValue()\n .equals(context.getVariable(ModelConst.TEMPLATE_ID));\n }\n\n private boolean isPageTemplate(ITemplateContext context) {\n return DefaultTemplateEnum.SINGLE_PAGE.getValue()\n .equals(context.getVariable(ModelConst.TEMPLATE_ID));\n }\n}" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/DefaultFaviconHeadProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n/**\n * Theme template head tag snippet injection processor for favicon.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class DefaultFaviconHeadProcessor implements TemplateHeadProcessor {\n\n private final SystemConfigFetcher fetcher;\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n return fetchBasicSetting()\n .filter(basic -> StringUtils.isNotBlank(basic.getFavicon()))\n .map(basic -> {\n IModelFactory modelFactory = context.getModelFactory();\n model.add(modelFactory.createText(faviconSnippet(basic.getFavicon())));\n return model;\n })\n .then();\n }\n\n private String faviconSnippet(String favicon) {\n return String.format(\"\\n\", favicon);\n }\n\n private Mono fetchBasicSetting() {\n return fetcher.fetch(SystemSetting.Basic.GROUP, SystemSetting.Basic.class);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/DefaultLinkExpressionFactory.java", "content": "package run.halo.app.theme.dialect;\n\nimport java.util.Set;\nimport org.thymeleaf.context.IExpressionContext;\nimport org.thymeleaf.exceptions.TemplateProcessingException;\nimport org.thymeleaf.expression.IExpressionObjectFactory;\nimport org.thymeleaf.linkbuilder.ILinkBuilder;\nimport org.thymeleaf.util.Validate;\nimport run.halo.app.theme.ThemeLinkBuilder;\n\n/**\n * A default implementation of {@link IExpressionObjectFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class DefaultLinkExpressionFactory implements IExpressionObjectFactory {\n private static final String THEME_EVALUATION_VARIABLE_NAME = \"theme\";\n\n @Override\n public Set getAllExpressionObjectNames() {\n return Set.of(THEME_EVALUATION_VARIABLE_NAME);\n }\n\n @Override\n public Object buildObject(IExpressionContext context, String expressionObjectName) {\n if (THEME_EVALUATION_VARIABLE_NAME.equals(expressionObjectName)) {\n return new ThemeLinkExpressObject(context);\n }\n return null;\n }\n\n @Override\n public boolean isCacheable(String expressionObjectName) {\n return THEME_EVALUATION_VARIABLE_NAME.equals(expressionObjectName);\n }\n\n public static class ThemeLinkExpressObject {\n private final ILinkBuilder linkBuilder;\n private final IExpressionContext context;\n\n /**\n * Construct an expression object that provides a set of methods to handle link in\n * Javascript or HTML through {@link IExpressionContext}.\n *\n * @param context expression context\n */\n public ThemeLinkExpressObject(IExpressionContext context) {\n Validate.notNull(context, \"Context cannot be null\");\n this.context = context;\n Set linkBuilders = context.getConfiguration().getLinkBuilders();\n linkBuilder = linkBuilders.stream()\n .findFirst()\n .orElseThrow(() -> new TemplateProcessingException(\"Link builder not found\"));\n }\n\n public String assets(String path) {\n String assetsPath = ThemeLinkBuilder.THEME_ASSETS_PREFIX + path;\n return linkBuilder.buildLink(context, assetsPath, null);\n }\n\n public String route(String path) {\n return linkBuilder.buildLink(context, path, null);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/DuplicateMetaTagProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport java.util.ArrayList;\nimport java.util.Comparator;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.regex.Matcher;\nimport java.util.regex.Pattern;\nimport lombok.AllArgsConstructor;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.model.ITemplateEvent;\nimport org.thymeleaf.model.IText;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\n\n/**\n *

This processor will remove the duplicate meta tag with the same name in head tag and only\n * keep the last one.

\n *

This processor will be executed last.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Order\n@Component\n@AllArgsConstructor\npublic class DuplicateMetaTagProcessor implements TemplateHeadProcessor {\n static final Pattern META_PATTERN = Pattern.compile(\"]+?name=\\\"([^\\\"]+)\\\"[^>]*>\\\\n*\");\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n IModel newModel = context.getModelFactory().createModel();\n\n Map uniqueMetaTags = new LinkedHashMap<>();\n List otherModel = new ArrayList<>();\n for (int i = 0; i < model.size(); i++) {\n ITemplateEvent templateEvent = model.get(i);\n // If the current node is a text node, it is processed separately.\n // Because the text node may contain multiple meta tags.\n if (templateEvent instanceof IText textNode) {\n String text = textNode.getText();\n Matcher matcher = META_PATTERN.matcher(text);\n while (matcher.find()) {\n String tagLine = matcher.group(0);\n String nameAttribute = matcher.group(1);\n // create a new text node to replace the original text node\n // replace multiple line breaks with one line break\n IText metaTagNode = context.getModelFactory()\n .createText(tagLine.replaceAll(\"\\\\n+\", \"\\n\"));\n uniqueMetaTags.put(nameAttribute, new IndexedModel(i, metaTagNode));\n text = text.replace(tagLine, \"\");\n }\n // put the rest of the text into the other model\n IText otherText = context.getModelFactory()\n .createText(text);\n otherModel.add(new IndexedModel(i, otherText));\n continue;\n }\n if (templateEvent instanceof IProcessableElementTag tag) {\n var indexedModel = new IndexedModel(i, tag);\n if (\"meta\".equals(tag.getElementCompleteName())) {\n var attribute = tag.getAttribute(\"name\");\n if (attribute != null) {\n uniqueMetaTags.put(attribute.getValue(), indexedModel);\n continue;\n }\n }\n }\n otherModel.add(new IndexedModel(i, templateEvent));\n }\n\n otherModel.addAll(uniqueMetaTags.values());\n otherModel.stream().sorted(Comparator.comparing(IndexedModel::index))\n .map(IndexedModel::templateEvent)\n .forEach(newModel::add);\n\n model.reset();\n model.addModel(newModel);\n return Mono.empty();\n }\n\n record IndexedModel(int index, ITemplateEvent templateEvent) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/EvaluationContextEnhancer.java", "content": "package run.halo.app.theme.dialect;\n\nimport static run.halo.app.theme.HaloViewResolver.HaloView.CONTEXT_VIEW_KEY;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.stream.Collectors;\nimport org.springframework.core.convert.TypeDescriptor;\nimport org.springframework.expression.AccessException;\nimport org.springframework.expression.EvaluationContext;\nimport org.springframework.expression.MethodExecutor;\nimport org.springframework.expression.MethodResolver;\nimport org.springframework.expression.PropertyAccessor;\nimport org.springframework.expression.TypedValue;\nimport org.springframework.expression.spel.CompilablePropertyAccessor;\nimport org.springframework.expression.spel.support.ReflectivePropertyAccessor;\nimport org.springframework.integration.json.JsonPropertyAccessor;\nimport org.springframework.lang.Nullable;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.ITemplateEnd;\nimport org.thymeleaf.model.ITemplateStart;\nimport org.thymeleaf.processor.templateboundaries.AbstractTemplateBoundariesProcessor;\nimport org.thymeleaf.processor.templateboundaries.ITemplateBoundariesStructureHandler;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.standard.StandardDialect;\nimport org.thymeleaf.templatemode.TemplateMode;\nimport reactor.util.context.ContextView;\nimport run.halo.app.infra.utils.ReactiveUtils;\n\n/**\n * Enhance the evaluation context to support reactive types.\n *\n * @author guqing\n * @author johnniang\n * @since 2.20.0\n */\npublic class EvaluationContextEnhancer extends AbstractTemplateBoundariesProcessor {\n\n private static final int PRECEDENCE = StandardDialect.PROCESSOR_PRECEDENCE;\n\n private static final JsonPropertyAccessor JSON_PROPERTY_ACCESSOR = new JsonPropertyAccessor();\n\n public EvaluationContextEnhancer() {\n super(TemplateMode.HTML, PRECEDENCE);\n }\n\n @Override\n public void doProcessTemplateStart(ITemplateContext context, ITemplateStart templateStart,\n ITemplateBoundariesStructureHandler structureHandler) {\n var evluationContextObject = context.getVariable(\n ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME\n );\n if (evluationContextObject instanceof ThymeleafEvaluationContext evaluationContext) {\n evaluationContext.addPropertyAccessor(JSON_PROPERTY_ACCESSOR);\n ReactiveReflectivePropertyAccessor.wrap(evaluationContext);\n ReactiveMethodResolver.wrap(evaluationContext, context);\n }\n }\n\n @Override\n public void doProcessTemplateEnd(ITemplateContext context, ITemplateEnd templateEnd,\n ITemplateBoundariesStructureHandler structureHandler) {\n // nothing to do\n }\n\n /**\n * A {@link PropertyAccessor} that wraps the original {@link ReflectivePropertyAccessor} and\n * blocks the reactive value.\n */\n private static class ReactiveReflectivePropertyAccessor\n extends ReflectivePropertyAccessor {\n private final ReflectivePropertyAccessor delegate;\n\n private ReactiveReflectivePropertyAccessor(ReflectivePropertyAccessor delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public boolean canRead(EvaluationContext context, Object target, String name)\n throws AccessException {\n if (target == null) {\n // For backward compatibility\n return true;\n }\n return this.delegate.canRead(context, target, name);\n }\n\n @Override\n public TypedValue read(EvaluationContext context, Object target, String name)\n throws AccessException {\n if (target == null) {\n // For backward compatibility\n return TypedValue.NULL;\n }\n var typedValue = delegate.read(context, target, name);\n return Optional.of(typedValue)\n .filter(tv ->\n Objects.nonNull(tv.getValue())\n && Objects.nonNull(tv.getTypeDescriptor())\n && ReactiveUtils.isReactiveType(tv.getTypeDescriptor().getType())\n )\n .map(tv -> new TypedValue(ReactiveUtils.blockReactiveValue(tv.getValue())))\n .orElse(typedValue);\n }\n\n @Override\n public boolean canWrite(EvaluationContext context, Object target, String name)\n throws AccessException {\n return delegate.canWrite(context, target, name);\n }\n\n @Override\n public void write(EvaluationContext context, Object target, String name, Object newValue)\n throws AccessException {\n delegate.write(context, target, name, newValue);\n }\n\n @Override\n public Class[] getSpecificTargetClasses() {\n return delegate.getSpecificTargetClasses();\n }\n\n @Override\n public PropertyAccessor createOptimalAccessor(EvaluationContext context, Object target,\n String name) {\n var optimalAccessor = delegate.createOptimalAccessor(context, target, name);\n if (optimalAccessor instanceof CompilablePropertyAccessor optimalPropertyAccessor) {\n if (ReactiveUtils.isReactiveType(optimalPropertyAccessor.getPropertyType())) {\n return this;\n }\n return optimalPropertyAccessor;\n }\n return this;\n }\n\n static void wrap(ThymeleafEvaluationContext evaluationContext) {\n var wrappedPropertyAccessors = evaluationContext.getPropertyAccessors()\n .stream()\n .map(propertyAccessor -> {\n if (propertyAccessor instanceof ReflectivePropertyAccessor reflectiveAccessor) {\n return new ReactiveReflectivePropertyAccessor(reflectiveAccessor);\n }\n return propertyAccessor;\n })\n // make the list mutable\n .collect(Collectors.toCollection(ArrayList::new));\n evaluationContext.setPropertyAccessors(wrappedPropertyAccessors);\n }\n\n @Override\n public boolean equals(Object obj) {\n return delegate.equals(obj);\n }\n\n @Override\n public int hashCode() {\n return delegate.hashCode();\n }\n\n }\n\n /**\n * A {@link MethodResolver} that wraps the original {@link MethodResolver} and blocks the\n * reactive value.\n *\n * @param delegate the original {@link MethodResolver}\n * @param templateContext the template context\n */\n private record ReactiveMethodResolver(MethodResolver delegate, ITemplateContext templateContext)\n implements MethodResolver {\n\n @Override\n @Nullable\n public MethodExecutor resolve(EvaluationContext context, Object targetObject, String name,\n List argumentTypes) throws AccessException {\n var executor = delegate.resolve(context, targetObject, name, argumentTypes);\n return Optional.ofNullable(executor)\n .map(methodExecutor -> new ReactiveMethodExecutor(methodExecutor, templateContext))\n .orElse(null);\n }\n\n static void wrap(ThymeleafEvaluationContext evaluationContext, ITemplateContext context) {\n var wrappedMethodResolvers = evaluationContext.getMethodResolvers()\n .stream()\n .map(\n methodResolver -> new ReactiveMethodResolver(methodResolver, context)\n )\n // make the list mutable\n .collect(Collectors.toCollection(ArrayList::new));\n evaluationContext.setMethodResolvers(wrappedMethodResolvers);\n }\n\n }\n\n /**\n * A {@link MethodExecutor} that wraps the original {@link MethodExecutor} and blocks the\n * reactive value.\n *\n * @param delegate the original {@link MethodExecutor}\n * @param templateContext the template context\n */\n private record ReactiveMethodExecutor(MethodExecutor delegate, ITemplateContext templateContext)\n implements MethodExecutor {\n\n @Override\n public TypedValue execute(EvaluationContext context, Object target, Object... arguments)\n throws AccessException {\n var typedValue = delegate.execute(context, target, arguments);\n return Optional.of(typedValue)\n .filter(tv ->\n Objects.nonNull(tv.getValue())\n && Objects.nonNull(tv.getTypeDescriptor())\n && ReactiveUtils.isReactiveType(tv.getTypeDescriptor().getType())\n )\n .map(tv -> {\n var contextView = (ContextView) Optional.ofNullable(\n templateContext.getVariable(CONTEXT_VIEW_KEY)\n )\n .filter(ContextView.class::isInstance)\n .orElse(null);\n return new TypedValue(\n ReactiveUtils.blockReactiveValue(tv.getValue(), contextView)\n );\n })\n .orElse(typedValue);\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/GeneratorMetaProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.thymeleaf.model.AttributeValueQuotes.DOUBLE;\n\nimport java.util.Map;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.info.BuildProperties;\nimport org.springframework.core.annotation.Order;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\n\n/**\n * Processor for generating generator meta.\n * Set the order to 0 for removing the meta in later TemplateHeadProcessor.\n *\n * @author johnniang\n */\n@Order(0)\npublic class GeneratorMetaProcessor implements TemplateHeadProcessor {\n\n private final String generatorValue;\n\n public GeneratorMetaProcessor(ObjectProvider buildProperties) {\n this.generatorValue = \"Halo \" + buildProperties.stream().findFirst()\n .map(BuildProperties::getVersion)\n .orElse(\"Unknown\");\n }\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n return Mono.fromRunnable(() -> {\n var modelFactory = context.getModelFactory();\n var generatorMeta = modelFactory.createStandaloneElementTag(\"meta\",\n Map.of(\"name\", \"generator\", \"content\", generatorValue),\n DOUBLE, false, true);\n model.add(generatorMeta);\n });\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/GlobalHeadInjectionProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.thymeleaf.spring6.context.SpringContextUtils.getApplicationContext;\n\nimport java.time.Duration;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.ITemplateEvent;\nimport org.thymeleaf.processor.element.AbstractElementModelProcessor;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport org.thymeleaf.templatemode.TemplateMode;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Global head injection processor.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class GlobalHeadInjectionProcessor extends AbstractElementModelProcessor {\n\n private static final Duration BLOCKING_TIMEOUT = Duration.ofSeconds(10);\n /**\n * Inserting tag will re-trigger this processor, in order to avoid the loop out trigger,\n * this flag is required to prevent the loop problem.\n */\n private static final String PROCESS_FLAG =\n GlobalHeadInjectionProcessor.class.getName() + \".PROCESSED\";\n\n private static final String TAG_NAME = \"head\";\n private static final int PRECEDENCE = 1000;\n\n public GlobalHeadInjectionProcessor(final String dialectPrefix) {\n super(\n TemplateMode.HTML, // This processor will apply only to HTML mode\n dialectPrefix, // Prefix to be applied to name for matching\n TAG_NAME, // Tag name: match specifically this tag\n false, // Apply dialect prefix to tag name\n null, // No attribute name: will match by tag name\n false, // No prefix to be applied to attribute name\n PRECEDENCE); // Precedence (inside dialect's own precedence)\n }\n\n @Override\n protected void doProcess(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n if (context.containsVariable(InjectionExcluderProcessor.EXCLUDE_INJECTION_VARIABLE)) {\n return;\n }\n\n // note that this is important!!\n Object processedAlready = context.getVariable(PROCESS_FLAG);\n if (processedAlready != null) {\n return;\n }\n structureHandler.setLocalVariable(PROCESS_FLAG, true);\n\n // handle tag\n if (model.size() < 2) {\n return;\n }\n\n /*\n * Create the DOM structure that will be substituting our custom tag.\n * The headline will be shown inside a '
' tag, and so this must\n * be created first and then a Text node must be added to it.\n */\n IModel modelToInsert = model.cloneModel();\n // close tag\n final ITemplateEvent closeHeadTag = modelToInsert.get(modelToInsert.size() - 1);\n modelToInsert.remove(modelToInsert.size() - 1);\n\n // open tag\n final ITemplateEvent openHeadTag = modelToInsert.get(0);\n modelToInsert.remove(0);\n\n // apply processors to modelToInsert\n getTemplateHeadProcessors(context)\n .concatMap(processor -> processor.process(\n SecureTemplateContextWrapper.wrap(context), modelToInsert, structureHandler)\n )\n .then()\n .block(BLOCKING_TIMEOUT);\n\n // reset model to insert\n model.reset();\n model.add(openHeadTag);\n model.addModel(modelToInsert);\n model.add(closeHeadTag);\n }\n\n private Flux getTemplateHeadProcessors(ITemplateContext context) {\n var extensionGetter = getApplicationContext(context).getBeanProvider(ExtensionGetter.class)\n .getIfUnique();\n if (extensionGetter == null) {\n return Flux.empty();\n }\n return extensionGetter.getExtensions(TemplateHeadProcessor.class);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/GlobalSeoProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport static run.halo.app.theme.Constant.META_DESCRIPTION_VARIABLE_NAME;\n\nimport java.util.LinkedHashMap;\nimport lombok.AllArgsConstructor;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.AttributeValueQuotes;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n/**\n * Inject code to the template head tag according to the global seo settings.\n *\n * @author guqing\n * @see SystemSetting.Seo\n * @since 2.0.0\n */\n@Order(Ordered.HIGHEST_PRECEDENCE + 1)\n@Component\n@AllArgsConstructor\nclass GlobalSeoProcessor implements TemplateHeadProcessor {\n\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n return environmentFetcher.fetch(SystemSetting.Seo.GROUP, SystemSetting.Seo.class)\n .switchIfEmpty(Mono.fromSupplier(SystemSetting.Seo::new))\n .doOnNext(seo -> {\n IModelFactory modelFactory = context.getModelFactory();\n if (Boolean.TRUE.equals(seo.getBlockSpiders())) {\n var attributes = LinkedHashMap.newLinkedHashMap(2);\n attributes.put(\"name\", \"robots\");\n attributes.put(\"content\", \"noindex\");\n var metaTag = modelFactory.createStandaloneElementTag(\n \"meta\",\n attributes,\n AttributeValueQuotes.DOUBLE,\n false,\n true\n );\n model.add(metaTag);\n return;\n }\n var seoMetaDescription = context.getVariable(META_DESCRIPTION_VARIABLE_NAME);\n if (seoMetaDescription instanceof String description && !description.isBlank()) {\n var attributes = LinkedHashMap.newLinkedHashMap(2);\n attributes.put(\"name\", \"description\");\n attributes.put(\"content\", description);\n var metaTag = modelFactory.createStandaloneElementTag(\n \"meta\",\n attributes,\n AttributeValueQuotes.DOUBLE,\n false,\n true\n );\n model.add(metaTag);\n }\n })\n .then();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/HaloExpressionObjectFactory.java", "content": "package run.halo.app.theme.dialect;\n\nimport java.util.Set;\nimport org.thymeleaf.context.IExpressionContext;\nimport org.thymeleaf.expression.IExpressionObjectFactory;\nimport run.halo.app.theme.dialect.expression.Annotations;\n\n/**\n * Builds the expression objects to be used by Halo dialects.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class HaloExpressionObjectFactory implements IExpressionObjectFactory {\n\n public static final String ANNOTATIONS_EXPRESSION_OBJECT_NAME = \"annotations\";\n\n protected static final Set ALL_EXPRESSION_OBJECT_NAMES = Set.of(\n ANNOTATIONS_EXPRESSION_OBJECT_NAME);\n\n private static final Annotations ANNOTATIONS = new Annotations();\n\n @Override\n public Set getAllExpressionObjectNames() {\n return ALL_EXPRESSION_OBJECT_NAMES;\n }\n\n @Override\n public Object buildObject(IExpressionContext context, String expressionObjectName) {\n if (ANNOTATIONS_EXPRESSION_OBJECT_NAME.equals(expressionObjectName)) {\n return ANNOTATIONS;\n }\n return null;\n }\n\n @Override\n public boolean isCacheable(String expressionObjectName) {\n return true;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/HaloPostTemplateHandler.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.thymeleaf.spring6.context.SpringContextUtils.getApplicationContext;\n\nimport java.time.Duration;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.Optional;\nimport org.springframework.lang.NonNull;\nimport org.springframework.util.CollectionUtils;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.engine.AbstractTemplateHandler;\nimport org.thymeleaf.model.IOpenElementTag;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.model.IStandaloneElementTag;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Template post-handler.\n *\n * @author johnniang\n * @since 2.20.0\n */\npublic class HaloPostTemplateHandler extends AbstractTemplateHandler {\n\n private List postProcessors = List.of();\n\n @Override\n public void setContext(ITemplateContext context) {\n super.setContext(context);\n this.postProcessors = Optional.ofNullable(getApplicationContext(context))\n .map(appContext -> appContext.getBeanProvider(ExtensionGetter.class).getIfUnique())\n .map(extensionGetter -> extensionGetter.getExtensionList(ElementTagPostProcessor.class))\n .orElseGet(List::of);\n }\n\n @Override\n public void handleStandaloneElement(IStandaloneElementTag standaloneElementTag) {\n var processedTag = handleElementTag(standaloneElementTag);\n super.handleStandaloneElement((IStandaloneElementTag) processedTag);\n }\n\n @Override\n public void handleOpenElement(IOpenElementTag openElementTag) {\n var processedTag = handleElementTag(openElementTag);\n super.handleOpenElement((IOpenElementTag) processedTag);\n }\n\n @NonNull\n private IProcessableElementTag handleElementTag(\n @NonNull IProcessableElementTag processableElementTag\n ) {\n IProcessableElementTag processedTag = processableElementTag;\n if (!CollectionUtils.isEmpty(postProcessors)) {\n var tagProcessorChain = Mono.just(processableElementTag);\n var context = getContext();\n for (ElementTagPostProcessor elementTagPostProcessor : postProcessors) {\n tagProcessorChain = tagProcessorChain.flatMap(\n tag -> elementTagPostProcessor.process(\n SecureTemplateContextWrapper.wrap(context), tag)\n .defaultIfEmpty(tag)\n );\n }\n processedTag =\n Objects.requireNonNull(tagProcessorChain.defaultIfEmpty(processableElementTag)\n .block(Duration.ofMinutes(1)));\n }\n return processedTag;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/HaloProcessorDialect.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.thymeleaf.templatemode.TemplateMode.HTML;\n\nimport java.util.HashSet;\nimport java.util.Set;\nimport org.thymeleaf.dialect.AbstractProcessorDialect;\nimport org.thymeleaf.dialect.IExpressionObjectDialect;\nimport org.thymeleaf.dialect.IPostProcessorDialect;\nimport org.thymeleaf.expression.IExpressionObjectFactory;\nimport org.thymeleaf.postprocessor.IPostProcessor;\nimport org.thymeleaf.postprocessor.PostProcessor;\nimport org.thymeleaf.processor.IProcessor;\nimport org.thymeleaf.standard.StandardDialect;\n\n/**\n * Thymeleaf processor dialect for Halo.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class HaloProcessorDialect extends AbstractProcessorDialect\n implements IExpressionObjectDialect, IPostProcessorDialect {\n private static final String DIALECT_NAME = \"haloThemeProcessorDialect\";\n\n private static final IExpressionObjectFactory HALO_EXPRESSION_OBJECTS_FACTORY =\n new HaloExpressionObjectFactory();\n\n public HaloProcessorDialect() {\n // We will set this dialect the same \"dialect processor\" precedence as\n // the Standard Dialect, so that processor executions can interleave.\n super(DIALECT_NAME, \"halo\", StandardDialect.PROCESSOR_PRECEDENCE);\n }\n\n @Override\n public Set getProcessors(String dialectPrefix) {\n final Set processors = new HashSet();\n // add more processors\n processors.add(new GlobalHeadInjectionProcessor(dialectPrefix));\n processors.add(new TemplateFooterElementTagProcessor(dialectPrefix));\n processors.add(new EvaluationContextEnhancer());\n processors.add(new CommentElementTagProcessor(dialectPrefix));\n processors.add(new CommentEnabledVariableProcessor());\n processors.add(new InjectionExcluderProcessor());\n return processors;\n }\n\n @Override\n public IExpressionObjectFactory getExpressionObjectFactory() {\n return HALO_EXPRESSION_OBJECTS_FACTORY;\n }\n\n @Override\n public int getDialectPostProcessorPrecedence() {\n return Integer.MAX_VALUE;\n }\n\n @Override\n public Set getPostProcessors() {\n return Set.of(new PostProcessor(HTML, HaloPostTemplateHandler.class, Integer.MAX_VALUE));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/HaloSpringSecurityDialect.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.springframework.security.core.authority.AuthorityUtils.createAuthorityList;\nimport static org.thymeleaf.extras.springsecurity6.dialect.processor.AuthorizeAttrProcessor.ATTR_NAME;\nimport static org.thymeleaf.extras.springsecurity6.dialect.processor.AuthorizeAttrProcessor.ATTR_PRECEDENCE;\nimport static run.halo.app.infra.AnonymousUserConst.PRINCIPAL;\nimport static run.halo.app.infra.AnonymousUserConst.Role;\n\nimport java.util.LinkedHashSet;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Function;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.security.access.expression.ExpressionUtils;\nimport org.springframework.security.access.expression.method.MethodSecurityExpressionHandler;\nimport org.springframework.security.authentication.AnonymousAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.SecurityContextImpl;\nimport org.springframework.security.util.MethodInvocationUtils;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.engine.AttributeName;\nimport org.thymeleaf.extras.springsecurity6.auth.AuthUtils;\nimport org.thymeleaf.extras.springsecurity6.dialect.SpringSecurityDialect;\nimport org.thymeleaf.extras.springsecurity6.util.SpringSecurityContextUtils;\nimport org.thymeleaf.extras.springsecurity6.util.SpringVersionSpecificUtils;\nimport org.thymeleaf.extras.springsecurity6.util.SpringVersionUtils;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.IProcessor;\nimport org.thymeleaf.standard.processor.AbstractStandardConditionalVisibilityTagProcessor;\nimport org.thymeleaf.templatemode.TemplateMode;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n/**\n * HaloSpringSecurityDialect overwrites value of thymeleafSpringSecurityContext.\n *\n * @author johnniang\n */\npublic class HaloSpringSecurityDialect extends SpringSecurityDialect implements InitializingBean {\n\n private static final String SECURITY_CONTEXT_EXECUTION_ATTRIBUTE_NAME =\n \"ThymeleafReactiveModelAdditions:\"\n + SpringSecurityContextUtils.SECURITY_CONTEXT_MODEL_ATTRIBUTE_NAME;\n\n private final ServerSecurityContextRepository securityContextRepository;\n\n private final ObjectProvider expressionHandler;\n\n public HaloSpringSecurityDialect(ServerSecurityContextRepository securityContextRepository,\n ObjectProvider expressionHandler) {\n this.securityContextRepository = securityContextRepository;\n this.expressionHandler = expressionHandler;\n }\n\n @Override\n public void afterPropertiesSet() {\n if (!SpringVersionUtils.isSpringWebFluxPresent()) {\n return;\n }\n\n // We have to build an anonymous authentication token here because the token won't be saved\n // into repository during anonymous authentication.\n var anonymousAuthentication =\n new AnonymousAuthenticationToken(\n \"fallback\", PRINCIPAL, createAuthorityList(AuthorityUtils.ROLE_PREFIX + Role)\n );\n var anonymousSecurityContext = new SecurityContextImpl(anonymousAuthentication);\n\n final Function secCtxInitializer =\n exchange -> securityContextRepository.load(exchange)\n .defaultIfEmpty(anonymousSecurityContext);\n\n // Just overwrite the value of the attribute\n getExecutionAttributes().put(SECURITY_CONTEXT_EXECUTION_ATTRIBUTE_NAME, secCtxInitializer);\n }\n\n @Override\n public Set getProcessors(String dialectPrefix) {\n LinkedHashSet processors = new LinkedHashSet<>();\n processors.add(\n new HaloAuthorizeAttrProcessor(TemplateMode.HTML, dialectPrefix, ATTR_NAME)\n );\n processors.addAll(super.getProcessors(dialectPrefix));\n return processors;\n }\n\n public class HaloAuthorizeAttrProcessor\n extends AbstractStandardConditionalVisibilityTagProcessor {\n\n protected HaloAuthorizeAttrProcessor(TemplateMode templateMode, String dialectPrefix,\n String attrName) {\n super(templateMode, dialectPrefix, attrName, ATTR_PRECEDENCE - 10);\n }\n\n @Override\n protected boolean isVisible(ITemplateContext context, IProcessableElementTag tag,\n AttributeName attributeName, String attributeValue) {\n\n final String attrValue = (attributeValue == null ? null : attributeValue.trim());\n\n if (attrValue == null || attrValue.isEmpty()) {\n return false;\n }\n\n final Authentication authentication = AuthUtils.getAuthenticationObject(context);\n\n if (authentication == null) {\n return false;\n }\n\n // resolve expr\n var expr = Optional.of(attributeValue)\n .filter(v -> v.startsWith(\"${\") && v.endsWith(\"}\"))\n .map(v -> v.substring(2, v.length() - 1))\n .orElse(attributeValue);\n\n var expressionHandler = HaloSpringSecurityDialect.this.expressionHandler.getIfUnique();\n if (expressionHandler == null) {\n // no expression handler found\n return false;\n }\n\n var expression = expressionHandler.getExpressionParser().parseExpression(expr);\n\n var methodInvocation = MethodInvocationUtils.createFromClass(this,\n HaloAuthorizeAttrProcessor.class,\n \"dummyAuthorize\",\n new Class[] {Authentication.class},\n new Object[] {authentication}\n );\n var evaluationContext =\n expressionHandler.createEvaluationContext(authentication, methodInvocation);\n\n var expressionObjects = context.getExpressionObjects();\n var wrappedEvolutionContext = SpringVersionSpecificUtils.wrapEvaluationContext(\n evaluationContext, expressionObjects\n );\n\n return ExpressionUtils.evaluateAsBoolean(expression, wrappedEvolutionContext);\n }\n\n /**\n * This method is only used to create a method invocation for the expression parser.\n *\n * @param authentication authentication object\n * @return result of authorization expression evaluation\n */\n public Boolean dummyAuthorize(Authentication authentication) {\n throw new UnsupportedOperationException(\"Should not be called\");\n }\n\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/HaloTrackerProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.utils.PathUtils;\n\n/**\n * Get {@link GroupVersionKind} and {@code plural} from the view model to construct tracker\n * script tag and insert it into the head tag.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class HaloTrackerProcessor implements TemplateHeadProcessor {\n\n public static final String SKIP_TRACKER =\n HaloTrackerProcessor.class.getName() + \".SKIP_TRACKER\";\n\n private final ExternalUrlSupplier externalUrlGetter;\n\n public HaloTrackerProcessor(ExternalUrlSupplier externalUrlGetter) {\n this.externalUrlGetter = externalUrlGetter;\n }\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n // Check if tracker should be skipped\n var isSkip = (Boolean) context.getVariable(SKIP_TRACKER);\n if (BooleanUtils.isTrue(isSkip)) {\n return Mono.empty();\n }\n\n final IModelFactory modelFactory = context.getModelFactory();\n return Mono.just(getTrackerScript(context))\n .filter(StringUtils::isNotBlank)\n .map(trackerScript -> {\n model.add(modelFactory.createText(trackerScript));\n return trackerScript;\n })\n .then();\n }\n\n private String getTrackerScript(ITemplateContext context) {\n String resourceName = (String) context.getVariable(\"name\");\n String externalUrl = externalUrlGetter.get().getPath();\n Object groupVersionKind = context.getVariable(\"groupVersionKind\");\n Object plural = context.getVariable(\"plural\");\n if (groupVersionKind == null || plural == null) {\n return StringUtils.EMPTY;\n }\n if (!(groupVersionKind instanceof GroupVersionKind gvk)) {\n return StringUtils.EMPTY;\n }\n return trackerScript(externalUrl, gvk.group(), (String) plural, resourceName);\n }\n\n private String trackerScript(String externalUrl, String group, String plural, String name) {\n String jsSrc = PathUtils.combinePath(externalUrl, \"/halo-tracker.js\");\n return \"\"\"\n \n \"\"\".formatted(jsSrc, group, plural, name);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/IndexSeoProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * Processor for index page SEO.\n *\n * @author ryanwang\n */\n@Component\n@AllArgsConstructor\nclass IndexSeoProcessor implements TemplateHeadProcessor {\n\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n if (!isIndexTemplate(context)) {\n return Mono.empty();\n }\n return environmentFetcher.fetch(SystemSetting.Seo.GROUP, SystemSetting.Seo.class)\n .map(seo -> {\n IModelFactory modelFactory = context.getModelFactory();\n\n String keywords = seo.getKeywords();\n if (StringUtils.isNotBlank(keywords)) {\n String keywordsMeta =\n \"\\n\";\n model.add(modelFactory.createText(keywordsMeta));\n }\n\n if (StringUtils.isNotBlank(seo.getDescription())) {\n String descriptionMeta =\n \"\\n\";\n model.add(modelFactory.createText(descriptionMeta));\n }\n return model;\n })\n .then();\n }\n\n private boolean isIndexTemplate(ITemplateContext context) {\n return DefaultTemplateEnum.INDEX.getValue()\n .equals(context.getVariable(ModelConst.TEMPLATE_ID));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/InjectionExcluderProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport java.util.Set;\nimport java.util.regex.Pattern;\nimport org.springframework.util.Assert;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.ITemplateEnd;\nimport org.thymeleaf.model.ITemplateStart;\nimport org.thymeleaf.processor.templateboundaries.AbstractTemplateBoundariesProcessor;\nimport org.thymeleaf.processor.templateboundaries.ITemplateBoundariesProcessor;\nimport org.thymeleaf.processor.templateboundaries.ITemplateBoundariesStructureHandler;\nimport org.thymeleaf.standard.StandardDialect;\nimport org.thymeleaf.templatemode.TemplateMode;\n\n/**\n *

Determine whether the current template being rendered needs to exclude the processor of\n * code injection. If it needs to be excluded, set a local variable.

\n *

Why do you need to set a local variable here instead of directly judging in the processor?

\n *

Because the processor will process the fragment, and if you need to exclude the login\n * .html template and the login.html is only a fragment, then the exclusion logic will\n * fail, so here use {@link ITemplateBoundariesProcessor} events are only fired for the\n * first-level template to solve this problem.

\n *\n * @author guqing\n * @since 2.20.0\n */\npublic class InjectionExcluderProcessor extends AbstractTemplateBoundariesProcessor {\n\n public static final String EXCLUDE_INJECTION_VARIABLE =\n InjectionExcluderProcessor.class.getName() + \".EXCLUDE_INJECTION\";\n\n private final PageInjectionExcluder injectionExcluder = new PageInjectionExcluder();\n\n public InjectionExcluderProcessor() {\n super(TemplateMode.HTML, StandardDialect.PROCESSOR_PRECEDENCE);\n }\n\n @Override\n public void doProcessTemplateStart(ITemplateContext context, ITemplateStart templateStart,\n ITemplateBoundariesStructureHandler structureHandler) {\n if (isExcluded(context)) {\n structureHandler.setLocalVariable(EXCLUDE_INJECTION_VARIABLE, true);\n }\n }\n\n @Override\n public void doProcessTemplateEnd(ITemplateContext context, ITemplateEnd templateEnd,\n ITemplateBoundariesStructureHandler structureHandler) {\n structureHandler.removeLocalVariable(EXCLUDE_INJECTION_VARIABLE);\n }\n\n /**\n * Check if the template will be rendered is excluded injection.\n *\n * @param context template context\n * @return true if the template is excluded, otherwise false\n */\n boolean isExcluded(ITemplateContext context) {\n return injectionExcluder.isExcluded(context.getTemplateData().getTemplate());\n }\n\n static class PageInjectionExcluder {\n\n private final Set exactMatches = Set.of(\n \"login\",\n \"signup\",\n \"logout\"\n );\n\n private final Set regexPatterns = Set.of(\n Pattern.compile(\"error/.*\"),\n Pattern.compile(\"challenges/.*\"),\n Pattern.compile(\"password-reset/.*\")\n );\n\n public boolean isExcluded(String templateName) {\n Assert.notNull(templateName, \"Template name must not be null\");\n if (exactMatches.contains(templateName)) {\n return true;\n }\n\n for (Pattern pattern : regexPatterns) {\n if (pattern.matcher(templateName).matches()) {\n return true;\n }\n }\n\n return false;\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/LinkExpressionObjectDialect.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.thymeleaf.dialect.AbstractDialect;\nimport org.thymeleaf.dialect.IExpressionObjectDialect;\nimport org.thymeleaf.expression.IExpressionObjectFactory;\n\n/**\n * An expression object dialect for theme link.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class LinkExpressionObjectDialect extends AbstractDialect implements\n IExpressionObjectDialect {\n\n private static final IExpressionObjectFactory LINK_EXPRESSION_OBJECTS_FACTORY =\n new DefaultLinkExpressionFactory();\n\n public LinkExpressionObjectDialect() {\n super(\"themeLink\");\n }\n\n @Override\n public IExpressionObjectFactory getExpressionObjectFactory() {\n return LINK_EXPRESSION_OBJECTS_FACTORY;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/SecureTemplateContext.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.thymeleaf.spring6.expression.ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME;\n\nimport java.util.List;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.context.IdentifierSequences;\nimport org.thymeleaf.engine.TemplateData;\nimport org.thymeleaf.expression.IExpressionObjects;\nimport org.thymeleaf.inline.IInliner;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.templatemode.TemplateMode;\n\n/**\n * Secure template context.\n *\n * @author johnniang\n * @since 2.20.0\n */\nclass SecureTemplateContext implements ITemplateContext {\n\n private static final Set DANGEROUS_VARIABLES =\n Set.of(THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME);\n\n private final ITemplateContext delegate;\n\n public SecureTemplateContext(ITemplateContext delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public TemplateData getTemplateData() {\n return delegate.getTemplateData();\n }\n\n @Override\n public TemplateMode getTemplateMode() {\n return delegate.getTemplateMode();\n }\n\n @Override\n public List getTemplateStack() {\n return delegate.getTemplateStack();\n }\n\n @Override\n public List getElementStack() {\n return delegate.getElementStack();\n }\n\n @Override\n public Map getTemplateResolutionAttributes() {\n return delegate.getTemplateResolutionAttributes();\n }\n\n @Override\n public IModelFactory getModelFactory() {\n return delegate.getModelFactory();\n }\n\n @Override\n public boolean hasSelectionTarget() {\n return delegate.hasSelectionTarget();\n }\n\n @Override\n public Object getSelectionTarget() {\n return delegate.getSelectionTarget();\n }\n\n @Override\n public IInliner getInliner() {\n return delegate.getInliner();\n }\n\n @Override\n public String getMessage(\n Class origin,\n String key,\n Object[] messageParameters,\n boolean useAbsentMessageRepresentation\n ) {\n return delegate.getMessage(origin, key, messageParameters, useAbsentMessageRepresentation);\n }\n\n @Override\n public String buildLink(String base, Map parameters) {\n return delegate.buildLink(base, parameters);\n }\n\n @Override\n public IdentifierSequences getIdentifierSequences() {\n return delegate.getIdentifierSequences();\n }\n\n @Override\n public IEngineConfiguration getConfiguration() {\n return delegate.getConfiguration();\n }\n\n @Override\n public IExpressionObjects getExpressionObjects() {\n return delegate.getExpressionObjects();\n }\n\n @Override\n public Locale getLocale() {\n return delegate.getLocale();\n }\n\n @Override\n public boolean containsVariable(String name) {\n if (DANGEROUS_VARIABLES.contains(name)) {\n return false;\n }\n return delegate.containsVariable(name);\n }\n\n @Override\n public Set getVariableNames() {\n return delegate.getVariableNames()\n .stream()\n .filter(name -> !DANGEROUS_VARIABLES.contains(name))\n .collect(Collectors.toSet());\n }\n\n @Override\n public Object getVariable(String name) {\n if (DANGEROUS_VARIABLES.contains(name)) {\n return null;\n }\n return delegate.getVariable(name);\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) {\n return true;\n }\n if (o == null || getClass() != o.getClass()) {\n return false;\n }\n\n SecureTemplateContext that = (SecureTemplateContext) o;\n return Objects.equals(delegate, that.delegate);\n }\n\n @Override\n public int hashCode() {\n return Objects.hashCode(delegate);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/SecureTemplateContextWrapper.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.thymeleaf.context.Contexts;\nimport org.thymeleaf.context.ITemplateContext;\n\n/**\n * Wrap the delegate template context to a secure template context according to whether it is a\n * WebContext.\n *\n * @author guqing\n * @since 2.20.4\n */\npublic class SecureTemplateContextWrapper {\n\n /**\n * Wrap the delegate template context to a secure template context.\n */\n static SecureTemplateContext wrap(ITemplateContext delegate) {\n if (Contexts.isWebContext(delegate)) {\n return new SecureTemplateWebContext(delegate);\n }\n return new SecureTemplateContext(delegate);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/SecureTemplateWebContext.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.context.IWebContext;\nimport org.thymeleaf.web.IWebExchange;\n\n/**\n * Secure template web context.\n *

It's used to prevent some dangerous variables such as {@link ApplicationContext} from being\n * accessed.\n *\n * @author guqing\n * @see SecureTemplateContext\n * @since 2.20.4\n */\nclass SecureTemplateWebContext extends SecureTemplateContext implements IWebContext {\n private final IWebContext delegate;\n\n /**\n * The delegate must be an instance of IWebContext to create a SecureTemplateWebContext.\n */\n public SecureTemplateWebContext(ITemplateContext delegate) {\n super(delegate);\n if (delegate instanceof IWebContext webContext) {\n this.delegate = webContext;\n } else {\n throw new IllegalArgumentException(\"The delegate must be an instance of IWebContext\");\n }\n }\n\n @Override\n public IWebExchange getExchange() {\n return delegate.getExchange();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/TemplateFooterElementTagProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.thymeleaf.spring6.context.SpringContextUtils.getApplicationContext;\n\nimport java.time.Duration;\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.element.AbstractElementTagProcessor;\nimport org.thymeleaf.processor.element.IElementTagStructureHandler;\nimport org.thymeleaf.spring6.context.SpringContextUtils;\nimport org.thymeleaf.templatemode.TemplateMode;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n *

Footer element tag processor.

\n *

Replace the footer tag <halo:footer /> with the contents of the footer\n * field of the global configuration item.

\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class TemplateFooterElementTagProcessor extends AbstractElementTagProcessor {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private static final String TAG_NAME = \"footer\";\n private static final int PRECEDENCE = 1000;\n\n /**\n * Constructor footer element tag processor with HTML mode, dialect prefix, footer tag name.\n *\n * @param dialectPrefix dialect prefix\n */\n public TemplateFooterElementTagProcessor(final String dialectPrefix) {\n super(\n TemplateMode.HTML, // This processor will apply only to HTML mode\n dialectPrefix, // Prefix to be applied to name for matching\n TAG_NAME, // Tag name: match specifically this tag\n true, // Apply dialect prefix to tag name\n null, // No attribute name: will match by tag name\n false, // No prefix to be applied to attribute name\n PRECEDENCE); // Precedence (inside dialect's own precedence)\n }\n\n @Override\n protected void doProcess(ITemplateContext context, IProcessableElementTag tag,\n IElementTagStructureHandler structureHandler) {\n\n if (context.containsVariable(InjectionExcluderProcessor.EXCLUDE_INJECTION_VARIABLE)) {\n return;\n }\n\n IModel modelToInsert = context.getModelFactory().createModel();\n /*\n * Obtain the Spring application context.\n */\n final ApplicationContext appCtx = SpringContextUtils.getApplicationContext(context);\n\n String globalFooterText = getGlobalFooterText(appCtx);\n modelToInsert.add(context.getModelFactory().createText(globalFooterText));\n\n getTemplateFooterProcessors(context)\n .concatMap(processor -> processor.process(\n SecureTemplateContextWrapper.wrap(context), tag, structureHandler, modelToInsert)\n )\n .then()\n .block(BLOCKING_TIMEOUT);\n structureHandler.replaceWith(modelToInsert, false);\n }\n\n private String getGlobalFooterText(ApplicationContext appCtx) {\n SystemConfigFetcher fetcher =\n appCtx.getBean(SystemConfigFetcher.class);\n return fetcher.fetch(SystemSetting.CodeInjection.GROUP, SystemSetting.CodeInjection.class)\n .map(SystemSetting.CodeInjection::getFooter)\n .block(BLOCKING_TIMEOUT);\n }\n\n private Flux getTemplateFooterProcessors(ITemplateContext context) {\n var extensionGetter = getApplicationContext(context).getBeanProvider(ExtensionGetter.class)\n .getIfUnique();\n if (extensionGetter == null) {\n return Flux.empty();\n }\n return extensionGetter.getExtensions(TemplateFooterProcessor.class);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/TemplateGlobalHeadProcessor.java", "content": "package run.halo.app.theme.dialect;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.core.Ordered;\nimport org.springframework.core.annotation.Order;\nimport org.springframework.stereotype.Component;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.processor.element.IElementModelStructureHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n *

Global custom head snippet injection for theme global setting.

\n *

Globally injected head snippet can be overridden by content template.

\n *\n * @author guqing\n * @since 2.0.0\n */\n@Order(Ordered.HIGHEST_PRECEDENCE + 2)\n@Component\npublic class TemplateGlobalHeadProcessor implements TemplateHeadProcessor {\n\n private final SystemConfigFetcher fetcher;\n\n public TemplateGlobalHeadProcessor(SystemConfigFetcher fetcher) {\n this.fetcher = fetcher;\n }\n\n @Override\n public Mono process(ITemplateContext context, IModel model,\n IElementModelStructureHandler structureHandler) {\n final IModelFactory modelFactory = context.getModelFactory();\n return fetchCodeInjection()\n .doOnNext(codeInjection -> {\n String globalHeader = codeInjection.getGlobalHead();\n if (StringUtils.isNotBlank(globalHeader)) {\n model.add(modelFactory.createText(globalHeader + \"\\n\"));\n }\n\n // add content head to model\n String contentHeader = codeInjection.getContentHead();\n if (StringUtils.isNotBlank(contentHeader) && isContentTemplate(context)) {\n model.add(modelFactory.createText(contentHeader + \"\\n\"));\n }\n })\n .then();\n }\n\n private Mono fetchCodeInjection() {\n return fetcher.fetch(SystemSetting.CodeInjection.GROUP, SystemSetting.CodeInjection.class);\n }\n\n private boolean isContentTemplate(ITemplateContext context) {\n String templateId = (String) context.getVariable(ModelConst.TEMPLATE_ID);\n return DefaultTemplateEnum.POST.getValue().equals(templateId)\n || DefaultTemplateEnum.SINGLE_PAGE.getValue().equals(templateId);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/dialect/expression/Annotations.java", "content": "package run.halo.app.theme.dialect.expression;\n\nimport java.util.Map;\nimport org.springframework.lang.NonNull;\nimport org.springframework.lang.Nullable;\nimport run.halo.app.theme.finders.vo.ExtensionVoOperator;\n\n/**\n *

Expression Object for performing annotations operations inside Halo Extra Expressions.

\n * An object of this class is usually available in variable evaluation expressions with the name\n * #annotations.\n *\n * @author guqing\n * @since 2.0.2\n */\npublic class Annotations {\n\n /**\n * Get annotation value from extension vo.\n *\n * @param extension extension vo\n * @param key the key of annotation\n * @return annotation value if exists, otherwise null\n */\n @Nullable\n public String get(ExtensionVoOperator extension, String key) {\n Map annotations = extension.getMetadata().getAnnotations();\n if (annotations == null) {\n return null;\n }\n return annotations.get(key);\n }\n\n /**\n * Returns the value to which the specified key is mapped, or defaultValue if\n * extension contains no mapping for the key.\n *\n * @param extension extension vo\n * @param key the key of annotation\n * @return annotation value if exists, otherwise defaultValue\n */\n @NonNull\n public String getOrDefault(ExtensionVoOperator extension, String key, String defaultValue) {\n Map annotations = extension.getMetadata().getAnnotations();\n if (annotations == null) {\n return defaultValue;\n }\n return annotations.getOrDefault(key, defaultValue);\n }\n\n /**\n * Check if the extension has the specified annotation.\n *\n * @param extension extension vo\n * @param key the key of annotation\n * @return true if the extension has the specified annotation, otherwise false\n */\n public boolean contains(ExtensionVoOperator extension, String key) {\n Map annotations = extension.getMetadata().getAnnotations();\n if (annotations == null) {\n return false;\n }\n return annotations.containsKey(key);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/endpoint/ThemeEndpoint.java", "content": "package run.halo.app.theme.endpoint;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\nimport static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;\nimport static org.springdoc.core.fn.builders.content.Builder.contentBuilder;\nimport static org.springdoc.core.fn.builders.parameter.Builder.parameterBuilder;\nimport static org.springdoc.core.fn.builders.requestbody.Builder.requestBodyBuilder;\nimport static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;\nimport static org.springframework.http.HttpStatus.NO_CONTENT;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\n\nimport io.swagger.v3.oas.annotations.enums.ParameterIn;\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport java.net.URI;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.time.Duration;\nimport java.util.List;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springdoc.core.fn.builders.operation.Builder;\nimport org.springdoc.webflux.core.fn.SpringdocRouteBuilder;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.multipart.FilePart;\nimport org.springframework.http.codec.multipart.Part;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.core.extension.endpoint.CustomEndpoint;\nimport run.halo.app.core.user.service.SettingConfigService;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.IListRequest;\nimport run.halo.app.infra.ReactiveUrlDataBufferFetcher;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.theme.TemplateEngineManager;\nimport run.halo.app.theme.service.ThemeService;\nimport run.halo.app.theme.service.ThemeUtils;\nimport tools.jackson.databind.node.ObjectNode;\n\n/**\n * Endpoint for managing themes.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@AllArgsConstructor\npublic class ThemeEndpoint implements CustomEndpoint {\n\n private final ReactiveExtensionClient client;\n\n private final ThemeRootGetter themeRoot;\n\n private final ThemeService themeService;\n\n private final TemplateEngineManager templateEngineManager;\n\n private final SystemConfigFetcher systemEnvironmentFetcher;\n\n private final ReactiveUrlDataBufferFetcher urlDataBufferFetcher;\n\n private final SettingConfigService settingConfigService;\n\n @Override\n public RouterFunction endpoint() {\n var tag = \"ThemeV1alpha1Console\";\n return SpringdocRouteBuilder.route()\n .POST(\"themes/install\", contentType(MediaType.MULTIPART_FORM_DATA),\n this::install, builder -> builder.operationId(\"InstallTheme\")\n .description(\"Install a theme by uploading a zip file.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder()\n .implementation(InstallRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Theme.class))\n )\n .POST(\"themes/-/install-from-uri\", this::installFromUri,\n builder -> builder.operationId(\"InstallThemeFromUri\")\n .description(\"Install a theme from uri.\")\n .tag(tag)\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(InstallFromUriRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Theme.class))\n )\n .POST(\"themes/{name}/upgrade-from-uri\", this::upgradeFromUri,\n builder -> builder.operationId(\"UpgradeThemeFromUri\")\n .description(\"Upgrade a theme from uri.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .in(ParameterIn.PATH)\n .name(\"name\")\n .required(true)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder()\n .mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder()\n .implementation(UpgradeFromUriRequest.class))\n ))\n .response(responseBuilder()\n .implementation(Theme.class))\n )\n .POST(\"themes/{name}/upgrade\", this::upgrade,\n builder -> builder.operationId(\"UpgradeTheme\")\n .description(\"Upgrade theme\")\n .tag(tag)\n .parameter(parameterBuilder().in(ParameterIn.PATH).name(\"name\").required(true))\n .requestBody(requestBodyBuilder().required(true)\n .content(contentBuilder().mediaType(MediaType.MULTIPART_FORM_DATA_VALUE)\n .schema(schemaBuilder().implementation(UpgradeRequest.class))))\n .build())\n .PUT(\"themes/{name}/reload\", this::reloadTheme,\n builder -> builder.operationId(\"Reload\")\n .description(\"Reload theme setting.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(Theme.class))\n )\n .PUT(\"themes/{name}/reset-config\", this::resetSettingConfig,\n builder -> builder.operationId(\"ResetThemeConfig\")\n .description(\"Reset the configMap of theme setting.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(ConfigMap.class))\n )\n .PUT(\"themes/{name}/json-config\", this::updateThemeJsonConfig,\n builder -> builder.operationId(\"updateThemeJsonConfig\")\n .description(\"Update the configMap of theme setting.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .requestBody(requestBodyBuilder()\n .required(true)\n .content(contentBuilder().mediaType(MediaType.APPLICATION_JSON_VALUE)\n .schema(schemaBuilder().implementation(Object.class))))\n .response(responseBuilder()\n .responseCode(String.valueOf(NO_CONTENT.value()))\n .implementation(Void.class))\n )\n .PUT(\"themes/{name}/activation\", this::activateTheme,\n builder -> builder.operationId(\"activateTheme\")\n .description(\"Activate a theme by name.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(Theme.class))\n )\n .PUT(\"/themes/{name}/invalidate-cache\", this::invalidateCache,\n builder -> builder.operationId(\"InvalidateCache\")\n .description(\"Invalidate theme template cache.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .responseCode(String.valueOf(NO_CONTENT.value()))\n )\n )\n .GET(\"themes\", this::listThemes,\n builder -> {\n builder.operationId(\"ListThemes\")\n .description(\"List themes.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(ListResult.generateGenericClass(Theme.class)));\n ThemeQuery.buildParameters(builder);\n }\n )\n .GET(\"themes/-/activation\", this::fetchActivatedTheme,\n builder -> builder.operationId(\"fetchActivatedTheme\")\n .description(\"Fetch the activated theme.\")\n .tag(tag)\n .response(responseBuilder()\n .implementation(Theme.class))\n )\n .GET(\"themes/{name}/setting\", this::fetchThemeSetting,\n builder -> builder.operationId(\"fetchThemeSetting\")\n .description(\"Fetch setting of theme.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder()\n .implementation(Setting.class))\n )\n .GET(\"themes/{name}/json-config\", this::fetchThemeJsonConfig,\n builder -> builder.operationId(\"fetchThemeJsonConfig\")\n .description(\n \"Fetch converted json config of theme by configured configMapName.\")\n .tag(tag)\n .parameter(parameterBuilder()\n .name(\"name\")\n .in(ParameterIn.PATH)\n .required(true)\n .implementation(String.class)\n )\n .response(responseBuilder().implementation(Object.class))\n )\n .build();\n }\n\n private Mono fetchThemeJsonConfig(ServerRequest request) {\n return themeNameInPathVariableOrActivated(request)\n .flatMap(themeName -> client.fetch(Theme.class, themeName))\n .mapNotNull(theme -> theme.getSpec().getConfigMapName())\n .flatMap(settingConfigService::fetchConfig)\n .flatMap(json -> ServerResponse.ok().bodyValue(json));\n }\n\n private Mono updateThemeJsonConfig(ServerRequest request) {\n final var themeName = request.pathVariable(\"name\");\n return client.fetch(Theme.class, themeName)\n .doOnNext(theme -> {\n String configMapName = theme.getSpec().getConfigMapName();\n if (StringUtils.isBlank(configMapName)) {\n throw new ServerWebInputException(\n \"Unable to complete the request because the theme configMapName is blank.\");\n }\n })\n .flatMap(theme -> {\n final var configMapName = theme.getSpec().getConfigMapName();\n return request.bodyToMono(ObjectNode.class)\n .switchIfEmpty(\n Mono.error(new ServerWebInputException(\"Required request body is missing\")))\n .flatMap(configJsonData ->\n settingConfigService.upsertConfig(configMapName, configJsonData));\n })\n .then(ServerResponse.noContent().build());\n }\n\n private Mono invalidateCache(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return client.get(Theme.class, name)\n .flatMap(theme -> templateEngineManager.clearCache(name))\n .then(ServerResponse.noContent().build());\n }\n\n private Mono upgradeFromUri(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n var content = request.bodyToMono(UpgradeFromUriRequest.class)\n .map(UpgradeFromUriRequest::uri)\n .flatMapMany(urlDataBufferFetcher::fetch);\n\n return themeService.upgrade(name, content)\n .flatMap((updatedTheme) ->\n templateEngineManager.clearCache(updatedTheme.getMetadata().getName())\n .thenReturn(updatedTheme)\n )\n .flatMap(theme -> ServerResponse.ok().bodyValue(theme));\n }\n\n private Mono installFromUri(ServerRequest request) {\n var content = request.bodyToMono(InstallFromUriRequest.class)\n .map(InstallFromUriRequest::uri)\n .flatMapMany(urlDataBufferFetcher::fetch);\n\n return themeService.install(content)\n .flatMap(theme -> ServerResponse.ok().bodyValue(theme));\n }\n\n private Mono activateTheme(ServerRequest request) {\n final var activatedThemeName = request.pathVariable(\"name\");\n return client.fetch(Theme.class, activatedThemeName)\n .switchIfEmpty(Mono.error(new NotFoundException(\"Theme not found.\")))\n .flatMap(theme -> themeService.fetchSystemSetting()\n .flatMap(themeSetting -> {\n // update active theme config\n themeSetting.setActive(activatedThemeName);\n return systemEnvironmentFetcher.getConfigMap()\n .filter(configMap -> configMap.getData() != null)\n .map(configMap -> {\n var themeConfigJson = JsonUtils.objectToJson(themeSetting);\n configMap.getData()\n .put(SystemSetting.Theme.GROUP, themeConfigJson);\n return configMap;\n });\n })\n .flatMap(client::update)\n .retryWhen(Retry.backoff(5, Duration.ofMillis(300))\n .filter(OptimisticLockingFailureException.class::isInstance)\n )\n .thenReturn(theme)\n )\n .flatMap(activatedTheme -> ServerResponse.ok().bodyValue(activatedTheme));\n }\n\n private Mono fetchActivatedTheme(ServerRequest request) {\n var activatedTheme = themeService.fetchActivatedTheme()\n .switchIfEmpty(\n Mono.error(() -> new NotFoundException(\"Activated theme not found or not set\"))\n );\n return ServerResponse.ok().body(activatedTheme, Theme.class);\n }\n\n private Mono fetchThemeSetting(ServerRequest request) {\n return themeNameInPathVariableOrActivated(request)\n .flatMap(name -> client.fetch(Theme.class, name))\n .mapNotNull(theme -> theme.getSpec().getSettingName())\n .flatMap(settingName -> client.fetch(Setting.class, settingName))\n .flatMap(setting -> ServerResponse.ok().bodyValue(setting));\n }\n\n private Mono themeNameInPathVariableOrActivated(ServerRequest request) {\n Assert.notNull(request, \"request must not be null.\");\n var themeName = request.pathVariable(\"name\");\n if (\"-\".equals(themeName)) {\n return themeService.fetchActivatedThemeName()\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"No activated theme found, unable to proceed the request.\"\n )));\n }\n return Mono.just(themeName);\n }\n\n public static class ThemeQuery extends IListRequest.QueryListRequest {\n\n public ThemeQuery(MultiValueMap queryParams) {\n super(queryParams);\n }\n\n @NonNull\n public Boolean getUninstalled() {\n return Boolean.parseBoolean(queryParams.getFirst(\"uninstalled\"));\n }\n\n public static void buildParameters(Builder builder) {\n IListRequest.buildParameters(builder);\n builder.parameter(parameterBuilder()\n .name(\"uninstalled\")\n .description(\"Whether to list uninstalled themes.\")\n .in(ParameterIn.QUERY)\n .implementation(Boolean.class)\n .required(false));\n }\n }\n\n // TODO Extract the method into ThemeService\n Mono listThemes(ServerRequest request) {\n MultiValueMap queryParams = request.queryParams();\n ThemeQuery query = new ThemeQuery(queryParams);\n return Mono.defer(() -> {\n if (query.getUninstalled()) {\n return listUninstalled(query);\n }\n return client.list(Theme.class, null, null, query.getPage(), query.getSize());\n }).flatMap(extensions -> ServerResponse.ok().bodyValue(extensions));\n }\n\n public interface IUpgradeRequest {\n\n @Schema(requiredMode = REQUIRED, description = \"Theme zip file.\")\n FilePart getFile();\n\n }\n\n public record UpgradeFromUriRequest(@Schema(requiredMode = REQUIRED) URI uri) {\n }\n\n public static class UpgradeRequest implements IUpgradeRequest {\n\n private final MultiValueMap multipartData;\n\n public UpgradeRequest(MultiValueMap multipartData) {\n this.multipartData = multipartData;\n }\n\n @Override\n public FilePart getFile() {\n var part = multipartData.getFirst(\"file\");\n if (!(part instanceof FilePart filePart)) {\n throw new ServerWebInputException(\"Invalid multipart type of file\");\n }\n if (!filePart.filename().endsWith(\".zip\")) {\n throw new ServerWebInputException(\"Only zip extension supported\");\n }\n return filePart;\n }\n\n }\n\n private Mono upgrade(ServerRequest request) {\n // validate the theme first\n var name = request.pathVariable(\"name\");\n return request.multipartData()\n .map(UpgradeRequest::new)\n .map(UpgradeRequest::getFile)\n .flatMap(filePart -> themeService.upgrade(name, filePart.content()))\n .flatMap((updatedTheme) ->\n templateEngineManager.clearCache(updatedTheme.getMetadata().getName())\n .thenReturn(updatedTheme))\n .flatMap(updatedTheme -> ServerResponse.ok().bodyValue(updatedTheme));\n }\n\n Mono> listUninstalled(ThemeQuery query) {\n Path path = themeRoot.get();\n return ThemeUtils.listAllThemesFromThemeDir(path)\n .collectList()\n .flatMap(this::filterUnInstalledThemes)\n .map(themes -> {\n Integer page = query.getPage();\n Integer size = query.getSize();\n List subList = ListResult.subList(themes, page, size);\n return new ListResult<>(page, size, themes.size(), subList);\n });\n }\n\n private Mono> filterUnInstalledThemes(@NonNull List allThemes) {\n return client.list(Theme.class, null, null)\n .map(theme -> theme.getMetadata().getName())\n .collectList()\n .map(installed -> allThemes.stream()\n .filter(theme -> !installed.contains(theme.getMetadata().getName()))\n .toList()\n );\n }\n\n Mono reloadTheme(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return themeService.reloadTheme(name)\n .flatMap(theme -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(theme));\n }\n\n Mono resetSettingConfig(ServerRequest request) {\n String name = request.pathVariable(\"name\");\n return themeService.resetSettingConfig(name)\n .flatMap(theme -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(theme));\n }\n\n @Schema(name = \"ThemeInstallRequest\", types = \"object\")\n public static class InstallRequest {\n\n @Schema(hidden = true)\n private final MultiValueMap multipartData;\n\n public InstallRequest(MultiValueMap multipartData) {\n this.multipartData = multipartData;\n }\n\n @Schema(requiredMode = REQUIRED, description = \"Theme zip file.\")\n FilePart getFile() {\n Part part = multipartData.getFirst(\"file\");\n if (!(part instanceof FilePart file)) {\n throw new ServerWebInputException(\n \"Invalid parameter of file, binary data is required\");\n }\n if (!Paths.get(file.filename()).toString().endsWith(\".zip\")) {\n throw new ServerWebInputException(\n \"Invalid file type, only zip format is supported\");\n }\n return file;\n }\n }\n\n public record InstallFromUriRequest(@Schema(requiredMode = REQUIRED) URI uri) {\n }\n\n Mono install(ServerRequest request) {\n return request.multipartData()\n .map(InstallRequest::new)\n .map(InstallRequest::getFile)\n .flatMap(filePart -> themeService.install(filePart.content()))\n .flatMap(theme -> ServerResponse.ok().bodyValue(theme));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/engine/DefaultThemeTemplateAvailabilityProvider.java", "content": "package run.halo.app.theme.engine;\n\nimport java.nio.file.Files;\nimport org.springframework.boot.thymeleaf.autoconfigure.ThymeleafProperties;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.theme.ThemeContext;\n\n@Component\npublic class DefaultThemeTemplateAvailabilityProvider implements ThemeTemplateAvailabilityProvider {\n\n private final ThymeleafProperties thymeleafProperties;\n\n public DefaultThemeTemplateAvailabilityProvider(ThymeleafProperties thymeleafProperties) {\n this.thymeleafProperties = thymeleafProperties;\n }\n\n @Override\n public boolean isTemplateAvailable(ThemeContext themeContext, String viewName) {\n var suffix = thymeleafProperties.getSuffix();\n // Currently, we only support Path here.\n var path = themeContext.getPath().resolve(\"templates\").resolve(viewName + suffix);\n return Files.exists(path);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/engine/HaloTemplateEngine.java", "content": "package run.halo.app.theme.engine;\n\nimport java.nio.channels.ClosedByInterruptException;\nimport java.nio.charset.Charset;\nimport java.util.Set;\nimport lombok.extern.slf4j.Slf4j;\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferFactory;\nimport org.springframework.http.MediaType;\nimport org.thymeleaf.context.IContext;\nimport org.thymeleaf.messageresolver.IMessageResolver;\nimport org.thymeleaf.spring6.SpringWebFluxTemplateEngine;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Schedulers;\n\n/**\n * Default template engine implementation to be used in Halo.\n *\n * @author johnniang\n */\n@Slf4j\npublic class HaloTemplateEngine extends SpringWebFluxTemplateEngine {\n\n private final IMessageResolver messageResolver;\n\n public HaloTemplateEngine(IMessageResolver messageResolver) {\n this.messageResolver = messageResolver;\n }\n\n @Override\n protected void initializeSpringSpecific() {\n // Before initialization, thymeleaf will overwrite message resolvers.\n // So we need to add own message resolver at here.\n addMessageResolver(messageResolver);\n }\n\n @Override\n public Publisher processStream(String template, Set markupSelectors,\n IContext context, DataBufferFactory bufferFactory,\n MediaType mediaType, Charset charset, int responseMaxChunkSizeBytes) {\n var publisher = super.processStream(template, markupSelectors, context, bufferFactory,\n mediaType, charset, responseMaxChunkSizeBytes);\n // We have to subscribe on blocking thread, because some blocking operations will be present\n // while processing.\n if (publisher instanceof Mono mono) {\n return mono.subscribeOn(Schedulers.boundedElastic())\n .doOnError(Exception.class, e -> this.logTemplateError(e, template));\n }\n if (publisher instanceof Flux flux) {\n return flux.subscribeOn(Schedulers.boundedElastic())\n .doOnError(Exception.class, e -> this.logTemplateError(e, template));\n }\n return publisher;\n }\n\n private void logTemplateError(Exception e, String template) {\n if (Exceptions.unwrap(e.getCause()) instanceof InterruptedException) {\n log.warn(\"Interrupted while processing template: {}\", template);\n }\n if (e.getCause() instanceof ClosedByInterruptException) {\n log.warn(\"Interrupted while outputting template: {}\", template);\n }\n // other exceptions will be caught by error handler\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/engine/PluginClassloaderTemplateResolver.java", "content": "package run.halo.app.theme.engine;\n\nimport static run.halo.app.plugin.PluginConst.SYSTEM_PLUGIN_NAME;\n\nimport java.util.Map;\nimport java.util.regex.Matcher;\nimport java.util.regex.Pattern;\nimport org.apache.commons.lang3.StringUtils;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginState;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport org.springframework.lang.Nullable;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.spring6.templateresource.SpringResourceTemplateResource;\nimport org.thymeleaf.templateresolver.AbstractConfigurableTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\n\n/**\n * Plugin classloader template resolver to resolve template by plugin classloader.\n *\n * @author guqing\n * @since 2.11.0\n */\npublic class PluginClassloaderTemplateResolver extends AbstractConfigurableTemplateResolver {\n\n private final PluginManager haloPluginManager;\n static final Pattern PLUGIN_TEMPLATE_PATTERN =\n Pattern.compile(\"plugin:([A-Za-z0-9\\\\-.]+):(.+)\");\n\n /**\n * Create a new plugin classloader template resolver, not cacheable.\n *\n * @param pluginManager plugin manager must not be null\n */\n public PluginClassloaderTemplateResolver(PluginManager pluginManager) {\n super();\n this.haloPluginManager = pluginManager;\n setCacheable(false);\n }\n\n @Override\n protected ITemplateResource computeTemplateResource(\n final IEngineConfiguration configuration, final String ownerTemplate, final String template,\n final String resourceName, final String characterEncoding,\n final Map templateResolutionAttributes) {\n var matchResult = matchPluginTemplate(ownerTemplate, template);\n if (!matchResult.matches()) {\n return null;\n }\n String pluginName = matchResult.pluginName();\n var classloader = getClassloaderByPlugin(pluginName);\n if (classloader == null) {\n return null;\n }\n\n var templateName = matchResult.templateName();\n var ownerTemplateName = matchResult.ownerTemplateName();\n\n String handledResourceName = computeResourceName(configuration, ownerTemplateName,\n templateName, getPrefix(), getSuffix(), getForceSuffix(), getTemplateAliases(),\n templateResolutionAttributes);\n\n var resource = new DefaultResourceLoader(classloader)\n .getResource(handledResourceName);\n return new SpringResourceTemplateResource(resource, characterEncoding);\n }\n\n MatchResult matchPluginTemplate(String ownerTemplate, String template) {\n boolean matches = false;\n String pluginName = null;\n String templateName = template;\n String ownerTemplateName = ownerTemplate;\n if (StringUtils.isNotBlank(ownerTemplate)) {\n Matcher ownerTemplateMatcher = PLUGIN_TEMPLATE_PATTERN.matcher(ownerTemplate);\n if (ownerTemplateMatcher.matches()) {\n matches = true;\n pluginName = ownerTemplateMatcher.group(1);\n ownerTemplateName = ownerTemplateMatcher.group(2);\n }\n }\n Matcher templateMatcher = PLUGIN_TEMPLATE_PATTERN.matcher(template);\n if (templateMatcher.matches()) {\n matches = true;\n pluginName = templateMatcher.group(1);\n templateName = templateMatcher.group(2);\n }\n return new MatchResult(pluginName, ownerTemplateName, templateName, matches);\n }\n\n record MatchResult(String pluginName, String ownerTemplateName, String templateName,\n boolean matches) {\n }\n\n @Nullable\n private ClassLoader getClassloaderByPlugin(String pluginName) {\n if (SYSTEM_PLUGIN_NAME.equals(pluginName)) {\n return this.getClass().getClassLoader();\n }\n var pluginWrapper = haloPluginManager.getPlugin(pluginName);\n if (pluginWrapper == null || !PluginState.STARTED.equals(pluginWrapper.getPluginState())) {\n return null;\n }\n return pluginWrapper.getPluginClassLoader();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/engine/ThemeTemplateAvailabilityProvider.java", "content": "package run.halo.app.theme.engine;\n\nimport run.halo.app.theme.ThemeContext;\n\npublic interface ThemeTemplateAvailabilityProvider {\n\n boolean isTemplateAvailable(ThemeContext themeContext, String viewName);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/CategoryFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.Collection;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.theme.finders.vo.CategoryTreeVo;\nimport run.halo.app.theme.finders.vo.CategoryVo;\n\n/**\n * A finder for {@link Category}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface CategoryFinder {\n\n Mono getByName(String name);\n\n Flux getByNames(Collection names);\n\n Mono> list(@Nullable Integer page, @Nullable Integer size);\n\n Flux listAll();\n\n Flux listAsTree();\n\n Flux listAsTree(String name);\n\n Mono getParentByName(String name);\n\n Flux getBreadcrumbs(String name);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/CommentFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.Map;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.theme.finders.vo.CommentVo;\nimport run.halo.app.theme.finders.vo.ReplyVo;\n\n/**\n * A finder for finding {@link Comment comments} in template.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface CommentFinder {\n\n Mono getByName(String name);\n\n Mono> list(@Nullable Map ref, @Nullable Integer page,\n @Nullable Integer size);\n\n Mono> listReply(String commentName, @Nullable Integer page,\n @Nullable Integer size);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/CommentPublicQueryService.java", "content": "package run.halo.app.theme.finders;\n\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.theme.finders.vo.CommentVo;\nimport run.halo.app.theme.finders.vo.CommentWithReplyVo;\nimport run.halo.app.theme.finders.vo.ReplyVo;\n\n/**\n * comment finder.\n *\n * @author LIlGG\n */\npublic interface CommentPublicQueryService {\n Mono getByName(String name);\n\n Mono> list(Ref ref, @Nullable Integer page,\n @Nullable Integer size);\n\n Mono> list(Ref ref, @Nullable PageRequest pageRequest);\n\n Mono> convertToWithReplyVo(ListResult comments,\n int replySize);\n\n Mono> listReply(String commentName, @Nullable Integer page,\n @Nullable Integer size);\n\n Mono> listReply(String commentName, PageRequest pageRequest);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/ContributorFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.Collection;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.theme.finders.vo.ContributorVo;\n\n/**\n * A finder for {@link User}.\n */\npublic interface ContributorFinder {\n\n Mono getContributor(String name);\n\n Flux getContributors(Collection names);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/DefaultFinderRegistry.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.concurrent.ConcurrentHashMap;\nimport org.springframework.beans.factory.InitializingBean;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.stereotype.Component;\n\n/**\n * Finder registry for class annotated with {@link Finder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\npublic class DefaultFinderRegistry implements FinderRegistry, InitializingBean {\n private final Map> pluginFindersLookup = new ConcurrentHashMap<>();\n private final Map finders = new ConcurrentHashMap<>(64);\n\n private final ApplicationContext applicationContext;\n\n public DefaultFinderRegistry(ApplicationContext applicationContext) {\n this.applicationContext = applicationContext;\n }\n\n Object get(String name) {\n return finders.get(name);\n }\n\n /**\n * Given a name, register a Finder for it.\n *\n * @param name the canonical name\n * @param finder the finder to be registered\n * @throws IllegalStateException if the name is already existing\n */\n void putFinder(String name, Object finder) {\n if (finders.containsKey(name)) {\n throw new IllegalStateException(\n \"Finder with name '\" + name + \"' is already registered\");\n }\n finders.put(name, finder);\n }\n\n /**\n * Register a finder.\n *\n * @param finder register a finder that annotated with {@link Finder}\n * @return the name of the finder\n */\n String putFinder(Object finder) {\n var name = getFinderName(finder);\n this.putFinder(name, finder);\n return name;\n }\n\n private String getFinderName(Object finder) {\n var annotation = finder.getClass().getAnnotation(Finder.class);\n if (annotation == null) {\n // should never happen\n throw new IllegalStateException(\"Finder must be annotated with @Finder\");\n }\n String name = annotation.value();\n if (name == null) {\n name = finder.getClass().getSimpleName();\n }\n return name;\n }\n\n public void removeFinder(String name) {\n finders.remove(name);\n }\n\n public Map getFinders() {\n return Map.copyOf(finders);\n }\n\n @Override\n public void afterPropertiesSet() {\n // initialize finders from application context\n applicationContext.getBeansWithAnnotation(Finder.class)\n .forEach((beanName, finder) -> {\n var finderName = getFinderName(finder);\n this.putFinder(finderName, finder);\n });\n }\n\n @Override\n public void register(String pluginId, ApplicationContext pluginContext) {\n pluginContext.getBeansWithAnnotation(Finder.class)\n .forEach((beanName, finder) -> {\n var finderName = getFinderName(finder);\n this.putFinder(finderName, finder);\n pluginFindersLookup\n .computeIfAbsent(pluginId, ignored -> new ArrayList<>())\n .add(finderName);\n });\n }\n\n @Override\n public void unregister(String pluginId) {\n var finderNames = pluginFindersLookup.remove(pluginId);\n if (finderNames != null) {\n finderNames.forEach(finders::remove);\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/FinderRegistry.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.Map;\nimport org.springframework.context.ApplicationContext;\n\n/**\n * Finder registry for class annotated with {@link Finder}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface FinderRegistry {\n\n Map getFinders();\n\n void register(String pluginId, ApplicationContext pluginContext);\n\n void unregister(String pluginId);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/MenuFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.finders.vo.MenuVo;\n\n/**\n * A finder for {@link run.halo.app.core.extension.Menu}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface MenuFinder {\n\n Mono getByName(String name);\n\n Mono getPrimary();\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/PluginFinder.java", "content": "package run.halo.app.theme.finders;\n\n/**\n * A finder for {@link run.halo.app.core.extension.Plugin}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface PluginFinder {\n\n boolean available(String pluginName);\n\n boolean available(String pluginName, String requiresVersion);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/PostFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.Map;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.theme.finders.impl.PostFinderImpl.PostQuery;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.NavigationPostVo;\nimport run.halo.app.theme.finders.vo.PostArchiveVo;\nimport run.halo.app.theme.finders.vo.PostVo;\n\n/**\n * A finder for {@link Post}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface PostFinder {\n\n /**\n *

Gets post detail by name.

\n * We ensure the post is public, non-deleted and published.\n *\n * @param postName is post name\n * @return post detail\n */\n Mono getByName(String postName);\n\n Mono content(String postName);\n\n Mono cursor(String current);\n\n Flux listAll();\n\n /**\n * Lists posts by query params.\n *\n * @param params query params see {@link PostQuery}\n */\n Mono> list(Map params);\n\n Mono> list(@Nullable Integer page, @Nullable Integer size);\n\n Mono> listByCategory(@Nullable Integer page, @Nullable Integer size,\n String categoryName);\n\n Mono> listByTag(@Nullable Integer page, @Nullable Integer size,\n String tag);\n\n Mono> listByOwner(@Nullable Integer page, @Nullable Integer size,\n String owner);\n\n Mono> archives(Integer page, Integer size);\n\n Mono> archives(Integer page, Integer size, String year);\n\n Mono> archives(Integer page, Integer size, String year, String month);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/PostPublicQueryService.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.List;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.theme.ReactivePostContentHandler;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.PostVo;\n\npublic interface PostPublicQueryService {\n\n /**\n * Lists public posts by the given list options and page request.\n *\n * @param listOptions additional list options\n * @param page page request must not be null\n * @return a list of listed post vo\n */\n Mono> list(ListOptions listOptions, PageRequest page);\n\n /**\n * Converts post to listed post vo.\n *\n * @param post post must not be null\n * @return listed post vo\n */\n Mono convertToListedVo(@NonNull Post post);\n\n Mono> convertToListedVos(List posts);\n\n /**\n * Converts {@link Post} to post vo and populate post content by the given snapshot name.\n *

This method will get post content by {@code snapshotName} and try to find\n * {@link ReactivePostContentHandler}s to extend the content

\n *\n * @param post post must not be null\n * @param snapshotName snapshot name must not be blank\n * @return converted post vo\n */\n Mono convertToVo(Post post, String snapshotName);\n\n /**\n * Gets post content by post name.\n *

This method will get post released content by post name and try to find\n * {@link ReactivePostContentHandler}s to extend the content

\n *\n * @param postName post name must not be blank\n * @return post content for theme-side\n * @see ReactivePostContentHandler\n */\n Mono getContent(String postName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/SinglePageConversionService.java", "content": "package run.halo.app.theme.finders;\n\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.theme.ReactiveSinglePageContentHandler;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedSinglePageVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * A service that converts {@link SinglePage} to {@link SinglePageVo}.\n *\n * @author guqing\n * @since 2.6.0\n */\npublic interface SinglePageConversionService {\n\n /**\n * Converts the given {@link SinglePage} to {@link SinglePageVo} and populate content by\n * given snapshot name.\n *\n * @param singlePage the single page must not be null\n * @param snapshotName the snapshot name to get content must not be blank\n * @return the converted single page vo\n * @see #convertToVo(SinglePage)\n */\n Mono convertToVo(SinglePage singlePage, String snapshotName);\n\n /**\n * Converts the given {@link SinglePage} to {@link SinglePageVo}.\n *

This method will query the additional information of the {@link SinglePageVo} needed to\n * populate.

\n *

This method will try to find {@link ReactiveSinglePageContentHandler}s to extend the\n * content.

\n *\n * @param singlePage the single page must not be null\n * @return the converted single page vo\n * @see #getContent(String)\n */\n Mono convertToVo(@NonNull SinglePage singlePage);\n\n /**\n * Gets content by given page name.\n *

This method will get released content by page name and try to find\n * {@link ReactiveSinglePageContentHandler}s to extend the content.

\n *\n * @param pageName page name must not be blank\n * @return content of the specified page\n * @since 2.7.0\n */\n Mono getContent(String pageName);\n\n Mono convertToListedVo(SinglePage singlePage);\n\n Mono> listBy(ListOptions listOptions, PageRequest pageRequest);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/SinglePageFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedSinglePageVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * A finder for {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface SinglePageFinder {\n\n Mono getByName(String pageName);\n\n Mono content(String pageName);\n\n Mono> list(@Nullable Integer page, @Nullable Integer size);\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/SiteStatsFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.finders.vo.SiteStatsVo;\n\n/**\n * Site statistics finder.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface SiteStatsFinder {\n\n Mono getStats();\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/TagFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport java.util.Collection;\nimport java.util.List;\nimport org.springframework.lang.Nullable;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.theme.finders.vo.TagVo;\n\n/**\n * A finder for {@link Tag}.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface TagFinder {\n\n Mono getByName(String name);\n\n Flux getByNames(Collection names);\n\n Mono> list(@Nullable Integer page, @Nullable Integer size);\n\n List convertToVo(List tags);\n\n Flux listAll();\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/ThemeFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport reactor.core.publisher.Mono;\nimport run.halo.app.theme.finders.vo.ThemeVo;\n\n/**\n * A finder for theme.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface ThemeFinder {\n\n Mono activation();\n\n Mono getByName(String themeName);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/ThumbnailFinder.java", "content": "package run.halo.app.theme.finders;\n\nimport reactor.core.publisher.Mono;\n\n/**\n * A dialect expression for image thumbnail.\n *\n * @author guqing\n * @since 2.19.0\n */\npublic interface ThumbnailFinder {\n\n /**\n * Generate thumbnail uri from given image uri and size.\n *\n * @param uri URI of the original image, must be encoded\n * @param size the size of thumbnail to generate\n * @return the generated thumbnail url\n */\n Mono gen(String uri, String size);\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/CategoryFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static run.halo.app.extension.index.query.Queries.notEqual;\n\nimport java.time.Instant;\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.ObjectUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.Nullable;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.theme.finders.CategoryFinder;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.vo.CategoryTreeVo;\nimport run.halo.app.theme.finders.vo.CategoryVo;\n\n/**\n * A default implementation of {@link CategoryFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Slf4j\n@Finder(\"categoryFinder\")\n@RequiredArgsConstructor\npublic class CategoryFinderImpl implements CategoryFinder {\n private final ReactiveExtensionClient client;\n private final CategoryService categoryService;\n\n @Override\n public Mono getByName(String name) {\n return client.fetch(Category.class, name)\n .map(CategoryVo::from);\n }\n\n @Override\n public Flux getByNames(Collection names) {\n if (CollectionUtils.isEmpty(names)) {\n return Flux.empty();\n }\n var options = ListOptions.builder()\n .andQuery(Queries.in(\"metadata.name\", names))\n .build();\n return client.listAll(Category.class, options, ExtensionUtil.defaultSort())\n .map(CategoryVo::from);\n }\n\n static Sort defaultSort() {\n return Sort.by(Sort.Order.desc(\"spec.priority\"),\n Sort.Order.desc(\"metadata.creationTimestamp\"),\n Sort.Order.desc(\"metadata.name\"));\n }\n\n @Override\n public Mono> list(Integer page, Integer size) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n notEqual(\"spec.hideFromList\", BooleanUtils.TRUE)\n ));\n return client.listBy(Category.class, listOptions,\n PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size), defaultSort())\n )\n .map(list -> {\n List categoryVos = list.get()\n .map(CategoryVo::from)\n .collect(Collectors.toList());\n return new ListResult<>(list.getPage(), list.getSize(), list.getTotal(),\n categoryVos);\n })\n .defaultIfEmpty(new ListResult<>(page, size, 0L, List.of()));\n }\n\n @Override\n public Flux listAsTree() {\n return listAll()\n .collectList()\n .flatMapMany(list -> Flux.fromIterable(listToTree(list, null)));\n }\n\n @Override\n public Flux listAsTree(String name) {\n return listAllFor(name)\n .collectList()\n .flatMapMany(list -> Flux.fromIterable(listToTree(list, name)));\n }\n\n @Override\n public Flux listAll() {\n return client.listAll(Category.class, new ListOptions(), defaultSort())\n .filter(category -> !category.getSpec().isHideFromList())\n .map(CategoryVo::from);\n }\n\n private Flux listAllFor(String parentName) {\n return Mono.defer(\n () -> {\n if (StringUtils.isBlank(parentName)) {\n return Mono.just(false);\n }\n return categoryService.isCategoryHidden(parentName);\n })\n .flatMapMany(\n isHidden -> client.listAll(Category.class, new ListOptions(), defaultSort())\n .filter(category -> {\n if (isHidden) {\n return true;\n }\n return !category.getSpec().isHideFromList();\n })\n .map(CategoryVo::from)\n );\n }\n\n private List listToTree(List categoryVos, @Nullable String name) {\n Map nameIdentityMap = categoryVos.stream()\n .map(CategoryTreeVo::from)\n .collect(Collectors.toMap(categoryVo -> categoryVo.getMetadata().getName(),\n Function.identity()));\n\n nameIdentityMap.forEach((nameKey, value) -> {\n List children = value.getSpec().getChildren();\n if (children == null) {\n return;\n }\n for (String child : children) {\n CategoryTreeVo childNode = nameIdentityMap.get(child);\n if (childNode != null) {\n childNode.setParentName(nameKey);\n }\n }\n });\n var tree = listToTree(nameIdentityMap.values(), name);\n recomputePostCount(tree);\n return tree;\n }\n\n private static List listToTree(Collection list, String name) {\n Map> parentNameIdentityMap = list.stream()\n .filter(categoryTreeVo -> categoryTreeVo.getParentName() != null)\n .collect(Collectors.groupingBy(CategoryTreeVo::getParentName));\n\n list.forEach(node -> {\n // sort children\n List children =\n parentNameIdentityMap.getOrDefault(node.getMetadata().getName(), List.of())\n .stream()\n .sorted(defaultTreeNodeComparator())\n .toList();\n node.setChildren(children);\n });\n return list.stream()\n .filter(v -> StringUtils.isEmpty(name) ? v.getParentName() == null\n : StringUtils.equals(v.getMetadata().getName(), name))\n .sorted(defaultTreeNodeComparator())\n .collect(Collectors.toList());\n }\n\n private CategoryTreeVo dummyVirtualRoot(List treeNodes) {\n Category.CategorySpec categorySpec = new Category.CategorySpec();\n categorySpec.setSlug(\"/\");\n return CategoryTreeVo.builder()\n .metadata(new Metadata())\n .spec(categorySpec)\n .postCount(0)\n .children(treeNodes)\n .metadata(new Metadata())\n .build();\n }\n\n void recomputePostCount(List treeNodes) {\n var rootNode = dummyVirtualRoot(treeNodes);\n recomputePostCount(rootNode);\n }\n\n private int recomputePostCount(CategoryTreeVo rootNode) {\n if (rootNode == null) {\n return 0;\n }\n\n int originalPostCount = rootNode.getPostCount();\n\n for (var child : rootNode.getChildren()) {\n int childSum = recomputePostCount(child);\n if (!child.getSpec().isPreventParentPostCascadeQuery()) {\n rootNode.setPostCount(rootNode.getPostCount() + childSum);\n }\n }\n\n return rootNode.getSpec().isPreventParentPostCascadeQuery() ? originalPostCount\n : rootNode.getPostCount();\n }\n\n static Comparator defaultTreeNodeComparator() {\n Function priority =\n category -> Objects.requireNonNullElse(category.getSpec().getPriority(), 0);\n Function creationTimestamp =\n category -> category.getMetadata().getCreationTimestamp();\n Function name =\n category -> category.getMetadata().getName();\n return Comparator.comparing(priority)\n .thenComparing(creationTimestamp)\n .thenComparing(name);\n }\n\n static Comparator defaultComparator() {\n Function priority =\n category -> Objects.requireNonNullElse(category.getSpec().getPriority(), 0);\n Function creationTimestamp =\n category -> category.getMetadata().getCreationTimestamp();\n Function name =\n category -> category.getMetadata().getName();\n return Comparator.comparing(priority)\n .thenComparing(creationTimestamp)\n .thenComparing(name)\n .reversed();\n }\n\n @Override\n public Mono getParentByName(String name) {\n return categoryService.getParentByName(name)\n .map(CategoryVo::from);\n }\n\n @Override\n public Flux getBreadcrumbs(String name) {\n return listAllFor(name)\n .collectList()\n .map(list -> listToTree(list, null))\n .flatMapMany(treeNodes -> {\n var rootNode = dummyVirtualRoot(treeNodes);\n var paths = new ArrayList();\n findPathHelper(rootNode, name, paths);\n return Flux.fromIterable(paths);\n });\n }\n\n private static boolean findPathHelper(CategoryTreeVo node, String targetName,\n List path) {\n Assert.notNull(targetName, \"Target name must not be null\");\n if (node == null) {\n return false;\n }\n\n // null name is just a virtual root\n if (node.getMetadata().getName() != null) {\n path.add(CategoryTreeVo.toCategoryVo(node));\n }\n\n // node maybe a virtual root node so it may have null name\n if (targetName.equals(node.getMetadata().getName())) {\n return true;\n }\n\n for (CategoryTreeVo child : node.getChildren()) {\n if (findPathHelper(child, targetName, path)) {\n return true;\n }\n }\n\n // if the target node is not in the current subtree, remove the current node to roll back\n if (!path.isEmpty()) {\n path.remove(path.size() - 1);\n }\n return false;\n }\n\n int pageNullSafe(Integer page) {\n return ObjectUtils.defaultIfNull(page, 1);\n }\n\n int sizeNullSafe(Integer page) {\n return ObjectUtils.defaultIfNull(page, 10);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/CommentFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport java.util.Map;\nimport lombok.RequiredArgsConstructor;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.theme.finders.CommentFinder;\nimport run.halo.app.theme.finders.CommentPublicQueryService;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.vo.CommentVo;\nimport run.halo.app.theme.finders.vo.ReplyVo;\n\n/**\n * A default implementation of {@link CommentFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"commentFinder\")\n@RequiredArgsConstructor\npublic class CommentFinderImpl implements CommentFinder {\n\n private final CommentPublicQueryService commentPublicQueryService;\n\n @Override\n public Mono getByName(String name) {\n return commentPublicQueryService.getByName(name);\n }\n\n @Override\n public Mono> list(Map map, Integer page, Integer size) {\n if (map == null) {\n return commentPublicQueryService.list(null, page, size);\n }\n Ref ref = new Ref();\n ref.setGroup(map.get(\"group\"));\n ref.setVersion(map.get(\"version\"));\n ref.setKind(map.get(\"kind\"));\n ref.setName(map.get(\"name\"));\n return commentPublicQueryService.list(ref, page, size);\n }\n\n @Override\n public Mono> listReply(String commentName, Integer page, Integer size) {\n return commentPublicQueryService.listReply(commentName, page, size);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/CommentPublicQueryServiceImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static run.halo.app.core.extension.content.Comment.CommentOwner.ownerIdentity;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.extension.index.query.Queries.or;\n\nimport com.google.common.hash.Hashing;\nimport java.util.HashMap;\nimport java.util.Objects;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Function;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.Nullable;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.comment.OwnerInfo;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.theme.finders.CommentPublicQueryService;\nimport run.halo.app.theme.finders.vo.CommentStatsVo;\nimport run.halo.app.theme.finders.vo.CommentVo;\nimport run.halo.app.theme.finders.vo.CommentWithReplyVo;\nimport run.halo.app.theme.finders.vo.ExtensionVoOperator;\nimport run.halo.app.theme.finders.vo.ReplyVo;\n\n/**\n * comment public query service implementation.\n *\n * @author LIlGG\n * @author guqing\n */\n@Component\n@RequiredArgsConstructor\npublic class CommentPublicQueryServiceImpl implements CommentPublicQueryService {\n private static final int DEFAULT_SIZE = 10;\n\n private static final String COMMENT_VIEW_PERMISSION = \"role-template-view-comments\";\n\n private final ReactiveExtensionClient client;\n private final UserService userService;\n private final CounterService counterService;\n\n @Override\n public Mono getByName(String name) {\n return client.fetch(Comment.class, name)\n .flatMap(this::toCommentVo);\n }\n\n @Override\n public Mono> list(Ref ref, Integer page, Integer size) {\n return list(ref,\n PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size), defaultCommentSort()));\n }\n\n @Override\n public Mono> list(Ref ref, PageRequest pageParam) {\n var pageRequest = Optional.ofNullable(pageParam)\n .map(page -> page.withSort(page.getSort().and(defaultCommentSort())))\n .orElseGet(() -> PageRequestImpl.ofSize(10));\n return populateCommentListOptions(ref)\n .flatMap(listOptions -> client.listBy(Comment.class, listOptions, pageRequest))\n .flatMap(listResult -> Flux.fromStream(listResult.get())\n .map(this::toCommentVo)\n .flatMapSequential(Function.identity())\n .collectList()\n .map(commentVos -> new ListResult<>(listResult.getPage(),\n listResult.getSize(),\n listResult.getTotal(),\n commentVos)\n )\n )\n .defaultIfEmpty(ListResult.emptyResult());\n }\n\n @Override\n public Mono> convertToWithReplyVo(ListResult comments,\n int replySize) {\n return Flux.fromIterable(comments.getItems())\n .flatMapSequential(commentVo -> {\n var commentName = commentVo.getMetadata().getName();\n return listReply(commentName, 1, replySize)\n .map(replyList -> CommentWithReplyVo.from(commentVo)\n .setReplies(replyList)\n );\n })\n .collectList()\n .map(result -> new ListResult<>(\n comments.getPage(),\n comments.getSize(),\n comments.getTotal(),\n result)\n );\n }\n\n @Override\n public Mono> listReply(String commentName, Integer page, Integer size) {\n return listReply(commentName, PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size),\n defaultReplySort()));\n }\n\n @Override\n public Mono> listReply(String commentName, PageRequest pageParam) {\n // check comment\n return client.get(Comment.class, commentName)\n .flatMap(this::populateReplyListOptions)\n .flatMap(listOptions -> {\n var pageRequest = Optional.ofNullable(pageParam)\n .map(page -> page.withSort(page.getSort().and(defaultReplySort())))\n .orElse(PageRequestImpl.ofSize(0));\n return client.listBy(Reply.class, listOptions, pageRequest)\n .flatMap(list -> Flux.fromStream(list.get().map(this::toReplyVo))\n .flatMapSequential(Function.identity())\n .collectList()\n .map(replyVos -> new ListResult<>(list.getPage(), list.getSize(),\n list.getTotal(),\n replyVos))\n );\n })\n .defaultIfEmpty(ListResult.emptyResult());\n }\n\n Mono toCommentVo(Comment comment) {\n Comment.CommentOwner owner = comment.getSpec().getOwner();\n return Mono.just(CommentVo.from(comment))\n .flatMap(commentVo -> populateStats(Comment.class, commentVo)\n .doOnNext(commentVo::setStats)\n .thenReturn(commentVo))\n .flatMap(commentVo -> getOwnerInfo(owner)\n .doOnNext(commentVo::setOwner)\n .thenReturn(commentVo)\n )\n .flatMap(this::filterCommentSensitiveData);\n }\n\n private Mono filterCommentSensitiveData(CommentVo commentVo) {\n var owner = commentVo.getOwner();\n commentVo.setOwner(OwnerInfo\n .builder()\n .displayName(owner.getDisplayName())\n .avatar(owner.getAvatar())\n .kind(owner.getKind())\n .build());\n\n commentVo.getSpec().setIpAddress(\"\");\n var specOwner = commentVo.getSpec().getOwner();\n specOwner.setName(\"\");\n var email = owner.getEmail();\n if (StringUtils.isNotBlank(email)) {\n var emailHash = Hashing.sha256()\n .hashString(email.toLowerCase(), UTF_8)\n .toString();\n if (specOwner.getAnnotations() == null) {\n specOwner.setAnnotations(new HashMap<>(2));\n }\n specOwner.getAnnotations()\n .put(Comment.CommentOwner.EMAIL_HASH_ANNO, emailHash);\n }\n if (specOwner.getAnnotations() != null) {\n specOwner.getAnnotations().remove(\"Email\");\n }\n return Mono.just(commentVo);\n }\n\n // @formatter:off\n private \n Mono populateStats(Class clazz, T vo) {\n return counterService.getByName(MeterUtils.nameOf(clazz, vo.getMetadata()\n .getName()))\n .map(counter -> CommentStatsVo.builder()\n .upvote(counter.getUpvote())\n .build()\n )\n .defaultIfEmpty(CommentStatsVo.empty());\n }\n // @formatter:on\n\n Mono toReplyVo(Reply reply) {\n return Mono.just(ReplyVo.from(reply))\n .flatMap(replyVo -> populateStats(Reply.class, replyVo)\n .doOnNext(replyVo::setStats)\n .thenReturn(replyVo))\n .flatMap(replyVo -> getOwnerInfo(reply.getSpec().getOwner())\n .doOnNext(replyVo::setOwner)\n .thenReturn(replyVo)\n )\n .flatMap(this::filterReplySensitiveData);\n }\n\n private Mono filterReplySensitiveData(ReplyVo replyVo) {\n var owner = replyVo.getOwner();\n replyVo.setOwner(OwnerInfo\n .builder()\n .displayName(owner.getDisplayName())\n .avatar(owner.getAvatar())\n .kind(owner.getKind())\n .build());\n\n replyVo.getSpec().setIpAddress(\"\");\n var specOwner = replyVo.getSpec().getOwner();\n specOwner.setName(\"\");\n var email = owner.getEmail();\n if (StringUtils.isNotBlank(email)) {\n var emailHash = Hashing.sha256()\n .hashString(email.toLowerCase(), UTF_8)\n .toString();\n if (specOwner.getAnnotations() == null) {\n specOwner.setAnnotations(new HashMap<>(2));\n }\n specOwner.getAnnotations()\n .put(Comment.CommentOwner.EMAIL_HASH_ANNO, emailHash);\n }\n if (specOwner.getAnnotations() != null) {\n specOwner.getAnnotations().remove(\"Email\");\n }\n return Mono.just(replyVo);\n }\n\n private Mono getOwnerInfo(Comment.CommentOwner owner) {\n if (Comment.CommentOwner.KIND_EMAIL.equals(owner.getKind())) {\n return Mono.just(OwnerInfo.from(owner));\n }\n return userService.getUserOrGhost(owner.getName())\n .map(OwnerInfo::from);\n }\n\n private Mono populateCommentListOptions(@Nullable Ref ref) {\n return populateVisibleListOptions(null)\n .doOnNext(builder -> {\n if (ref != null) {\n builder.andQuery(\n equal(\"spec.subjectRef\", Comment.toSubjectRefKey(ref)));\n }\n })\n .map(ListOptions.ListOptionsBuilder::build);\n }\n\n private Mono populateVisibleListOptions(\n @Nullable Comment comment) {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Authentication::getName)\n .defaultIfEmpty(AnonymousUserConst.PRINCIPAL)\n .zipWith(userService.hasSufficientRoles(Set.of(COMMENT_VIEW_PERMISSION))\n .defaultIfEmpty(false))\n .flatMap(tuple2 -> {\n var username = tuple2.getT1();\n var hasViewPermission = tuple2.getT2();\n var commentHidden = false;\n var isCommentOwner = false;\n if (comment != null) {\n commentHidden = Boolean.TRUE.equals(comment.getSpec().getHidden());\n var owner = comment.getSpec().getOwner();\n isCommentOwner = owner != null && Objects.equals(\n ownerIdentity(owner.getKind(), owner.getName()),\n ownerIdentity(User.KIND, username)\n );\n boolean hasPermission =\n (!commentHidden) || (hasViewPermission || isCommentOwner);\n if (ExtensionUtil.isDeleted(comment) || !hasPermission) {\n return Mono.error(new ServerWebInputException(\n \"The comment was not found, hidden or deleted.\"\n ));\n }\n }\n\n var builder = ListOptions.builder();\n builder.andQuery(isNull(\"metadata.deletionTimestamp\"));\n var visibleQuery = and(\n equal(\"spec.hidden\", BooleanUtils.FALSE),\n equal(\"spec.approved\", BooleanUtils.TRUE)\n );\n\n var isAnonymous = AnonymousUserConst.isAnonymousUser(username);\n if (isAnonymous) {\n builder.andQuery(visibleQuery);\n } else if (!(hasViewPermission || (commentHidden && isCommentOwner))) {\n builder.andQuery(or(\n equal(\"spec.owner\", ownerIdentity(User.KIND, username)),\n visibleQuery\n ));\n }\n // View all replies if the user is not an anonymous user, has view permission\n // or is the comment owner.\n return Mono.just(builder);\n });\n }\n\n private Mono populateReplyListOptions(Comment comment) {\n // The comment name must be equal to the comment name of the reply\n // is approved and not hidden\n return populateVisibleListOptions(comment)\n .doOnNext(builder ->\n builder.andQuery(equal(\"spec.commentName\", comment.getMetadata().getName()))\n )\n .map(ListOptions.ListOptionsBuilder::build);\n }\n\n static Sort defaultCommentSort() {\n return Sort.by(Sort.Order.desc(\"spec.top\"),\n Sort.Order.asc(\"spec.priority\"),\n Sort.Order.desc(\"spec.creationTime\"),\n Sort.Order.asc(\"metadata.name\")\n );\n }\n\n static Sort defaultReplySort() {\n return Sort.by(Sort.Order.asc(\"spec.creationTime\"),\n Sort.Order.asc(\"metadata.name\")\n );\n }\n\n int pageNullSafe(Integer page) {\n return defaultIfNull(page, 1);\n }\n\n int sizeNullSafe(Integer size) {\n return defaultIfNull(size, DEFAULT_SIZE);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/ContributorFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport java.util.Collection;\nimport lombok.RequiredArgsConstructor;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.theme.finders.ContributorFinder;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.vo.ContributorVo;\n\n/**\n * A default implementation of {@link ContributorFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"contributorFinder\")\n@RequiredArgsConstructor\npublic class ContributorFinderImpl implements ContributorFinder {\n\n private final UserService userService;\n\n @Override\n public Mono getContributor(String name) {\n return userService.getUserOrGhost(name).map(ContributorVo::from);\n }\n\n @Override\n public Flux getContributors(Collection names) {\n return userService.getUsersOrGhosts(names).map(ContributorVo::from);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/MenuFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport java.time.Instant;\nimport java.util.Collection;\nimport java.util.Comparator;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport lombok.AllArgsConstructor;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.util.comparator.Comparators;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.MenuFinder;\nimport run.halo.app.theme.finders.vo.MenuItemVo;\nimport run.halo.app.theme.finders.vo.MenuVo;\n\n/**\n * A default implementation for {@link MenuFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"menuFinder\")\n@AllArgsConstructor\npublic class MenuFinderImpl implements MenuFinder {\n\n private final ReactiveExtensionClient client;\n private final SystemConfigFetcher environmentFetcher;\n\n @Override\n public Mono getByName(String name) {\n return listAsTree()\n .filter(menu -> menu.getMetadata().getName().equals(name))\n .next()\n .switchIfEmpty(Mono.error(\n () -> new NotFoundException(\"Menu with name \" + name + \" not found\")));\n }\n\n @Override\n public Mono getPrimary() {\n return listAsTree().collectList()\n .flatMap(menuVos -> {\n if (CollectionUtils.isEmpty(menuVos)) {\n return Mono.empty();\n }\n return environmentFetcher.fetch(SystemSetting.Menu.GROUP, SystemSetting.Menu.class)\n .map(SystemSetting.Menu::getPrimary)\n .map(primaryConfig -> menuVos.stream()\n .filter(menuVo -> menuVo.getMetadata().getName().equals(primaryConfig))\n .findAny()\n .orElse(menuVos.get(0))\n )\n .defaultIfEmpty(menuVos.get(0));\n })\n .switchIfEmpty(\n Mono.error(() -> new NotFoundException(\"No primary menu found\"))\n );\n }\n\n Flux listAll() {\n return client.list(Menu.class, null, null)\n .map(MenuVo::from);\n }\n\n Flux listAsTree() {\n return listAllMenuItem()\n .collectList()\n .map(MenuFinderImpl::populateParentName)\n .flatMapMany(menuItemVos -> {\n List treeList = listToTree(menuItemVos);\n Map nameItemRootNodeMap = treeList.stream()\n .collect(Collectors.toMap(item -> item.getMetadata().getName(),\n Function.identity()));\n return listAll()\n .map(menuVo -> {\n LinkedHashSet menuItemNames = menuVo.getSpec().getMenuItems();\n if (menuItemNames == null) {\n return menuVo.withMenuItems(List.of());\n }\n List menuItems = menuItemNames.stream()\n .map(nameItemRootNodeMap::get)\n .filter(Objects::nonNull)\n .sorted(defaultTreeNodeComparator())\n .toList();\n return menuVo.withMenuItems(menuItems);\n });\n });\n }\n\n static List listToTree(Collection list) {\n Map> parentNameIdentityMap = list.stream()\n .filter(menuItemVo -> menuItemVo.getParentName() != null)\n .collect(Collectors.groupingBy(MenuItemVo::getParentName));\n\n list.forEach(node -> {\n // sort children\n List children =\n parentNameIdentityMap.getOrDefault(node.getMetadata().getName(), List.of())\n .stream()\n .sorted(defaultTreeNodeComparator())\n .toList();\n node.setChildren(children);\n });\n\n return list.stream()\n .filter(v -> v.getParentName() == null)\n .collect(Collectors.toList());\n }\n\n Flux listAllMenuItem() {\n return client.list(MenuItem.class, null, null)\n .map(MenuItemVo::from);\n }\n\n static Comparator defaultTreeNodeComparator() {\n Function priority = menuItem -> menuItem.getSpec().getPriority();\n Function createTime = menuItem -> menuItem.getMetadata()\n .getCreationTimestamp();\n Function name = menuItem -> menuItem.getMetadata().getName();\n\n return Comparator.comparing(priority)\n .thenComparing(createTime, Comparators.nullsLow())\n .thenComparing(name);\n }\n\n static Collection populateParentName(List menuItemVos) {\n Map nameIdentityMap = menuItemVos.stream()\n .collect(Collectors.toMap(menuItem -> menuItem.getMetadata().getName(),\n Function.identity()));\n\n nameIdentityMap.forEach((name, value) -> {\n LinkedHashSet children = value.getSpec().getChildren();\n if (children == null) {\n return;\n }\n for (String child : children) {\n MenuItemVo childNode = nameIdentityMap.get(child);\n if (childNode != null) {\n childNode.setParentName(name);\n }\n }\n });\n return nameIdentityMap.values();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/PluginFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.util.Assert;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.PluginFinder;\n\n/**\n * Plugin finder implementation.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"pluginFinder\")\n@AllArgsConstructor\npublic class PluginFinderImpl implements PluginFinder {\n private final PluginManager pluginManager;\n\n @Override\n public boolean available(String pluginName) {\n if (StringUtils.isBlank(pluginName)) {\n return false;\n }\n PluginWrapper pluginWrapper = pluginManager.getPlugin(pluginName);\n if (pluginWrapper == null) {\n return false;\n }\n return PluginState.STARTED.equals(pluginWrapper.getPluginState());\n }\n\n @Override\n public boolean available(String pluginName, String requiresVersion) {\n Assert.notNull(requiresVersion, \"Requires version must not be null.\");\n if (!this.available(pluginName)) {\n return false;\n }\n var pluginWrapper = pluginManager.getPlugin(pluginName);\n var pluginVersion = pluginWrapper.getDescriptor().getVersion();\n return pluginManager.getVersionManager()\n .checkVersionConstraint(pluginVersion, requiresVersion);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/PostFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static run.halo.app.extension.PageRequestImpl.ofSize;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.in;\nimport static run.halo.app.extension.index.query.Queries.notEqual;\n\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.stream.Collectors;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.ObjectUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Condition;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.SortUtils;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.NavigationPostVo;\nimport run.halo.app.theme.finders.vo.PostArchiveVo;\nimport run.halo.app.theme.finders.vo.PostArchiveYearMonthVo;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.router.ReactiveQueryPostPredicateResolver;\n\n/**\n * A finder for {@link Post}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"postFinder\")\n@AllArgsConstructor\npublic class PostFinderImpl implements PostFinder {\n\n private final ReactiveExtensionClient client;\n\n private final PostPublicQueryService postPublicQueryService;\n\n private final ReactiveQueryPostPredicateResolver postPredicateResolver;\n\n private final CategoryService categoryService;\n\n @Override\n public Mono getByName(String postName) {\n return postPredicateResolver.getPredicate()\n .flatMap(predicate -> client.get(Post.class, postName)\n .filter(predicate)\n .flatMap(post -> postPublicQueryService.convertToVo(post,\n post.getSpec().getReleaseSnapshot())\n )\n );\n }\n\n @Override\n public Mono content(String postName) {\n return postPublicQueryService.getContent(postName);\n }\n\n static Sort defaultSort() {\n return Sort.by(Sort.Order.desc(\"spec.pinned\"),\n Sort.Order.desc(\"spec.priority\"),\n Sort.Order.desc(\"spec.publishTime\"),\n Sort.Order.asc(\"metadata.name\")\n );\n }\n\n static Sort archiveSort() {\n return Sort.by(Sort.Order.desc(\"spec.publishTime\"),\n Sort.Order.desc(\"metadata.name\")\n );\n }\n\n @Override\n public Mono cursor(String currentName) {\n return client.fetch(Post.class, currentName)\n // make sure the current post is published and has publishing time\n .filter(p -> Post.isPublished(p.getMetadata()))\n .filter(p -> p.getSpec() != null && p.getSpec().getPublishTime() != null)\n .flatMap(currentPost -> {\n var findPreviousPost = findPreviousPost(currentPost).map(Optional::of)\n .defaultIfEmpty(Optional.empty());\n var findNextPost = findNextPost(currentPost).map(Optional::of)\n .defaultIfEmpty(Optional.empty());\n return Mono.zip(findPreviousPost, findNextPost, (previous, next) ->\n NavigationPostVo.builder()\n .previous(previous.map(ListedPostVo::from).orElse(null))\n .next(next.map(ListedPostVo::from).orElse(null))\n .build()\n );\n })\n .switchIfEmpty(Mono.fromSupplier(NavigationPostVo::empty));\n }\n\n private Mono findPreviousPost(Post currentPost) {\n var publishTime = currentPost.getSpec().getPublishTime();\n return postPredicateResolver.getListOptions()\n .map(listOptions -> ListOptions.builder(listOptions)\n .andQuery(notHiddenPostQuery())\n .andQuery(Queries.lessThan(\"spec.publishTime\", publishTime))\n .build()\n )\n .flatMap(listOptions -> {\n var sort = Sort.by(\n Sort.Order.desc(\"spec.publishTime\"),\n Sort.Order.desc(\"metadata.name\")\n );\n return client.listBy(\n Post.class, listOptions, ofSize(1).withSort(sort)\n );\n })\n .flatMap(listResult -> Mono.justOrEmpty(listResult.getItems().stream().findFirst()));\n }\n\n private Mono findNextPost(Post currentPost) {\n var publishTime = currentPost.getSpec().getPublishTime();\n return postPredicateResolver.getListOptions()\n .map(listOptions -> ListOptions.builder(listOptions)\n .andQuery(notHiddenPostQuery())\n .andQuery(Queries.greaterThan(\"spec.publishTime\", publishTime))\n .build()\n )\n .flatMap(listOptions -> {\n var sort = Sort.by(\n Sort.Order.asc(\"spec.publishTime\"),\n Sort.Order.asc(\"metadata.name\")\n );\n return client.listBy(\n Post.class, listOptions, ofSize(1).withSort(sort)\n );\n })\n .flatMap(listResult -> Mono.justOrEmpty(listResult.getItems().stream().findFirst()));\n }\n\n private static Condition notHiddenPostQuery() {\n return notEqual(\"status.hideFromList\", BooleanUtils.TRUE);\n }\n\n @Override\n public Mono> list(Map params) {\n var query = Optional.ofNullable(params)\n .map(map -> JsonUtils.mapToObject(map, PostQuery.class))\n .orElseGet(PostQuery::new);\n if (StringUtils.isNotBlank(query.getCategoryName())) {\n return listChildrenCategories(query.getCategoryName())\n .map(category -> category.getMetadata().getName())\n .collectList()\n .map(categoryNames -> ListOptions.builder(query.toListOptions())\n .andQuery(in(\"spec.categories\", categoryNames))\n .build()\n )\n .flatMap(\n listOptions -> postPublicQueryService.list(listOptions, query.toPageRequest()));\n }\n return postPublicQueryService.list(query.toListOptions(), query.toPageRequest());\n }\n\n @Override\n public Mono> list(Integer page, Integer size) {\n var listOptions = ListOptions.builder()\n .fieldQuery(notHiddenPostQuery())\n .build();\n return postPublicQueryService.list(listOptions, getPageRequest(page, size));\n }\n\n private PageRequestImpl getPageRequest(Integer page, Integer size) {\n return PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size), defaultSort());\n }\n\n @Override\n public Mono> listByCategory(Integer page, Integer size,\n String categoryName) {\n return listChildrenCategories(categoryName)\n .map(category -> category.getMetadata().getName())\n .collectList()\n .flatMap(categoryNames -> {\n var listOptions = new ListOptions();\n var fieldQuery = in(\"spec.categories\", categoryNames);\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return postPublicQueryService.list(listOptions, getPageRequest(page, size));\n });\n }\n\n private Flux listChildrenCategories(String categoryName) {\n if (StringUtils.isBlank(categoryName)) {\n return client.listAll(Category.class, new ListOptions(),\n Sort.by(Sort.Order.asc(\"metadata.creationTimestamp\"),\n Sort.Order.desc(\"metadata.name\")));\n }\n return categoryService.listChildren(categoryName);\n }\n\n @Override\n public Mono> listByTag(Integer page, Integer size, String tag) {\n var fieldQuery = Queries.empty();\n if (StringUtils.isNotBlank(tag)) {\n fieldQuery = fieldQuery.and(equal(\"spec.tags\", tag));\n }\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return postPublicQueryService.list(listOptions, getPageRequest(page, size));\n }\n\n @Override\n public Mono> listByOwner(Integer page, Integer size, String owner) {\n var fieldQuery = Queries.empty();\n if (StringUtils.isNotBlank(owner)) {\n fieldQuery = fieldQuery.and(equal(\"spec.owner\", owner));\n }\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return postPublicQueryService.list(listOptions, getPageRequest(page, size));\n }\n\n @Override\n public Mono> archives(Integer page, Integer size) {\n return archives(page, size, null, null);\n }\n\n @Override\n public Mono> archives(Integer page, Integer size, String year) {\n return archives(page, size, year, null);\n }\n\n @Override\n public Mono> archives(Integer page, Integer size, String year,\n String month) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(notHiddenPostQuery()));\n var labelSelectorBuilder = LabelSelector.builder();\n if (StringUtils.isNotBlank(year)) {\n labelSelectorBuilder.eq(Post.ARCHIVE_YEAR_LABEL, year);\n }\n if (StringUtils.isNotBlank(month)) {\n labelSelectorBuilder.eq(Post.ARCHIVE_MONTH_LABEL, month);\n }\n listOptions.setLabelSelector(labelSelectorBuilder.build());\n var pageRequest = PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size), archiveSort());\n return postPublicQueryService.list(listOptions, pageRequest)\n .map(list -> {\n Map> yearPosts = list.get()\n .collect(Collectors.groupingBy(\n post -> HaloUtils.getYearText(post.getSpec().getPublishTime())));\n List postArchives = yearPosts.entrySet().stream()\n .map(entry -> {\n String key = entry.getKey();\n // archives by month\n Map> monthPosts = entry.getValue().stream()\n .collect(Collectors.groupingBy(\n post -> HaloUtils.getMonthText(post.getSpec().getPublishTime())));\n // convert to archive year month value objects\n List monthArchives = monthPosts.entrySet()\n .stream()\n .map(monthEntry -> PostArchiveYearMonthVo.builder()\n .posts(monthEntry.getValue())\n .month(monthEntry.getKey())\n .build()\n )\n .sorted(\n Comparator.comparing(PostArchiveYearMonthVo::getMonth).reversed())\n .toList();\n return PostArchiveVo.builder()\n .year(String.valueOf(key))\n .months(monthArchives)\n .build();\n })\n .sorted(Comparator.comparing(PostArchiveVo::getYear).reversed())\n .toList();\n return new ListResult<>(list.getPage(), list.getSize(), list.getTotal(),\n postArchives);\n })\n .defaultIfEmpty(ListResult.emptyResult());\n }\n\n @Override\n public Flux listAll() {\n return postPredicateResolver.getListOptions()\n .flatMapMany(listOptions -> client.listAll(Post.class, listOptions, defaultSort()))\n .collectList()\n .flatMap(postPublicQueryService::convertToListedVos)\n .flatMapMany(Flux::fromIterable);\n }\n\n static int pageNullSafe(Integer page) {\n return ObjectUtils.defaultIfNull(page, 1);\n }\n\n static int sizeNullSafe(Integer size) {\n return ObjectUtils.defaultIfNull(size, 10);\n }\n\n @Data\n public static class PostQuery {\n private Integer page;\n private Integer size;\n private String categoryName;\n private String tagName;\n private String owner;\n private List sort;\n\n public ListOptions toListOptions() {\n var builder = ListOptions.builder();\n var hasQuery = false;\n if (StringUtils.isNotBlank(owner)) {\n builder.andQuery(equal(\"spec.owner\", owner));\n hasQuery = true;\n }\n if (StringUtils.isNotBlank(tagName)) {\n builder.andQuery(equal(\"spec.tags\", tagName));\n hasQuery = true;\n }\n // Exclude hidden posts when no query\n if (!hasQuery) {\n builder.fieldQuery(notHiddenPostQuery());\n }\n return builder.build();\n }\n\n public PageRequest toPageRequest() {\n return PageRequestImpl.of(pageNullSafe(getPage()),\n sizeNullSafe(getSize()), SortUtils.resolve(sort).and(defaultSort()));\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/PostPublicQueryServiceImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static java.util.Objects.requireNonNullElse;\nimport static java.util.Objects.requireNonNullElseGet;\nimport static run.halo.app.core.counter.MeterUtils.nameOf;\nimport static run.halo.app.core.user.service.UserService.GHOST_USER_NAME;\n\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.ReactivePostContentHandler;\nimport run.halo.app.theme.finders.CategoryFinder;\nimport run.halo.app.theme.finders.ContributorFinder;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ContributorVo;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.finders.vo.StatsVo;\nimport run.halo.app.theme.router.ReactiveQueryPostPredicateResolver;\n\n@Component\n@RequiredArgsConstructor\npublic class PostPublicQueryServiceImpl implements PostPublicQueryService {\n\n private final ReactiveExtensionClient client;\n\n private final TagFinder tagFinder;\n\n private final CategoryFinder categoryFinder;\n\n private final ContributorFinder contributorFinder;\n\n private final CounterService counterService;\n\n private final PostService postService;\n\n private final ExtensionGetter extensionGetter;\n\n private final ReactiveQueryPostPredicateResolver postPredicateResolver;\n\n @Override\n public Mono> list(ListOptions queryOptions, PageRequest page) {\n return postPredicateResolver.getListOptions()\n .map(option -> {\n var fieldSelector = queryOptions.getFieldSelector();\n if (fieldSelector != null) {\n option.setFieldSelector(option.getFieldSelector()\n .andQuery(fieldSelector.query()));\n }\n var labelSelector = queryOptions.getLabelSelector();\n if (labelSelector != null) {\n option.setLabelSelector(option.getLabelSelector().and(labelSelector));\n }\n return option;\n })\n .flatMap(listOptions -> client.listBy(Post.class, listOptions, page))\n .flatMap(list -> convertToListedVos(list.getItems())\n .map(\n postVos -> new ListResult<>(\n list.getPage(), list.getSize(), list.getTotal(), postVos\n )\n )\n )\n .defaultIfEmpty(ListResult.emptyResult());\n }\n\n\n @Override\n public Mono convertToListedVo(@NonNull Post post) {\n Assert.notNull(post, \"Post must not be null\");\n ListedPostVo postVo = ListedPostVo.from(post);\n postVo.setCategories(List.of());\n postVo.setTags(List.of());\n postVo.setContributors(List.of());\n\n return Mono.just(postVo)\n .flatMap(lp -> populateStats(postVo)\n .doOnNext(lp::setStats)\n .thenReturn(lp)\n )\n .flatMap(p -> {\n String owner = p.getSpec().getOwner();\n return contributorFinder.getContributor(owner)\n .doOnNext(p::setOwner)\n .thenReturn(p);\n })\n .flatMap(p -> {\n List tagNames = p.getSpec().getTags();\n if (CollectionUtils.isEmpty(tagNames)) {\n return Mono.just(p);\n }\n return tagFinder.getByNames(tagNames)\n .collectList()\n .doOnNext(p::setTags)\n .thenReturn(p);\n })\n .flatMap(p -> {\n List categoryNames = p.getSpec().getCategories();\n if (CollectionUtils.isEmpty(categoryNames)) {\n return Mono.just(p);\n }\n return categoryFinder.getByNames(categoryNames)\n .collectList()\n .doOnNext(p::setCategories)\n .thenReturn(p);\n })\n .flatMap(p -> contributorFinder.getContributors(p.getStatus().getContributors())\n .collectList()\n .doOnNext(p::setContributors)\n .thenReturn(p)\n )\n .defaultIfEmpty(postVo);\n }\n\n @Override\n public Mono> convertToListedVos(List posts) {\n var counterNames = new HashSet(posts.size());\n var userNames = new HashSet();\n var tagNames = new HashSet();\n var categoryNames = new HashSet();\n posts.forEach(post -> {\n counterNames.add(nameOf(Post.class, post.getMetadata().getName()));\n var spec = post.getSpec();\n userNames.add(spec.getOwner());\n var status = post.getStatus();\n if (status != null && status.getContributors() != null) {\n userNames.addAll(status.getContributors());\n }\n if (spec.getTags() != null) {\n tagNames.addAll(spec.getTags());\n }\n if (spec.getCategories() != null) {\n categoryNames.addAll(spec.getCategories());\n }\n });\n\n var getCounters = counterService.getByNames(counterNames)\n .collectMap(counter -> counter.getMetadata().getName());\n var getContributors = contributorFinder.getContributors(userNames)\n .collectMap(ContributorVo::getName);\n var getTags = tagFinder.getByNames(tagNames)\n .collectMap(tagVo -> tagVo.getMetadata().getName());\n var getCategories = categoryFinder.getByNames(categoryNames)\n .collectMap(categoryVo -> categoryVo.getMetadata().getName());\n\n return Mono.zip(getCounters, getContributors, getTags, getCategories)\n .map(tuple -> {\n var counters = tuple.getT1();\n var contributors = tuple.getT2();\n var tags = tuple.getT3();\n var categories = tuple.getT4();\n return posts.stream()\n .map(post -> {\n var vo = ListedPostVo.from(post);\n vo.setCategories(List.of());\n vo.setTags(List.of());\n vo.setContributors(List.of());\n\n var spec = post.getSpec();\n var status = post.getStatus();\n var ghost = requireNonNullElseGet(\n contributors.get(GHOST_USER_NAME), ContributorVo::ghost\n );\n vo.setOwner(requireNonNullElse(contributors.get(spec.getOwner()), ghost));\n if (status != null && !CollectionUtils.isEmpty(status.getContributors())) {\n vo.setContributors(status.getContributors()\n .stream()\n .map(name -> requireNonNullElse(contributors.get(name), ghost))\n .toList());\n }\n\n if (!CollectionUtils.isEmpty(spec.getTags())) {\n vo.setTags(spec.getTags()\n .stream()\n .map(tags::get)\n .filter(Objects::nonNull)\n .toList());\n }\n if (!CollectionUtils.isEmpty(spec.getCategories())) {\n vo.setCategories(spec.getCategories()\n .stream()\n .map(categories::get)\n .filter(Objects::nonNull)\n .toList());\n }\n\n var counterName = nameOf(Post.class, post.getMetadata().getName());\n var counter = counters.get(counterName);\n if (counter != null) {\n vo.setStats(StatsVo.builder()\n .visit(counter.getVisit())\n .upvote(counter.getUpvote())\n .comment(counter.getApprovedComment())\n .build()\n );\n } else {\n vo.setStats(StatsVo.empty());\n }\n\n return vo;\n })\n .toList();\n });\n }\n\n @Override\n public Mono convertToVo(Post post, String snapshotName) {\n final String baseSnapshotName = post.getSpec().getBaseSnapshot();\n return convertToListedVo(post)\n .map(PostVo::from)\n .flatMap(postVo -> postService.getContent(snapshotName, baseSnapshotName)\n .flatMap(wrapper -> extendPostContent(post, wrapper))\n .doOnNext(postVo::setContent)\n .thenReturn(postVo)\n );\n }\n\n @Override\n public Mono getContent(String postName) {\n return postPredicateResolver.getPredicate()\n .flatMap(predicate -> client.get(Post.class, postName)\n .filter(predicate)\n )\n .flatMap(post -> {\n String releaseSnapshot = post.getSpec().getReleaseSnapshot();\n return postService.getContent(releaseSnapshot, post.getSpec().getBaseSnapshot())\n .flatMap(wrapper -> extendPostContent(post, wrapper));\n });\n }\n\n @NonNull\n protected Mono extendPostContent(Post post,\n ContentWrapper wrapper) {\n Assert.notNull(post, \"Post name must not be null\");\n Assert.notNull(wrapper, \"Post content must not be null\");\n return extensionGetter.getEnabledExtensions(ReactivePostContentHandler.class)\n .reduce(Mono.fromSupplier(() -> ReactivePostContentHandler.PostContentContext.builder()\n .post(post)\n .content(wrapper.getContent())\n .raw(wrapper.getRaw())\n .rawType(wrapper.getRawType())\n .build()\n ),\n (contentMono, handler) -> contentMono.flatMap(handler::handle)\n )\n .flatMap(Function.identity())\n .map(postContent -> ContentVo.builder()\n .content(postContent.getContent())\n .raw(postContent.getRaw())\n .build()\n );\n }\n\n private Mono populateStats(T postVo) {\n return counterService.getByName(nameOf(Post.class, postVo.getMetadata()\n .getName())\n )\n .map(counter -> StatsVo.builder()\n .visit(counter.getVisit())\n .upvote(counter.getUpvote())\n .comment(counter.getApprovedComment())\n .build()\n )\n .defaultIfEmpty(StatsVo.empty());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/SinglePageConversionServiceImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.springframework.data.domain.Sort.Order.asc;\nimport static org.springframework.data.domain.Sort.Order.desc;\nimport static run.halo.app.core.extension.content.Post.VisibleEnum.PUBLIC;\nimport static run.halo.app.core.extension.content.SinglePage.PUBLISHED_LABEL;\nimport static run.halo.app.extension.ExtensionUtil.notDeleting;\nimport static run.halo.app.extension.index.query.Queries.equal;\n\nimport java.util.List;\nimport java.util.function.Function;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.SinglePageService;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.ReactiveSinglePageContentHandler;\nimport run.halo.app.theme.ReactiveSinglePageContentHandler.SinglePageContentContext;\nimport run.halo.app.theme.finders.ContributorFinder;\nimport run.halo.app.theme.finders.SinglePageConversionService;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedSinglePageVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\nimport run.halo.app.theme.finders.vo.StatsVo;\n\n/**\n * Default implementation of {@link SinglePageConversionService}.\n *\n * @author guqing\n * @since 2.6.0\n */\n@Component\n@RequiredArgsConstructor\npublic class SinglePageConversionServiceImpl implements SinglePageConversionService {\n\n private final ReactiveExtensionClient client;\n\n private final SinglePageService singlePageService;\n\n private final ContributorFinder contributorFinder;\n\n private final CounterService counterService;\n\n private final ExtensionGetter extensionGetter;\n\n @Override\n public Mono convertToVo(SinglePage singlePage, String snapshotName) {\n return convert(singlePage, snapshotName);\n }\n\n @Override\n public Mono convertToVo(@NonNull SinglePage singlePage) {\n return convert(singlePage, singlePage.getSpec().getReleaseSnapshot());\n }\n\n protected Mono extendPageContent(SinglePage singlePage,\n ContentWrapper wrapper) {\n Assert.notNull(singlePage, \"SinglePage must not be null\");\n Assert.notNull(wrapper, \"SinglePage content must not be null\");\n return extensionGetter.getEnabledExtensions(\n ReactiveSinglePageContentHandler.class)\n .reduce(Mono.fromSupplier(() -> SinglePageContentContext.builder()\n .singlePage(singlePage)\n .content(wrapper.getContent())\n .raw(wrapper.getRaw())\n .rawType(wrapper.getRawType())\n .build()\n ),\n (contentMono, handler) -> contentMono.flatMap(handler::handle)\n )\n .flatMap(Function.identity())\n .map(pageContent -> ContentVo.builder()\n .content(pageContent.getContent())\n .raw(pageContent.getRaw())\n .build()\n );\n }\n\n @Override\n public Mono getContent(String pageName) {\n return client.get(SinglePage.class, pageName)\n .flatMap(singlePage -> {\n String releaseSnapshot = singlePage.getSpec().getReleaseSnapshot();\n String baseSnapshot = singlePage.getSpec().getBaseSnapshot();\n return singlePageService.getContent(releaseSnapshot, baseSnapshot)\n .flatMap(wrapper -> extendPageContent(singlePage, wrapper));\n })\n .map(wrapper -> ContentVo.builder().content(wrapper.getContent())\n .raw(wrapper.getRaw()).build());\n }\n\n @Override\n public Mono convertToListedVo(SinglePage singlePage) {\n return Mono.fromSupplier(\n () -> {\n ListedSinglePageVo pageVo = ListedSinglePageVo.from(singlePage);\n pageVo.setContributors(List.of());\n return pageVo;\n })\n .flatMap(this::populateStats)\n .flatMap(this::populateContributors);\n }\n\n @Override\n public Mono> listBy(ListOptions listOptions,\n PageRequest pageRequest) {\n // rewrite list options\n var rewroteListOptions = ListOptions.builder(listOptions)\n .andQuery(notDeleting())\n .andQuery(equal(\"spec.deleted\", Boolean.FALSE.toString()))\n .andQuery(equal(\"spec.visible\", PUBLIC.name()))\n .labelSelector()\n .eq(PUBLISHED_LABEL, Boolean.TRUE.toString())\n .end()\n .build();\n\n // rewrite sort\n var rewroteSort = pageRequest.getSort()\n .and(Sort.by(\n desc(\"spec.pinned\"),\n asc(\"spec.priority\")\n ));\n\n var rewrotePageRequest =\n PageRequestImpl.of(pageRequest.getPageNumber(), pageRequest.getPageSize(), rewroteSort);\n\n return client.listBy(SinglePage.class, rewroteListOptions, rewrotePageRequest)\n .flatMap(list -> Flux.fromStream(list.get())\n .flatMapSequential(this::convertToListedVo)\n .collectList()\n .map(pageVos ->\n new ListResult<>(list.getPage(), list.getSize(), list.getTotal(), pageVos)\n )\n );\n }\n\n\n Mono convert(SinglePage singlePage, String snapshotName) {\n Assert.notNull(singlePage, \"Single page must not be null\");\n Assert.hasText(snapshotName, \"Snapshot name must not be empty\");\n return Mono.just(singlePage)\n .map(page -> {\n SinglePageVo pageVo = SinglePageVo.from(page);\n pageVo.setContributors(List.of());\n pageVo.setContent(ContentVo.empty());\n return pageVo;\n })\n .flatMap(this::populateStats)\n .flatMap(this::populateContributors)\n .flatMap(page -> {\n String baseSnapshot = page.getSpec().getBaseSnapshot();\n return singlePageService.getContent(snapshotName, baseSnapshot)\n .flatMap(wrapper -> extendPageContent(singlePage, wrapper))\n .doOnNext(page::setContent)\n .thenReturn(page);\n })\n .flatMap(page -> contributorFinder.getContributor(page.getSpec().getOwner())\n .doOnNext(page::setOwner)\n .thenReturn(page)\n );\n }\n\n Mono populateStats(T pageVo) {\n String name = pageVo.getMetadata().getName();\n return counterService.getByName(MeterUtils.nameOf(SinglePage.class, name))\n .map(counter -> StatsVo.builder()\n .visit(counter.getVisit())\n .upvote(counter.getUpvote())\n .comment(counter.getApprovedComment())\n .build()\n )\n .doOnNext(pageVo::setStats)\n .thenReturn(pageVo);\n }\n\n Mono populateContributors(T pageVo) {\n List names = pageVo.getStatus().getContributors();\n if (CollectionUtils.isEmpty(names)) {\n return Mono.just(pageVo);\n }\n return contributorFinder.getContributors(names)\n .collectList()\n .doOnNext(pageVo::setContributors)\n .thenReturn(pageVo);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/SinglePageFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport java.security.Principal;\nimport java.util.Objects;\nimport java.util.function.Predicate;\nimport lombok.AllArgsConstructor;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.SinglePageConversionService;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.finders.vo.ContentVo;\nimport run.halo.app.theme.finders.vo.ListedSinglePageVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * A default implementation of {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"singlePageFinder\")\n@AllArgsConstructor\npublic class SinglePageFinderImpl implements SinglePageFinder {\n\n private final ReactiveExtensionClient client;\n\n private final SinglePageConversionService singlePagePublicQueryService;\n\n @Override\n public Mono getByName(String pageName) {\n return client.get(SinglePage.class, pageName)\n .filterWhen(page -> queryPredicate().map(predicate -> predicate.test(page)))\n .flatMap(singlePagePublicQueryService::convertToVo);\n }\n\n @Override\n public Mono content(String pageName) {\n return singlePagePublicQueryService.getContent(pageName);\n }\n\n @Override\n public Mono> list(Integer page, Integer size) {\n return singlePagePublicQueryService.listBy(\n new ListOptions(),\n PageRequestImpl.of(page, size)\n );\n }\n\n Mono> queryPredicate() {\n Predicate predicate = page -> page.isPublished()\n && Objects.equals(false, page.getSpec().getDeleted());\n Predicate visiblePredicate =\n page -> Post.VisibleEnum.PUBLIC.equals(page.getSpec().getVisible());\n return currentUserName()\n .map(username -> predicate.and(\n visiblePredicate.or(page -> username.equals(page.getSpec().getOwner())))\n )\n .defaultIfEmpty(predicate.and(visiblePredicate));\n }\n\n Mono currentUserName() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName)\n .filter(name -> !AnonymousUserConst.isAnonymousUser(name));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/SiteStatsFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\n\nimport lombok.AllArgsConstructor;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.SiteStatsFinder;\nimport run.halo.app.theme.finders.vo.SiteStatsVo;\n\n/**\n * A default implementation of {@link SiteStatsFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@AllArgsConstructor\n@Finder(\"siteStatsFinder\")\npublic class SiteStatsFinderImpl implements SiteStatsFinder {\n private final ReactiveExtensionClient client;\n\n @Override\n public Mono getStats() {\n return client.list(Counter.class, null, null)\n .reduce(SiteStatsVo.empty(), (stats, counter) -> {\n stats.setVisit(stats.getVisit() + counter.getVisit());\n stats.setComment(stats.getComment() + counter.getApprovedComment());\n stats.setUpvote(stats.getUpvote() + counter.getUpvote());\n return stats;\n })\n .flatMap(siteStatsVo -> postCount()\n .doOnNext(siteStatsVo::setPost)\n .thenReturn(siteStatsVo)\n )\n .flatMap(siteStatsVo -> categoryCount()\n .doOnNext(siteStatsVo::setCategory)\n .thenReturn(siteStatsVo));\n }\n\n Mono postCount() {\n var listOptions = new ListOptions();\n listOptions.setLabelSelector(LabelSelector.builder()\n .eq(Post.PUBLISHED_LABEL, \"true\")\n .build());\n var fieldQuery = and(\n isNull(\"metadata.deletionTimestamp\"),\n equal(\"spec.deleted\", \"false\")\n );\n listOptions.setFieldSelector(FieldSelector.of(fieldQuery));\n return client.listBy(Post.class, listOptions, PageRequestImpl.ofSize(1))\n .map(result -> (int) result.getTotal());\n }\n\n Mono categoryCount() {\n return client.listBy(Category.class, new ListOptions(), PageRequestImpl.ofSize(1))\n .map(ListResult::getTotal)\n .map(Long::intValue);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/TagFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport java.util.Collection;\nimport java.util.Comparator;\nimport java.util.List;\nimport java.util.stream.Collectors;\nimport org.apache.commons.lang3.ObjectUtils;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.util.CollectionUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.finders.vo.TagVo;\n\n/**\n * A default implementation of {@link TagFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"tagFinder\")\npublic class TagFinderImpl implements TagFinder {\n\n public static final Comparator DEFAULT_COMPARATOR =\n Comparator.comparing(tag -> tag.getMetadata().getCreationTimestamp());\n\n private final ReactiveExtensionClient client;\n\n public TagFinderImpl(ReactiveExtensionClient client) {\n this.client = client;\n }\n\n @Override\n public Mono getByName(String name) {\n return client.fetch(Tag.class, name)\n .map(TagVo::from);\n }\n\n @Override\n public Flux getByNames(Collection names) {\n if (CollectionUtils.isEmpty(names)) {\n return Flux.empty();\n }\n var options = ListOptions.builder()\n .andQuery(Queries.in(\"metadata.name\", names))\n .build();\n return client.listAll(Tag.class, options, ExtensionUtil.defaultSort())\n .map(TagVo::from);\n }\n\n @Override\n public Mono> list(Integer page, Integer size) {\n return listBy(new ListOptions(),\n PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size)));\n }\n\n @Override\n public List convertToVo(List tags) {\n if (CollectionUtils.isEmpty(tags)) {\n return List.of();\n }\n return tags.stream()\n .map(TagVo::from)\n .collect(Collectors.toList());\n }\n\n @Override\n public Flux listAll() {\n return client.listAll(Tag.class, new ListOptions(),\n Sort.by(Sort.Order.desc(\"metadata.creationTimestamp\")))\n .map(TagVo::from);\n }\n\n private Mono> listBy(ListOptions listOptions, PageRequest pageRequest) {\n return client.listBy(Tag.class, listOptions, pageRequest)\n .map(result -> {\n List tagVos = result.get()\n .map(TagVo::from)\n .collect(Collectors.toList());\n return new ListResult<>(result.getPage(), result.getSize(), result.getTotal(),\n tagVos);\n });\n }\n\n int pageNullSafe(Integer page) {\n return ObjectUtils.defaultIfNull(page, 1);\n }\n\n int sizeNullSafe(Integer size) {\n return ObjectUtils.defaultIfNull(size, 10);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/ThemeFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.apache.commons.lang3.StringUtils;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.ThemeFinder;\nimport run.halo.app.theme.finders.vo.ThemeVo;\n\n/**\n * A default implementation for {@link ThemeFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Finder(\"themeFinder\")\npublic class ThemeFinderImpl implements ThemeFinder {\n\n private final ReactiveExtensionClient client;\n private final SystemConfigFetcher environmentFetcher;\n\n public ThemeFinderImpl(ReactiveExtensionClient client,\n SystemConfigFetcher environmentFetcher) {\n this.client = client;\n this.environmentFetcher = environmentFetcher;\n }\n\n @Override\n public Mono activation() {\n return environmentFetcher.fetch(SystemSetting.Theme.GROUP, SystemSetting.Theme.class)\n .map(SystemSetting.Theme::getActive)\n .flatMap(themeName -> client.fetch(Theme.class, themeName))\n .flatMap(theme -> themeWithConfig(ThemeVo.from(theme)));\n }\n\n @Override\n public Mono getByName(String themeName) {\n return client.fetch(Theme.class, themeName)\n .flatMap(theme -> themeWithConfig(ThemeVo.from(theme)));\n }\n\n private Mono themeWithConfig(ThemeVo themeVo) {\n if (StringUtils.isBlank(themeVo.getSpec().getConfigMapName())) {\n return Mono.just(themeVo);\n }\n return client.fetch(ConfigMap.class, themeVo.getSpec().getConfigMapName())\n .map(configMap -> {\n Map config = new HashMap<>();\n configMap.getData().forEach((k, v) -> {\n JsonNode jsonNode = JsonUtils.jsonToObject(v, JsonNode.class);\n config.put(k, jsonNode);\n });\n JsonNode configJson = JsonUtils.mapToObject(config, JsonNode.class);\n return themeVo.withConfig(configJson);\n })\n .defaultIfEmpty(themeVo);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/impl/ThumbnailFinderImpl.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport java.net.URI;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.attachment.thumbnail.ThumbnailService;\nimport run.halo.app.theme.finders.Finder;\nimport run.halo.app.theme.finders.ThumbnailFinder;\n\n@Slf4j\n@Finder(\"thumbnail\")\n@RequiredArgsConstructor\npublic class ThumbnailFinderImpl implements ThumbnailFinder {\n\n private final ThumbnailService thumbnailService;\n\n @Override\n public Mono gen(String uriStr, String size) {\n return Mono.fromCallable(() -> URI.create(uriStr))\n .flatMap(uri -> thumbnailService.get(uri, ThumbnailSize.fromName(size)))\n .map(URI::toASCIIString)\n .onErrorComplete(IllegalArgumentException.class)\n .defaultIfEmpty(uriStr);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/CategoryTreeVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport java.util.Objects;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A tree vo for {@link Category}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\n@ToString\n@EqualsAndHashCode\npublic class CategoryTreeVo implements VisualizableTreeNode, ExtensionVoOperator {\n\n private MetadataOperator metadata;\n\n private Category.CategorySpec spec;\n\n private Category.CategoryStatus status;\n\n private List children;\n\n private String parentName;\n\n private Integer postCount;\n\n /**\n * Convert {@link CategoryVo} to {@link CategoryTreeVo}.\n *\n * @param category category value object\n * @return category tree value object\n */\n public static CategoryTreeVo from(CategoryVo category) {\n Assert.notNull(category, \"The category must not be null\");\n return CategoryTreeVo.builder()\n .metadata(category.getMetadata())\n .spec(category.getSpec())\n .status(category.getStatus())\n .children(List.of())\n .postCount(Objects.requireNonNullElse(category.getPostCount(), 0))\n .build();\n }\n\n /**\n * Convert {@link CategoryTreeVo} to {@link CategoryVo}.\n */\n public static CategoryVo toCategoryVo(CategoryTreeVo categoryTreeVo) {\n Assert.notNull(categoryTreeVo, \"The category tree vo must not be null\");\n return CategoryVo.builder()\n .metadata(categoryTreeVo.getMetadata())\n .spec(categoryTreeVo.getSpec())\n .status(categoryTreeVo.getStatus())\n .postCount(categoryTreeVo.getPostCount())\n .build();\n }\n\n @Override\n public String nodeText() {\n return String.format(\"%s (%s)%s\", getSpec().getDisplayName(), getPostCount(),\n spec.isPreventParentPostCascadeQuery() ? \" (Independent)\" : \"\");\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/CategoryVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.EqualsAndHashCode;\nimport lombok.Value;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Category}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@Builder\n@EqualsAndHashCode\npublic class CategoryVo implements ExtensionVoOperator {\n\n MetadataOperator metadata;\n\n Category.CategorySpec spec;\n\n Category.CategoryStatus status;\n\n Integer postCount;\n\n /**\n * Convert {@link Category} to {@link CategoryVo}.\n *\n * @param category category extension\n * @return category value object\n */\n public static CategoryVo from(Category category) {\n return CategoryVo.builder()\n .metadata(category.getMetadata())\n .spec(category.getSpec())\n .status(category.getStatus())\n .postCount(category.getStatusOrDefault().getVisiblePostCount())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/CommentStatsVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.Value;\n\n/**\n * comment stats value object.\n *\n * @author LIlGG\n * @since 2.0.0\n */\n@Value\n@Builder\npublic class CommentStatsVo {\n Integer upvote;\n\n public static CommentStatsVo empty() {\n return CommentStatsVo.builder()\n .upvote(0)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/CommentVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.experimental.Accessors;\nimport run.halo.app.content.comment.OwnerInfo;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Comment}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Accessors(chain = true)\n@EqualsAndHashCode\npublic class CommentVo implements ExtensionVoOperator {\n\n @Schema(requiredMode = REQUIRED)\n private MetadataOperator metadata;\n\n @Schema(requiredMode = REQUIRED)\n private Comment.CommentSpec spec;\n\n private Comment.CommentStatus status;\n\n @Schema(requiredMode = REQUIRED)\n private OwnerInfo owner;\n\n @Schema(requiredMode = REQUIRED)\n private CommentStatsVo stats;\n\n /**\n * Convert {@link Comment} to {@link CommentVo}.\n *\n * @param comment comment extension\n * @return a value object for {@link Comment}\n */\n public static CommentVo from(Comment comment) {\n return new CommentVo()\n .setMetadata(comment.getMetadata())\n .setSpec(comment.getSpec())\n .setStatus(comment.getStatus());\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/CommentWithReplyVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.experimental.Accessors;\nimport org.springframework.beans.BeanUtils;\nimport run.halo.app.extension.ListResult;\n\n/**\n *

A value object for comment with reply.

\n *\n * @author guqing\n * @since 2.14.0\n */\n@Data\n@Accessors(chain = true)\n@EqualsAndHashCode(callSuper = true)\npublic class CommentWithReplyVo extends CommentVo {\n\n private ListResult replies;\n\n /**\n * Convert {@link CommentVo} to {@link CommentWithReplyVo}.\n */\n public static CommentWithReplyVo from(CommentVo commentVo) {\n var commentWithReply = new CommentWithReplyVo();\n BeanUtils.copyProperties(commentVo, commentWithReply);\n commentWithReply.setReplies(ListResult.emptyResult());\n return commentWithReply;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/ContentVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.ToString;\nimport lombok.Value;\nimport run.halo.app.core.extension.content.Snapshot;\n\n/**\n * A value object for Content from {@link Snapshot}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@ToString\n@Builder\npublic class ContentVo {\n\n String raw;\n\n String content;\n\n /**\n * Empty content object.\n */\n public static ContentVo empty() {\n return ContentVo.builder()\n .raw(\"\")\n .content(\"\")\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/ContributorVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.ToString;\nimport lombok.Value;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link run.halo.app.core.extension.User}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@ToString\n@Builder\npublic class ContributorVo implements ExtensionVoOperator {\n\n String name;\n\n String displayName;\n\n String avatar;\n\n String bio;\n\n String permalink;\n\n MetadataOperator metadata;\n\n /**\n * Convert {@link User} to {@link ContributorVo}.\n *\n * @param user user extension\n * @return contributor value object\n */\n public static ContributorVo from(User user) {\n User.UserStatus status = user.getStatus();\n String permalink = (status == null ? \"\" : status.getPermalink());\n return builder().name(user.getMetadata().getName())\n .displayName(user.getSpec().getDisplayName())\n .avatar(user.getSpec().getAvatar())\n .bio(user.getSpec().getBio())\n .permalink(permalink)\n .metadata(user.getMetadata())\n .build();\n }\n\n /**\n * Create a ghost contributor.\n *\n * @return a ghost contributor value object\n */\n public static ContributorVo ghost() {\n var metadata = new Metadata();\n metadata.setName(UserService.GHOST_USER_NAME);\n return builder()\n .name(\"ghost\")\n .displayName(\"Ghost\")\n // .avatar(\"/images/ghost.png\")\n .bio(\"A ghost user.\")\n .permalink(\"/authors/ghost\")\n .metadata(metadata)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/ListedPostVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport lombok.experimental.SuperBuilder;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Post}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@SuperBuilder\n@ToString\n@EqualsAndHashCode\npublic class ListedPostVo implements ExtensionVoOperator {\n\n private MetadataOperator metadata;\n\n private Post.PostSpec spec;\n\n private Post.PostStatus status;\n\n private List categories;\n\n private List tags;\n\n private List contributors;\n\n private ContributorVo owner;\n\n private StatsVo stats;\n\n /**\n * Convert {@link Post} to {@link ListedPostVo}.\n *\n * @param post post extension\n * @return post value object\n */\n public static ListedPostVo from(Post post) {\n Assert.notNull(post, \"The post must not be null.\");\n Post.PostSpec spec = post.getSpec();\n Post.PostStatus postStatus = post.getStatusOrDefault();\n return ListedPostVo.builder()\n .metadata(post.getMetadata())\n .spec(spec)\n .status(postStatus)\n .categories(List.of())\n .tags(List.of())\n .contributors(List.of())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/ListedSinglePageVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport lombok.experimental.SuperBuilder;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@SuperBuilder\n@ToString\n@EqualsAndHashCode\npublic class ListedSinglePageVo implements ExtensionVoOperator {\n\n private MetadataOperator metadata;\n\n private SinglePage.SinglePageSpec spec;\n\n private SinglePage.SinglePageStatus status;\n\n private StatsVo stats;\n\n private List contributors;\n\n private ContributorVo owner;\n\n /**\n * Convert {@link SinglePage} to {@link ListedSinglePageVo}.\n *\n * @param singlePage single page extension\n * @return special page value object\n */\n public static ListedSinglePageVo from(SinglePage singlePage) {\n Assert.notNull(singlePage, \"The singlePage must not be null.\");\n SinglePage.SinglePageSpec spec = singlePage.getSpec();\n SinglePage.SinglePageStatus pageStatus = singlePage.getStatus();\n return ListedSinglePageVo.builder()\n .metadata(singlePage.getMetadata())\n .spec(spec)\n .status(pageStatus)\n .contributors(List.of())\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/MenuItemVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.ToString;\nimport org.apache.commons.lang3.StringUtils;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link MenuItem}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@ToString\n@Builder\npublic class MenuItemVo implements VisualizableTreeNode, ExtensionVoOperator {\n\n MetadataOperator metadata;\n\n MenuItem.MenuItemSpec spec;\n\n MenuItem.MenuItemStatus status;\n\n List children;\n\n String parentName;\n\n /**\n * Gets menu item's display name.\n */\n public String getDisplayName() {\n if (status != null && StringUtils.isNotBlank(status.getDisplayName())) {\n return status.getDisplayName();\n }\n return spec.getDisplayName();\n }\n\n /**\n * Convert {@link MenuItem} to {@link MenuItemVo}.\n *\n * @param menuItem menu item extension\n * @return menu item value object\n */\n public static MenuItemVo from(MenuItem menuItem) {\n MenuItem.MenuItemStatus status = menuItem.getStatus();\n return MenuItemVo.builder()\n .metadata(menuItem.getMetadata())\n .spec(menuItem.getSpec())\n .status(status)\n .children(List.of())\n .build();\n }\n\n @Override\n public String nodeText() {\n return getDisplayName();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/MenuVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.Iterator;\nimport java.util.List;\nimport lombok.Builder;\nimport lombok.ToString;\nimport lombok.Value;\nimport lombok.With;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Menu}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@ToString\n@Builder\npublic class MenuVo implements ExtensionVoOperator {\n\n MetadataOperator metadata;\n\n Menu.Spec spec;\n\n @With\n List menuItems;\n\n /**\n * Convert {@link Menu} to {@link MenuVo}.\n *\n * @param menu menu extension\n * @return menu value object\n */\n public static MenuVo from(Menu menu) {\n return builder()\n .metadata(menu.getMetadata())\n .spec(menu.getSpec())\n .menuItems(List.of())\n .build();\n }\n\n public void print(StringBuilder buffer) {\n buffer.append(getSpec().getDisplayName());\n buffer.append('\\n');\n if (menuItems == null) {\n return;\n }\n for (Iterator it = menuItems.iterator(); it.hasNext(); ) {\n MenuItemVo next = it.next();\n if (it.hasNext()) {\n next.print(buffer, \"├── \", \"│ \");\n } else {\n next.print(buffer, \"└── \", \" \");\n }\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/NavigationPostVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Builder;\nimport org.jspecify.annotations.Nullable;\n\n/**\n * Post navigation vo to hold previous and next item.\n *\n * @param previous Previous post. It's publishing time is earlier than current post.\n * @param next Next post. It's publishing time is later than current post.\n * @author guqing\n * @author johnniang\n * @since 2.0.0\n */\n@Builder\npublic record NavigationPostVo(\n\n @Schema(requiredMode = NOT_REQUIRED)\n @Nullable\n ListedPostVo previous,\n\n @Schema(requiredMode = NOT_REQUIRED)\n @Nullable\n ListedPostVo next\n\n) {\n /**\n * Indicates whether it has next post.\n *\n * @return true if it has next post, false otherwise\n */\n public boolean hasNext() {\n return next != null;\n }\n\n /**\n * Indicates whether it has previous post.\n *\n * @return true if it has previous post, false otherwise\n */\n public boolean hasPrevious() {\n return previous != null;\n }\n\n public static NavigationPostVo empty() {\n return NavigationPostVo.builder().build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/PostArchiveVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Builder;\nimport lombok.Value;\n\n/**\n * Post archives by year and month.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@Builder\npublic class PostArchiveVo {\n\n String year;\n\n List months;\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/PostArchiveYearMonthVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Builder;\nimport lombok.Value;\n\n/**\n * Post archives by month.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@Builder\npublic class PostArchiveYearMonthVo {\n\n String month;\n\n List posts;\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/PostVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport lombok.experimental.SuperBuilder;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.Post;\n\n/**\n * A value object for {@link Post}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@SuperBuilder\n@ToString\n@EqualsAndHashCode(callSuper = true)\npublic class PostVo extends ListedPostVo {\n\n private ContentVo content;\n\n /**\n * Convert {@link Post} to {@link PostVo}.\n *\n * @param post post extension\n * @return post value object\n */\n public static PostVo from(Post post) {\n Assert.notNull(post, \"The post must not be null.\");\n Post.PostSpec spec = post.getSpec();\n Post.PostStatus postStatus = post.getStatusOrDefault();\n return PostVo.builder()\n .metadata(post.getMetadata())\n .spec(spec)\n .status(postStatus)\n .categories(List.of())\n .tags(List.of())\n .contributors(List.of())\n .content(new ContentVo(null, null))\n .build();\n }\n\n /**\n * Convert {@link Post} to {@link PostVo}.\n */\n public static PostVo from(ListedPostVo postVo) {\n return builder()\n .metadata(postVo.getMetadata())\n .spec(postVo.getSpec())\n .status(postVo.getStatus())\n .categories(postVo.getCategories())\n .tags(postVo.getTags())\n .contributors(postVo.getContributors())\n .owner(postVo.getOwner())\n .stats(postVo.getStats())\n .content(new ContentVo(\"\", \"\"))\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/ReplyVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;\n\nimport io.swagger.v3.oas.annotations.media.Schema;\nimport lombok.Builder;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport run.halo.app.content.comment.OwnerInfo;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Reply}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\n@ToString\n@EqualsAndHashCode\npublic class ReplyVo implements ExtensionVoOperator {\n\n @Schema(requiredMode = REQUIRED)\n private MetadataOperator metadata;\n\n @Schema(requiredMode = REQUIRED)\n private Reply.ReplySpec spec;\n\n @Schema(requiredMode = REQUIRED)\n private OwnerInfo owner;\n\n @Schema(requiredMode = REQUIRED)\n private CommentStatsVo stats;\n\n /**\n * Convert {@link Reply} to {@link ReplyVo}.\n *\n * @param reply reply extension\n * @return a value object for {@link Reply}\n */\n public static ReplyVo from(Reply reply) {\n Reply.ReplySpec spec = reply.getSpec();\n return ReplyVo.builder()\n .metadata(reply.getMetadata())\n .spec(spec)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/SinglePageVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.List;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\nimport lombok.experimental.SuperBuilder;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.SinglePage;\n\n/**\n * A value object for {@link SinglePage}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@SuperBuilder\n@ToString\n@EqualsAndHashCode(callSuper = true)\npublic class SinglePageVo extends ListedSinglePageVo {\n\n private ContentVo content;\n\n /**\n * Convert {@link SinglePage} to {@link SinglePageVo}.\n *\n * @param singlePage single page extension\n * @return special page value object\n */\n public static SinglePageVo from(SinglePage singlePage) {\n Assert.notNull(singlePage, \"The singlePage must not be null.\");\n SinglePage.SinglePageSpec spec = singlePage.getSpec();\n SinglePage.SinglePageStatus pageStatus = singlePage.getStatus();\n return SinglePageVo.builder()\n .metadata(singlePage.getMetadata())\n .spec(spec)\n .status(pageStatus)\n .contributors(List.of())\n .content(new ContentVo(null, null))\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/SiteSettingVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.net.URL;\nimport java.util.Locale;\nimport java.util.Map;\nimport lombok.Builder;\nimport lombok.With;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.util.Assert;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemSetting.ThemeRouteRules;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Site setting value object for theme.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Builder\npublic record SiteSettingVo(\n\n String title,\n\n @With URL url,\n\n @With String version,\n\n String subtitle,\n\n String logo,\n\n String favicon,\n\n String language,\n\n Boolean allowRegistration,\n\n PostSetting post,\n\n SeoSetting seo,\n\n Routes routes,\n\n CommentSetting comment\n\n) {\n\n /**\n * Convert to system {@link ConfigMap} to {@link SiteSettingVo}.\n *\n * @param data config map data\n * @return site setting value object\n */\n public static SiteSettingVo from(Map data) {\n Assert.notNull(data, \"Config data must not be null\");\n SystemSetting.Basic basicSetting =\n toObject(data.get(SystemSetting.Basic.GROUP), SystemSetting.Basic.class);\n\n SystemSetting.User userSetting =\n toObject(data.get(SystemSetting.User.GROUP), SystemSetting.User.class);\n\n SystemSetting.Post postSetting =\n toObject(data.get(SystemSetting.Post.GROUP), SystemSetting.Post.class);\n\n SystemSetting.Seo seoSetting =\n toObject(data.get(SystemSetting.Seo.GROUP), SystemSetting.Seo.class);\n\n var routeRules = toObject(data.get(ThemeRouteRules.GROUP), ThemeRouteRules.class);\n\n SystemSetting.Comment commentSetting = toObject(data.get(SystemSetting.Comment.GROUP),\n SystemSetting.Comment.class);\n return builder()\n .title(basicSetting.getTitle())\n .subtitle(basicSetting.getSubtitle())\n .logo(basicSetting.getLogo())\n .favicon(basicSetting.getFavicon())\n .allowRegistration(userSetting.isAllowRegistration())\n .language(basicSetting.useSystemLocale().orElse(Locale.getDefault()).toLanguageTag())\n .post(PostSetting.builder()\n .postPageSize(postSetting.getPostPageSize())\n .archivePageSize(postSetting.getArchivePageSize())\n .categoryPageSize(postSetting.getCategoryPageSize())\n .tagPageSize(postSetting.getTagPageSize())\n .authorPageSize(postSetting.getAuthorPageSize())\n .build())\n .seo(SeoSetting.builder()\n .blockSpiders(seoSetting.getBlockSpiders())\n .keywords(seoSetting.getKeywords())\n .description(seoSetting.getDescription())\n .build())\n .comment(CommentSetting.builder()\n .enable(commentSetting.getEnable())\n .requireReviewForNew(commentSetting.getRequireReviewForNew())\n .systemUserOnly(commentSetting.getSystemUserOnly())\n .build())\n .routes(Routes.builder()\n .categoriesUri(StringUtils.prependIfMissing(routeRules.getCategories(), \"/\"))\n .tagsUri(StringUtils.prependIfMissing(routeRules.getTags(), \"/\"))\n .archivesUri(StringUtils.prependIfMissing(routeRules.getArchives(), \"/\"))\n .build()\n )\n .build();\n }\n\n private static T toObject(String json, Class type) {\n if (json == null) {\n // empty object\n json = \"{}\";\n }\n return JsonUtils.jsonToObject(json, type);\n }\n\n @Builder\n public record PostSetting(\n Integer postPageSize,\n Integer archivePageSize,\n Integer categoryPageSize,\n Integer tagPageSize,\n Integer authorPageSize\n ) {\n }\n\n @Builder\n public record SeoSetting(\n Boolean blockSpiders,\n String keywords,\n String description\n ) {\n }\n\n @Builder\n public record CommentSetting(\n Boolean enable,\n Boolean systemUserOnly,\n Boolean requireReviewForNew\n ) {\n }\n\n @Builder\n public record Routes(\n String categoriesUri,\n String tagsUri,\n String archivesUri\n ) {\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/SiteStatsVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.Data;\n\n/**\n * A value object for site stats.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Data\n@Builder\npublic class SiteStatsVo {\n\n private Integer visit;\n\n private Integer upvote;\n\n private Integer comment;\n\n private Integer post;\n\n private Integer category;\n\n public static SiteStatsVo empty() {\n return SiteStatsVo.builder()\n .visit(0)\n .upvote(0)\n .comment(0)\n .post(0)\n .category(0)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/StatsVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.Value;\n\n/**\n * Stats value object.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@Builder\npublic class StatsVo {\n\n Integer visit;\n\n Integer upvote;\n\n Integer comment;\n\n public static StatsVo empty() {\n return StatsVo.builder()\n .visit(0)\n .upvote(0)\n .comment(0)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/TagVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport lombok.Builder;\nimport lombok.Value;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Tag}.\n */\n@Value\n@Builder\npublic class TagVo implements ExtensionVoOperator {\n\n MetadataOperator metadata;\n\n Tag.TagSpec spec;\n\n Tag.TagStatus status;\n\n Integer postCount;\n\n /**\n * Convert {@link Tag} to {@link TagVo}.\n *\n * @param tag tag extension\n * @return tag value object\n */\n public static TagVo from(Tag tag) {\n Tag.TagSpec spec = tag.getSpec();\n Tag.TagStatus status = tag.getStatusOrDefault();\n return TagVo.builder()\n .metadata(tag.getMetadata())\n .spec(spec)\n .status(status)\n .postCount(defaultIfNull(status.getVisiblePostCount(), 0))\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/ThemeVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport lombok.Builder;\nimport lombok.ToString;\nimport lombok.Value;\nimport lombok.With;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.MetadataOperator;\n\n/**\n * A value object for {@link Theme}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Value\n@Builder\n@ToString\npublic class ThemeVo implements ExtensionVoOperator {\n\n MetadataOperator metadata;\n\n Theme.ThemeSpec spec;\n\n @With\n JsonNode config;\n\n /**\n * Convert {@link Theme} to {@link ThemeVo}.\n *\n * @param theme theme extension\n * @return theme value object\n */\n public static ThemeVo from(Theme theme) {\n return ThemeVo.builder()\n .metadata(theme.getMetadata())\n .spec(theme.getSpec())\n .config(null)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/UserVo.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport lombok.Builder;\nimport lombok.Value;\nimport org.apache.commons.lang3.ObjectUtils;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@Value\n@Builder\npublic class UserVo implements ExtensionVoOperator {\n MetadataOperator metadata;\n\n User.UserSpec spec;\n\n User.UserStatus status;\n\n /**\n * Converts to {@link UserVo} from {@link User}.\n *\n * @param user user extension\n * @return user value object.\n */\n public static UserVo from(User user) {\n User.UserStatus statusCopy =\n JsonUtils.deepCopy(ObjectUtils.defaultIfNull(user.getStatus(), new User.UserStatus()));\n\n User.UserSpec userSpecCopy = JsonUtils.deepCopy(user.getSpec());\n userSpecCopy.setPassword(\"[PROTECTED]\");\n return UserVo.builder()\n .metadata(user.getMetadata())\n .spec(userSpecCopy)\n .status(statusCopy)\n .build();\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/finders/vo/VisualizableTreeNode.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport java.util.Iterator;\nimport java.util.List;\n\n/**\n * Show Tree Hierarchy.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic interface VisualizableTreeNode> {\n\n /**\n * Visualize tree node.\n */\n default void print(StringBuilder buffer, String prefix, String childrenPrefix) {\n buffer.append(prefix);\n buffer.append(nodeText());\n buffer.append('\\n');\n if (getChildren() == null) {\n return;\n }\n for (Iterator it = getChildren().iterator(); it.hasNext(); ) {\n T next = it.next();\n if (it.hasNext()) {\n next.print(buffer, childrenPrefix + \"├── \", childrenPrefix + \"│ \");\n } else {\n next.print(buffer, childrenPrefix + \"└── \", childrenPrefix + \" \");\n }\n }\n }\n\n String nodeText();\n\n List getChildren();\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/message/ThemeMessageResolutionUtils.java", "content": "package run.halo.app.theme.message;\n\nimport java.io.BufferedInputStream;\nimport java.io.BufferedReader;\nimport java.io.File;\nimport java.io.FileInputStream;\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.io.InputStreamReader;\nimport java.io.Reader;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Properties;\nimport org.springframework.lang.Nullable;\nimport org.thymeleaf.exceptions.TemplateInputException;\nimport org.thymeleaf.exceptions.TemplateProcessingException;\nimport org.thymeleaf.util.StringUtils;\nimport run.halo.app.theme.ThemeContext;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class ThemeMessageResolutionUtils {\n\n private static final Map EMPTY_MESSAGES = Collections.emptyMap();\n private static final String PROPERTIES_FILE_EXTENSION = \".properties\";\n private static final String LOCATION = \"i18n\";\n\n @Nullable\n private static Reader messageReader(String messageResourceName, ThemeContext theme)\n throws FileNotFoundException {\n var themePath = theme.getPath();\n File messageFile = themePath.resolve(messageResourceName).toFile();\n if (!messageFile.exists()) {\n return null;\n }\n final InputStream inputStream = new FileInputStream(messageFile);\n return new BufferedReader(new InputStreamReader(new BufferedInputStream(inputStream)));\n }\n\n public static Map resolveMessagesForTemplate(final Locale locale,\n ThemeContext theme) {\n\n // Compute all the resource names we should use: *_gl_ES-gheada.properties, *_gl_ES\n // .properties, _gl.properties...\n // The order here is important: as we will let values from more specific files\n // overwrite those in less specific,\n // (e.g. a value for gl_ES will have more precedence than a value for gl). So we will\n // iterate these resource\n // names from less specific to more specific.\n final List\n messageResourceNames = computeMessageResourceNamesFromBase(locale);\n\n // Build the combined messages\n Map combinedMessages = null;\n for (final String messageResourceName : messageResourceNames) {\n try {\n final Reader messageResourceReader = messageReader(messageResourceName, theme);\n if (messageResourceReader != null) {\n\n final Properties messageProperties =\n readMessagesResource(messageResourceReader);\n if (messageProperties != null && !messageProperties.isEmpty()) {\n\n if (combinedMessages == null) {\n combinedMessages = new HashMap<>(20);\n }\n\n for (final Map.Entry propertyEntry :\n messageProperties.entrySet()) {\n combinedMessages.put((String) propertyEntry.getKey(),\n (String) propertyEntry.getValue());\n }\n\n }\n\n }\n\n } catch (final IOException ignored) {\n // File might not exist, simply try the next one\n }\n }\n\n if (combinedMessages == null) {\n return EMPTY_MESSAGES;\n }\n\n return Collections.unmodifiableMap(combinedMessages);\n }\n\n private static List computeMessageResourceNamesFromBase(final Locale locale) {\n\n final List resourceNames = new ArrayList<>(5);\n\n if (StringUtils.isEmptyOrWhitespace(locale.getLanguage())) {\n throw new TemplateProcessingException(\n \"Locale \\\"\" + locale + \"\\\" \"\n + \"cannot be used as it does not specify a language.\");\n }\n\n resourceNames.add(getResourceName(\"default\"));\n resourceNames.add(getResourceName(locale.getLanguage()));\n\n if (!StringUtils.isEmptyOrWhitespace(locale.getCountry())) {\n resourceNames.add(\n getResourceName(locale.getLanguage() + \"_\" + locale.getCountry()));\n }\n\n if (!StringUtils.isEmptyOrWhitespace(locale.getVariant())) {\n resourceNames.add(getResourceName(\n locale.getLanguage() + \"_\" + locale.getCountry() + \"-\" + locale.getVariant()));\n }\n\n return resourceNames;\n\n }\n\n private static String getResourceName(String name) {\n return LOCATION + \"/\" + name + PROPERTIES_FILE_EXTENSION;\n }\n\n\n private static Properties readMessagesResource(final Reader propertiesReader) {\n if (propertiesReader == null) {\n return null;\n }\n final Properties properties = new Properties();\n try (propertiesReader) {\n // Note Properties#load(Reader) this is JavaSE 6 specific, but Thymeleaf 3.0 does\n // not support Java 5 anymore...\n properties.load(propertiesReader);\n } catch (final Exception e) {\n throw new TemplateInputException(\"Exception loading messages file\", e);\n }\n // ignore errors closing\n return properties;\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/message/ThemeMessageResolver.java", "content": "package run.halo.app.theme.message;\n\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.thymeleaf.messageresolver.StandardMessageResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport run.halo.app.theme.ThemeContext;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class ThemeMessageResolver extends StandardMessageResolver {\n\n private final ThemeContext theme;\n\n public ThemeMessageResolver(ThemeContext theme) {\n this.theme = theme;\n }\n\n @Override\n protected Map resolveMessagesForTemplate(String template,\n ITemplateResource templateResource,\n Locale locale) {\n var properties = new HashMap();\n Optional.ofNullable(ThemeMessageResolutionUtils.resolveMessagesForTemplate(locale, theme))\n .ifPresent(properties::putAll);\n Optional.ofNullable(super.resolveMessagesForTemplate(template, templateResource, locale))\n .ifPresent(properties::putAll);\n return Collections.unmodifiableMap(properties);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/DefaultQueryPostPredicateResolver.java", "content": "package run.halo.app.theme.router;\n\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.extension.index.query.Queries.or;\n\nimport java.security.Principal;\nimport java.util.Objects;\nimport java.util.function.Predicate;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.extension.router.selector.LabelSelector;\nimport run.halo.app.infra.AnonymousUserConst;\n\n/**\n * The default implementation of {@link ReactiveQueryPostPredicateResolver}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@Component\npublic class DefaultQueryPostPredicateResolver implements ReactiveQueryPostPredicateResolver {\n\n @Override\n public Mono> getPredicate() {\n Predicate predicate = post -> post.isPublished()\n && !ExtensionUtil.isDeleted(post)\n && Objects.equals(false, post.getSpec().getDeleted());\n Predicate visiblePredicate =\n post -> Post.VisibleEnum.PUBLIC.equals(post.getSpec().getVisible());\n return currentUserName()\n .map(username -> predicate.and(\n visiblePredicate.or(post -> username.equals(post.getSpec().getOwner())))\n )\n .defaultIfEmpty(predicate.and(visiblePredicate));\n }\n\n @Override\n public Mono getListOptions() {\n var listOptions = new ListOptions();\n listOptions.setLabelSelector(LabelSelector.builder()\n .eq(Post.PUBLISHED_LABEL, \"true\").build());\n\n var fieldQuery = and(\n isNull(\"metadata.deletionTimestamp\"),\n equal(\"spec.deleted\", \"false\")\n );\n var visibleQuery = equal(\"spec.visible\", Post.VisibleEnum.PUBLIC.name());\n return currentUserName()\n .map(username -> and(fieldQuery,\n or(visibleQuery, equal(\"spec.owner\", username)))\n )\n .defaultIfEmpty(and(fieldQuery, visibleQuery))\n .map(query -> {\n listOptions.setFieldSelector(FieldSelector.of(query));\n return listOptions;\n });\n }\n\n Mono currentUserName() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName)\n .filter(name -> !AnonymousUserConst.isAnonymousUser(name));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/ExtensionPermalinkPatternUpdater.java", "content": "package run.halo.app.theme.router;\n\nimport static run.halo.app.theme.utils.PatternUtils.normalizePattern;\nimport static run.halo.app.theme.utils.PatternUtils.normalizePostPattern;\n\nimport java.util.Map;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.lang.NonNull;\nimport org.springframework.scheduling.annotation.Async;\nimport org.springframework.stereotype.Component;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.infra.SystemConfigChangedEvent;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemSetting.ThemeRouteRules;\n\n/**\n * {@link ExtensionPermalinkPatternUpdater} to update the value of key\n * {@link Constant#PERMALINK_PATTERN_ANNO} in {@link MetadataOperator#getAnnotations()}\n * of {@link Extension} when the pattern changed.\n *\n * @author guqing\n * @see Post\n * @see Category\n * @see Tag\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\nclass ExtensionPermalinkPatternUpdater implements ApplicationListener {\n\n private final ExtensionClient client;\n\n @Override\n @Async\n public void onApplicationEvent(@NonNull SystemConfigChangedEvent event) {\n var oldData = event.getOldData();\n var newData = event.getNewData();\n var oldRules = SystemSetting.get(oldData, ThemeRouteRules.GROUP, ThemeRouteRules.class);\n if (oldRules == null) {\n oldRules = ThemeRouteRules.empty();\n }\n var newRules = SystemSetting.get(newData, ThemeRouteRules.GROUP, ThemeRouteRules.class);\n if (newRules == null) {\n newRules = ThemeRouteRules.empty();\n }\n var archivesRuleChanged = !Objects.equals(oldRules.getArchives(), newRules.getArchives());\n var postRuleChanged = !Objects.equals(oldRules.getPost(), newRules.getPost());\n var categoriesRuleChanged =\n !Objects.equals(oldRules.getCategories(), newRules.getCategories());\n if (categoriesRuleChanged) {\n var categoriesPattern = normalizePattern(newRules.getCategories());\n updateCategoryPermalink(categoriesPattern);\n }\n var tagsRuleChanged = !Objects.equals(oldRules.getTags(), newRules.getTags());\n if (tagsRuleChanged) {\n var tagsPattern = normalizePattern(newRules.getTags());\n log.info(\"Update tag permalink pattern for tags change: {}\", tagsPattern);\n updateTagPermalink(tagsPattern);\n }\n if (archivesRuleChanged || categoriesRuleChanged || postRuleChanged) {\n var postPattern = normalizePostPattern(newRules);\n updatePostPermalink(postPattern);\n }\n }\n\n private void updatePostPermalink(String pattern) {\n log.debug(\"Update post permalink by new policy [{}]\", pattern);\n // TODO Optimize by batch update\n client.listAll(Post.class, new ListOptions(), Sort.unsorted())\n .forEach(post -> updateIfPermalinkPatternChanged(post, pattern));\n }\n\n private void updateIfPermalinkPatternChanged(AbstractExtension extension, String pattern) {\n Map annotations = MetadataUtil.nullSafeAnnotations(extension);\n String oldPattern = annotations.get(Constant.PERMALINK_PATTERN_ANNO);\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, pattern);\n\n if (StringUtils.equals(oldPattern, pattern) && StringUtils.isNotBlank(oldPattern)) {\n return;\n }\n // update permalink pattern annotation\n client.update(extension);\n }\n\n private void updateCategoryPermalink(String pattern) {\n log.debug(\"Update category and categories permalink by new policy [{}]\", pattern);\n client.listAll(Category.class, new ListOptions(), Sort.unsorted())\n .forEach(category -> updateIfPermalinkPatternChanged(category, pattern));\n }\n\n private void updateTagPermalink(String pattern) {\n log.debug(\"Update tag and tags permalink by new policy [{}]\", pattern);\n client.listAll(Tag.class, new ListOptions(), Sort.unsorted())\n .forEach(tag -> updateIfPermalinkPatternChanged(tag, pattern));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/ModelMapUtils.java", "content": "package run.halo.app.theme.router;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.dialect.CommentWidget;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * A util class for building model map.\n *\n * @author guqing\n * @since 2.6.0\n */\npublic abstract class ModelMapUtils {\n private static final Scheme POST_SCHEME = Scheme.buildFromType(Post.class);\n private static final Scheme SINGLE_PAGE_SCHEME = Scheme.buildFromType(SinglePage.class);\n\n /**\n * Build post view model.\n *\n * @param postVo post vo\n * @return model map\n */\n public static Map postModel(PostVo postVo) {\n Map model = new HashMap<>();\n model.put(\"name\", postVo.getMetadata().getName());\n model.put(ModelConst.TEMPLATE_ID, DefaultTemplateEnum.POST.getValue());\n model.put(\"groupVersionKind\", POST_SCHEME.groupVersionKind());\n model.put(\"plural\", POST_SCHEME.plural());\n model.put(\"post\", postVo);\n model.put(CommentWidget.ENABLE_COMMENT_ATTRIBUTE, postVo.getSpec().getAllowComment());\n return model;\n }\n\n /**\n * Build single page view model.\n *\n * @param pageVo page vo\n * @return model map\n */\n public static Map singlePageModel(SinglePageVo pageVo) {\n Map model = new HashMap<>();\n model.put(\"name\", pageVo.getMetadata().getName());\n model.put(\"groupVersionKind\", SINGLE_PAGE_SCHEME.groupVersionKind());\n model.put(\"plural\", SINGLE_PAGE_SCHEME.plural());\n model.put(ModelConst.TEMPLATE_ID, DefaultTemplateEnum.SINGLE_PAGE.getValue());\n model.put(\"singlePage\", pageVo);\n model.put(CommentWidget.ENABLE_COMMENT_ATTRIBUTE, pageVo.getSpec().getAllowComment());\n return model;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/PermalinkRuleChangedEvent.java", "content": "package run.halo.app.theme.router;\n\nimport org.springframework.context.ApplicationEvent;\nimport run.halo.app.theme.DefaultTemplateEnum;\n\npublic class PermalinkRuleChangedEvent extends ApplicationEvent {\n private final DefaultTemplateEnum template;\n private final String oldRule;\n private final String rule;\n\n public PermalinkRuleChangedEvent(Object source, DefaultTemplateEnum template,\n String oldRule, String rule) {\n super(source);\n this.template = template;\n this.oldRule = oldRule;\n this.rule = rule;\n }\n\n public DefaultTemplateEnum getTemplate() {\n return template;\n }\n\n public String getOldRule() {\n return oldRule;\n }\n\n public String getRule() {\n return rule;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/PreviewRouterFunction.java", "content": "package run.halo.app.theme.router;\n\nimport java.security.Principal;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport lombok.RequiredArgsConstructor;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.security.core.context.ReactiveSecurityContextHolder;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.dialect.HaloTrackerProcessor;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.SinglePageConversionService;\nimport run.halo.app.theme.finders.vo.ContributorVo;\nimport run.halo.app.theme.finders.vo.PostVo;\n\n/**\n *

Preview router for previewing posts and single pages.

\n *\n * @author guqing\n * @since 2.6.0\n */\n@Component\n@RequiredArgsConstructor\npublic class PreviewRouterFunction {\n static final String SNAPSHOT_NAME_PARAM = \"snapshotName\";\n\n private final ReactiveExtensionClient client;\n\n private final PostPublicQueryService postPublicQueryService;\n\n private final ViewNameResolver viewNameResolver;\n\n private final PostService postService;\n\n private final SinglePageConversionService singlePageConversionService;\n\n @Bean\n RouterFunction previewRouter() {\n return RouterFunctions.route()\n .GET(\"/preview/posts/{name}\", this::previewPost)\n .GET(\"/preview/singlepages/{name}\", this::previewSinglePage)\n .build();\n }\n\n private Mono previewPost(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return currentAuthenticatedUserName()\n .flatMap(principal -> client.fetch(Post.class, name))\n .flatMap(post -> {\n String snapshotName = request.queryParam(SNAPSHOT_NAME_PARAM)\n .orElse(post.getSpec().getHeadSnapshot());\n return convertToPostVo(post, snapshotName);\n })\n .flatMap(post -> canPreview(post.getContributors())\n .doOnNext(canPreview -> {\n if (!canPreview) {\n throw new NotFoundException(\"Post not found.\");\n }\n })\n .thenReturn(post)\n )\n // Check permissions before throwing this exception\n .switchIfEmpty(Mono.error(() -> new NotFoundException(\"Post not found.\")))\n .flatMap(postVo -> {\n String template = postVo.getSpec().getTemplate();\n Map model = ModelMapUtils.postModel(postVo);\n // Mark as preview mode for downstream view processing\n request.exchange().getAttributes()\n .put(HaloTrackerProcessor.SKIP_TRACKER, Boolean.TRUE);\n return viewNameResolver.resolveViewNameOrDefault(request, template,\n DefaultTemplateEnum.POST.getValue())\n .flatMap(templateName -> ServerResponse.ok().render(templateName, model));\n });\n }\n\n private Mono convertToPostVo(Post post, String snapshotName) {\n return postPublicQueryService.convertToVo(post, snapshotName)\n .doOnNext(postVo -> {\n // fake some attributes only for preview when they are not published\n Post.PostSpec spec = postVo.getSpec();\n if (spec.getPublishTime() == null) {\n spec.setPublishTime(Instant.now());\n }\n if (spec.getPublish() == null) {\n spec.setPublish(false);\n }\n Post.PostStatus status = postVo.getStatus();\n if (status == null) {\n status = new Post.PostStatus();\n postVo.setStatus(status);\n }\n if (status.getLastModifyTime() == null) {\n status.setLastModifyTime(Instant.now());\n }\n });\n }\n\n private Mono previewSinglePage(ServerRequest request) {\n final var name = request.pathVariable(\"name\");\n return currentAuthenticatedUserName()\n .flatMap(principal -> client.fetch(SinglePage.class, name))\n .flatMap(singlePage -> {\n String snapshotName = request.queryParam(SNAPSHOT_NAME_PARAM)\n .orElse(singlePage.getSpec().getHeadSnapshot());\n return singlePageConversionService.convertToVo(singlePage, snapshotName);\n })\n .doOnNext(pageVo -> {\n // fake some attributes only for preview when they are not published\n SinglePage.SinglePageSpec spec = pageVo.getSpec();\n if (spec.getPublishTime() == null) {\n spec.setPublishTime(Instant.now());\n }\n if (spec.getPublish() == null) {\n spec.setPublish(false);\n }\n SinglePage.SinglePageStatus status = pageVo.getStatus();\n if (status == null) {\n status = new SinglePage.SinglePageStatus();\n pageVo.setStatus(status);\n }\n if (status.getLastModifyTime() == null) {\n status.setLastModifyTime(Instant.now());\n }\n })\n .flatMap(singlePageVo -> canPreview(singlePageVo.getContributors())\n .doOnNext(canPreview -> {\n if (!canPreview) {\n throw new NotFoundException(\"Single page not found.\");\n }\n })\n .thenReturn(singlePageVo)\n )\n // Check permissions before throwing this exception\n .switchIfEmpty(Mono.error(() -> new NotFoundException(\"Single page not found.\")))\n .flatMap(singlePageVo -> {\n Map model = ModelMapUtils.singlePageModel(singlePageVo);\n // Mark as preview mode for downstream view processing\n request.exchange().getAttributes()\n .put(HaloTrackerProcessor.SKIP_TRACKER, Boolean.TRUE);\n String template = singlePageVo.getSpec().getTemplate();\n return viewNameResolver.resolveViewNameOrDefault(request, template,\n DefaultTemplateEnum.SINGLE_PAGE.getValue())\n .flatMap(viewName -> ServerResponse.ok().render(viewName, model));\n });\n }\n\n private Mono canPreview(List contributors) {\n Assert.notNull(contributors, \"The contributors must not be null\");\n Set contributorNames = contributors.stream()\n .map(ContributorVo::getName)\n .collect(Collectors.toSet());\n return currentAuthenticatedUserName()\n .map(contributorNames::contains)\n .defaultIfEmpty(false);\n }\n\n Mono currentAuthenticatedUserName() {\n return ReactiveSecurityContextHolder.getContext()\n .map(SecurityContext::getAuthentication)\n .map(Principal::getName)\n .filter(name -> !AnonymousUserConst.isAnonymousUser(name));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/ReactiveQueryPostPredicateResolver.java", "content": "package run.halo.app.theme.router;\n\nimport java.util.function.Predicate;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\n\n/**\n * The reactive query post predicate resolver.\n *\n * @author guqing\n * @since 2.9.0\n */\npublic interface ReactiveQueryPostPredicateResolver {\n\n Mono> getPredicate();\n\n Mono getListOptions();\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/SinglePageRoute.java", "content": "package run.halo.app.theme.router;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.methods;\n\nimport java.nio.charset.StandardCharsets;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.stream.Collectors;\nimport lombok.RequiredArgsConstructor;\nimport org.apache.commons.lang3.BooleanUtils;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.beans.factory.DisposableBean;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RequestPredicate;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport org.springframework.web.util.UriUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionOperator;\nimport run.halo.app.extension.controller.Controller;\nimport run.halo.app.extension.controller.ControllerBuilder;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.SinglePageFinder;\n\n/**\n * The {@link SinglePageRoute} for route request to specific template page.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@RequiredArgsConstructor\npublic class SinglePageRoute\n implements RouterFunction, Reconciler, DisposableBean {\n private Map> quickRouteMap =\n new ConcurrentHashMap<>();\n\n private final ExtensionClient client;\n\n private final SinglePageFinder singlePageFinder;\n\n private final ViewNameResolver viewNameResolver;\n\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n private final LocaleContextResolver localeContextResolver;\n\n @Override\n @NonNull\n public Mono> route(@NonNull ServerRequest request) {\n return Flux.fromIterable(routerFunctions())\n .concatMap(routerFunction -> routerFunction.route(request))\n .next();\n }\n\n /**\n * Set quickRouteMap. This method is only for testing.\n *\n * @param quickRouteMap fresh quickRouteMap.\n */\n void setQuickRouteMap(Map> quickRouteMap) {\n this.quickRouteMap = quickRouteMap;\n }\n\n @Override\n public void accept(@NonNull RouterFunctions.Visitor visitor) {\n routerFunctions().forEach(routerFunction -> routerFunction.accept(visitor));\n }\n\n private List> routerFunctions() {\n return quickRouteMap.keySet().stream()\n .map(nameSlugPair -> {\n var routePath = singlePageRoute(nameSlugPair.slug());\n return RouterFunctions.route(methods(HttpMethod.GET)\n .and(exactPath(routePath))\n .and(RequestPredicates.accept(MediaType.TEXT_HTML)),\n handlerFunction(nameSlugPair.name()));\n })\n .collect(Collectors.toList());\n }\n\n private RequestPredicate exactPath(String path) {\n return request -> {\n var encodedRoutePath = UriUtils.encodePath(path, StandardCharsets.UTF_8);\n var requestPath = request.requestPath().pathWithinApplication().value();\n return Objects.equals(requestPath, encodedRoutePath);\n };\n }\n\n @Override\n public Result reconcile(Request request) {\n client.fetch(SinglePage.class, request.name())\n .ifPresent(page -> {\n var nameSlugPair = NameSlugPair.from(page);\n if (ExtensionOperator.isDeleted(page)) {\n quickRouteMap.remove(nameSlugPair);\n return;\n }\n if (BooleanUtils.isTrue(page.getSpec().getDeleted())) {\n quickRouteMap.remove(nameSlugPair);\n } else {\n // put new one\n if (page.isPublished()) {\n quickRouteMap.put(nameSlugPair, handlerFunction(request.name()));\n } else {\n quickRouteMap.remove(nameSlugPair);\n }\n }\n });\n return new Result(false, null);\n }\n\n @Override\n public Controller setupWith(ControllerBuilder builder) {\n return builder\n .extension(new SinglePage())\n .build();\n }\n\n @Override\n public void destroy() throws Exception {\n quickRouteMap.clear();\n }\n\n record NameSlugPair(String name, String slug) {\n public static NameSlugPair from(SinglePage page) {\n return new NameSlugPair(page.getMetadata().getName(), page.getSpec().getSlug());\n }\n }\n\n String singlePageRoute(String slug) {\n return StringUtils.prependIfMissing(slug, \"/\");\n }\n\n HandlerFunction handlerFunction(String name) {\n return request -> singlePageFinder.getByName(name)\n .doOnNext(singlePageVo -> {\n titleVisibilityIdentifyCalculator.calculateTitle(\n singlePageVo.getSpec().getTitle(),\n singlePageVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale()\n );\n })\n .flatMap(singlePageVo -> {\n Map model = ModelMapUtils.singlePageModel(singlePageVo);\n String template = singlePageVo.getSpec().getTemplate();\n return viewNameResolver.resolveViewNameOrDefault(request, template,\n DefaultTemplateEnum.SINGLE_PAGE.getValue())\n .flatMap(viewName -> ServerResponse.ok().render(viewName, model));\n })\n .switchIfEmpty(\n Mono.error(new NotFoundException(\"Single page not found\"))\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/ThemeCompositeRouterFunction.java", "content": "package run.halo.app.theme.router;\n\nimport static run.halo.app.theme.utils.PatternUtils.normalizePattern;\nimport static run.halo.app.theme.utils.PatternUtils.normalizePostPattern;\n\nimport java.time.Duration;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Objects;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.context.ApplicationListener;\nimport org.springframework.context.SmartLifecycle;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigChangedEvent;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemSetting.ThemeRouteRules;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.router.factories.ArchiveRouteFactory;\nimport run.halo.app.theme.router.factories.AuthorPostsRouteFactory;\nimport run.halo.app.theme.router.factories.CategoriesRouteFactory;\nimport run.halo.app.theme.router.factories.CategoryPostRouteFactory;\nimport run.halo.app.theme.router.factories.IndexRouteFactory;\nimport run.halo.app.theme.router.factories.PostRouteFactory;\nimport run.halo.app.theme.router.factories.TagPostRouteFactory;\nimport run.halo.app.theme.router.factories.TagsRouteFactory;\n\n/**\n *

The combination router of theme templates is used to render theme templates, but does not\n * include page.html templates which is processed separately.

\n *\n * @author guqing\n * @see SinglePageRoute\n * @since 2.0.0\n */\n@Slf4j\n@Component\n@RequiredArgsConstructor\npublic class ThemeCompositeRouterFunction implements\n RouterFunction,\n SmartLifecycle,\n ApplicationListener {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final SystemConfigFetcher environmentFetcher;\n\n private final ArchiveRouteFactory archiveRouteFactory;\n private final PostRouteFactory postRouteFactory;\n private final CategoriesRouteFactory categoriesRouteFactory;\n private final CategoryPostRouteFactory categoryPostRouteFactory;\n private final TagPostRouteFactory tagPostRouteFactory;\n private final TagsRouteFactory tagsRouteFactory;\n private final AuthorPostsRouteFactory authorPostsRouteFactory;\n private final IndexRouteFactory indexRouteFactory;\n\n private List> cachedRouters = List.of();\n private volatile boolean running;\n\n @Override\n public void onApplicationEvent(SystemConfigChangedEvent event) {\n var oldData = event.getOldData();\n var newData = event.getNewData();\n var oldRules = SystemSetting.get(oldData, ThemeRouteRules.GROUP,\n ThemeRouteRules.class);\n if (oldRules == null) {\n oldRules = ThemeRouteRules.empty();\n }\n var newRules = SystemSetting.get(newData, ThemeRouteRules.GROUP,\n ThemeRouteRules.class);\n if (newRules == null) {\n newRules = ThemeRouteRules.empty();\n }\n boolean rulesChanged = !Objects.equals(oldRules, newRules);\n if (rulesChanged) {\n log.info(\"Theme route rules changed, updating router functions...\");\n if (log.isDebugEnabled()) {\n log.debug(\"Old theme route rules: {}\", oldRules);\n log.debug(\"New theme route rules: {}\", newRules);\n }\n this.cachedRouters = routerFunctions(newRules);\n log.info(\"Theme route rules updated.\");\n }\n }\n\n @Override\n @NonNull\n public Mono> route(@NonNull ServerRequest request) {\n return Flux.fromIterable(cachedRouters)\n .concatMap(routerFunction -> routerFunction.route(request))\n .next();\n }\n\n @Override\n public void accept(@NonNull RouterFunctions.Visitor visitor) {\n cachedRouters.forEach(routerFunction -> routerFunction.accept(visitor));\n }\n\n private List> routerFunctions(ThemeRouteRules rules) {\n return transformedPatterns(rules).stream()\n .map(this::createRouterFunction)\n .toList();\n }\n\n private List> routerFunctions() {\n return transformedPatterns().stream()\n .map(this::createRouterFunction)\n .toList();\n }\n\n private RouterFunction createRouterFunction(RoutePattern routePattern) {\n return switch (routePattern.identifier()) {\n case POST -> postRouteFactory.create(routePattern.pattern());\n case ARCHIVES -> archiveRouteFactory.create(routePattern.pattern());\n case CATEGORIES -> categoriesRouteFactory.create(routePattern.pattern());\n case CATEGORY -> categoryPostRouteFactory.create(routePattern.pattern());\n case TAGS -> tagsRouteFactory.create(routePattern.pattern());\n case TAG -> tagPostRouteFactory.create(routePattern.pattern());\n case AUTHOR -> authorPostsRouteFactory.create(routePattern.pattern());\n case INDEX -> indexRouteFactory.create(routePattern.pattern());\n default ->\n throw new IllegalStateException(\"Unexpected value: \" + routePattern.identifier());\n };\n }\n\n @Override\n public void start() {\n if (running) {\n return;\n }\n running = true;\n this.cachedRouters = routerFunctions();\n }\n\n @Override\n public void stop() {\n if (!running) {\n return;\n }\n running = false;\n this.cachedRouters = List.of();\n }\n\n @Override\n public boolean isRunning() {\n return running;\n }\n\n record RoutePattern(DefaultTemplateEnum identifier, String pattern) {\n }\n\n private List transformedPatterns(ThemeRouteRules rules) {\n List routePatterns = new ArrayList<>();\n var archives = normalizePattern(rules.getArchives());\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.ARCHIVES, archives));\n\n var categories = normalizePattern(rules.getCategories());\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.CATEGORIES, categories));\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.CATEGORY, categories));\n\n var tags = normalizePattern(rules.getTags());\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.TAGS, tags));\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.TAG, tags));\n\n var post = normalizePostPattern(rules);\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.POST, post));\n\n // Add the index route to the end to prevent conflict with the queryParam rule of the post\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.AUTHOR, \"\"));\n routePatterns.add(new RoutePattern(DefaultTemplateEnum.INDEX, \"/\"));\n return routePatterns;\n\n }\n\n private List transformedPatterns() {\n var rules = environmentFetcher.fetch(ThemeRouteRules.GROUP, ThemeRouteRules.class)\n .blockOptional(BLOCKING_TIMEOUT)\n .orElseGet(ThemeRouteRules::empty);\n return transformedPatterns(rules);\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/TitleVisibilityIdentifyCalculator.java", "content": "package run.halo.app.theme.router;\n\nimport java.util.Locale;\nimport lombok.AllArgsConstructor;\nimport org.springframework.context.MessageSource;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.Assert;\nimport run.halo.app.core.extension.content.Post;\n\n@Component\n@AllArgsConstructor\npublic class TitleVisibilityIdentifyCalculator {\n\n private final MessageSource messageSource;\n\n /**\n * Calculate title with visibility identification.\n *\n * @param title title must not be null\n * @param visibleEnum visibility enum\n */\n public String calculateTitle(String title, Post.VisibleEnum visibleEnum, Locale locale) {\n Assert.notNull(title, \"Title must not be null\");\n if (Post.VisibleEnum.PRIVATE.equals(visibleEnum)) {\n String identify = messageSource.getMessage(\n \"title.visibility.identification.private\",\n null,\n \"\",\n locale);\n return title + identify;\n }\n return title;\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/ArchiveRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static run.halo.app.theme.router.PageUrlUtils.totalPage;\n\nimport java.util.List;\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RequestPredicate;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.vo.PostArchiveVo;\nimport run.halo.app.theme.router.ModelConst;\nimport run.halo.app.theme.router.PageUrlUtils;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\nimport run.halo.app.theme.router.UrlContextListResult;\n\n/**\n * The {@link ArchiveRouteFactory} for generate {@link RouterFunction} specific to the template\n * posts.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class ArchiveRouteFactory implements RouteFactory {\n\n private final PostFinder postFinder;\n\n private final SystemConfigFetcher environmentFetcher;\n\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n private final LocaleContextResolver localeContextResolver;\n\n @Override\n public RouterFunction create(String prefix) {\n RequestPredicate requestPredicate = patterns(prefix).stream()\n .map(RequestPredicates::GET)\n .reduce(req -> false, RequestPredicate::or)\n .and(accept(MediaType.TEXT_HTML));\n return RouterFunctions.route(requestPredicate, handlerFunction());\n }\n\n HandlerFunction handlerFunction() {\n return request -> {\n String templateName = DefaultTemplateEnum.ARCHIVES.getValue();\n return ServerResponse.ok()\n .render(templateName,\n Map.of(\"archives\", archivePosts(request),\n ModelConst.TEMPLATE_ID, templateName)\n );\n };\n }\n\n private List patterns(String prefix) {\n return List.of(\n StringUtils.prependIfMissing(prefix, \"/\"),\n PathUtils.combinePath(prefix, \"/page/{page:\\\\d+}\"),\n PathUtils.combinePath(prefix, \"/{year:\\\\d{4}}\"),\n PathUtils.combinePath(prefix, \"/{year:\\\\d{4}}/page/{page:\\\\d+}\"),\n PathUtils.combinePath(prefix, \"/{year:\\\\d{4}}/{month:\\\\d{2}}\"),\n PathUtils.combinePath(prefix,\n \"/{year:\\\\d{4}}/{month:\\\\d{2}}/page/{page:\\\\d+}\")\n );\n }\n\n private Mono> archivePosts(ServerRequest request) {\n ArchivePathVariables variables = ArchivePathVariables.from(request);\n int pageNum = pageNumInPathVariable(request);\n String requestPath = request.path();\n return configuredPageSize(environmentFetcher, SystemSetting.Post::getArchivePageSize)\n .flatMap(pageSize -> postFinder.archives(pageNum, pageSize, variables.getYear(),\n variables.getMonth()))\n .doOnNext(list -> list.get()\n .map(PostArchiveVo::getMonths)\n .flatMap(List::stream)\n .flatMap(month -> month.getPosts().stream())\n .forEach(postVo -> postVo.getSpec()\n .setTitle(titleVisibilityIdentifyCalculator.calculateTitle(\n postVo.getSpec().getTitle(),\n postVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale())\n )\n )\n )\n .map(list -> new UrlContextListResult.Builder()\n .listResult(list)\n .nextUrl(PageUrlUtils.nextPageUrl(requestPath, totalPage(list)))\n .prevUrl(PageUrlUtils.prevPageUrl(requestPath))\n .build());\n }\n\n @Data\n static class ArchivePathVariables {\n String year;\n String month;\n String page;\n\n static ArchivePathVariables from(ServerRequest request) {\n Map variables = request.pathVariables();\n return JsonUtils.mapToObject(variables, ArchivePathVariables.class);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/AuthorPostsRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static run.halo.app.theme.router.PageUrlUtils.totalPage;\n\nimport java.util.Map;\nimport java.util.Set;\nimport lombok.AllArgsConstructor;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.security.authorization.AuthorityUtils;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.UserVo;\nimport run.halo.app.theme.router.ModelConst;\nimport run.halo.app.theme.router.PageUrlUtils;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\nimport run.halo.app.theme.router.UrlContextListResult;\n\n/**\n * The {@link AuthorPostsRouteFactory} for generate {@link RouterFunction} specific to the template\n * index.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class AuthorPostsRouteFactory implements RouteFactory {\n\n private final PostFinder postFinder;\n private final ReactiveExtensionClient client;\n private final RoleService roleService;\n private SystemConfigFetcher environmentFetcher;\n\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n private final LocaleContextResolver localeContextResolver;\n\n @Override\n public RouterFunction create(String pattern) {\n return RouterFunctions\n .route(GET(\"/authors/{name}\").or(GET(\"/authors/{name}/page/{page:\\\\d+}\"))\n .and(accept(MediaType.TEXT_HTML)), handlerFunction());\n }\n\n HandlerFunction handlerFunction() {\n return request -> {\n String name = request.pathVariable(\"name\");\n return hasPostManageRole(name)\n .flatMap(hasPostManageRole -> {\n if (hasPostManageRole) {\n return ServerResponse.ok()\n .render(DefaultTemplateEnum.AUTHOR.getValue(),\n Map.of(\"author\", getByName(name),\n \"posts\", postList(request, name),\n ModelConst.TEMPLATE_ID, DefaultTemplateEnum.AUTHOR.getValue()\n )\n );\n }\n return Mono.error(new NotFoundException(\"Author page not found.\"));\n });\n };\n }\n\n protected Mono hasPostManageRole(String username) {\n return roleService.getRolesByUsername(username)\n .collectList()\n .flatMap(roles -> roleService.contains(roles,\n Set.of(AuthorityUtils.POST_CONTRIBUTOR_ROLE_NAME))\n )\n .defaultIfEmpty(false);\n }\n\n private Mono> postList(ServerRequest request, String name) {\n String path = request.path();\n int pageNum = pageNumInPathVariable(request);\n return configuredPageSize(environmentFetcher, SystemSetting.Post::getAuthorPageSize)\n .flatMap(pageSize -> postFinder.listByOwner(pageNum, pageSize, name))\n .doOnNext(list -> {\n list.getItems().forEach(listedPostVo -> {\n listedPostVo.getSpec().setTitle(\n titleVisibilityIdentifyCalculator.calculateTitle(\n listedPostVo.getSpec().getTitle(),\n listedPostVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale())\n );\n });\n })\n .map(list -> new UrlContextListResult.Builder()\n .listResult(list)\n .nextUrl(PageUrlUtils.nextPageUrl(path, totalPage(list)))\n .prevUrl(PageUrlUtils.prevPageUrl(path))\n .build());\n }\n\n private Mono getByName(String name) {\n return client.fetch(User.class, name)\n .switchIfEmpty(Mono.error(() -> new NotFoundException(\"Author page not found.\")))\n .map(UserVo::from);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/CategoriesRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\n\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.CategoryFinder;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * The {@link CategoriesRouteFactory} for generate {@link RouterFunction} specific to the\n * template\n * categories.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class CategoriesRouteFactory implements RouteFactory {\n\n private final CategoryFinder categoryFinder;\n\n @Override\n public RouterFunction create(String prefix) {\n return RouterFunctions.route(GET(StringUtils.prependIfMissing(prefix, \"/\")),\n handlerFunction());\n }\n\n HandlerFunction handlerFunction() {\n return request -> ServerResponse.ok()\n .render(DefaultTemplateEnum.CATEGORIES.getValue(),\n Map.of(\"categories\", categoryFinder.listAsTree(),\n ModelConst.TEMPLATE_ID, DefaultTemplateEnum.CATEGORIES.getValue()));\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/CategoryPostRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.theme.router.PageUrlUtils.totalPage;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.theme.Constant;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.vo.CategoryVo;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.router.ModelConst;\nimport run.halo.app.theme.router.PageUrlUtils;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\nimport run.halo.app.theme.router.UrlContextListResult;\n\n/**\n * The {@link CategoryPostRouteFactory} for generate {@link RouterFunction} specific to the template\n * category.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class CategoryPostRouteFactory implements RouteFactory {\n\n private final PostFinder postFinder;\n\n private final SystemConfigFetcher environmentFetcher;\n private final ReactiveExtensionClient client;\n private final ViewNameResolver viewNameResolver;\n\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n private final LocaleContextResolver localeContextResolver;\n\n @Override\n public RouterFunction create(String prefix) {\n return RouterFunctions.route(GET(PathUtils.combinePath(prefix, \"/{slug}\"))\n .or(GET(PathUtils.combinePath(prefix, \"/{slug}/page/{page:\\\\d+}\")))\n .and(accept(MediaType.TEXT_HTML)), handlerFunction());\n }\n\n HandlerFunction handlerFunction() {\n return request -> {\n String slug = request.pathVariable(\"slug\");\n return fetchBySlug(slug)\n .flatMap(categoryVo -> {\n Map model = new HashMap<>();\n model.put(ModelConst.TEMPLATE_ID, DefaultTemplateEnum.CATEGORY.getValue());\n model.put(\"posts\",\n postListByCategoryName(categoryVo.getMetadata().getName(), request));\n model.put(\"category\", categoryVo);\n model.put(\n Constant.META_DESCRIPTION_VARIABLE_NAME,\n categoryVo.getSpec().getDescription()\n );\n String template = categoryVo.getSpec().getTemplate();\n return viewNameResolver.resolveViewNameOrDefault(request, template,\n DefaultTemplateEnum.CATEGORY.getValue())\n .flatMap(viewName -> ServerResponse.ok().render(viewName, model));\n })\n .switchIfEmpty(\n Mono.error(new NotFoundException(\"Category not found with slug: \" + slug)));\n };\n }\n\n Mono fetchBySlug(String slug) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n and(\n equal(\"spec.slug\", slug),\n isNull(\"metadata.deletionTimestamp\")\n )\n ));\n return client.listBy(Category.class, listOptions, PageRequestImpl.ofSize(1))\n .mapNotNull(result -> ListResult.first(result)\n .map(CategoryVo::from)\n .orElse(null)\n );\n }\n\n private Mono> postListByCategoryName(String name,\n ServerRequest request) {\n String path = request.path();\n int pageNum = pageNumInPathVariable(request);\n return configuredPageSize(environmentFetcher, SystemSetting.Post::getCategoryPageSize)\n .flatMap(pageSize -> postFinder.listByCategory(pageNum, pageSize, name))\n .doOnNext(list -> list.forEach(postVo -> postVo.getSpec().setTitle(\n titleVisibilityIdentifyCalculator.calculateTitle(\n postVo.getSpec().getTitle(),\n postVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale()\n )\n )\n ))\n .map(list -> new UrlContextListResult.Builder()\n .listResult(list)\n .nextUrl(PageUrlUtils.nextPageUrl(path, totalPage(list)))\n .prevUrl(PageUrlUtils.prevPageUrl(path))\n .build()\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/IndexRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static run.halo.app.theme.router.PageUrlUtils.totalPage;\n\nimport java.time.Duration;\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport org.thymeleaf.context.LazyContextVariable;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.ReactiveUtils;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.router.ModelConst;\nimport run.halo.app.theme.router.PageUrlUtils;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\nimport run.halo.app.theme.router.UrlContextListResult;\n\n/**\n * The {@link IndexRouteFactory} for generate {@link RouterFunction} specific to the template\n * index.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class IndexRouteFactory implements RouteFactory {\n\n private static final Duration BLOCKING_TIMEOUT = ReactiveUtils.DEFAULT_TIMEOUT;\n\n private final PostFinder postFinder;\n private final SystemConfigFetcher environmentFetcher;\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n private final LocaleContextResolver localeContextResolver;\n\n @Override\n public RouterFunction create(String pattern) {\n return RouterFunctions\n .route(GET(\"/\").or(GET(\"/page/{page:\\\\d+}\")\n .or(GET(\"/index\")).or(GET(\"/index/page/{page:\\\\d+}\"))\n .and(accept(MediaType.TEXT_HTML))), handlerFunction());\n }\n\n HandlerFunction handlerFunction() {\n return request -> Mono.deferContextual(contextView -> {\n var posts = new LazyContextVariable>() {\n @Override\n protected UrlContextListResult loadValue() {\n return postList(request).contextWrite(contextView).block(BLOCKING_TIMEOUT);\n }\n };\n return ServerResponse.ok().render(DefaultTemplateEnum.INDEX.getValue(), Map.of(\n \"posts\", posts,\n ModelConst.TEMPLATE_ID, DefaultTemplateEnum.INDEX.getValue()\n ));\n });\n }\n\n private Mono> postList(ServerRequest request) {\n String path = request.path();\n\n return configuredPageSize(environmentFetcher, SystemSetting.Post::getPostPageSize)\n .flatMap(pageSize -> postFinder.list(pageNumInPathVariable(request), pageSize))\n .doOnNext(list -> list.getItems()\n .forEach(listedPostVo -> listedPostVo.getSpec()\n .setTitle(titleVisibilityIdentifyCalculator.calculateTitle(\n listedPostVo.getSpec().getTitle(),\n listedPostVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale())\n )\n )\n )\n .map(list -> new UrlContextListResult.Builder()\n .listResult(list)\n .nextUrl(PageUrlUtils.nextPageUrl(path, totalPage(list)))\n .prevUrl(PageUrlUtils.prevPageUrl(path))\n .build()\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/PostRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\nimport static org.apache.commons.lang3.StringUtils.isNotBlank;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static run.halo.app.content.permalinks.PostPermalinkPolicy.DEFAULT_CATEGORY;\n\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.regex.Pattern;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport lombok.Getter;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.stereotype.Component;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RequestPredicate;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.index.query.Queries;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.router.ModelMapUtils;\nimport run.halo.app.theme.router.ReactiveQueryPostPredicateResolver;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\n\n/**\n * The {@link PostRouteFactory} for generate {@link RouterFunction} specific to the template\n * post.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class PostRouteFactory implements RouteFactory {\n\n private final PostFinder postFinder;\n\n private final ViewNameResolver viewNameResolver;\n\n private final ReactiveExtensionClient client;\n\n private final ReactiveQueryPostPredicateResolver queryPostPredicateResolver;\n\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n private final LocaleContextResolver localeContextResolver;\n private final PostService postService;\n\n @Override\n public RouterFunction create(String pattern) {\n var postParamPredicate = new PatternParser(pattern);\n if (postParamPredicate.isQueryParamPattern()) {\n RequestPredicate requestPredicate = postParamPredicate.toRequestPredicate();\n return RouterFunctions.route(GET(\"/\")\n .and(requestPredicate), queryParamHandlerFunction(postParamPredicate));\n }\n return RouterFunctions\n .route(GET(pattern).and(accept(MediaType.TEXT_HTML)), handlerFunction());\n }\n\n HandlerFunction queryParamHandlerFunction(PatternParser paramPredicate) {\n return request -> {\n Map variables = mergedVariables(request);\n PostPatternVariable patternVariable = new PostPatternVariable();\n Optional.ofNullable(variables.get(paramPredicate.getParamName()))\n .ifPresent(value -> {\n switch (paramPredicate.getPlaceholderName()) {\n case \"name\" -> patternVariable.setName(value);\n case \"slug\" -> patternVariable.setSlug(value);\n default ->\n throw new IllegalArgumentException(\"Unsupported query param predicate\");\n }\n });\n return postResponse(request, patternVariable);\n };\n }\n\n HandlerFunction handlerFunction() {\n return request -> {\n PostPatternVariable patternVariable = PostPatternVariable.from(request);\n return postResponse(request, patternVariable)\n .switchIfEmpty(Mono.error(() -> new NotFoundException(\"Post not found.\")));\n };\n }\n\n @NonNull\n private Mono postResponse(ServerRequest request,\n PostPatternVariable patternVariable) {\n Mono postVoMono = bestMatchPost(patternVariable);\n return postVoMono\n .doOnNext(postVo -> {\n postVo.getSpec().setTitle(\n titleVisibilityIdentifyCalculator.calculateTitle(\n postVo.getSpec().getTitle(),\n postVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale())\n );\n })\n .flatMap(postVo -> {\n Map model = ModelMapUtils.postModel(postVo);\n return determineTemplate(request, postVo)\n .flatMap(templateName -> ServerResponse.ok().render(templateName, model));\n });\n }\n\n Mono determineTemplate(ServerRequest request, PostVo postVo) {\n return Flux.fromIterable(defaultIfNull(postVo.getCategories(), List.of()))\n .filter(category -> isNotBlank(category.getSpec().getPostTemplate()))\n .concatMap(category -> viewNameResolver.resolveViewNameOrDefault(request,\n category.getSpec().getPostTemplate(), null)\n )\n .next()\n .switchIfEmpty(Mono.defer(() -> viewNameResolver.resolveViewNameOrDefault(request,\n postVo.getSpec().getTemplate(),\n DefaultTemplateEnum.POST.getValue())\n ));\n }\n\n Mono bestMatchPost(PostPatternVariable variable) {\n return postsByPredicates(variable)\n .filter(post -> {\n Map labels = MetadataUtil.nullSafeLabels(post);\n return matchIfPresent(variable.getName(), post.getMetadata().getName())\n && matchIfPresent(variable.getSlug(), post.getSpec().getSlug())\n && matchIfPresent(variable.getYear(), labels.get(Post.ARCHIVE_YEAR_LABEL))\n && matchIfPresent(variable.getMonth(), labels.get(Post.ARCHIVE_MONTH_LABEL))\n && matchIfPresent(variable.getDay(), labels.get(Post.ARCHIVE_DAY_LABEL));\n })\n .filterWhen(post -> {\n if (isNotBlank(variable.getCategorySlug())) {\n var categoryNames = post.getSpec().getCategories();\n return postService.listCategories(categoryNames)\n .next()\n .filter(category -> category.getSpec().getSlug()\n .equals(variable.getCategorySlug())\n )\n .map(category -> category.getSpec().getSlug())\n .switchIfEmpty(Mono.defer(() -> {\n if (DEFAULT_CATEGORY.equals(variable.getCategorySlug())) {\n return Mono.just(DEFAULT_CATEGORY);\n }\n return Mono.empty();\n }))\n .hasElement();\n }\n return Mono.just(true);\n })\n .next()\n .flatMap(post -> postFinder.getByName(post.getMetadata().getName()));\n }\n\n Flux postsByPredicates(PostPatternVariable patternVariable) {\n if (isNotBlank(patternVariable.getName())) {\n return fetchPostsByName(patternVariable.getName());\n }\n if (isNotBlank(patternVariable.getSlug())) {\n return fetchPostsBySlug(patternVariable.getSlug());\n }\n return Flux.empty();\n }\n\n private Flux fetchPostsByName(String name) {\n return queryPostPredicateResolver.getPredicate()\n .flatMap(predicate -> client.fetch(Post.class, name)\n .filter(predicate)\n )\n .flux();\n }\n\n private Flux fetchPostsBySlug(String slug) {\n return queryPostPredicateResolver.getListOptions()\n .flatMapMany(listOptions -> {\n if (isNotBlank(slug)) {\n var other = Queries.equal(\"spec.slug\", slug);\n listOptions.setFieldSelector(listOptions.getFieldSelector().andQuery(other));\n }\n return client.listAll(Post.class, listOptions, Sort.unsorted());\n });\n }\n\n private boolean matchIfPresent(String variable, String target) {\n return StringUtils.isBlank(variable) || StringUtils.equals(target, variable);\n }\n\n @Data\n static class PostPatternVariable {\n String name;\n String slug;\n String year;\n String month;\n String day;\n String categorySlug;\n\n static PostPatternVariable from(ServerRequest request) {\n Map variables = mergedVariables(request);\n return JsonUtils.mapToObject(variables, PostPatternVariable.class);\n }\n }\n\n static Map mergedVariables(ServerRequest request) {\n Map pathVariables = request.pathVariables();\n MultiValueMap queryParams = request.queryParams();\n Map mergedVariables = new LinkedHashMap<>();\n for (String paramKey : queryParams.keySet()) {\n mergedVariables.put(paramKey, queryParams.getFirst(paramKey));\n }\n // path variables higher priority will override query params\n mergedVariables.putAll(pathVariables);\n return mergedVariables;\n }\n\n @Getter\n static class PatternParser {\n private static final Pattern PATTERN_COMPILE = Pattern.compile(\"([^&?]*)=\\\\{(.*?)\\\\}(&|$)\");\n\n private final String pattern;\n private String paramName;\n private String placeholderName;\n private final boolean isQueryParamPattern;\n\n PatternParser(String pattern) {\n this.pattern = pattern;\n var matcher = PATTERN_COMPILE.matcher(pattern);\n if (matcher.find()) {\n this.paramName = matcher.group(1);\n this.placeholderName = matcher.group(2);\n this.isQueryParamPattern = true;\n } else {\n this.isQueryParamPattern = false;\n }\n }\n\n RequestPredicate toRequestPredicate() {\n if (!this.isQueryParamPattern) {\n throw new IllegalStateException(\"Not a query param pattern: \" + pattern);\n }\n\n return RequestPredicates.queryParam(paramName, value -> true);\n }\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/RouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.apache.commons.lang3.ObjectUtils.defaultIfNull;\n\nimport java.util.function.Function;\nimport org.apache.commons.lang3.math.NumberUtils;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic interface RouteFactory {\n RouterFunction create(String pattern);\n\n default Mono configuredPageSize(\n SystemConfigFetcher environmentFetcher,\n Function mapper) {\n return environmentFetcher.fetchPost()\n .map(p -> defaultIfNull(mapper.apply(p), ModelConst.DEFAULT_PAGE_SIZE));\n }\n\n default int pageNumInPathVariable(ServerRequest request) {\n String page = request.pathVariables().get(\"page\");\n return NumberUtils.toInt(page, 1);\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/TagPostRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static run.halo.app.extension.index.query.Queries.and;\nimport static run.halo.app.extension.index.query.Queries.equal;\nimport static run.halo.app.extension.index.query.Queries.isNull;\nimport static run.halo.app.theme.router.PageUrlUtils.totalPage;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.router.selector.FieldSelector;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.utils.PathUtils;\nimport run.halo.app.theme.Constant;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.TagVo;\nimport run.halo.app.theme.router.PageUrlUtils;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\nimport run.halo.app.theme.router.UrlContextListResult;\n\n/**\n * The {@link TagPostRouteFactory} for generate {@link RouterFunction} specific to the template\n * tag.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class TagPostRouteFactory implements RouteFactory {\n\n private final ReactiveExtensionClient client;\n private final SystemConfigFetcher environmentFetcher;\n private final TagFinder tagFinder;\n private final PostFinder postFinder;\n\n private final TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n private final LocaleContextResolver localeContextResolver;\n\n @Override\n public RouterFunction create(String prefix) {\n return RouterFunctions\n .route(GET(PathUtils.combinePath(prefix, \"/{slug}\"))\n .or(GET(PathUtils.combinePath(prefix, \"/{slug}/page/{page:\\\\d+}\")))\n .and(accept(MediaType.TEXT_HTML)), handlerFunction());\n }\n\n private HandlerFunction handlerFunction() {\n return request -> tagBySlug(request.pathVariable(\"slug\"))\n .flatMap(tagVo -> {\n int pageNum = pageNumInPathVariable(request);\n String path = request.path();\n var postList = postList(tagVo.getMetadata().getName(), pageNum, path)\n .doOnNext(list -> list.forEach(postVo ->\n postVo.getSpec().setTitle(\n titleVisibilityIdentifyCalculator.calculateTitle(\n postVo.getSpec().getTitle(),\n postVo.getSpec().getVisible(),\n localeContextResolver.resolveLocaleContext(request.exchange())\n .getLocale()\n )\n )\n ));\n Map model = new HashMap<>();\n model.put(\"name\", tagVo.getMetadata().getName());\n model.put(\"posts\", postList);\n model.put(\"tag\", tagVo);\n model.put(\n Constant.META_DESCRIPTION_VARIABLE_NAME,\n tagVo.getSpec().getDescription()\n );\n return ServerResponse.ok()\n .render(DefaultTemplateEnum.TAG.getValue(), model);\n });\n }\n\n private Mono> postList(String name, Integer page,\n String requestPath) {\n return configuredPageSize(environmentFetcher, SystemSetting.Post::getTagPageSize)\n .flatMap(pageSize -> postFinder.listByTag(page, pageSize, name))\n .map(list -> new UrlContextListResult.Builder()\n .listResult(list)\n .nextUrl(PageUrlUtils.nextPageUrl(requestPath, totalPage(list)))\n .prevUrl(PageUrlUtils.prevPageUrl(requestPath))\n .build()\n );\n }\n\n private Mono tagBySlug(String slug) {\n var listOptions = new ListOptions();\n listOptions.setFieldSelector(FieldSelector.of(\n and(\n equal(\"spec.slug\", slug),\n isNull(\"metadata.deletionTimestamp\")\n )\n ));\n return client.listBy(Tag.class, listOptions, PageRequestImpl.ofSize(1))\n .mapNotNull(result -> ListResult.first(result).orElse(null))\n .flatMap(tag -> tagFinder.getByName(tag.getMetadata().getName()))\n .switchIfEmpty(\n Mono.error(new NotFoundException(\"Tag not found with slug: \" + slug)));\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/router/factories/TagsRouteFactory.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\n\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.http.MediaType;\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * The {@link TagsRouteFactory} for generate {@link RouterFunction} specific to the template\n * tags.html.\n *\n * @author guqing\n * @since 2.0.0\n */\n@Component\n@AllArgsConstructor\npublic class TagsRouteFactory implements RouteFactory {\n\n private final TagFinder tagFinder;\n\n @Override\n public RouterFunction create(String prefix) {\n return RouterFunctions\n .route(GET(StringUtils.prependIfMissing(prefix, \"/\"))\n .and(accept(MediaType.TEXT_HTML)), handlerFunction());\n }\n\n private HandlerFunction handlerFunction() {\n return request -> ServerResponse.ok()\n .render(DefaultTemplateEnum.TAGS.getValue(),\n Map.of(\"tags\", tagFinder.listAll(),\n ModelConst.TEMPLATE_ID, DefaultTemplateEnum.TAGS.getValue()\n )\n );\n }\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/service/ThemeService.java", "content": "package run.halo.app.theme.service;\n\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.util.StringUtils;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.infra.SystemSetting;\n\npublic interface ThemeService {\n\n Mono installPresetTheme();\n\n Mono install(Publisher content);\n\n Mono upgrade(String themeName, Publisher content);\n\n Mono reloadTheme(String name);\n\n Mono resetSettingConfig(String name);\n\n /**\n * Fetch activated theme.\n *\n * @return the activated theme\n */\n Mono fetchActivatedTheme();\n\n /**\n * Fetch system setting of theme.\n *\n * @return the system setting of theme\n */\n Mono fetchSystemSetting();\n\n /**\n * Fetch activated theme name.\n *\n * @return the activated theme name\n */\n default Mono fetchActivatedThemeName() {\n return fetchSystemSetting()\n .mapNotNull(SystemSetting.Theme::getActive)\n .filter(StringUtils::hasText);\n }\n\n // TODO Migrate other useful methods in ThemeEndpoint in the future.\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/service/ThemeServiceImpl.java", "content": "package run.halo.app.theme.service;\n\nimport static org.springframework.util.FileSystemUtils.copyRecursively;\nimport static run.halo.app.infra.utils.FileUtils.deleteRecursivelyAndSilently;\nimport static run.halo.app.infra.utils.FileUtils.unzip;\nimport static run.halo.app.theme.service.ThemeUtils.loadThemeManifest;\nimport static run.halo.app.theme.service.ThemeUtils.locateThemeManifest;\nimport static run.halo.app.theme.service.ThemeUtils.unzipThemeTo;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.time.Duration;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.Set;\nimport java.util.function.Predicate;\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.apache.commons.lang3.StringUtils;\nimport org.jspecify.annotations.Nullable;\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.UrlResource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.core.io.buffer.DefaultDataBufferFactory;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.Assert;\nimport org.springframework.util.ResourceUtils;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.web.server.ServerErrorException;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.core.extension.notification.NotificationTemplate;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.infra.exception.ThemeAlreadyExistsException;\nimport run.halo.app.infra.exception.ThemeUpgradeException;\nimport run.halo.app.infra.exception.UnsatisfiedAttributeValueException;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.infra.utils.SettingUtils;\nimport run.halo.app.infra.utils.VersionUtils;\n\n@Slf4j\n@Service\n@AllArgsConstructor\npublic class ThemeServiceImpl implements ThemeService {\n\n private final ReactiveExtensionClient client;\n\n private final ThemeRootGetter themeRoot;\n\n private final HaloProperties haloProperties;\n\n private final SystemVersionSupplier systemVersionSupplier;\n\n private final SystemConfigFetcher systemConfigFetcher;\n\n private final Scheduler scheduler = Schedulers.boundedElastic();\n\n @Override\n public Mono installPresetTheme() {\n var themeProps = haloProperties.getTheme();\n var location = themeProps.getInitializer().getLocation();\n return Mono.using(\n () -> Files.createTempDirectory(\"halo-theme-preset\"),\n tempDir -> Mono.fromCallable(() -> {\n var themeUrl = ResourceUtils.getURL(location);\n var resource = new UrlResource(themeUrl);\n var tempThemePath = tempDir.resolve(\"theme.zip\");\n FileUtils.copyResource(resource, tempThemePath);\n return tempThemePath;\n }).flatMap(themePath -> {\n var content = DataBufferUtils.read(new FileSystemResource(themePath),\n DefaultDataBufferFactory.sharedInstance,\n StreamUtils.BUFFER_SIZE);\n // We don't want to run on the bounded elastic scheduler again, so pass null\n // here.\n return doInstall(content, null);\n }),\n FileUtils::deleteRecursivelyAndSilently\n )\n .subscribeOn(scheduler)\n .onErrorResume(IOException.class, e -> {\n log.warn(\"Failed to initialize theme from {}\", location, e);\n return Mono.empty();\n })\n .onErrorResume(ThemeAlreadyExistsException.class, e -> {\n log.warn(\"Failed to initialize theme from {}, because it already exists\", location);\n return Mono.empty();\n })\n .then();\n }\n\n @Override\n public Mono install(Publisher content) {\n return doInstall(content, this.scheduler);\n }\n\n @Override\n public Mono upgrade(String themeName, Publisher content) {\n var checkTheme = client.fetch(Theme.class, themeName)\n .switchIfEmpty(Mono.error(() -> new ServerWebInputException(\n \"The given theme with name \" + themeName + \" did not exist\")\n ));\n var upgradeTheme = Mono.using(\n () -> Files.createTempDirectory(\"halo-theme-\"),\n tempDir -> {\n var locateThemeManifest = Mono.fromCallable(\n () -> locateThemeManifest(tempDir).orElse(null)\n )\n .switchIfEmpty(Mono.error(() -> new ThemeUpgradeException(\n \"Missing theme manifest file: theme.yaml or theme.yml\",\n \"problemDetail.theme.upgrade.missingManifest\", null)\n ));\n return unzip(content, tempDir)\n .then(locateThemeManifest)\n .flatMap(themeManifest -> {\n if (log.isDebugEnabled()) {\n log.debug(\"Found theme manifest file: {}\", themeManifest);\n }\n var newTheme = loadThemeManifest(themeManifest);\n if (!Objects.equals(themeName, newTheme.getMetadata().getName())) {\n if (log.isDebugEnabled()) {\n log.error(\"Want theme name: {}, but provided: {}\", themeName,\n newTheme.getMetadata().getName());\n }\n return Mono.error(new ThemeUpgradeException(\n \"Please make sure the theme name is correct\",\n \"problemDetail.theme.upgrade.nameMismatch\",\n new Object[] {newTheme.getMetadata().getName(), themeName}));\n }\n var copyTheme = Mono.fromCallable(() -> {\n var themePath = themeRoot.get().resolve(themeName);\n // TODO Create backup before deleting\n deleteRecursivelyAndSilently(themePath);\n copyRecursively(themeManifest.getParent(), themePath);\n return themePath;\n });\n return copyTheme.then(this.persistent(newTheme, true));\n });\n },\n FileUtils::deleteRecursivelyAndSilently\n ).subscribeOn(scheduler);\n return checkTheme.then(upgradeTheme);\n }\n\n private Mono doInstall(Publisher content, @Nullable Scheduler scheduler) {\n var themeRoot = this.themeRoot.get();\n return unzipThemeTo(content, themeRoot, scheduler)\n .flatMap(theme -> persistent(theme, false));\n }\n\n /**\n * Creates theme manifest and related unstructured resources.\n * TODO: In case of failure in saving midway, the problem of data consistency needs to be\n * solved.\n *\n * @param themeManifest the theme custom model\n * @return a theme custom model\n * @see Theme\n */\n private Mono persistent(Unstructured themeManifest, boolean isUpgrade) {\n Assert.state(StringUtils.equals(Theme.KIND, themeManifest.getKind()),\n \"Theme manifest kind must be Theme.\");\n var newTheme = Unstructured.OBJECT_MAPPER.convertValue(themeManifest, Theme.class);\n final Mono createOrUpdateTheme;\n if (isUpgrade) {\n createOrUpdateTheme = client.get(Theme.class, newTheme.getMetadata().getName())\n .doOnNext(theme -> updateTheme(theme, newTheme))\n .flatMap(client::update);\n } else {\n createOrUpdateTheme = client.create(newTheme);\n }\n return createOrUpdateTheme\n .doOnNext(theme -> {\n String systemVersion = systemVersionSupplier.get().toStableVersion().toString();\n String requires = theme.getSpec().getRequires();\n if (!VersionUtils.satisfiesRequires(systemVersion, requires)) {\n throw new UnsatisfiedAttributeValueException(\n String.format(\"The theme requires a minimum system version of %s, \"\n + \"but the current version is %s.\",\n requires, systemVersion),\n \"problemDetail.theme.version.unsatisfied.requires\",\n new String[] {requires, systemVersion});\n }\n })\n .flatMap(theme -> {\n var unstructureds = ThemeUtils.loadThemeResources(getThemePath(theme));\n if (unstructureds.stream()\n .filter(hasSettingsYaml(theme))\n .count() > 1) {\n return Mono.error(new IllegalStateException(\n \"Theme must only have one settings.yaml or settings.yml.\"));\n }\n if (unstructureds.stream()\n .filter(hasConfigYaml(theme))\n .count() > 1) {\n return Mono.error(new IllegalStateException(\n \"Theme must only have one config.yaml or config.yml.\"));\n }\n return Flux.fromIterable(unstructureds)\n .filter(unstructured -> ExtensionWhitelist.of(theme).isAllowed(unstructured))\n .doOnNext(unstructured ->\n populateThemeNameLabel(unstructured, theme.getMetadata().getName()))\n .flatMap(unstructured -> {\n if (isUpgrade) {\n return createOrUpdate(unstructured);\n }\n return client.create(unstructured);\n })\n .then()\n .thenReturn(theme);\n });\n }\n\n private Mono createOrUpdate(Unstructured unstructured) {\n return Mono.defer(() -> client.fetch(unstructured.groupVersionKind(),\n unstructured.getMetadata().getName())\n .flatMap(existUnstructured -> {\n unstructured.getMetadata()\n .setVersion(existUnstructured.getMetadata().getVersion());\n return client.update(unstructured);\n })\n .switchIfEmpty(Mono.defer(() -> client.create(unstructured)))\n )\n .retryWhen(Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance));\n }\n\n @Override\n public Mono reloadTheme(String name) {\n return client.fetch(Theme.class, name)\n .flatMap(oldTheme -> {\n String settingName = oldTheme.getSpec().getSettingName();\n return waitForSettingDeleted(settingName)\n .then(waitForAnnotationSettingsDeleted(name));\n })\n .then(Mono.defer(() -> {\n Path themePath = themeRoot.get().resolve(name);\n Path themeManifestPath = ThemeUtils.resolveThemeManifest(themePath);\n if (themeManifestPath == null) {\n throw new IllegalArgumentException(\n \"The manifest file [theme.yaml] is required.\");\n }\n Unstructured unstructured = loadThemeManifest(themeManifestPath);\n Theme newTheme = Unstructured.OBJECT_MAPPER.convertValue(unstructured,\n Theme.class);\n return client.fetch(Theme.class, name)\n .map(oldTheme -> {\n newTheme.getMetadata().setVersion(oldTheme.getMetadata().getVersion());\n return newTheme;\n })\n .flatMap(client::update);\n }))\n .flatMap(theme -> Flux.fromIterable(ThemeUtils.loadThemeResources(getThemePath(theme)))\n .filter(unstructured -> ExtensionWhitelist.of(theme).isAllowed(unstructured))\n .doOnNext(unstructured -> populateThemeNameLabel(unstructured, name))\n .flatMap(this::createOrUpdate)\n .then(Mono.just(theme))\n );\n }\n\n private static void populateThemeNameLabel(Unstructured unstructured, String themeName) {\n Map labels = unstructured.getMetadata().getLabels();\n if (labels == null) {\n labels = new HashMap<>();\n unstructured.getMetadata().setLabels(labels);\n }\n labels.put(Theme.THEME_NAME_LABEL, themeName);\n }\n\n @Override\n public Mono resetSettingConfig(String name) {\n return client.fetch(Theme.class, name)\n .filter(theme -> StringUtils.isNotBlank(theme.getSpec().getSettingName()))\n .flatMap(theme -> {\n String configMapName = theme.getSpec().getConfigMapName();\n String settingName = theme.getSpec().getSettingName();\n return client.fetch(Setting.class, settingName)\n .map(SettingUtils::settingDefinedDefaultValueMap)\n .flatMap(data -> updateConfigMapData(configMapName, data));\n });\n }\n\n @Override\n public Mono fetchActivatedTheme() {\n return fetchSystemSetting().mapNotNull(SystemSetting.Theme::getActive)\n .flatMap(name -> client.fetch(Theme.class, name));\n }\n\n @Override\n public Mono fetchSystemSetting() {\n return systemConfigFetcher.fetch(SystemSetting.Theme.GROUP, SystemSetting.Theme.class);\n }\n\n private Mono updateConfigMapData(String configMapName, Map data) {\n return client.fetch(ConfigMap.class, configMapName)\n .flatMap(configMap -> {\n configMap.setData(data);\n return client.update(configMap);\n })\n .retryWhen(Retry.fixedDelay(10, Duration.ofMillis(100))\n .filter(t -> t instanceof OptimisticLockingFailureException));\n }\n\n private Mono waitForSettingDeleted(String settingName) {\n return client.fetch(Setting.class, settingName)\n .flatMap(setting -> client.delete(setting)\n .flatMap(deleted -> client.fetch(Setting.class, settingName)\n .flatMap(s -> Mono.error(\n () -> new IllegalStateException(\"Re-check if the setting is deleted.\")\n ))\n .retryWhen(Retry.fixedDelay(10, Duration.ofMillis(100))\n .filter(IllegalStateException.class::isInstance)\n )\n )\n )\n .then();\n }\n\n private Mono waitForAnnotationSettingsDeleted(String themeName) {\n return client.list(AnnotationSetting.class,\n annotationSetting -> {\n Map labels = MetadataUtil.nullSafeLabels(annotationSetting);\n return StringUtils.equals(themeName, labels.get(Theme.THEME_NAME_LABEL));\n }, null)\n .flatMap(annotationSetting -> client.delete(annotationSetting)\n .flatMap(deleted -> client.fetch(AnnotationSetting.class,\n annotationSetting.getMetadata().getName())\n .flatMap(latest -> Mono.error(\n new IllegalStateException(\"AnnotationSetting is not deleted yet.\")\n ))\n .retryWhen(Retry.fixedDelay(10, Duration.ofMillis(100))\n .filter(t -> t instanceof IllegalStateException)\n )\n )\n )\n .then();\n }\n\n private Path getThemePath(Theme theme) {\n return themeRoot.get().resolve(theme.getMetadata().getName());\n }\n\n private Predicate hasSettingsYaml(Theme theme) {\n return unstructured -> Setting.KIND.equals(unstructured.getKind())\n && theme.getSpec().getSettingName().equals(unstructured.getMetadata().getName());\n }\n\n private Predicate hasConfigYaml(Theme theme) {\n return unstructured -> ConfigMap.KIND.equals(unstructured.getKind())\n && theme.getSpec().getConfigMapName().equals(unstructured.getMetadata().getName());\n }\n\n Mono deleteThemeAndWaitForComplete(String themeName) {\n return client.fetch(Theme.class, themeName)\n .flatMap(client::delete)\n .flatMap(deletingTheme -> waitForThemeDeleted(themeName)\n .thenReturn(deletingTheme));\n }\n\n Mono waitForThemeDeleted(String themeName) {\n return client.fetch(Theme.class, themeName)\n .flatMap(theme -> Mono.error(\n new IllegalStateException(\"Re-check if the theme is deleted successfully\")\n ))\n .retryWhen(Retry.fixedDelay(20, Duration.ofMillis(100))\n .filter(IllegalStateException.class::isInstance)\n .onRetryExhaustedThrow((spec, signal) ->\n new ServerErrorException(\"Wait timeout for theme deleted\", null)))\n .then();\n }\n\n static class ExtensionWhitelist {\n private final Set rules;\n\n private ExtensionWhitelist(Theme theme) {\n this.rules = getRules(theme);\n }\n\n public static ExtensionWhitelist of(Theme theme) {\n return new ExtensionWhitelist(theme);\n }\n\n public boolean isAllowed(Unstructured unstructured) {\n return this.rules.stream()\n .anyMatch(rule -> rule.matches(unstructured));\n }\n\n private Set getRules(Theme theme) {\n var rules = new HashSet();\n rules.add(AllowedExtension.of(AnnotationSetting.class));\n rules.add(AllowedExtension.of(NotificationTemplate.class));\n\n var configMapName = theme.getSpec().getConfigMapName();\n if (StringUtils.isNotBlank(configMapName)) {\n rules.add(AllowedExtension.of(ConfigMap.class, configMapName));\n }\n\n var settingName = theme.getSpec().getSettingName();\n if (StringUtils.isNotBlank(settingName)) {\n rules.add(AllowedExtension.of(Setting.class, settingName));\n }\n return rules;\n }\n }\n\n record AllowedExtension(String apiGroup, String kind, String name) {\n AllowedExtension {\n Assert.notNull(apiGroup, \"The apiGroup must not be null\");\n Assert.notNull(kind, \"Kind must not be null\");\n }\n\n public static AllowedExtension of(Class clazz) {\n return of(clazz, null);\n }\n\n public static AllowedExtension of(Class clazz, String name) {\n var gvk = GroupVersionKind.fromExtension(clazz);\n return new AllowedExtension(gvk.group(), gvk.kind(), name);\n }\n\n public boolean matches(Unstructured unstructured) {\n var groupVersionKind = unstructured.groupVersionKind();\n return this.apiGroup.equals(groupVersionKind.group())\n && this.kind.equals(groupVersionKind.kind())\n && (this.name == null || this.name.equals(unstructured.getMetadata().getName()));\n }\n }\n\n private static void updateTheme(Theme existing, Theme updating) {\n var existingSpec = existing.getSpec();\n var updatingSpec = updating.getSpec();\n // merge spec\n existingSpec.setAuthor(updatingSpec.getAuthor());\n existingSpec.setCustomTemplates(updatingSpec.getCustomTemplates());\n existingSpec.setDescription(updatingSpec.getDescription());\n existingSpec.setDisplayName(updatingSpec.getDisplayName());\n existingSpec.setHomepage(updatingSpec.getHomepage());\n existingSpec.setIssues(updatingSpec.getIssues());\n existingSpec.setLicense(updatingSpec.getLicense());\n existingSpec.setLogo(updatingSpec.getLogo());\n existingSpec.setRepo(updatingSpec.getRepo());\n existingSpec.setSettingName(updatingSpec.getSettingName());\n existingSpec.setVersion(updatingSpec.getVersion());\n existingSpec.setRequires(updatingSpec.getRequires());\n // Do not overwrite configMapName to avoid data loss\n\n var existingMeta = existing.getMetadata();\n var updatingMeta = updating.getMetadata();\n // merge labels\n if (updatingMeta.getLabels() != null) {\n if (existingMeta.getLabels() == null) {\n existingMeta.setLabels(new HashMap<>());\n }\n existingMeta.getLabels().putAll(updatingMeta.getLabels());\n }\n // merge annotations\n if (updatingMeta.getAnnotations() != null) {\n if (existingMeta.getAnnotations() == null) {\n existingMeta.setAnnotations(new HashMap<>());\n }\n existingMeta.getAnnotations().putAll(updatingMeta.getAnnotations());\n }\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/service/ThemeUtils.java", "content": "package run.halo.app.theme.service;\n\nimport static org.springframework.util.FileSystemUtils.copyRecursively;\nimport static run.halo.app.infra.utils.FileUtils.createTempDir;\nimport static run.halo.app.infra.utils.FileUtils.deleteRecursivelyAndSilently;\nimport static run.halo.app.infra.utils.FileUtils.unzip;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.ArrayList;\nimport java.util.Comparator;\nimport java.util.LinkedList;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.stream.BaseStream;\nimport java.util.stream.Stream;\nimport lombok.experimental.UtilityClass;\nimport lombok.extern.slf4j.Slf4j;\nimport org.jspecify.annotations.Nullable;\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.util.CollectionUtils;\nimport org.springframework.web.server.ResponseStatusException;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.core.scheduler.Scheduler;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.exception.ThemeAlreadyExistsException;\nimport run.halo.app.infra.exception.ThemeInstallationException;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\n@Slf4j\n@UtilityClass\npublic class ThemeUtils {\n private static final String THEME_TMP_PREFIX = \"halo-theme-\";\n private static final String[] THEME_MANIFESTS = {\"theme.yaml\", \"theme.yml\"};\n\n public static Flux listAllThemesFromThemeDir(Path themesDir) {\n return walkThemesFromPath(themesDir)\n .filter(Files::isDirectory)\n .map(ThemeUtils::findThemeManifest)\n .flatMap(Flux::fromIterable)\n .filter(unstructured -> unstructured.getKind().equals(Theme.KIND))\n .map(unstructured -> Unstructured.OBJECT_MAPPER.convertValue(unstructured,\n Theme.class))\n .sort(Comparator.comparing(theme -> theme.getMetadata().getName()));\n }\n\n private static Flux walkThemesFromPath(Path path) {\n return Flux.using(() -> Files.walk(path, 2),\n Flux::fromStream,\n BaseStream::close\n )\n .subscribeOn(Schedulers.boundedElastic());\n }\n\n private static List findThemeManifest(Path themePath) {\n List resources = new ArrayList<>(4);\n for (String themeResource : THEME_MANIFESTS) {\n Path resourcePath = themePath.resolve(themeResource);\n if (Files.exists(resourcePath)) {\n resources.add(new FileSystemResource(resourcePath));\n }\n }\n if (CollectionUtils.isEmpty(resources)) {\n return List.of();\n }\n return new YamlUnstructuredLoader(resources.toArray(new Resource[0]))\n .load();\n }\n\n static List loadThemeResources(Path themePath) {\n try (Stream paths = Files.list(themePath)) {\n List resources = paths\n .filter(path -> {\n String pathString = path.toString();\n return pathString.endsWith(\".yaml\") || pathString.endsWith(\".yml\");\n })\n .filter(path -> {\n String pathString = path.toString();\n for (String themeManifest : THEME_MANIFESTS) {\n if (pathString.endsWith(themeManifest)) {\n return false;\n }\n }\n return true;\n })\n .map(FileSystemResource::new)\n .toList();\n return new YamlUnstructuredLoader(resources.toArray(new Resource[0]))\n .load();\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n\n static Mono unzipThemeTo(Publisher content, Path themeWorkDir,\n @Nullable Scheduler scheduler) {\n return unzipThemeTo(content, themeWorkDir, false, scheduler)\n .onErrorMap(e -> !(e instanceof ResponseStatusException), e -> {\n log.error(\"Failed to unzip theme\", e);\n throw new ServerWebInputException(\"Failed to unzip theme\");\n });\n }\n\n static Mono unzipThemeTo(Publisher content, Path themeWorkDir,\n boolean override, @Nullable Scheduler scheduler) {\n var unzipThem = Mono.usingWhen(\n createTempDir(THEME_TMP_PREFIX, null),\n tempDir -> {\n var locateThemeManifest = Mono.fromCallable(\n () -> locateThemeManifest(tempDir).orElse(null)\n )\n .switchIfEmpty(\n Mono.error(() -> new ThemeInstallationException(\n \"Missing theme manifest\",\n \"problemDetail.theme.install.missingManifest\", null\n ))\n );\n return unzip(content, tempDir, null)\n .then(locateThemeManifest)\n .handle((themeManifestPath, sink) -> {\n var theme = loadThemeManifest(themeManifestPath);\n var themeName = theme.getMetadata().getName();\n var themeTargetPath = themeWorkDir.resolve(themeName);\n try {\n if (!override && !FileUtils.isEmpty(themeTargetPath)) {\n sink.error(new ThemeAlreadyExistsException(themeName));\n return;\n }\n // install theme to theme work dir\n copyRecursively(themeManifestPath.getParent(), themeTargetPath);\n sink.next(theme);\n } catch (IOException e) {\n deleteRecursivelyAndSilently(themeTargetPath);\n sink.error(e);\n }\n });\n },\n tempDir -> FileUtils.deleteRecursivelyAndSilently(tempDir, null)\n );\n if (scheduler != null) {\n return unzipThem.subscribeOn(scheduler);\n }\n return unzipThem;\n }\n\n static Unstructured loadThemeManifest(Path themeManifestPath) {\n var unstructureds = new YamlUnstructuredLoader(new FileSystemResource(themeManifestPath))\n .load();\n if (CollectionUtils.isEmpty(unstructureds)) {\n throw new ThemeInstallationException(\"Missing theme manifest\",\n \"problemDetail.theme.install.missingManifest\", null);\n }\n return unstructureds.get(0);\n }\n\n @Nullable\n static Path resolveThemeManifest(Path tempDirectory) {\n for (String themeManifest : THEME_MANIFESTS) {\n Path path = tempDirectory.resolve(themeManifest);\n if (Files.exists(path)) {\n return path;\n }\n }\n return null;\n }\n\n static Optional locateThemeManifest(Path path) {\n if (!Files.isDirectory(path)) {\n return Optional.empty();\n }\n var queue = new LinkedList();\n queue.add(path);\n var manifest = Optional.empty();\n while (!queue.isEmpty()) {\n var current = queue.pop();\n try (Stream subPaths = Files.list(current)) {\n manifest = subPaths.filter(Files::isReadable)\n .filter(subPath -> {\n if (Files.isDirectory(subPath)) {\n queue.add(subPath);\n return false;\n }\n return true;\n })\n .filter(Files::isRegularFile)\n .filter(ThemeUtils::isManifest)\n .findFirst();\n } catch (IOException e) {\n throw Exceptions.propagate(e);\n }\n if (manifest.isPresent()) {\n break;\n }\n }\n return manifest;\n }\n\n static boolean isManifest(Path file) {\n if (!Files.isRegularFile(file)) {\n return false;\n }\n return Set.of(THEME_MANIFESTS).contains(file.getFileName().toString());\n }\n\n}\n" }, { "path": "application/src/main/java/run/halo/app/theme/utils/PatternUtils.java", "content": "package run.halo.app.theme.utils;\n\nimport static org.apache.commons.lang3.StringUtils.prependIfMissing;\nimport static org.apache.commons.lang3.StringUtils.removeEnd;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.springframework.util.Assert;\nimport run.halo.app.infra.SystemSetting.ThemeRouteRules;\n\n/**\n * Pattern utility methods.\n *\n * @author johnniang\n * @since 2.22.0\n */\npublic enum PatternUtils {\n ;\n\n /**\n * Normalize the pattern by ensuring it starts with a \"/\" and does not end with a \"/\".\n *\n * @param pattern the pattern to normalize, must not be blank or just \"/\"\n * @return the normalized pattern\n */\n public static String normalizePattern(String pattern) {\n Assert.hasText(pattern, \"Pattern must not be blank\");\n Assert.isTrue(!\"/\".equals(pattern.trim()), \"Pattern must not be just '/'\");\n pattern = prependIfMissing(pattern.trim(), \"/\");\n return removeEnd(pattern, \"/\");\n }\n\n\n /**\n * Normalize the post pattern, if the post pattern starts with /archives/ or /categories/,\n * replace it with the corresponding pattern from rules.\n *\n * @param rules the theme route rules\n * @return the normalized post pattern\n */\n public static String normalizePostPattern(ThemeRouteRules rules) {\n var postPattern = normalizePattern(rules.getPost());\n if (StringUtils.startsWith(postPattern, \"/archives/\")) {\n var archivesPattern = normalizePattern(rules.getArchives());\n postPattern = archivesPattern + StringUtils.removeStart(postPattern, \"/archives\");\n } else if (StringUtils.startsWith(postPattern, \"/categories/\")) {\n var categoriesPattern = normalizePattern(rules.getCategories());\n postPattern = categoriesPattern + StringUtils.removeStart(postPattern, \"/categories\");\n }\n return postPattern;\n }\n}\n" }, { "path": "application/src/main/resources/META-INF/spring-devtools.properties", "content": "# See https://docs.spring.io/spring-boot/docs/current/reference/html/using.html#using.devtools.restart.customizing-the-classload for more\nrestart.include.apimodule=/api-[\\\\w\\\\d-\\\\.]+\\\\.jar\n" }, { "path": "application/src/main/resources/application-dev.yaml", "content": "server:\n port: 8090\n\nspring:\n output:\n ansi:\n enabled: always\n thymeleaf:\n cache: false\n web:\n resources:\n cache:\n cachecontrol:\n no-cache: true\n use-last-modified: false\n\nhalo:\n security:\n basic-auth:\n disabled: false\n ui:\n proxy:\n endpoint: http://localhost:3000/\n enabled: true\n plugin:\n runtime-mode: development # development, deployment\n work-dir: ${user.home}/halo2-dev\nlogging:\n level:\n org.springframework.data.r2dbc: DEBUG\n org.springframework.r2dbc: DEBUG\n run.halo: DEBUG\n web: DEBUG\n org.springframework.boot.autoconfigure.web.reactive.error.AbstractErrorWebExceptionHandler: DEBUG\nspringdoc:\n cache:\n disabled: true\n api-docs:\n enabled: true\n version: OPENAPI_3_0\n swagger-ui:\n enabled: true\n show-actuator: true\n\nmanagement:\n endpoints:\n web:\n exposure:\n include: \"*\"\n" }, { "path": "application/src/main/resources/application-doc.yaml", "content": "springdoc:\n cache:\n disabled: true\n api-docs:\n enabled: true\n version: OPENAPI_3_0\n\nspring:\n main:\n banner-mode: off\n r2dbc:\n url: r2dbc:h2:mem:///halo\n\nhalo:\n extension:\n controller:\n disabled: true\n" }, { "path": "application/src/main/resources/application-mariadb.yaml", "content": "spring:\n r2dbc:\n url: r2dbc:pool:mariadb://localhost:3306/halo\n username: root\n password: mariadb\n sql:\n init:\n mode: always\n platform: mariadb\n" }, { "path": "application/src/main/resources/application-mysql.yaml", "content": "spring:\n r2dbc:\n url: r2dbc:pool:mysql://localhost:3306/halo\n username: root\n password: openmysql\n sql:\n init:\n mode: always\n platform: mysql\n" }, { "path": "application/src/main/resources/application-postgresql.yaml", "content": "spring:\n r2dbc:\n url: r2dbc:pool:postgresql://localhost:5432/halo\n username: postgres\n password: openpostgresql\n sql:\n init:\n mode: always\n platform: postgresql\n" }, { "path": "application/src/main/resources/application-win.yaml", "content": "spring:\n r2dbc:\n url: r2dbc:h2:file:///~/halo2-dev/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE\nhalo:\n work-dir: ${user.home}/halo2-dev" }, { "path": "application/src/main/resources/application.yaml", "content": "server:\n port: 8090\n forward-headers-strategy: native\n compression:\n enabled: true\nspring:\n output:\n ansi:\n enabled: detect\n r2dbc:\n url: r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE\n username: admin\n password: 123456\n sql:\n init:\n mode: always\n platform: h2\n http:\n codecs:\n max-in-memory-size: 10MB\n messages:\n basename: config.i18n.messages\n web:\n error:\n whitelabel:\n enabled: false\n resources:\n cache:\n cachecontrol:\n max-age: 365d\n thymeleaf:\n reactive:\n maxChunkSize: 8KB\n cache:\n type: caffeine\n caffeine:\n spec: expireAfterAccess=1h, maximumSize=10000\n threads:\n virtual:\n enabled: true\n\nhalo:\n work-dir: ${user.home}/.halo2\n attachment:\n resource-mappings:\n - pathPattern: /upload/**\n locations:\n - migrate-from-1.x\n security:\n password-reset-methods:\n - name: email\n href: /password-reset/email\n icon: /images/password-reset-methods/email.svg\n\nspringdoc:\n api-docs:\n enabled: false\n writer-with-order-by-keys: true\n\nlogging:\n level:\n org.thymeleaf.TemplateEngine: OFF\n file:\n name: ${halo.work-dir}/logs/halo.log\n logback:\n rollingpolicy:\n max-file-size: 10MB\n total-size-cap: 1GB\n max-history: 0\n\nmanagement:\n endpoints:\n web:\n exposure:\n include: \"*\"\n endpoint:\n shutdown:\n access: unrestricted\n heapdump:\n access: unrestricted\n health:\n show-details: when-authorized\n show-components: when-authorized\n roles: super-role\n probes:\n enabled: true\n info:\n java:\n enabled: true\n os:\n enabled: true\n\nresilience4j.ratelimiter:\n configs:\n authentication:\n limitForPeriod: 3\n limitRefreshPeriod: 1m\n timeoutDuration: 0\n comment-creation:\n limitForPeriod: 10\n limitRefreshPeriod: 1m\n timeoutDuration: 0s\n signup:\n limitForPeriod: 3\n limitRefreshPeriod: 1h\n timeoutDuration: 0s\n send-email-verification-code:\n limitForPeriod: 1\n limitRefreshPeriod: 1m\n timeoutDuration: 0s\n verify-email:\n limitForPeriod: 3\n limitRefreshPeriod: 1h\n timeoutDuration: 0s\n send-password-reset-email:\n limitForPeriod: 10\n limitRefreshPeriod: 1m\n timeoutDuration: 0s\n password-reset-verification:\n limitForPeriod: 10\n limitRefreshPeriod: 1m\n timeoutDuration: 0s\nr2dbc:\n migrate:\n resources-path: classpath:/db/migration/${spring.sql.init.platform}/*.sql\n dialect: ${spring.sql.init.platform}\n" }, { "path": "application/src/main/resources/banner.txt", "content": "${AnsiColor.BLUE}\n __ __ __\n / / / /___ _/ /___\n / /_/ / __ `/ / __ \\\n / __ / /_/ / / /_/ /\n/_/ /_/\\__,_/_/\\____/\n${AnsiColor.BRIGHT_YELLOW}\nVersion: ${application.version}${AnsiColor.DEFAULT}" }, { "path": "application/src/main/resources/config/i18n/messages.properties", "content": "# Title definitions\nproblemDetail.title.org.springframework.web.server.ServerWebInputException=Bad Request\nproblemDetail.title.run.halo.app.infra.exception.UnsatisfiedAttributeValueException=Unsatisfied Request Attribute value\nproblemDetail.title.org.springframework.web.server.UnsupportedMediaTypeStatusException=Unsupported Media Type\nproblemDetail.title.org.springframework.web.server.MissingRequestValueException=Missing Request Value\nproblemDetail.title.org.springframework.web.server.UnsatisfiedRequestParameterException=Unsatisfied Request Parameter\nproblemDetail.title.org.springframework.web.bind.support.WebExchangeBindException=Data Binding or Validation Failure\nproblemDetail.title.org.springframework.web.server.NotAcceptableStatusException=Not Acceptable\nproblemDetail.title.org.springframework.web.server.ServerErrorException=Server Error\nproblemDetail.title.org.springframework.web.server.MethodNotAllowedException=Method Not Allowed\nproblemDetail.title.org.springframework.security.authentication.BadCredentialsException=Bad Credentials\nproblemDetail.title.run.halo.app.extension.exception.SchemaViolationException=Schema Violation\nproblemDetail.title.run.halo.app.infra.exception.AttachmentAlreadyExistsException=Attachment Already Exists\nproblemDetail.title.run.halo.app.infra.exception.FileTypeNotAllowedException=File Type Not Allowed\nproblemDetail.title.run.halo.app.infra.exception.FileSizeExceededException=File Size Exceeded\nproblemDetail.title.run.halo.app.infra.exception.AccessDeniedException=Access Denied\nproblemDetail.title.run.halo.app.infra.exception.RequestRestrictedException=Request Restricted\nproblemDetail.title.reactor.core.Exceptions.RetryExhaustedException=Retry Exhausted\nproblemDetail.title.run.halo.app.infra.exception.ThemeInstallationException=Theme Install Error\nproblemDetail.title.run.halo.app.infra.exception.ThemeUpgradeException=Theme Upgrade Error\nproblemDetail.title.run.halo.app.infra.exception.ThemeAlreadyExistsException=Theme Already Exists Error\nproblemDetail.title.run.halo.app.infra.exception.PluginInstallationException=Plugin Install Error\nproblemDetail.title.run.halo.app.infra.exception.PluginAlreadyExistsException=Plugin Already Exists Error\nproblemDetail.title.run.halo.app.infra.exception.DuplicateNameException=Duplicate Name Error\nproblemDetail.title.run.halo.app.infra.exception.RateLimitExceededException=Request Not Permitted\nproblemDetail.title.run.halo.app.infra.exception.NotFoundException=Resource Not Found\nproblemDetail.title.run.halo.app.infra.exception.EmailVerificationFailed=Email Verification Failed\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$CyclicException=Cyclic Dependency Detected\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$NotFoundException=Dependencies Not Found\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$WrongVersionsException=Wrong Dependency Version\nproblemDetail.title.run.halo.app.infra.exception.PluginDependentsNotDisabledException=Dependents Not Disabled\nproblemDetail.title.run.halo.app.infra.exception.PluginDependenciesNotEnabledException=Dependencies Not Enabled\nproblemDetail.title.run.halo.app.infra.exception.OAuth2UserAlreadyBoundException=User Already Bound Error\nproblemDetail.title.run.halo.app.infra.exception.PluginRuntimeIncompatibleException=Plugin Runtime Incompatible\nproblemDetail.title.run.halo.app.infra.exception.RestrictedNameException=Restricted Name\nproblemDetail.title.internalServerError=Internal Server Error\nproblemDetail.title.conflict=Conflict\n\n# Detail definitions\nproblemDetail.org.springframework.web.server.UnsupportedMediaTypeStatusException=Content type {0} is not supported. Supported media types: {1}.\nproblemDetail.org.springframework.web.server.UnsupportedMediaTypeStatusException.parseError=Could not parse Content-Type.\nproblemDetail.org.springframework.web.server.MissingRequestValueException=Required {0} '{1}' is not present.\nproblemDetail.org.springframework.web.server.UnsatisfiedRequestParameterException=Parameter conditions \"{0}\" not met for actual request parameters.\nproblemDetail.org.springframework.web.bind.support.WebExchangeBindException=Invalid request content. Global errors: {0}. Field errors: {1}.\nproblemDetail.org.springframework.web.server.NotAcceptableStatusException=Acceptable representations: {0}.\nproblemDetail.org.springframework.web.server.NotAcceptableStatusException.parseError=Could not parse Accept header.\nproblemDetail.org.springframework.web.server.ServerErrorException={0}.\nproblemDetail.org.springframework.security.authentication.BadCredentialsException=The username or password is incorrect.\nproblemDetail.org.springframework.web.server.MethodNotAllowedException=Request method {0} is not supported. Supported methods: {1}.\nproblemDetail.run.halo.app.extension.exception.SchemaViolationException={1} of schema {0}.\nproblemDetail.run.halo.app.infra.exception.AttachmentAlreadyExistsException=File {0} already exists, please rename it and try again.\nproblemDetail.run.halo.app.infra.exception.DuplicateNameException=Duplicate name detected, please rename it and retry.\nproblemDetail.run.halo.app.infra.exception.PluginAlreadyExistsException=Plugin {0} already exists.\nproblemDetail.run.halo.app.infra.exception.RateLimitExceededException=API rate limit exceeded, please try again later.\nproblemDetail.run.halo.app.infra.exception.EmailVerificationFailed=Invalid email verification code.\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$CyclicException=A cyclic dependency was detected.\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$NotFoundException=Dependencies \"{0}\" were not found.\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$WrongVersionsException=Dependencies have wrong version: {0}.\nproblemDetail.run.halo.app.infra.exception.PluginDependentsNotDisabledException=Plugin dependents {0} are not fully disabled, please disable them first.\nproblemDetail.run.halo.app.infra.exception.PluginDependenciesNotEnabledException=Plugin dependencies {0} are not fully enabled, please enable them first.\nproblemDetail.run.halo.app.infra.exception.OAuth2UserAlreadyBoundException=The user {0} has already been bound to another OAuth2 user, cannot automatically bind the current OAuth2 user.\nproblemDetail.run.halo.app.infra.exception.PluginRuntimeIncompatibleException=The plugin is incompatible with the current Halo runtime, please upgrade the plugin or downgrade the Halo runtime.\n\nproblemDetail.index.duplicateKey=The value of {0} already exists for unique index {1}, please rename it and retry.\nproblemDetail.user.email.verify.maxAttempts=Too many verification attempts, please try again later.\nproblemDetail.user.email.verify.emailInUse=The email has been used, please change the email and retry.\nproblemDetail.user.password.unsatisfied=The password does not meet the specifications.\nproblemDetail.user.username.unsatisfied=The username does not meet the specifications.\nproblemDetail.user.oldPassword.notMatch=The old password does not match.\nproblemDetail.user.password.notMatch=The password does not match.\nproblemDetail.user.signUpFailed.disallowed=System does not allow new users to register.\nproblemDetail.user.duplicateName=The username {0} already exists, please rename it and retry.\nproblemDetail.user.displayName.restricted=The display name {0} is a reserved name, please change it and retry.\nproblemDetail.comment.turnedOff=The comment function has been turned off.\nproblemDetail.comment.systemUsersOnly=Allow only system users to comment\nproblemDetail.theme.upgrade.missingManifest=Missing theme manifest file \"theme.yaml\" or \"theme.yml\".\nproblemDetail.theme.upgrade.nameMismatch=The current theme name {0} did not match the installed theme name.\nproblemDetail.theme.install.missingManifest=Missing theme manifest file \"theme.yaml\" or manifest file does not conform to the theme specification.\nproblemDetail.theme.install.alreadyExists=Theme {0} already exists.\nproblemDetail.theme.version.unsatisfied.requires=The theme requires a minimum system version of {0}, but the current version is {1}.\nproblemDetail.directoryTraversal=Directory traversal detected. Base path is {0}, but real path is {1}.\nproblemDetail.plugin.version.unsatisfied.requires=Plugin requires a minimum system version of {0}, but the current version is {1}.\nproblemDetail.plugin.missingManifest=Missing plugin manifest file \"plugin.yaml\" or manifest file does not conform to the specification.\nproblemDetail.internalServerError=Something went wrong, please try again later.\nproblemDetail.conflict=Conflict detected, please check the data and retry.\nproblemDetail.migration.backup.notFound=The backup file does not exist or has been deleted.\nproblemDetail.attachment.upload.fileSizeExceeded=Make sure the file size is less than {0}.\nproblemDetail.attachment.upload.fileTypeNotSupported=Unsupported upload of {0} type files.\nproblemDetail.attachment.upload.fileTypeNotMatch=The file type {0} does not match the file extension, and the upload is rejected.\nproblemDetail.comment.waitingForApproval=Comment is awaiting approval.\n\ntitle.visibility.identification.private=(Private)\nsignup.error.confirm-password-not-match=The confirmation password does not match the password.\nsignup.error.email-code.invalid=Invalid email code.\nsignup.error.email.already-taken=Email address is already taken.\n\nvalidation.error.email.pattern=The email format is incorrect\nvalidation.error.username.pattern=The username can only be lowercase and can only contain letters, numbers, hyphens, and dots, starting and ending with characters.\nvalidation.error.password.pattern=The password can only use uppercase and lowercase letters (A-Z, a-z), numbers (0-9), and the following special characters: !@#$%^&*\nvalidation.error.password.size=The password length must be between {0} and {1}\n" }, { "path": "application/src/main/resources/config/i18n/messages_es.properties", "content": "# Title definitions\nproblemDetail.title.org.springframework.web.server.ServerWebInputException=Solicitud incorrecta\nproblemDetail.title.run.halo.app.infra.exception.UnsatisfiedAttributeValueException=Valor de atributo de solicitud no satisfecho\nproblemDetail.title.org.springframework.web.server.UnsupportedMediaTypeStatusException=Tipo de medio no soportado\nproblemDetail.title.org.springframework.web.server.MissingRequestValueException=Valor de solicitud faltante\nproblemDetail.title.org.springframework.web.server.UnsatisfiedRequestParameterException=Parámetro de solicitud no satisfecho\nproblemDetail.title.org.springframework.web.bind.support.WebExchangeBindException=Fallo en la validación o vinculación de datos\nproblemDetail.title.org.springframework.web.server.NotAcceptableStatusException=No aceptable\nproblemDetail.title.org.springframework.web.server.ServerErrorException=Error del servidor\nproblemDetail.title.org.springframework.web.server.MethodNotAllowedException=Método no permitido\nproblemDetail.title.org.springframework.security.authentication.BadCredentialsException=Credenciales incorrectas\nproblemDetail.title.run.halo.app.extension.exception.SchemaViolationException=Violación de esquema\nproblemDetail.title.run.halo.app.infra.exception.AttachmentAlreadyExistsException=El archivo adjunto ya existe\nproblemDetail.title.run.halo.app.infra.exception.FileTypeNotAllowedException=Tipo de archivo no permitido\nproblemDetail.title.run.halo.app.infra.exception.FileSizeExceededException=Tamaño de archivo excedido\nproblemDetail.title.run.halo.app.infra.exception.AccessDeniedException=Acceso denegado\nproblemDetail.title.run.halo.app.infra.exception.RequestRestrictedException=Solicitud restringida\nproblemDetail.title.reactor.core.Exceptions.RetryExhaustedException=Reintentos agotados\nproblemDetail.title.run.halo.app.infra.exception.ThemeInstallationException=Error de instalación del tema\nproblemDetail.title.run.halo.app.infra.exception.ThemeUpgradeException=Error de actualización del tema\nproblemDetail.title.run.halo.app.infra.exception.ThemeAlreadyExistsException=Error: El tema ya existe\nproblemDetail.title.run.halo.app.infra.exception.PluginInstallationException=Error de instalación del complemento\nproblemDetail.title.run.halo.app.infra.exception.PluginAlreadyExistsException=Error: El complemento ya existe\nproblemDetail.title.run.halo.app.infra.exception.DuplicateNameException=Error de nombre duplicado\nproblemDetail.title.run.halo.app.infra.exception.RateLimitExceededException=Solicitud no permitida (Límite de tasa excedido)\nproblemDetail.title.run.halo.app.infra.exception.NotFoundException=Recurso no encontrado\nproblemDetail.title.run.halo.app.infra.exception.EmailVerificationFailed=Fallo en la verificación del correo electrónico\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$CyclicException=Dependencia cíclica detectada\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$NotFoundException=Dependencias no encontradas\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$WrongVersionsException=Versión de dependencia incorrecta\nproblemDetail.title.run.halo.app.infra.exception.PluginDependentsNotDisabledException=Dependientes no desactivados\nproblemDetail.title.run.halo.app.infra.exception.PluginDependenciesNotEnabledException=Dependencias no activadas\nproblemDetail.title.run.halo.app.infra.exception.OAuth2UserAlreadyBoundException=Error: Usuario ya vinculado\nproblemDetail.title.run.halo.app.infra.exception.PluginRuntimeIncompatibleException=Entorno de ejecución del complemento incompatible\nproblemDetail.title.run.halo.app.infra.exception.RestrictedNameException=Nombre restringido\nproblemDetail.title.internalServerError=Error interno del servidor\nproblemDetail.title.conflict=Conflicto\n\n# Detail definitions\nproblemDetail.org.springframework.web.server.UnsupportedMediaTypeStatusException=El tipo de contenido {0} no está soportado. Tipos de medios soportados: {1}.\nproblemDetail.org.springframework.web.server.UnsupportedMediaTypeStatusException.parseError=No se pudo analizar el Content-Type.\nproblemDetail.org.springframework.web.server.MissingRequestValueException=El {0} requerido ''{1}'' no está presente.\nproblemDetail.org.springframework.web.server.UnsatisfiedRequestParameterException=No se cumplen las condiciones del parámetro \"{0}\" para los parámetros de la solicitud actual.\nproblemDetail.org.springframework.web.bind.support.WebExchangeBindException=Contenido de la solicitud inválido. Errores globales: {0}. Errores de campo: {1}.\nproblemDetail.org.springframework.web.server.NotAcceptableStatusException=Representaciones aceptables: {0}.\nproblemDetail.org.springframework.web.server.NotAcceptableStatusException.parseError=No se pudo analizar el encabezado Accept.\nproblemDetail.org.springframework.web.server.ServerErrorException={0}.\nproblemDetail.org.springframework.security.authentication.BadCredentialsException=El nombre de usuario o la contraseña son incorrectos.\nproblemDetail.org.springframework.web.server.MethodNotAllowedException=El método de solicitud {0} no está soportado. Métodos soportados: {1}.\nproblemDetail.run.halo.app.extension.exception.SchemaViolationException={1} del esquema {0}.\nproblemDetail.run.halo.app.infra.exception.AttachmentAlreadyExistsException=El archivo {0} ya existe, por favor cámbiale el nombre e inténtalo de nuevo.\nproblemDetail.run.halo.app.infra.exception.DuplicateNameException=Se ha detectado un nombre duplicado, por favor cámbiale el nombre e inténtalo de nuevo.\nproblemDetail.run.halo.app.infra.exception.PluginAlreadyExistsException=El complemento {0} ya existe.\nproblemDetail.run.halo.app.infra.exception.RateLimitExceededException=Se ha excedido el límite de tasa de la API, por favor inténtalo de nuevo más tarde.\nproblemDetail.run.halo.app.infra.exception.EmailVerificationFailed=Código de verificación de correo electrónico inválido.\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$CyclicException=Se ha detectado una dependencia cíclica.\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$NotFoundException=No se encontraron las dependencias \"{0}\".\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$WrongVersionsException=Las dependencias tienen una versión incorrecta: {0}.\nproblemDetail.run.halo.app.infra.exception.PluginDependentsNotDisabledException=Los dependientes del complemento {0} no están totalmente desactivados, por favor desactívalos primero.\nproblemDetail.run.halo.app.infra.exception.PluginDependenciesNotEnabledException=Las dependencias del complemento {0} no están totalmente activadas, por favor actívalas primero.\nproblemDetail.run.halo.app.infra.exception.OAuth2UserAlreadyBoundException=El usuario {0} ya ha sido vinculado a otro usuario de OAuth2, no se puede vincular automáticamente el usuario de OAuth2 actual.\nproblemDetail.run.halo.app.infra.exception.PluginRuntimeIncompatibleException=El complemento es incompatible con el entorno de ejecución de Halo actual, por favor actualiza el complemento o degrada el entorno de Halo.\n\nproblemDetail.index.duplicateKey=El valor de {0} ya existe para el índice único {1}, por favor cámbiale el nombre e inténtalo de nuevo.\nproblemDetail.user.email.verify.maxAttempts=Demasiados intentos de verificación, por favor inténtalo de nuevo más tarde.\nproblemDetail.user.email.verify.emailInUse=El correo electrónico ya está en uso, por favor cámbialo e inténtalo de nuevo.\nproblemDetail.user.password.unsatisfied=La contraseña no cumple con las especificaciones.\nproblemDetail.user.username.unsatisfied=El nombre de usuario no cumple con las especificaciones.\nproblemDetail.user.oldPassword.notMatch=La contraseña antigua no coincide.\nproblemDetail.user.password.notMatch=La contraseña no coincide.\nproblemDetail.user.signUpFailed.disallowed=El sistema no permite que nuevos usuarios se registren.\nproblemDetail.user.duplicateName=El nombre de usuario {0} ya existe, por favor cámbiale el nombre e inténtalo de nuevo.\nproblemDetail.user.displayName.restricted=El nombre para mostrar {0} es un nombre reservado, por favor cámbialo e inténtalo de nuevo.\nproblemDetail.comment.turnedOff=La función de comentarios ha sido desactivada.\nproblemDetail.comment.systemUsersOnly=Solo se permite comentar a los usuarios del sistema.\nproblemDetail.theme.upgrade.missingManifest=Falta el archivo de manifiesto del tema \"theme.yaml\" o \"theme.yml\".\nproblemDetail.theme.upgrade.nameMismatch=El nombre del tema actual {0} no coincide con el nombre del tema instalado.\nproblemDetail.theme.install.missingManifest=Falta el archivo de manifiesto del tema \"theme.yaml\" o el archivo no cumple con las especificaciones del tema.\nproblemDetail.theme.install.alreadyExists=El tema {0} ya existe.\nproblemDetail.theme.version.unsatisfied.requires=El tema requiere una versión mínima del sistema de {0}, pero la versión actual es {1}.\nproblemDetail.directoryTraversal=Travesía de directorios detectada. La ruta base es {0}, pero la ruta real es {1}.\nproblemDetail.plugin.version.unsatisfied.requires=El complemento requiere una versión mínima del sistema de {0}, pero la versión actual es {1}.\nproblemDetail.plugin.missingManifest=Falta el archivo de manifiesto del complemento \"plugin.yaml\" o el archivo no cumple con las especificaciones.\nproblemDetail.internalServerError=Algo salió mal, por favor inténtalo de nuevo más tarde.\nproblemDetail.conflict=Conflicto detectado, por favor revisa los datos e inténtalo de nuevo.\nproblemDetail.migration.backup.notFound=El archivo de respaldo no existe o ha sido eliminado.\nproblemDetail.attachment.upload.fileSizeExceeded=Asegúrate de que el tamaño del archivo sea inferior a {0}.\nproblemDetail.attachment.upload.fileTypeNotSupported=Carga no soportada para archivos de tipo {0}.\nproblemDetail.attachment.upload.fileTypeNotMatch=El tipo de archivo {0} no coincide con la extensión del archivo y la carga ha sido rechazada.\nproblemDetail.comment.waitingForApproval=El comentario está esperando aprobación.\n\ntitle.visibility.identification.private=(Privado)\nsignup.error.confirm-password-not-match=La contraseña de confirmación no coincide con la contraseña.\nsignup.error.email-code.invalid=Código de correo electrónico inválido.\nsignup.error.email.already-taken=La dirección de correo electrónico ya está en uso.\n\nvalidation.error.email.pattern=El formato del correo electrónico es incorrecto\nvalidation.error.username.pattern=El nombre de usuario solo puede estar en minúsculas y solo puede contener letras, números, guiones y puntos, comenzando y terminando con caracteres.\nvalidation.error.password.pattern=La contraseña solo puede usar letras mayúsculas y minúsculas (A-Z, a-z), números (0-9) y los siguientes caracteres especiales: !@#$%^&*\nvalidation.error.password.size=La longitud de la contraseña debe estar entre {0} y {1}\n" }, { "path": "application/src/main/resources/config/i18n/messages_zh.properties", "content": "problemDetail.title.org.springframework.web.server.ServerWebInputException=请求参数有误\nproblemDetail.title.org.springframework.security.authentication.BadCredentialsException=无效凭据\nproblemDetail.title.run.halo.app.infra.exception.UnsatisfiedAttributeValueException=请求参数属性值不满足要求\nproblemDetail.title.run.halo.app.infra.exception.PluginInstallationException=插件安装失败\nproblemDetail.title.run.halo.app.infra.exception.AttachmentAlreadyExistsException=附件已存在\nproblemDetail.title.run.halo.app.infra.exception.FileTypeNotAllowedException=文件类型不允许\nproblemDetail.title.run.halo.app.infra.exception.FileSizeExceededException=文件大小超出限制\nproblemDetail.title.run.halo.app.infra.exception.RequestRestrictedException=请求受限\nproblemDetail.title.run.halo.app.infra.exception.DuplicateNameException=名称重复\nproblemDetail.title.run.halo.app.infra.exception.PluginAlreadyExistsException=插件已存在\nproblemDetail.title.run.halo.app.infra.exception.ThemeInstallationException=主题安装失败\nproblemDetail.title.run.halo.app.infra.exception.ThemeAlreadyExistsException=主题已存在\nproblemDetail.title.run.halo.app.infra.exception.RateLimitExceededException=请求限制\nproblemDetail.title.run.halo.app.infra.exception.NotFoundException=资源不存在\nproblemDetail.title.run.halo.app.infra.exception.EmailVerificationFailed=邮箱验证失败\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$CyclicException=循环依赖\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$NotFoundException=依赖未找到\nproblemDetail.title.run.halo.app.infra.exception.PluginDependencyException$WrongVersionsException=依赖版本错误\nproblemDetail.title.run.halo.app.infra.exception.PluginDependentsNotDisabledException=子插件未禁用\nproblemDetail.title.run.halo.app.infra.exception.PluginDependenciesNotEnabledException=依赖未启用\nproblemDetail.title.run.halo.app.infra.exception.OAuth2UserAlreadyBoundException=用户已绑定错误\nproblemDetail.title.run.halo.app.infra.exception.PluginRuntimeIncompatibleException=插件运行时不兼容\nproblemDetail.title.run.halo.app.infra.exception.RestrictedNameException=名称受限\n\nproblemDetail.title.internalServerError=服务器内部错误\nproblemDetail.title.conflict=冲突\n\nproblemDetail.org.springframework.security.authentication.BadCredentialsException=用户名或密码错误。\nproblemDetail.run.halo.app.infra.exception.AttachmentAlreadyExistsException=文件 {0} 已存在，建议更名后重试。\nproblemDetail.run.halo.app.infra.exception.DuplicateNameException=检测到有重复的名称，请重命名后重试。\nproblemDetail.run.halo.app.infra.exception.PluginAlreadyExistsException=插件 {0} 已经存在。\nproblemDetail.run.halo.app.infra.exception.RateLimitExceededException=请求过于频繁，请稍候再试。\nproblemDetail.run.halo.app.infra.exception.EmailVerificationFailed=验证码错误或已失效。\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$CyclicException=检测到循环依赖。\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$NotFoundException=依赖“{0}”未找到。\nproblemDetail.run.halo.app.infra.exception.PluginDependencyException$WrongVersionsException=依赖版本有误：{0}。\nproblemDetail.run.halo.app.infra.exception.PluginDependentsNotDisabledException=子插件 {0} 未完全禁用，请先禁用它们。\nproblemDetail.run.halo.app.infra.exception.PluginDependenciesNotEnabledException=插件依赖 {0} 未完全启用，请先启用它们。\nproblemDetail.run.halo.app.infra.exception.OAuth2UserAlreadyBoundException=用户 {0} 已经绑定到另一个 OAuth2 用户，无法自动绑定当前 OAuth2 用户。\nproblemDetail.run.halo.app.infra.exception.PluginRuntimeIncompatibleException=插件和当前 Halo 运行时不兼容，请升级插件或降级 Halo 运行时。\n\nproblemDetail.index.duplicateKey=唯一索引 {1} 中的值 {0} 已存在，请更名后重试。\nproblemDetail.user.email.verify.maxAttempts=尝试次数过多，请稍候再试。\nproblemDetail.user.email.verify.emailInUse=邮箱已被使用, 请更换邮箱后重试。\nproblemDetail.user.password.unsatisfied=密码不符合规范。\nproblemDetail.user.username.unsatisfied=用户名不符合规范。\nproblemDetail.user.oldPassword.notMatch=旧密码不匹配。\nproblemDetail.user.password.notMatch=密码不匹配。\nproblemDetail.user.signUpFailed.disallowed=系统不允许注册新用户。\nproblemDetail.user.duplicateName=用户名 {0} 已存在，请更换用户名后重试。\nproblemDetail.user.displayName.restricted=显示名称 {0} 为保留名称，请更换后重试。\nproblemDetail.plugin.version.unsatisfied.requires=插件要求一个最小的系统版本为 {0}, 但当前版本为 {1}。\nproblemDetail.plugin.missingManifest=缺少 plugin.yaml 配置文件或配置文件不符合规范。\nproblemDetail.theme.version.unsatisfied.requires=主题要求一个最小的系统版本为 {0}, 但当前版本为 {1}。\nproblemDetail.theme.install.missingManifest=缺少 theme.yaml 配置文件或配置文件不符合规范。\nproblemDetail.theme.install.alreadyExists=主题 {0} 已存在。\nproblemDetail.internalServerError=服务器内部发生错误，请稍候再试。\nproblemDetail.conflict=检测到冲突，请检查数据后重试。\nproblemDetail.migration.backup.notFound=备份文件不存在或已删除。\nproblemDetail.attachment.upload.fileSizeExceeded=最大支持上传 {0} 大小的文件。\nproblemDetail.attachment.upload.fileTypeNotSupported=不支持上传 {0} 类型的文件。\nproblemDetail.attachment.upload.fileTypeNotMatch=文件类型 {0} 与文件扩展名不匹配，上传被拒绝。\nproblemDetail.comment.waitingForApproval=评论审核中。\n\ntitle.visibility.identification.private=（私有）\nsignup.error.confirm-password-not-match=确认密码与密码不匹配。\nsignup.error.email-code.invalid=邮箱验证码无效。\nsignup.error.email.already-taken=邮箱地址已被注册。\n\nvalidation.error.email.pattern=邮箱格式不正确\nvalidation.error.username.pattern=用户名只能小写且只能包含字母、数字、中划线和点，以字符开头和结尾\nvalidation.error.password.pattern=密码只能使用大小写字母 (A-Z, a-z)、数字 (0-9)，以及以下特殊字符: !@#$%^&*.?\nvalidation.error.password.size=密码长度必须在 {0} 到 {1} 之间\n" }, { "path": "application/src/main/resources/db/migration/h2/.gitkeep", "content": "" }, { "path": "application/src/main/resources/db/migration/mariadb/.gitkeep", "content": "" }, { "path": "application/src/main/resources/db/migration/mysql/.gitkeep", "content": "" }, { "path": "application/src/main/resources/db/migration/postgresql/.gitkeep", "content": "" }, { "path": "application/src/main/resources/extensions/attachment-local-policy.yaml", "content": "apiVersion: storage.halo.run/v1alpha1\nkind: PolicyTemplate\nmetadata:\n name: local\nspec:\n displayName: 本地存储\n settingName: local-policy-template-setting\n---\napiVersion: storage.halo.run/v1alpha1\nkind: Policy\nmetadata:\n name: default-policy\n finalizers:\n - system-protection\nspec:\n displayName: 本地存储\n templateName: local\n configMapName: default-policy-config\n---\napiVersion: v1alpha1\nkind: ConfigMap\nmetadata:\n name: default-policy-config\n labels:\n storage.halo.run/policy-owner: default-policy\n halo.run/do-not-overwrite: \"true\"\ndata:\n default: \"{\\\"location\\\":\\\"\\\"}\"\n---\napiVersion: v1alpha1\nkind: Setting\nmetadata:\n name: local-policy-template-setting\nspec:\n forms:\n - group: default\n label: Default\n formSchema:\n - $formkit: text\n name: location\n label: 存储位置\n help: ~/.halo2/attachments/upload 下的子目录\n - $formkit: text\n name: maxFileSize\n label: 最大单文件大小\n validation: [ [ 'matches', '/^(0|[1-9]\\d*)(?:[KMG]B)?$/' ] ]\n validation-visibility: \"live\"\n validation-messages:\n matches: \"输入格式错误，遵循：整数 + 大写的单位（KB, MB, GB）\"\n help: \"0 表示不限制，示例：5KB、10MB、1GB\"\n - $formkit: checkbox\n name: allowedFileTypes\n label: 文件类型限制\n help: 限制允许上传的文件类型\n options:\n - label: 无限制\n value: ALL\n - label: 图片\n value: IMAGE\n - label: SVG\n value: SVG\n - label: 视频\n value: VIDEO\n - label: 音频\n value: AUDIO\n - label: 文档\n value: DOCUMENT\n - label: 压缩包\n value: ARCHIVE\n - $formkit: checkbox\n name: alwaysRenameFilename\n id: alwaysRenameFilename\n label: 是否总是重命名文件名\n help: 勾选后上传后的文件名将被重命名\n value: false\n - $formkit: group\n if: $get(alwaysRenameFilename).value\n id: renameStrategy\n name: renameStrategy\n label: 重命名策略\n value:\n method: RANDOM\n randomLength: 32\n children:\n - $formkit: radio\n name: method\n label: 重命名方法\n options:\n - label: 随机字符串\n value: RANDOM\n - label: UUID\n value: UUID\n - label: 时间戳（毫秒级）\n value: TIMESTAMP\n - $formkit: number\n number: integer\n if: \"$value.method === RANDOM\"\n name: randomLength\n id: randomLength\n label: 随机文件名长度\n help: 默认值为 32。因为文件名的长度限制，随机文件名的长度范围为 [8, 64]。\n validation: \"between:8,64\"\n validation-visibility: live\n min: 8\n max: 64\n - $formkit: checkbox\n name: excludeOriginalFilename\n label: 是否排除原始文件名\n help: 勾选后重命名后的文件名将不包含原始文件名\n---\napiVersion: storage.halo.run/v1alpha1\nkind: Group\nmetadata:\n name: user-avatar-group\n labels:\n halo.run/hidden: \"true\"\n finalizers:\n - system-protection\nspec:\n displayName: UserAvatar" }, { "path": "application/src/main/resources/extensions/authproviders.yaml", "content": "apiVersion: auth.halo.run/v1alpha1\nkind: AuthProvider\nmetadata:\n name: local\n labels:\n auth.halo.run/auth-binding: \"false\"\n auth.halo.run/privileged: \"true\"\n finalizers:\n - system-protection\nspec:\n displayName: Local\n description: Built-in authentication for Halo.\n logo: /images/login-methods/login-with-credentials.svg\n website: https://www.halo.run\n authenticationUrl: /login\n method: post\n rememberMeSupport: true\n authType: form" }, { "path": "application/src/main/resources/extensions/extension-definitions.yaml", "content": "## TODO: Currently, Halo does not support i18n for configuration file descriptions\n## So Simplified Chinese is temporarily used as the default description language.\n\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: username-password-logout-handler\n labels:\n auth.halo.run/extension-point-name: \"additional-webfilter\"\nspec:\n className: run.halo.app.security.authentication.login.UsernamePasswordLogoutHandler\n extensionPointName: additional-webfilter\n displayName: \"用户名密码注销处理器\"\n description: \"用于用户名和密码认证的注销处理器\"\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: delegating-logout-page-generating-webfilter\n labels:\n auth.halo.run/extension-point-name: \"additional-webfilter\"\nspec:\n className: run.halo.app.security.authentication.login.DelegatingLogoutPageGeneratingWebFilter\n extensionPointName: additional-webfilter\n displayName: \"注销页面生成过滤器\"\n description: \"用于生成默认的注销页面\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: halo-email-notifier\nspec:\n className: run.halo.app.notification.EmailNotifier\n extensionPointName: reactive-notifier\n displayName: \"邮件通知器\"\n description: \"支持通过电子邮件向用户发送通知\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: search-engine-lucene\nspec:\n className: run.halo.app.search.lucene.LuceneSearchEngine\n extensionPointName: search-engine\n displayName: \"Lucene 搜索引擎\"\n description: \"Halo 自带的本地搜索引擎\"\n icon: /images/extension-points/lucene.png\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: post-content-thumbnail-handler\nspec:\n className: run.halo.app.content.PostContentThumbnailHandler\n extensionPointName: reactive-post-content-handler\n displayName: \"文章内容缩略图处理\"\n description: \"处理文章的 HTML 内容为 img 标签追加缩略图\"\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: page-content-thumbnail-handler\nspec:\n className: run.halo.app.content.PageContentThumbnailHandler\n extensionPointName: reactive-page-content-handler\n displayName: \"自定义页面内容缩略图处理\"\n description: \"处理页面的 HTML 内容为 img 标签追加缩略图\"\n" }, { "path": "application/src/main/resources/extensions/extensionpoint-definitions.yaml", "content": "## TODO: Currently, Halo does not support i18n for configuration file descriptions\n## So Simplified Chinese is temporarily used as the default description language.\n\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: additional-webfilter\nspec:\n className: run.halo.app.security.AdditionalWebFilter\n displayName: \"附加 Web 过滤器\"\n type: MULTI_INSTANCE\n description: \"用于 Web 请求的链式处理，可以用来实现跨领域、与应用无关的需求，如安全性、超时等\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: reactive-post-content-handler\nspec:\n className: run.halo.app.theme.ReactivePostContentHandler\n displayName: \"文章内容处理器\"\n type: MULTI_INSTANCE\n description: \"扩展在主题侧显示的文章内容\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: reactive-singlepage-content-handler\nspec:\n className: run.halo.app.theme.ReactiveSinglePageContentHandler\n displayName: \"页面内容处理器\"\n type: MULTI_INSTANCE\n description: \"扩展在主题侧显示的页面内容\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: comment-widget\nspec:\n className: run.halo.app.theme.dialect.CommentWidget\n displayName: \"评论组件\"\n type: SINGLETON\n description: \"扩展在文章页面中显示的评论组件\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: username-password-authentication-manager\nspec:\n className: run.halo.app.security.authentication.login.UsernamePasswordAuthenticationManager\n displayName: \"用户名密码认证管理器\"\n type: SINGLETON\n description: \"扩展用户名密码认证\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: reactive-notifier\nspec:\n className: run.halo.app.notification.ReactiveNotifier\n displayName: \"消息通知器\"\n type: MULTI_INSTANCE\n description: \"扩展消息通知器，以向用户发送通知\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: search-engine\nspec:\n className: run.halo.app.search.SearchEngine\n displayName: \"搜索引擎\"\n type: SINGLETON\n description: \"扩展内容搜索引擎\"\n\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: template-footer-processor\nspec:\n className: run.halo.app.theme.dialect.TemplateFooterProcessor\n displayName: 页脚标签内容处理器\n type: MULTI_INSTANCE\n description: \"提供用于扩展 标签内容的扩展方式。\"\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: excerpt-generator\nspec:\n className: run.halo.app.content.ExcerptGenerator\n displayName: 摘要生成器\n type: SINGLETON\n description: \"提供自动生成摘要的方式扩展，如使用算法提取或使用 AI 生成。\"\n---\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionPointDefinition\nmetadata:\n name: thumbnail-provider\nspec:\n className: run.halo.app.core.attachment.ThumbnailProvider\n displayName: 图片缩略图生成\n type: MULTI_INSTANCE\n description: \"提供生成图片缩略图的扩展方式\"\n" }, { "path": "application/src/main/resources/extensions/notification-templates.yaml", "content": "apiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-new-comment-on-post\nspec:\n reasonSelector:\n reasonType: new-comment-on-post\n language: default\n template:\n title: \"[(${commenter})] 评论了你的文章《[(${postTitle})]》\"\n rawBody: |\n [(${subscriber.displayName})] 你好：\n\n [(${commenter})] 评论了你的文章 《[(${postTitle})]》，以下是评论的具体内容：\n\n [(${content})]\n htmlBody: |\n
\n
\n

\n
\n
\n

\n 评论了你的文章\n \n ，以下是评论的具体内容：\n

\n
\n
\n
\n
\n\n---\napiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-new-comment-on-single-page\nspec:\n reasonSelector:\n reasonType: new-comment-on-single-page\n language: default\n template:\n title: \"[(${commenter})] 评论了你的页面《[(${pageTitle})]》\"\n rawBody: |\n [(${subscriber.displayName})] 你好：\n\n [(${commenter})] 评论了你的页面 《[(${pageTitle})]》，以下是评论的具体内容：\n\n [(${content})]\n htmlBody: |\n
\n
\n

\n
\n
\n

\n 评论了你的页面\n \n ，以下是评论的具体内容：\n

\n
\n
\n
\n
\n\n---\napiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-someone-replied-to-you\nspec:\n reasonSelector:\n reasonType: someone-replied-to-you\n language: default\n template:\n title: \"[(${replier})] 在评论中回复了你\"\n rawBody: |\n [(${subscriber.displayName})] 你好：\n\n [(${replier})] 在评论“[(${isQuoteReply ? quoteContent : commentContent})]”中回复了你，以下是回复的具体内容：\n\n [(${content})]\n htmlBody: |\n
\n
\n

\n
\n
\n

\n 在\n \n 中回复了你。\n

\n

你的评论：

\n
\n

回复的内容：

\n
\n
\n
\n
\n---\napiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-email-verification\nspec:\n reasonSelector:\n reasonType: email-verification\n language: default\n template:\n title: \"邮箱验证-[(${site.title})]\"\n rawBody: |\n 【[(${site.title})]】你的邮箱验证码是：[(${code})]，请在 [(${expirationAtMinutes})] 分钟内完成验证。\n htmlBody: |\n
\n
\n

\n
\n
\n

使用下面的动态验证码（OTP）验证您的电子邮件地址。

\n
\n \n
\n

\n

如果您没有尝试验证您的电子邮件地址，请忽略此电子邮件。

\n
\n
\n---\napiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-reset-password-by-email\nspec:\n reasonSelector:\n reasonType: reset-password-by-email\n language: default\n template:\n title: \"重置密码-[(${site.title})]\"\n rawBody: |\n 【[(${site.title})]】你已经请求了重置密码，可以链接来重置密码：[(${link})]，请在 [(${expirationAtMinutes})] 分钟内完成重置。\n htmlBody: |\n
\n
\n

\n
\n
\n

你已经请求了重置密码，可以点击下面的链接来重置密码：

\n
\n \n
\n

\n

如果您没有请求重置密码，请忽略此电子邮件。

\n
\n
\n---\napiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-new-device-login\nspec:\n reasonSelector:\n reasonType: new-device-login\n language: default\n template:\n title: \"你的 [(${site.title})] 账号被用于在 [(${os})] 上登录\"\n rawBody: |\n [(${subscriber.displayName})] 你好：\n\n 你的 [(${site.title})] 账号被用于在 [(${os})] 的 [(${browser})] 上登录。\n 时间：[(${loginTime})]\n IP 地址：[(${ipAddress})] \n 如果你知悉上述信息，请忽略此电子邮件。\n 如果你最近没有使用你的 Halo 账号登录并相信有人可能访问了你的账户，请尽快重设你的密码。\n htmlBody: |\n
\n
\n

\n
\n
\n

\n
\n

\n

\n
\n

如果你知悉上述信息，请忽略此电子邮件。

\n

\n
\n
\n" }, { "path": "application/src/main/resources/extensions/notification.yaml", "content": "apiVersion: notification.halo.run/v1alpha1\nkind: NotifierDescriptor\nmetadata:\n name: default-email-notifier\nspec:\n displayName: '邮件通知'\n description: '通过邮件将通知发送给用户'\n notifierExtName: 'halo-email-notifier'\n senderSettingRef:\n name: 'notifier-setting-for-email'\n group: 'sender'\n---\napiVersion: v1alpha1\nkind: Setting\nmetadata:\n name: notifier-setting-for-email\nspec:\n forms:\n - group: sender\n label: 发件设置\n formSchema:\n - $formkit: checkbox\n label: \"启用邮件通知器\"\n value: false\n name: enable\n - $formkit: verificationForm\n if: \"$enable\"\n action: /apis/console.api.notification.halo.run/v1alpha1/notifiers/default-email-notifier/verify-connection\n label: 测试邮箱\n children:\n - $formkit: text\n label: \"用户名\"\n name: username\n validation: required\n - $formkit: text\n if: \"$enable\"\n label: \"发信地址\"\n name: \"sender\"\n help: \"如果用户名为实际发信地址，可忽略\"\n - $formkit: password\n label: \"密码\"\n name: password\n validation: required\n - $formkit: text\n label: \"显示名称\"\n name: displayName\n - $formkit: text\n label: \"SMTP 服务器地址\"\n name: host\n validation: required\n - $formkit: text\n label: \"端口号\"\n name: port\n validation: required\n - $formkit: select\n label: \"加密方式\"\n name: encryption\n value: \"SSL\"\n options:\n - label: \"SSL\"\n value: \"SSL\"\n - label: \"TLS\"\n value: \"TLS\"\n - label: \"不加密\"\n value: \"NONE\"\n---\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: new-comment-on-post\n annotations:\n rbac.authorization.halo.run/ui-permissions: |\n [ \"uc:posts:publish\" ]\nspec:\n displayName: \"我的文章收到新评论\"\n description: \"如果有读者在你的文章下方留下了新的评论，你将会收到一条通知，告诉你有新的评论。\n 这个通知事件可以帮助你及时了解读者对你的文章的反馈，以便你更好地与读者互动，提高文章的质量和受欢迎程度。\"\n properties:\n - name: postName\n type: string\n description: \"The name of the post.\"\n - name: postOwner\n type: string\n description: \"The user name of the post owner.\"\n - name: postTitle\n type: string\n - name: postUrl\n type: string\n - name: commenter\n type: string\n description: \"The display name of the commenter.\"\n - name: commentName\n type: string\n description: \"The name of the comment.\"\n - name: content\n type: string\n description: \"The content of the comment.\"\n---\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: new-comment-on-single-page\n annotations:\n rbac.authorization.halo.run/ui-permissions: |\n [ \"system:singlepages:manage\" ]\nspec:\n displayName: \"我的自定义页面收到新评论\"\n description: \"当你创建的自定义页面收到新评论时，你将会收到一条通知，告诉你有新的评论。\"\n properties:\n - name: pageName\n type: string\n description: \"The name of the single page.\"\n - name: pageOwner\n type: string\n description: \"The user name of the page owner.\"\n - name: pageTitle\n type: string\n - name: pageUrl\n type: string\n - name: commenter\n type: string\n description: \"The display name of the commenter.\"\n - name: commentName\n type: string\n description: \"The name of the comment.\"\n - name: content\n type: string\n description: \"The content of the comment.\"\n---\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: someone-replied-to-you\nspec:\n displayName: \"有人回复了我\"\n description: \"如果有其他用户回复了你的评论，你将会收到一条通知，告诉你有人回复了你。\"\n properties:\n - name: commentName\n type: string\n description: \"The name of the comment.\"\n - name: commentSubjectTitle\n type: string\n - name: commentSubjectUrl\n type: string\n - name: quoteContent\n type: string\n optional: true\n description: \"The content of quoted reply.\"\n - name: isQuoteReply\n type: boolean\n - name: commentContent\n type: string\n - name: repliedOwner\n type: string\n description: \"The owner of the comment or reply that has been replied to.\"\n - name: replyOwner\n type: string\n description: \"The user who created the current reply.\"\n - name: replier\n type: string\n description: \"The display name of the replier.\"\n - name: replyName\n type: string\n description: \"The name of the reply.\"\n - name: content\n type: string\n description: \"The content of the reply.\"\n---\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: email-verification\n labels:\n halo.run/hidden: \"true\"\nspec:\n displayName: \"邮箱验证\"\n description: \"当你的邮箱被用于注册账户时，会收到一条带有验证码的邮件，你需要点击邮件中的链接来验证邮箱是否属于你。\"\n properties:\n - name: username\n type: string\n description: \"The username of the user.\"\n - name: code\n type: string\n description: \"The verification code.\"\n - name: expirationAtMinutes\n type: string\n description: \"The expiration minutes of the verification code, such as 5 minutes.\"\n---\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: reset-password-by-email\n labels:\n halo.run/hidden: \"true\"\nspec:\n displayName: \"根据邮件地址重置密码\"\n description: \"当你通过邮件地址找回密码时，会收到一条带密码重置链接的邮件，你需要点击邮件中的链接来重置密码。\"\n properties:\n - name: username\n type: string\n description: \"The username of the user.\"\n - name: link\n type: string\n description: \"The reset link.\"\n - name: expirationAtMinutes\n type: string\n description: \"The expiration minutes of the reset link, such as 30 minutes.\"\n---\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: new-device-login\nspec:\n displayName: \"新设备登录\"\n description: \"当你的账户在新设备上登录时，你会收到一条通知，告诉你有新设备登录了你的账户。\"\n properties:\n - name: os\n type: string\n description: \"The operating system of the device.\"\n - name: browser\n type: string\n description: \"The browser of the device.\"\n - name: ipAddress\n type: string\n description: \"The IP address of the device.\"\n - name: loginTime\n type: string\n description: \"The login time of the device.\"\n - name: principalName\n type: string\n description: \"The principal name of the device.\"" }, { "path": "application/src/main/resources/extensions/role-template-actuator.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-actuator\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Actuator Management\"\n rbac.authorization.halo.run/display-name: \"Actuator Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:actuator:manage\"]\nrules:\n - nonResourceURLs: [ \"actuator\", \"/actuator/*\" ]\n verbs: [ \"get\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-anonymous.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: anonymous\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-own-permissions\", \"role-template-public-apis\" ]\nrules:\n - apiGroups: [ \"api.halo.run\" ]\n resources: [ \"comments\", \"comments/reply\" ]\n verbs: [ \"create\", \"get\", \"list\" ]\n - apiGroups: [ \"api.halo.run\" ]\n resources: [ \"*\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"get\" ]\n - nonResourceURLs: [ \"/apis/api.halo.run/v1alpha1/trackers/*\" ]\n verbs: [ \"create\" ]\n - nonResourceURLs: [ \"/actuator/globalinfo\", \"/actuator/health\", \"/actuator/health/*\", \"/login/public-key\" ]\n verbs: [ \"get\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-public-apis\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"api.halo.run\" ]\n resources: [ \"*\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.content.halo.run\" ]\n resources: [ \"*\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.plugin.halo.run\" ]\n resources: [ \"*\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.notification.halo.run\" ]\n resources: [ \"subscriptions/unsubscribe\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.storage.halo.run\" ]\n resources: [ \"thumbnails/via-uri\" ]\n verbs: [ \"get\", \"list\" ]" }, { "path": "application/src/main/resources/extensions/role-template-attachment.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-attachments\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-attachments\\\" ]\"\n rbac.authorization.halo.run/module: \"Attachments Management\"\n rbac.authorization.halo.run/display-name: \"Attachment Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:attachments:manage\"]\nrules:\n - apiGroups: [ \"storage.halo.run\" ]\n resources: [ \"attachments\", \"policies\", \"policytemplates\", \"groups\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"attachments\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"attachments/upload-from-url\" ]\n verbs: [ \"create\" ]\n - apiGroups: [ \"\" ]\n resources: [ \"settings\" ]\n verbs: [ \"get\" ]\n - nonResourceURLs: [\n \"/apis/api.console.halo.run/v1alpha1/attachments/upload\"\n ]\n verbs: [ \"create\" ]\n - apiGroups: [ \"console.api.storage.halo.run\" ]\n resources: [ \"attachments/upload\" ]\n verbs: [ \"create\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-attachments\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Attachments Management\"\n rbac.authorization.halo.run/display-name: \"Attachment View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:attachments:view\"]\nrules:\n - apiGroups: [ \"storage.halo.run\" ]\n resources: [ \"attachments\", \"policies\", \"policytemplates\", \"groups\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"attachments\" ]\n verbs: [ \"get\", \"list\" ]" }, { "path": "application/src/main/resources/extensions/role-template-authenticated.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: authenticated\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \n \"role-template-own-user-info\",\n \"role-template-own-permissions\",\n \"role-template-change-own-password\",\n \"role-template-stats\",\n \"role-template-annotation-setting\",\n \"role-template-manage-own-pat\",\n \"role-template-manage-own-authentications\",\n \"role-template-user-notification\"\n ]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"configmaps\" ]\n resourceNames: [ \"system-states\" ]\n verbs: [ \"get\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"auth-providers\" ]\n verbs: [ \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"plugins/bundle.js\", \"plugins/bundle.css\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"get\" ]\n - apiGroups: [ \"uc.api.auth.halo.run\" ]\n resources: [ \"user-connections/disconnect\" ]\n verbs: [ \"update\" ]\n - apiGroups: [ \"uc.api.halo.run\" ]\n resources: [ \"user-preferences\", \"annotationsettings\" ]\n verbs: [ \"get\", \"list\", \"update\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-own-user-info\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"get\", \"update\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/avatar\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"create\", \"delete\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/send-email-verification-code\", \"users/verify-email\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"create\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-own-permissions\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/permissions\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"list\", \"get\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-change-own-password\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/password\" ]\n resourceNames: [ \"-\" ]\n verbs: [ \"update\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-stats\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"stats\" ]\n verbs: [ \"get\", \"list\" ]\n\n---\napiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-annotation-setting\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"annotationsettings\" ]\n verbs: [ \"get\", \"list\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-own-pat\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"uc.api.security.halo.run\" ]\n resources: [ \"personalaccesstokens\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"uc.api.security.halo.run\" ]\n resources: [ \"personalaccesstokens/actions\" ]\n verbs: [ \"update\" ]\n\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-own-authentications\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"uc.api.security.halo.run\" ]\n resources: [ \"authentications\", \"authentications/totp\", \"authentications/settings\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"uc.api.security.halo.run\" ]\n resources: [ \"devices\" ]\n verbs: [ \"get\", \"list\", \"delete\" ]\n---\napiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-user-notification\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"api.notification.halo.run\" ]\n resources: [ \"notifications\" ]\n verbs: [ \"get\", \"list\", \"delete\" ]\n - apiGroups: [ \"api.notification.halo.run\" ]\n resources: [ \"notifications/mark-as-read\", \"notifications/mark-specified-as-read\" ]\n verbs: [ \"update\" ]\n - apiGroups: [ \"api.notification.halo.run\" ]\n resources: [ \"notifiers/receiver-config\" ]\n verbs: [ \"get\", \"update\" ]\n - apiGroups: [ \"api.notification.halo.run\" ]\n resources: [ \"notification-preferences\" ]\n verbs: [ \"create\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-cache.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-cache\n deletionTimestamp: 2024-06-01T00:00:00Z\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Cache Management\"\n rbac.authorization.halo.run/display-name: \"Cache Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:caches:manage\"]\nrules:\n - apiGroups: [\"api.console.halo.run\"]\n resources: [\"caches\"]\n verbs: [\"delete\"]\n" }, { "path": "application/src/main/resources/extensions/role-template-category.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-categories\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-categories\\\" ]\"\n rbac.authorization.halo.run/ui-permissions: |\n [ \"system:categories:manage\", \"uc:categories:manage\" ]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"categories\" ]\n verbs: [ \"*\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-categories\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/ui-permissions: |\n [ \"system:categories:view\", \"uc:categories:view\" ]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"categories\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-comment.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-comments\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-comments\\\" ]\"\n rbac.authorization.halo.run/module: \"Comments Management\"\n rbac.authorization.halo.run/display-name: \"Comment Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:comments:manage\"]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"comments\", \"replies\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"comments\", \"comments/reply\", \"replies\" ]\n verbs: [ \"*\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-comments\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Comments Management\"\n rbac.authorization.halo.run/display-name: \"Comment View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:comments:view\"]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"comments\", \"replies\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"comments\", \"comments/reply\", \"replies\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-configmap.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-configmaps\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-configmaps\\\" ]\"\n rbac.authorization.halo.run/module: \"ConfigMaps Management\"\n rbac.authorization.halo.run/display-name: \"ConfigMap Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:configmaps:manage\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"configmaps\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-configmaps\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"ConfigMaps Management\"\n rbac.authorization.halo.run/display-name: \"ConfigMap View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:configmaps:view\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"configmaps\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-menu.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-menus\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-menus\\\" ]\"\n rbac.authorization.halo.run/module: \"Menus Management\"\n rbac.authorization.halo.run/display-name: \"Menu Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:menus:manage\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"menus\", \"menuitems\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"console.api.halo.run\" ]\n resources: [ \"systemconfigs\" ]\n resourceNames: [ \"menu\" ]\n verbs: [ \"update\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-menus\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Menus Management\"\n rbac.authorization.halo.run/display-name: \"Menu View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:menus:view\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"menus\", \"menuitems\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"console.api.halo.run\" ]\n resources: [ \"systemconfigs\" ]\n resourceNames: [ \"menu\" ]\n verbs: [ \"get\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-migration.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-migration\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Migration Management\"\n rbac.authorization.halo.run/display-name: \"Migration Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:migrations:manage\"]\nrules:\n - apiGroups: [ \"console.api.migration.halo.run\" ]\n resources: [ \"restorations\" ]\n verbs: [ \"create\" ]\n - apiGroups: [ \"console.api.migration.halo.run\" ]\n resources: [ \"backup-files\" ]\n verbs: [ \"list\" ]\n - apiGroups: [ \"console.api.migration.halo.run\" ]\n resources: [ \"backups/files\" ]\n verbs: [ \"get\" ]\n - apiGroups: [ \"migration.halo.run\" ]\n resources: [ \"backups\" ]\n verbs: [ \"list\", \"get\", \"create\", \"update\", \"delete\", \"patch\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-notification.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-notifier-config\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Notification Configuration\"\n rbac.authorization.halo.run/display-name: \"Configure Notifier\"\nrules:\n - apiGroups: [ \"notification.halo.run\" ]\n resources: [ \"notifierDescriptors\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"notifiers/sender-config\" ]\n verbs: [ \"get\", \"update\" ]\n - apiGroups: [ \"console.api.notification.halo.run\" ]\n resources: [ \"notifiers/verify-connection\" ]\n resourceNames: [ \"default-email-notifier\" ]\n verbs: [ \"create\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-permissions.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-permissions\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-permissions\\\" ]\"\n rbac.authorization.halo.run/module: \"Permissions Management\"\n rbac.authorization.halo.run/display-name: \"Permissions Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:permissions:manage\"]\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/permissions\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-permissions\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Permissions Management\"\n rbac.authorization.halo.run/display-name: \"Permissions View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:permissions:view\"]\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/permissions\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-plugin.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-plugins\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-view-plugins\" ]\n rbac.authorization.halo.run/module: \"Plugins Management\"\n rbac.authorization.halo.run/display-name: \"Plugin Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:plugins:manage\"]\nrules:\n - apiGroups: [ \"plugin.halo.run\" ]\n resources: [ \"plugins\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"plugins/upgrade\", \"plugins/resetconfig\", \"plugins/config\", \"plugins/json-config\",\n \"plugins/reload\", \"plugins/install-from-uri\", \"plugins/upgrade-from-uri\", \"plugins/plugin-state\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"plugin-presets\" ]\n verbs: [ \"list\" ]\n - nonResourceURLs: [ \"/apis/api.console.halo.run/v1alpha1/plugins/*\" ]\n verbs: [ \"create\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-plugins\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Plugins Management\"\n rbac.authorization.halo.run/display-name: \"Plugin View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:plugins:view\"]\nrules:\n - apiGroups: [ \"plugin.halo.run\" ]\n resources: [ \"plugins\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"plugins\", \"plugins/setting\", \"plugins/config\", \"plugins/json-config\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-post.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-posts\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-view-posts\", \"role-template-manage-snapshots\", \"role-template-manage-tags\", \"role-template-manage-categories\", \"role-template-post-author\" ]\n rbac.authorization.halo.run/module: \"Posts Management\"\n rbac.authorization.halo.run/display-name: \"Post Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:posts:manage\"]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"posts\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"posts\", \"posts/publish\", \"posts/unpublish\", \"posts/recycle\", \"posts/content\", \"indices/post\", \"posts/revert-content\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-posts\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-view-snapshots\", \"role-template-view-tags\", \"role-template-view-categories\" ]\n rbac.authorization.halo.run/module: \"Posts Management\"\n rbac.authorization.halo.run/display-name: \"Post View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:posts:view\"]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"posts\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"posts\", \"posts/head-content\", \"posts/release-content\", \"posts/snapshot\", \"posts/content\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-role.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-roles\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-view-roles\", \"role-template-manage-permissions\" ]\n rbac.authorization.halo.run/module: \"Roles Management\"\n rbac.authorization.halo.run/display-name: \"Role Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:roles:manage\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"roles\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-roles\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Roles Management\"\n rbac.authorization.halo.run/display-name: \"Role View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:roles:view\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"roles\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-setting.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-settings\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-settings\\\", \\\"role-template-notifier-config\\\" ]\"\n rbac.authorization.halo.run/module: \"Settings Management\"\n rbac.authorization.halo.run/display-name: \"Setting Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:settings:manage\", \"system:notifier:configuration\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"settings\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"auth-providers/enable\", \"auth-providers/disable\" ]\n verbs: [ \"update\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-settings\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Settings Management\"\n rbac.authorization.halo.run/display-name: \"Setting View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:settings:view\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"settings\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"auth-providers\" ]\n verbs: [ \"get\", \"list\" ]" }, { "path": "application/src/main/resources/extensions/role-template-singlepage.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-singlepages\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-singlepages\\\", \\\"role-template-manage-snapshots\\\" ]\"\n rbac.authorization.halo.run/module: \"SinglePages Management\"\n rbac.authorization.halo.run/display-name: \"SinglePage Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:singlepages:manage\"]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"singlepages\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"singlepages\", \"singlepages/publish\", \"singlepages/content\", \"singlepages/revert-content\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-singlepages\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-snapshots\\\" ]\"\n rbac.authorization.halo.run/module: \"SinglePages Management\"\n rbac.authorization.halo.run/display-name: \"SinglePage View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:singlepages:view\"]\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"singlepages\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"singlepages\", \"singlepages/head-content\", \"singlepages/release-content\", \"singlepages/snapshot\", \"singlepages/content\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-snapshot.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-snapshots\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-snapshots\\\" ]\"\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"snapshots\" ]\n verbs: [ \"*\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-snapshots\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"snapshots\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-tag.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-tags\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-tags\\\" ]\"\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"tags\" ]\n verbs: [ \"*\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-tags\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\nrules:\n - apiGroups: [ \"content.halo.run\" ]\n resources: [ \"tags\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"tags\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-theme.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-themes\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: \"[ \\\"role-template-view-themes\\\" ]\"\n rbac.authorization.halo.run/module: \"Themes Management\"\n rbac.authorization.halo.run/display-name: \"Theme Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:themes:manage\"]\nrules:\n - apiGroups: [ \"theme.halo.run\" ]\n resources: [ \"themes\" ]\n verbs: [ \"*\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"themes\", \"themes/reload\", \"themes/resetconfig\", \"themes/config\", \"themes/json-config\",\n \"themes/activation\", \"themes/install-from-uri\", \"themes/upgrade-from-uri\", \"themes/invalidate-cache\" ]\n verbs: [ \"*\" ]\n - nonResourceURLs: [ \"/apis/api.console.halo.run/themes/install\" ]\n verbs: [ \"create\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-themes\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Themes Management\"\n rbac.authorization.halo.run/display-name: \"Theme View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:themes:view\"]\nrules:\n - apiGroups: [ \"theme.halo.run\" ]\n resources: [ \"themes\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"themes\", \"themes/activation\", \"themes/setting\", \"themes/config\", \"themes/json-config\" ]\n verbs: [ \"get\", \"list\" ]\n\n" }, { "path": "application/src/main/resources/extensions/role-template-uc-attachment.yaml", "content": "apiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-uc-attachment-manager\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Attachments Management\"\n rbac.authorization.halo.run/display-name: \"UC Attachment Manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [ \"uc:attachments:manage\" ]\nrules:\n - apiGroups: [ \"uc.api.storage.halo.run\" ]\n resources: [ \"attachments\", \"attachments/upload\", \"attachments/upload-from-url\" ]\n verbs: [ \"create\", \"list\" ]\n" }, { "path": "application/src/main/resources/extensions/role-template-uc-content.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: post-editor\n labels:\n rbac.authorization.halo.run/system-reserved: \"true\"\n annotations:\n # Currently, yaml definition does not support i18n, please see https://github.com/halo-dev/halo/issues/3573\n rbac.authorization.halo.run/display-name: \"文章管理员\"\n rbac.authorization.halo.run/dependencies: |\n [\"role-template-manage-posts\"]\nrules: [ ]\n\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: post-author\n labels:\n rbac.authorization.halo.run/system-reserved: \"true\"\n annotations:\n # Currently, yaml definition does not support i18n, please see https://github.com/halo-dev/halo/issues/3573\n rbac.authorization.halo.run/display-name: \"作者\"\n rbac.authorization.halo.run/disallow-access-console: \"true\"\n rbac.authorization.halo.run/redirect-on-login: \"/uc\"\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-post-author\" ]\nrules: [ ]\n\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-post-author\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Posts Management\"\n # Currently, yaml definition does not support i18n, please see https://github.com/halo-dev/halo/issues/3573\n rbac.authorization.halo.run/display-name: \"Post Author\"\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-post-contributor\", \"role-template-post-publisher\", \"role-template-recycle-my-post\",\n \"role-template-uc-attachment-manager\" ]\nrules: [ ]\n\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: post-contributor\n labels:\n rbac.authorization.halo.run/system-reserved: \"true\"\n annotations:\n # Currently, yaml definition does not support i18n, please see https://github.com/halo-dev/halo/issues/3573\n rbac.authorization.halo.run/display-name: \"投稿者\"\n rbac.authorization.halo.run/disallow-access-console: \"true\"\n rbac.authorization.halo.run/redirect-on-login: \"/uc\"\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-post-contributor\" ]\nrules: [ ]\n\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-post-contributor\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Posts Management\"\n # Currently, yaml definition does not support i18n, please see https://github.com/halo-dev/halo/issues/3573\n rbac.authorization.halo.run/display-name: \"Post Contributor\"\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-view-categories\", \"role-template-view-tags\" ]\n rbac.authorization.halo.run/ui-permissions: |\n [ \"uc:posts:manage\" ]\nrules:\n - apiGroups: [ \"uc.api.content.halo.run\" ]\n resources: [ \"posts\" ]\n verbs: [ \"get\", \"list\", \"create\", \"update\", \"delete\" ]\n - apiGroups: [ \"uc.api.content.halo.run\" ]\n resources: [ \"posts/draft\" ]\n verbs: [ \"update\", \"get\" ]\n\n---\napiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-post-publisher\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Posts Management\"\n rbac.authorization.halo.run/display-name: \"Post Publisher\"\n rbac.authorization.halo.run/ui-permissions: |\n [ \"uc:posts:publish\" ]\nrules:\n - apiGroups: [ \"uc.api.content.halo.run\" ]\n resources: [ \"posts/publish\", \"posts/unpublish\" ]\n verbs: [ \"update\" ]\n\n---\n# TODO remove this in next major version\napiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-recycle-my-post\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Posts Management\"\n rbac.authorization.halo.run/display-name: \"Recycle My Post\"\n rbac.authorization.halo.run/ui-permissions: |\n [ \"uc:posts:recycle\" ]\nrules:\n - apiGroups: [ \"uc.api.content.halo.run\" ]\n resources: [ \"posts/recycle\" ]\n verbs: [ \"delete\" ]\n\n---\napiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-post-attachment-manager\n deletionTimestamp: 2024-09-30T14:00:41.813954138Z\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Posts Management\"\n rbac.authorization.halo.run/display-name: \"Post Attachment Manager\"\nrules: [ ]\n" }, { "path": "application/src/main/resources/extensions/role-template-user.yaml", "content": "apiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-manage-users\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/dependencies: |\n [ \"role-template-view-users\", \"role-template-change-password\" ]\n rbac.authorization.halo.run/module: \"Users Management\"\n rbac.authorization.halo.run/display-name: \"User manage\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:users:manage\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"users\" ]\n verbs: [ \"create\", \"patch\", \"update\", \"delete\", \"deletecollection\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users\", \"users/permissions\", \"users/password\", \"users/avatar\" ]\n verbs: [ \"*\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-view-users\n labels:\n halo.run/role-template: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Users Management\"\n rbac.authorization.halo.run/display-name: \"User View\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"system:users:view\"]\nrules:\n - apiGroups: [ \"\" ]\n resources: [ \"users\" ]\n verbs: [ \"get\", \"list\" ]\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users\" ]\n verbs: [ \"get\", \"list\" ]\n---\napiVersion: v1alpha1\nkind: \"Role\"\nmetadata:\n name: role-template-change-password\n labels:\n halo.run/role-template: \"true\"\n halo.run/hidden: \"true\"\n annotations:\n rbac.authorization.halo.run/module: \"Users Management\"\n rbac.authorization.halo.run/display-name: \"User Password Change\"\nrules:\n - apiGroups: [ \"api.console.halo.run\" ]\n resources: [ \"users/password\" ]\n verbs: [ \"update\" ]\n" }, { "path": "application/src/main/resources/extensions/system-configurable-configmap.yaml", "content": "apiVersion: v1alpha1\nkind: \"ConfigMap\"\nmetadata:\n name: system-default\ndata:\n user: |\n {\n \"allowRegistration\": false,\n \"mustVerifyEmailOnRegistration\": false,\n \"defaultRole\": \"guest\",\n \"avatarPolicy\": \"default-policy\",\n \"ucAttachmentPolicy\": \"default-policy\"\n }\n attachment: |\n {\n \"console\": {\n \"policyName\": \"default-policy\"\n },\n \"uc\": {\n \"policyName\": \"default-policy\"\n },\n \"avatar\": {\n \"policyName\": \"default-policy\"\n }\n }\n theme: |\n {\n \"active\": \"theme-earth\"\n }\n routeRules: |\n {\n \"categories\": \"categories\",\n \"archives\": \"archives\",\n \"post\": \"/archives/{slug}\",\n \"tags\": \"tags\"\n }\n codeInjection: |\n {\n \"globalHead\": \"\",\n \"footer\": \"\"\n }\n post: |\n {\n \"review\": false,\n \"postPageSize\": 10,\n \"archivePageSize\": 10,\n \"categoryPageSize\": 10,\n \"tagPageSize\": 10,\n \"authorPageSize\": 10,\n \"slugGenerationStrategy\": \"generateByTitle\",\n \"attachmentPolicyName\": \"default-policy\"\n }\n comment: |\n {\n \"enable\": true,\n \"requireReviewForNew\": true,\n \"systemUserOnly\": true\n }\n menu: |\n {\n \"primary\": \"primary\"\n }\n extensionPointEnabled: |\n {\n \"search-engine\": [\"search-engine-lucene\"]\n }\n authProvider: |\n {\n \"states\": [{\n \"name\": \"local\",\n \"enabled\": true,\n \"priority\": 0\n }]\n }\n" }, { "path": "application/src/main/resources/extensions/system-default-role.yaml", "content": "apiVersion: v1alpha1\nkind: Role\nmetadata:\n name: guest\n labels:\n rbac.authorization.halo.run/system-reserved: \"true\"\n annotations:\n rbac.authorization.halo.run/display-name: \"访客\"\n rbac.authorization.halo.run/disallow-access-console: \"true\"\n rbac.authorization.halo.run/redirect-on-login: \"/uc\"\nrules: []\n\n---\napiVersion: v1alpha1\nkind: Role\nmetadata:\n name: super-role\n labels:\n rbac.authorization.halo.run/system-reserved: \"true\"\n annotations:\n rbac.authorization.halo.run/display-name: \"超级管理员\"\n rbac.authorization.halo.run/ui-permissions: |\n [\"*\"]\nrules:\n - apiGroups: [\"*\"]\n resources: [\"*\"]\n nonResourceURLs: [\"*\"]\n verbs: [\"*\"]\n" }, { "path": "application/src/main/resources/extensions/system-setting.yaml", "content": "apiVersion: v1alpha1\nkind: Setting\nmetadata:\n name: system\nspec:\n forms:\n - group: basic\n label: 基本设置\n formSchema:\n - $formkit: text\n label: \"站点标题\"\n name: title\n validation: required\n - $formkit: text\n label: \"站点副标题\"\n name: subtitle\n - $formkit: attachment\n label: Logo\n name: logo\n width: \"4rem\"\n accepts:\n - 'image/*'\n - $formkit: attachment\n label: Favicon\n name: favicon\n width: \"4rem\"\n accepts:\n - 'image/*'\n - $formkit: select\n label: \"首选语言\"\n name: language\n value: 'zh-CN'\n options:\n - label: 'English'\n value: 'en'\n - label: 'Español'\n value: 'es'\n - label: '简体中文'\n value: 'zh-CN'\n - label: '繁体中文'\n value: 'zh-TW'\n - group: post\n label: 文章设置\n formSchema:\n - $formkit: number\n label: \"文章列表显示条数\"\n name: postPageSize\n value: 10\n min: 1\n max: 100\n validation: required | max:100\n - $formkit: number\n label: \"归档页文章显示条数\"\n name: archivePageSize\n value: 10\n min: 1\n max: 100\n validation: required | max:100\n - $formkit: number\n label: \"分类页文章显示条数\"\n name: categoryPageSize\n value: 10\n min: 1\n max: 100\n validation: required | max:100\n - $formkit: number\n label: \"标签页文章显示条数\"\n name: tagPageSize\n value: 10\n min: 1\n max: 100\n validation: required\n - $formkit: number\n label: \"作者页文章显示条数\"\n name: authorPageSize\n value: 10\n min: 1\n max: 100\n validation: required\n - $formkit: select\n label: \"别名生成策略\"\n name: slugGenerationStrategy\n value: 'generateByTitle'\n options:\n - label: '根据标题'\n value: 'generateByTitle'\n - label: '时间戳'\n value: 'timestamp'\n - label: 'Short UUID'\n value: 'shortUUID'\n - label: 'UUID'\n value: 'UUID'\n help: 此选项仅在创建文章时生效，修改此选项不会影响已有文章\n - $formkit: attachmentPolicySelect\n name: attachmentPolicyName\n label: \"附件存储策略\"\n value: \"default-policy\"\n help: 用于指定在文章编辑器中上传的默认附件存储策略（已过时，请使用附件配置中的管理端附件配置）\n - $formkit: attachmentGroupSelect\n name: attachmentGroupName\n label: \"附件存储组\"\n value: \"\"\n help: 用于指定在文章编辑器中上传的默认附件存储分组（已过时，请使用附件配置中的管理端附件配置）\n - group: seo\n label: SEO 设置\n formSchema:\n - $formkit: checkbox\n name: blockSpiders\n label: \"屏蔽搜索引擎\"\n value: false\n help: \"为所有页面添加 标签，阻止搜索引擎索引，但不是所有搜索引擎都会遵守\"\n - $formkit: textarea\n name: keywords\n label: \"站点关键词\"\n help: \"目前主流搜索引擎已经不再使用此字段，所以通常不建议设置，此选项可能在未来版本中被移除\"\n auto-height: true\n - $formkit: textarea\n name: description\n label: \"站点描述\"\n help: \"仅对首页生效，其他页面将根据页面类型自动生成描述\"\n auto-height: true\n - group: user\n label: 用户设置\n formSchema:\n - $formkit: checkbox\n name: allowRegistration\n id: allowRegistration\n key: allowRegistration\n label: \"开放注册\"\n value: false\n - $formkit: checkbox\n name: mustVerifyEmailOnRegistration\n label: \"注册需验证邮箱\"\n if: \"$get(allowRegistration).value === true\"\n help: \"需要确保已经正确配置邮件通知器\"\n value: false\n - $formkit: textarea\n name: protectedUsernames\n label: \"保留用户名与名称\"\n if: \"$get(allowRegistration).value === true\"\n help: 保留用户名与名称，限制用户注册或编辑资料时使用，多个请用英文逗号,分隔，留空则不限制\n value: \"admin,administrator,root,system,superuser,guest,test,demo,user,backup,ftp,www,manager,support,service,api,超级管理员,管理员\"\n - $formkit: roleSelect\n name: defaultRole\n label: \"默认角色\"\n validation: 'required'\n if: \"$get(allowRegistration).value === true\"\n help: 用户注册之后默认为用户分配的角色\n - $formkit: attachmentPolicySelect\n name: avatarPolicy\n label: \"头像存储位置\"\n value: \"default-policy\"\n help: 指定用户上传头像的存储策略（已过时，请使用附件配置中的头像附件配置）\n - $formkit: attachmentPolicySelect\n name: ucAttachmentPolicy\n label: \"个人中心附件存储位置\"\n value: \"default-policy\"\n help: 指定用户在个人中心上传的附件的存储位置（已过时，请使用附件配置中的个人中心附件配置）\n - group: attachment\n label: 附件配置\n formSchema:\n - $formkit: group\n name: console\n label: 管理端附件配置\n help: 为管理端直接上传附件的地方设置默认的存储策略和分组\n children:\n - $formkit: attachmentPolicySelect\n name: policyName\n label: \"存储策略\"\n auto-select: false\n - $formkit: attachmentGroupSelect\n name: groupName\n label: \"存储组\"\n auto-select: false\n clearable: true\n - $formkit: group\n name: uc\n label: 个人中心附件配置\n help: 为个人中心直接上传附件的地方设置默认的存储策略和分组，处于安全考虑，建议为所选存储策略限制文件类型和大小\n children:\n - $formkit: attachmentPolicySelect\n name: policyName\n label: \"存储策略\"\n auto-select: false\n - $formkit: attachmentGroupSelect\n name: groupName\n label: \"存储组\"\n auto-select: false\n clearable: true\n - $formkit: group\n name: avatar\n label: 头像附件配置\n help: 为用户头像设置存储策略，处于安全考虑，建议为所选存储策略限制文件类型和大小\n children:\n - $formkit: attachmentPolicySelect\n name: policyName\n label: \"存储策略\"\n - group: comment\n label: 评论设置\n formSchema:\n - $formkit: checkbox\n name: enable\n value: true\n label: \"启用评论\"\n - $formkit: checkbox\n name: requireReviewForNew\n value: true\n label: \"新评论审核\"\n help: 开启之后，新评论需要管理员审核后才会显示\n - $formkit: checkbox\n name: systemUserOnly\n value: true\n label: \"仅允许注册用户评论\"\n - group: routeRules\n label: 主题路由设置\n formSchema:\n - $formkit: checkbox\n label: \"关闭主题预览\"\n value: false\n name: disableThemePreview\n help: \"关闭后，未包含主题管理权限的用户将无法通过参数预览未激活的主题\"\n - $formkit: text\n label: \"分类页路由前缀\"\n value: \"categories\"\n name: categories\n validation: required | alphanumeric\n - $formkit: text\n label: \"标签页路由前缀\"\n value: \"tags\"\n name: tags\n validation: required | alphanumeric\n - $formkit: text\n label: \"归档页路由前缀\"\n value: \"archives\"\n name: archives\n validation: required | alphanumeric\n - $formkit: select\n label: 文章详情页访问规则\n value: '/archives/{slug}'\n options:\n - label: '/archives/{slug}'\n value: '/archives/{slug}'\n - label: '/archives/{name}'\n value: '/archives/{name}'\n - label: '/?p={name}'\n value: '/?p={name}'\n - label: '/?p={slug}'\n value: '/?p={slug}'\n - label: '/{year}/{slug}'\n value: '/{year:\\d{4}}/{slug}'\n - label: '/{year}/{month}/{slug}'\n value: '/{year:\\d{4}}/{month:\\d{2}}/{slug}'\n - label: '/{year}/{month}/{day}/{slug}'\n value: '/{year:\\d{4}}/{month:\\d{2}}/{day:\\d{2}}/{slug}'\n - label: '/categories/{categorySlug}/{slug}'\n value: '/categories/{categorySlug}/{slug}'\n name: post\n validation: required\n - group: codeInjection\n label: 代码注入\n formSchema:\n - $formkit: code\n language: html\n height: 200px\n label: \"全局 head 标签\"\n name: globalHead\n help: \"注入代码到所有页面的 head 标签部分\"\n - $formkit: code\n language: html\n height: 200px\n label: \"内容页 head 标签\"\n name: contentHead\n help: \"注入代码到文章页面和自定义页面的 head 标签部分\"\n - $formkit: code\n language: html\n height: 200px\n label: \"页脚\"\n name: footer\n help: \"注入代码到所有页面的页脚部分\"" }, { "path": "application/src/main/resources/extensions/user.yaml", "content": "apiVersion: v1alpha1\nkind: User\nmetadata:\n name: anonymousUser\n labels:\n halo.run/hidden-user: \"true\"\n finalizers:\n - system-protection\nspec:\n displayName: Anonymous User\n email: anonymous@example.com\n disabled: true\n\n---\napiVersion: v1alpha1\nkind: User\nmetadata:\n name: ghost\n labels:\n halo.run/hidden-user: \"true\"\n finalizers:\n - system-protection\nspec:\n displayName: 已删除用户\n email: ghost@example.com\n disabled: true\n bio: 该用户已被删除。\n\n" }, { "path": "application/src/main/resources/initial-data.yaml", "content": "# 提供了 timestamp、username 变量，用于初始化数据时填充时间戳和用户名\n# 初始化文章关联的分类、标签数据\napiVersion: content.halo.run/v1alpha1\nkind: Category\nmetadata:\n name: 76514a40-6ef1-4ed9-b58a-e26945bde3ca\nspec:\n displayName: 默认分类\n slug: default\n description: 这是你的默认分类，如不需要，删除即可。\n cover: \"\"\n template: \"\"\n priority: 0\n children: [ ]\nstatus:\n permalink: \"/categories/default\"\n\n---\napiVersion: content.halo.run/v1alpha1\nkind: Tag\nmetadata:\n name: c33ceabb-d8f1-4711-8991-bb8f5c92ad7c\nspec:\n displayName: Halo\n slug: halo\n cover: \"\"\nstatus:\n permalink: \"/tags/halo\"\n\n---\n# 文章关联的内容\napiVersion: content.halo.run/v1alpha1\nkind: Snapshot\nmetadata:\n name: fb5cd6bd-998d-4ccc-984d-5cc23b0a09f9\n annotations:\n content.halo.run/keep-raw: \"true\"\nspec:\n subjectRef:\n group: content.halo.run\n version: v1alpha1\n kind: Post\n name: 5152aea5-c2e8-4717-8bba-2263d46e19d5\n rawType: HTML\n rawPatch:

Hello\n Halo

如果你看到了这一篇文章，那么证明你已经安装成功了，感谢使用 Halo\n 进行创作，希望能够使用愉快。

相关链接

  • 官网：https://www.halo.run

  • 文档：https://docs.halo.run

  • 社区：https://bbs.halo.run

  • 应用市场：https://www.halo.run/store/apps

  • 开源地址：https://github.com/halo-dev/halo

在使用过程中，有任何问题都可以通过以上链接找寻答案，或者联系我们。

这是一篇自动生成的文章，请删除这篇文章之后开始你的创作吧！

\n contentPatch:

Hello\n Halo

如果你看到了这一篇文章，那么证明你已经安装成功了，感谢使用 Halo\n 进行创作，希望能够使用愉快。

相关链接

  • 官网：https://www.halo.run

  • 文档：https://docs.halo.run

  • 社区：https://bbs.halo.run

  • 应用市场：https://www.halo.run/store/apps

  • 开源地址：https://github.com/halo-dev/halo

在使用过程中，有任何问题都可以通过以上链接找寻答案，或者联系我们。

这是一篇自动生成的文章，请删除这篇文章之后开始你的创作吧！

\n lastModifyTime: \"${timestamp}\"\n owner: \"${username}\"\n contributors:\n - \"${username}\"\n\n---\n# 初始化文章数据\napiVersion: content.halo.run/v1alpha1\nkind: Post\nmetadata:\n name: 5152aea5-c2e8-4717-8bba-2263d46e19d5\nspec:\n title: Hello Halo\n slug: hello-halo\n releaseSnapshot: fb5cd6bd-998d-4ccc-984d-5cc23b0a09f9\n headSnapshot: fb5cd6bd-998d-4ccc-984d-5cc23b0a09f9\n baseSnapshot: fb5cd6bd-998d-4ccc-984d-5cc23b0a09f9\n owner: \"${username}\"\n template: \"\"\n cover: \"\"\n deleted: false\n publish: true\n publishTime: \"${timestamp}\"\n pinned: false\n allowComment: true\n visible: PUBLIC\n priority: 0\n excerpt:\n autoGenerate: false\n raw: 如果你看到了这一篇文章，那么证明你已经安装成功了，感谢使用 Halo 进行创作，希望能够使用愉快。\n categories:\n - 76514a40-6ef1-4ed9-b58a-e26945bde3ca\n tags:\n - c33ceabb-d8f1-4711-8991-bb8f5c92ad7c\n htmlMetas: [ ]\nstatus:\n permalink: /archives/hello-halo\n\n---\n# 自定义页面关联的内容\napiVersion: content.halo.run/v1alpha1\nkind: Snapshot\nmetadata:\n name: c3f73cc2-194e-4cd8-9092-7386aa50a0e5\n annotations:\n content.halo.run/keep-raw: \"true\"\nspec:\n subjectRef:\n group: content.halo.run\n version: v1alpha1\n kind: SinglePage\n name: 373a5f79-f44f-441a-9df1-85a4f553ece8\n rawType: HTML\n rawPatch:

关于页面

这是一个自定义页面，你可以在后台的 页面\n -> 自定义页面\n 找到它，你可以用于新建关于页面、联系我们页面等等。

这是一篇自动生成的页面，你可以在后台删除它。

\n contentPatch:

关于页面

这是一个自定义页面，你可以在后台的 页面\n -> 自定义页面\n 找到它，你可以用于新建关于页面、联系我们页面等等。

这是一篇自动生成的页面，你可以在后台删除它。

\n lastModifyTime: \"${timestamp}\"\n owner: \"${username}\"\n contributors:\n - \"${username}\"\n\n---\n# 初始化自定义页面数据\napiVersion: content.halo.run/v1alpha1\nkind: SinglePage\nmetadata:\n name: 373a5f79-f44f-441a-9df1-85a4f553ece8\nspec:\n title: 关于\n slug: about\n template: \"\"\n cover: \"\"\n owner: \"${username}\"\n deleted: false\n publish: true\n baseSnapshot: c3f73cc2-194e-4cd8-9092-7386aa50a0e5\n headSnapshot: c3f73cc2-194e-4cd8-9092-7386aa50a0e5\n releaseSnapshot: c3f73cc2-194e-4cd8-9092-7386aa50a0e5\n pinned: false\n allowComment: true\n visible: PUBLIC\n version: 1\n priority: 0\n excerpt:\n autoGenerate: false\n raw: 这是一个自定义页面，你可以在后台的 页面 -> 自定义页面 找到它，你可以用于新建关于页面、联系我们页面等等。\n htmlMetas: [ ]\nstatus:\n permalink: \"/about\"\n\n---\n# 首页菜单项\napiVersion: v1alpha1\nkind: MenuItem\nmetadata:\n name: 88c3f10b-321c-4092-86a8-70db00251b74\nspec:\n displayName: 首页\n href: /\n children: [ ]\n priority: 0\n---\n# 关联到文章作为菜单\napiVersion: v1alpha1\nkind: MenuItem\nmetadata:\n name: c4c814d1-0c2c-456b-8c96-4864965fee94\nspec:\n displayName: \"Hello Halo\"\n href: \"/archives/hello-halo\"\n children: [ ]\n priority: 1\n targetRef:\n group: content.halo.run\n version: v1alpha1\n kind: Post\n name: 5152aea5-c2e8-4717-8bba-2263d46e19d5\n---\n# 关联到标签作为菜单\napiVersion: v1alpha1\nkind: MenuItem\nmetadata:\n name: 35869bd3-33b5-448b-91ee-cf6517a59644\nspec:\n displayName: \"Halo\"\n href: \"/tags/halo\"\n children: [ ]\n priority: 2\n targetRef:\n group: content.halo.run\n version: v1alpha1\n kind: Tag\n name: c33ceabb-d8f1-4711-8991-bb8f5c92ad7c\n---\n# 关联到自定义页面作为菜单\napiVersion: v1alpha1\nkind: MenuItem\nmetadata:\n name: b0d041fa-dc99-48f6-a193-8604003379cf\nspec:\n displayName: \"关于\"\n href: \"/about\"\n children: [ ]\n priority: 3\n targetRef:\n group: content.halo.run\n version: v1alpha1\n kind: SinglePage\n name: 373a5f79-f44f-441a-9df1-85a4f553ece8\n---\napiVersion: v1alpha1\nkind: Menu\nmetadata:\n name: primary\nspec:\n displayName: 主菜单\n menuItems:\n - 88c3f10b-321c-4092-86a8-70db00251b74\n - c4c814d1-0c2c-456b-8c96-4864965fee94\n - 35869bd3-33b5-448b-91ee-cf6517a59644\n - b0d041fa-dc99-48f6-a193-8604003379cf\n" }, { "path": "application/src/main/resources/schema-h2.sql", "content": "create table if not exists extensions\n(\n name varchar(255) not null,\n data blob,\n version bigint,\n primary key (name)\n);\n" }, { "path": "application/src/main/resources/schema-mariadb.sql", "content": "create table if not exists extensions\n(\n name varchar(255) not null COLLATE utf8mb4_bin,\n data longblob,\n version bigint,\n primary key (name)\n);\n" }, { "path": "application/src/main/resources/schema-mysql.sql", "content": "create table if not exists extensions\n(\n name varchar(255) not null COLLATE utf8mb4_bin,\n data longblob,\n version bigint,\n primary key (name)\n);\n" }, { "path": "application/src/main/resources/schema-postgresql.sql", "content": "create table if not exists extensions\n(\n name varchar(255) not null,\n data bytea,\n version bigint,\n primary key (name)\n);\n" }, { "path": "application/src/main/resources/static/halo-tracker.js", "content": "!function(){\"use strict\";!function(t){var e=t.screen,r=e.width,n=e.height,a=t.navigator.language,o=t.location,i=t.localStorage,c=t.document,u=t.history,l=o.hostname,s=o.pathname,p=o.search,f=c.currentScript;if(f){var h=function(t,e,r){var n=t[e];return function(){for(var e=[],a=arguments.length;a--;)e[a]=arguments[a];return r.apply(null,e),n.apply(t,e)}},d=function(){return i&&i.getItem(\"haloTracker.disabled\")||T&&function(){var e=t.doNotTrack,r=t.navigator,n=t.external,a=\"msTrackingProtectionEnabled\",o=e||r.doNotTrack||r.msDoNotTrack||n&&a in n&&n[a]();return\"1\"==o||\"yes\"===o}()||j&&!w.includes(l)},g=\"data-\",v=f.getAttribute.bind(f),m=v(g+\"group\")||\"\",k=v(g+\"plural\"),y=v(g+\"name\"),S=v(g+\"host-url\"),b=\"false\"!==v(g+\"auto-track\"),T=v(g+\"do-not-track\"),j=v(g+\"domains\")||\"\",w=j.split(\",\").map((function(t){return t.trim()})),E=(S?S.replace(/\\/$/,\"\"):f.src.split(\"/\").slice(0,-1).join(\"/\"))+\"/apis/api.halo.run/v1alpha1/trackers/counter\",N=r+\"x\"+n,O=\"\"+s+p,x=c.referrer,P=function(t,e){return void 0===t&&(t=O),void 0===e&&(e=x),function(t){if(!d())return fetch(E,{method:\"POST\",body:JSON.stringify(Object.assign({},t)),headers:{\"Content-Type\":\"application/json\"}}).then((function(t){return t.text()})).then((function(t){console.debug(\"Visit count:\",t)}))}((r={group:m,plural:k,name:y,hostname:l,screen:N,language:a,url:O},n={url:t,referrer:e},Object.keys(n).forEach((function(t){void 0!==n[t]&&(r[t]=n[t])})),r));var r,n},V=function(t,e,r){if(r){x=O;var n=r.toString();(O=\"http\"===n.substring(0,4)?\"/\"+n.split(\"/\").splice(3).join(\"/\"):n)!==x&&P()}};if(!t.haloTracker){var A=function(t){return trackEvent(t)};A.trackView=P,t.haloTracker=A}if(b&&!d()){u.pushState=h(u,\"pushState\",V),u.replaceState=h(u,\"replaceState\",V);var C=function(){\"complete\"===c.readyState&&P()};c.addEventListener(\"readystatechange\",C,!0),C()}}}(window)}();\n" }, { "path": "application/src/main/resources/static/js/main.js", "content": "const Toast = (function () {\n let container;\n\n function getContainer() {\n if (container) return container;\n\n container = document.createElement(\"div\");\n container.style.cssText = `\n position: fixed;\n top: 20px;\n left: 50%;\n transform: translateX(-50%);\n z-index: 9999;\n `;\n\n if (document.body) {\n document.body.appendChild(container);\n } else {\n document.addEventListener(\"DOMContentLoaded\", () => {\n document.body.appendChild(container);\n });\n }\n\n return container;\n }\n\n class ToastMessage {\n constructor(message, type) {\n this.message = message;\n this.type = type;\n this.element = null;\n this.create();\n }\n\n create() {\n this.element = document.createElement(\"div\");\n this.element.textContent = this.message;\n this.element.style.cssText = `\n background-color: ${this.type === \"success\" ? \"#4CAF50\" : \"#F44336\"};\n color: white;\n padding: 12px 24px;\n border-radius: 4px;\n margin-bottom: 10px;\n box-shadow: 0 2px 5px rgba(0,0,0,0.2);\n opacity: 0;\n transition: opacity 0.3s ease-in-out;\n `;\n getContainer().appendChild(this.element);\n\n setTimeout(() => {\n this.element.style.opacity = \"1\";\n }, 10);\n\n setTimeout(() => {\n this.remove();\n }, 3000);\n }\n\n remove() {\n this.element.style.opacity = \"0\";\n setTimeout(() => {\n const parent = this.element.parentNode;\n if (parent) {\n parent.removeChild(this.element);\n }\n }, 300);\n }\n }\n\n function showToast(message, type) {\n if (document.readyState === \"loading\") {\n document.addEventListener(\"DOMContentLoaded\", () => {\n new ToastMessage(message, type);\n });\n } else {\n new ToastMessage(message, type);\n }\n }\n\n return {\n success: function (message) {\n showToast(message, \"success\");\n },\n error: function (message) {\n showToast(message, \"error\");\n },\n };\n})();\n\nfunction sendVerificationCode(button, sendRequest) {\n let timer;\n const countdown = 60;\n const originalButtonText = button.textContent;\n\n button.addEventListener(\"click\", () => {\n button.disabled = true;\n button.textContent = i18nResources.sendVerificationCodeSending;\n sendRequest()\n .then(() => {\n startCountdown();\n Toast.success(i18nResources.sendVerificationCodeSuccess);\n })\n .catch((e) => {\n button.disabled = false;\n button.textContent = originalButtonText;\n if (e instanceof Error) {\n Toast.error(e.message);\n } else {\n Toast.error(i18nResources.sendVerificationCodeFailed);\n }\n });\n });\n\n function startCountdown() {\n let remainingTime = countdown;\n button.disabled = true;\n button.classList.add(\"disabled\");\n\n timer = setInterval(() => {\n if (remainingTime > 0) {\n button.textContent = `${remainingTime}s`;\n remainingTime--;\n } else {\n clearInterval(timer);\n button.textContent = originalButtonText;\n button.disabled = false;\n button.classList.remove(\"disabled\");\n }\n }, 1000);\n }\n}\n\ndocument.addEventListener(\"DOMContentLoaded\", () => {\n const passwordContainers = document.querySelectorAll(\".toggle-password-display-flag\");\n\n passwordContainers.forEach((container) => {\n const passwordInput = container.querySelector('input[type=\"password\"]');\n const toggleButton = container.querySelector(\".toggle-password-button\");\n const displayIcon = container.querySelector(\".password-display-icon\");\n const hiddenIcon = container.querySelector(\".password-hidden-icon\");\n\n if (passwordInput && toggleButton && displayIcon && hiddenIcon) {\n toggleButton.addEventListener(\"click\", () => {\n if (passwordInput.type === \"password\") {\n passwordInput.type = \"text\";\n displayIcon.style.display = \"none\";\n hiddenIcon.style.display = \"block\";\n } else {\n passwordInput.type = \"password\";\n displayIcon.style.display = \"block\";\n hiddenIcon.style.display = \"none\";\n }\n });\n }\n });\n});\n\nfunction setupPasswordConfirmation(passwordId, confirmPasswordId) {\n const password = document.getElementById(passwordId);\n const confirmPassword = document.getElementById(confirmPasswordId);\n\n function validatePasswordMatch() {\n if (password.value !== confirmPassword.value) {\n confirmPassword.setCustomValidity(i18nResources.passwordConfirmationFailed);\n } else {\n confirmPassword.setCustomValidity(\"\");\n }\n }\n\n password.addEventListener(\"change\", validatePasswordMatch);\n confirmPassword.addEventListener(\"input\", validatePasswordMatch);\n}\n" }, { "path": "application/src/main/resources/static/styles/main.css", "content": ".gateway-page {\n width: 100%;\n height: 100vh;\n overflow: auto;\n}\n\n.gateway-wrapper,\n.gateway-wrapper:before,\n.gateway-wrapper:after,\n.gateway-wrapper *,\n.gateway-wrapper :before,\n.gateway-wrapper :after {\n box-sizing: border-box;\n border-style: solid;\n border-width: 0;\n}\n\n.gateway-wrapper {\n --color-primary: #4ccba0;\n --color-secondary: #0e1731;\n --color-link: #1f75cb;\n --color-text: #374151;\n --color-border: #d1d5db;\n --rounded-sm: 0.125em;\n --rounded-base: 0.25em;\n --rounded-lg: 0.5em;\n --spacing-2xl: 1.5em;\n --spacing-xl: 1.25em;\n --spacing-lg: 1em;\n --spacing-md: 0.875em;\n --spacing-sm: 0.625em;\n --spacing-xs: 0.5em;\n --text-xl: 1.25em;\n --text-2xl: 1.5em;\n --text-lg: 1.125em;\n --text-base: 1em;\n --text-sm: 0.875em;\n --font-size-base: 16px;\n --font-size-md: 14px;\n padding: 5% var(--spacing-lg);\n font-size: var(--font-size-base);\n max-width: 28em;\n margin: 0 auto;\n font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica Neue, Arial,\n Noto Sans, sans-serif, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol, Noto Color Emoji;\n line-height: 1.5;\n}\n\n.halo-form-wrapper {\n border-radius: var(--rounded-lg);\n padding: var(--spacing-2xl);\n background: #fff;\n border: 1px solid #dfe6ecb3;\n}\n\n.form-title {\n all: unset;\n font-size: var(--text-2xl);\n margin-bottom: var(--spacing-lg);\n font-weight: 500;\n display: block;\n}\n\n.halo-form .form-item {\n margin-bottom: var(--spacing-2xl);\n flex-direction: column;\n width: 100%;\n display: flex;\n}\n\n.halo-form .form-item:last-of-type {\n margin-bottom: 0;\n}\n\n.halo-form .form-item-group {\n gap: var(--spacing-lg);\n margin-bottom: var(--spacing-2xl);\n align-items: flex-start;\n display: flex;\n}\n\n.halo-form .form-item-group .form-item {\n margin-bottom: 0;\n}\n\n.halo-form .form-input {\n border-radius: var(--rounded-base);\n border: 1px solid var(--color-border);\n background: #fff;\n height: 2.5em;\n padding: 0 0.75rem;\n}\n\n.halo-form .form-input:focus-within {\n border-color: var(--color-primary);\n outline-offset: \"2px\";\n outline: 2px solid #0000;\n}\n\n.halo-form .form-item input {\n appearance: none;\n font-size: var(--text-base);\n box-shadow: none;\n background: none;\n width: 100%;\n height: 100%;\n display: block;\n}\n\n.halo-form .form-item select {\n appearance: none;\n font-size: var(--text-base);\n box-shadow: none;\n width: 100%;\n height: 100%;\n display: block;\n outline: none;\n border: none;\n background: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1em' height='1em' viewBox='0 0 24 24'%3E%3Cpath fill='%23000' d='m12 13.171l4.95-4.95l1.414 1.415L12 16L5.636 9.636L7.05 8.222z'/%3E%3C/svg%3E\")\n right 0em center no-repeat;\n}\n\n.halo-form .form-item input:focus {\n outline: none;\n}\n\n.halo-form .form-input-stack {\n align-items: center;\n gap: 0.5em;\n display: flex;\n}\n\n.halo-form .form-input-stack-icon {\n color: var(--color-text);\n cursor: pointer;\n align-items: center;\n display: inline-flex;\n}\n\n.halo-form .form-input-stack-select {\n all: unset;\n color: var(--color-text);\n font-size: var(--text-sm);\n background: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1em' height='1em' viewBox='0 0 24 24'%3E%3Cpath fill='%23000' d='m12 13.171l4.95-4.95l1.414 1.415L12 16L5.636 9.636L7.05 8.222z'/%3E%3C/svg%3E\")\n right 0.3em center no-repeat;\n align-items: center;\n padding-right: 1.85em;\n display: inline-flex;\n}\n\n.halo-form .form-input-stack-text {\n color: var(--color-text);\n font-size: var(--text-sm);\n}\n\n.halo-form .form-item label {\n color: var(--color-text);\n font-size: var(--text-base);\n margin-bottom: 0.75rem;\n font-weight: 500;\n}\n\n.halo-form .form-item .form-label-group {\n justify-content: space-between;\n align-items: center;\n margin-bottom: 0.75em;\n display: flex;\n}\n\n.halo-form .form-item .form-label-group label {\n margin-bottom: 0;\n}\n\n.halo-form .form-item-extra-link {\n color: var(--color-link);\n font-size: var(--text-sm);\n text-decoration: none;\n}\n\n.halo-form .form-item-compact {\n gap: var(--spacing-sm);\n margin-bottom: var(--spacing-2xl);\n align-items: center;\n display: flex;\n}\n\n.halo-form .form-item-compact label {\n color: var(--color-text);\n font-size: var(--text-sm);\n}\n\n.halo-form button[type=\"submit\"] {\n background: var(--color-secondary);\n border-radius: var(--rounded-base);\n color: #fff;\n cursor: pointer;\n border: none;\n height: 2.5em;\n}\n\n.halo-form button[type=\"submit\"]:hover {\n opacity: 0.8;\n}\n\n.halo-form button[type=\"submit\"]:active {\n opacity: 0.9;\n}\n\n.halo-form button[disabled] {\n cursor: not-allowed !important;\n}\n\n.halo-form input[type=\"checkbox\"] {\n border: 1px solid var(--color-border);\n border-radius: var(--rounded-sm);\n appearance: none;\n print-color-adjust: exact;\n vertical-align: middle;\n user-select: none;\n color: #2563eb;\n background-color: #fff;\n background-origin: border-box;\n flex-shrink: 0;\n width: 1em;\n height: 1em;\n padding: 0;\n display: inline-block;\n}\n\n.halo-form input[type=\"checkbox\"]:focus {\n outline-offset: 2px;\n outline: 2px solid #0000;\n box-shadow: 0 0 0 2px #fff, 0 0 0 4px #2563eb, 0 0 #0000;\n}\n\n.halo-form input[type=\"checkbox\"]:checked {\n background-color: currentColor;\n background-image: url(\"data:image/svg+xml,%3csvg viewBox='0 0 16 16' fill='white' xmlns='http://www.w3.org/2000/svg'%3e%3cpath d='M12.207 4.793a1 1 0 010 1.414l-5 5a1 1 0 01-1.414 0l-2-2a1 1 0 011.414-1.414L6.5 9.086l4.293-4.293a1 1 0 011.414 0z'/%3e%3c/svg%3e\");\n background-position: center;\n background-repeat: no-repeat;\n background-size: 100% 100%;\n border-color: #0000;\n}\n\n.halo-form .form-input-group {\n gap: var(--spacing-sm);\n grid-template-columns: repeat(3, minmax(0, 1fr));\n align-items: center;\n display: grid;\n height: 2.5em;\n}\n\n.halo-form .form-input {\n grid-column: span 2 / span 2;\n}\n\n.halo-form .form-input-group button {\n border-radius: var(--rounded-base);\n border: 1px solid var(--color-border);\n color: var(--color-text);\n font-size: var(--text-sm);\n cursor: pointer;\n background: #fff;\n grid-column: span 1 / span 1;\n height: 100%;\n}\n\n.halo-form .form-input-group button:hover {\n color: #333;\n background: #f3f4f6;\n}\n\n.halo-form .form-input-group button:active {\n background: #f9fafb;\n}\n\n.pill-items {\n all: unset;\n gap: var(--spacing-sm);\n flex-wrap: wrap;\n justify-content: center;\n margin: 0;\n display: flex;\n}\n\n.pill-items li {\n all: unset;\n border-radius: var(--rounded-lg);\n border: 1px solid #e5e7eb;\n transition-property: all;\n transition-duration: 0.15s;\n transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);\n overflow: hidden;\n}\n\n.pill-items li button {\n all: unset;\n cursor: pointer;\n width: 100%;\n height: 100%;\n}\n\n.pill-items li a,\n.pill-items li button {\n gap: var(--spacing-sm);\n font-size: var(--text-sm);\n color: #1f2937;\n align-items: center;\n padding: 0.6em 0.9em;\n text-decoration: none;\n display: flex;\n}\n\n.pill-items li img {\n width: 1.5em;\n height: 1.5em;\n}\n\n.pill-items li:hover {\n border-color: var(--color-primary);\n background: #f3f4f6;\n}\n\n.pill-items li:hover {\n color: #111827;\n}\n\n.pill-items li:focus-within {\n border-color: var(--color-primary);\n}\n\n.divider-wrapper {\n color: var(--color-text);\n font-size: var(--text-sm);\n gap: var(--spacing-lg);\n align-items: center;\n margin: 1.5em 0;\n display: flex;\n}\n\n.divider-wrapper hr {\n border: 0;\n border-top: 1px solid #f3f4f6;\n flex-grow: 1;\n overflow: hidden;\n}\n\n.alert {\n border-radius: var(--rounded-base);\n margin-bottom: var(--spacing-xl);\n padding: var(--spacing-md) var(--spacing-xl);\n font-size: var(--text-sm);\n color: var(--color-text);\n border: 1px solid #e5e7eb;\n position: relative;\n overflow: hidden;\n}\n\n.alert:before {\n content: \"\";\n background: #d1d5db;\n width: 0.25em;\n height: 100%;\n position: absolute;\n top: 0;\n left: 0;\n}\n\n.alert-warning {\n border-color: #fde047;\n}\n\n.alert-warning:before {\n background: #ea580c;\n}\n\n.alert-error {\n border-color: #fca5a5;\n}\n\n.alert-error:before {\n background: #dc2626;\n}\n\n.alert-success {\n border-color: #86efac;\n}\n\n.alert-success:before {\n background: #16a34a;\n}\n\n.alert-info {\n border-color: #7dd3fc;\n}\n\n.alert-info:before {\n background: #0284c7;\n}\n\n@media (forced-colors: active) {\n .halo-form input[type=\"checkbox\"]:checked {\n appearance: auto;\n }\n}\n\n@media only screen and (max-width: 768px) {\n .halo-form .form-item-group {\n flex-direction: column;\n }\n}\n\n@media screen and (min-width: 1201px) and (max-width: 1600px) {\n .gateway-wrapper {\n font-size: var(--font-size-md);\n }\n}\n\n@media screen and (min-width: 1601px) {\n .gateway-wrapper {\n font-size: var(--font-size-base);\n }\n}\n\n::-ms-reveal {\n display: none;\n}\n" }, { "path": "application/src/main/resources/templates/challenges/two-factor/totp.html", "content": "\n\n \n
\n
\n
\n

\n
\n
\n
\n \n\n \n \n \n\n" }, { "path": "application/src/main/resources/templates/challenges/two-factor/totp.properties", "content": "title=两步验证\n" }, { "path": "application/src/main/resources/templates/challenges/two-factor/totp_en.properties", "content": "title=Two-Factor Authentication\n" }, { "path": "application/src/main/resources/templates/challenges/two-factor/totp_es.properties", "content": "title=Autenticación en Dos Pasos\n" }, { "path": "application/src/main/resources/templates/challenges/two-factor/totp_zh_TW.properties", "content": "title=兩步驗證\n" }, { "path": "application/src/main/resources/templates/error/error.html", "content": "\n\n\n \n \n \n \n\n\n\n
\n

\n

\n

\n
\n \n
\n
\n\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/common.html", "content": "\n \n \n\n\n\n \n \n \n \n\n \n\n \n\n\n\n \n \n\n\n
\n \n
\n \n \n \n
\n
\n\n
\n \n
\n \"Halo\"\n
\n
\n\n
\n \n
\n
\n \n
\n
\n
    \n
  • \n \n \n \n
    • \n
\n \n \n
\n\n
\n \n
\n
\n \n
\n
\n \n \n
\n\n
\n \n
\n
\n \n \n
\n
\n
\n\n
\n \n
\n
\n \n \n
\n
\n
\n\n
\n \n
\n \n \n \n \n \n \n
\n
\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/common.properties", "content": "socialLogin.label=社交登录\njs.sendVerificationCode.success=发送成功\njs.sendVerificationCode.failed=发送失败，请稍后再试\njs.sendVerificationCode.sending=发送中...\njs.passwordConfirmation.failed=确认密码不匹配\n\nsignupNotice.description=没有账号？\nsignupNotice.link=立即注册\nloginNotice.description=已有账号，\nloginNotice.link=立即登录\nreturnToSite=返回网站\n\npasswordResetMethods.label=其他重置方式\npasswordResetMethods.email.displayName=通过邮件重置" }, { "path": "application/src/main/resources/templates/gateway_fragments/common_en.properties", "content": "socialLogin.label=Social Login\njs.sendVerificationCode.success=Sent Successfully\njs.sendVerificationCode.failed=Sending Failed, Please Try Again Later\njs.sendVerificationCode.sending=Sending...\njs.passwordConfirmation.failed=Password confirmation does not match\n\nsignupNotice.description=Don't have an account?\nsignupNotice.link=Sign up\nloginNotice.description=Already have an account,\nloginNotice.link=Login now\nreturnToSite=Return to site\n\npasswordResetMethods.label=Other Reset Methods\npasswordResetMethods.email.displayName=Reset via Email" }, { "path": "application/src/main/resources/templates/gateway_fragments/common_es.properties", "content": "socialLogin.label=Inicio de Sesión Social\njs.sendVerificationCode.success=Enviado con éxito\njs.sendVerificationCode.failed=Error al enviar, por favor intente nuevamente más tarde\njs.sendVerificationCode.sending=Enviando...\njs.passwordConfirmation.failed=La confirmación de la contraseña no coincide\n\nsignupNotice.description=¿No tienes una cuenta?\nsignupNotice.link=Regístrate ahora\nloginNotice.description=Ya tienes una cuenta,\nloginNotice.link=Inicia sesión ahora\nreturnToSite=Volver al sitio\n\npasswordResetMethods.label=Otros Métodos de Restablecimiento\npasswordResetMethods.email.displayName=Restablecer por Correo Electrónico" }, { "path": "application/src/main/resources/templates/gateway_fragments/common_zh_TW.properties", "content": "socialLogin.label=社交登入\njs.sendVerificationCode.success=發送成功\njs.sendVerificationCode.failed=發送失敗，請稍後再試\njs.sendVerificationCode.sending=發送中...\njs.passwordConfirmation.failed=確認密碼不匹配\n\nsignupNotice.description=沒有帳號？\nsignupNotice.link=立即註冊\nloginNotice.description=已有帳號，\nloginNotice.link=立即登入\nreturnToSite=返回網站\n\npasswordResetMethods.label=其他重置方式\npasswordResetMethods.email.displayName=通過郵件重置" }, { "path": "application/src/main/resources/templates/gateway_fragments/input.html", "content": "
\n
\n \n\n
\n \n \n \n\n \n \n \n
\n
\n
" }, { "path": "application/src/main/resources/templates/gateway_fragments/layout.html", "content": "\n\n \n \n \n \n \n \n \n \n \n \n\n \n\n \n \n \n \n \n \n \n\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/login.html", "content": "\n
0}\" th:with=\"error = ${param.error[0]}\">\n \n \n \n \n \n \n \n \n \n
\n
0}\">\n \n
\n
0}\">\n \n
\n
0}\">\n \n
\n
0}\">\n \n
\n\n
\n\n
\n \n \n
\n\n
\n \n
\n\n\n
\n \n
\n
\n \n
\n
\n \n \n
" }, { "path": "application/src/main/resources/templates/gateway_fragments/login.properties", "content": "form.messages.logoutSuccess=登出成功。\nform.messages.signupSuccess=恭喜！注册成功，请立即登录。\nform.messages.oauth2Bind=当前登录未绑定账号，请尝试通过其他方式登录，登录成功后会自动绑定账号。\nform.messages.passwordReset=密码重置成功，请立即登录。\nform.error.invalidCredential=无效的凭证。\nform.error.rateLimitExceeded=请求过于频繁，请稍后再试。\nform.error.accountDisabled=账号已被禁用。\nform.rememberMe.label=保持登录会话\nform.submit=登录\n\notherLogin.label=其他登录方式\n\n# Rule: `formAuthProviders.${provider.metadata.name}.displayName`\nformAuthProviders.local.displayName=账号密码登录" }, { "path": "application/src/main/resources/templates/gateway_fragments/login_en.properties", "content": "form.messages.logoutSuccess=Logout successfully.\nform.messages.signupSuccess=Congratulations! Sign up successfully, please login now.\nform.messages.oauth2Bind=The current login is not bound to an account. Please try to log in through other methods. After successful login, the account will be automatically bound.\nform.messages.passwordReset=Password reset successfully, please login now.\nform.error.invalidCredential=Invalid credentials.\nform.error.rateLimitExceeded=Too many requests, please try again later.\nform.error.accountDisabled=Account has been disabled.\nform.rememberMe.label=Remember me\nform.submit=Login\n\notherLogin.label=Other Login\n\n# Rule: `formAuthProviders.${provider.metadata.name}.displayName`\nformAuthProviders.local.displayName=Login with credentials" }, { "path": "application/src/main/resources/templates/gateway_fragments/login_es.properties", "content": "form.messages.logoutSuccess=Cierre de sesión exitoso.\nform.messages.signupSuccess=¡Felicidades! Registro exitoso, por favor inicie sesión de inmediato.\nform.messages.oauth2Bind=El inicio de sesión actual no está vinculado a una cuenta. Intente iniciar sesión a través de otros métodos. Después de un inicio de sesión exitoso, la cuenta se vinculará automáticamente.\nform.messages.passwordReset=¡Felicidades! La contraseña se ha restablecido con éxito.\nform.error.invalidCredential=Credenciales inválidas.\nform.error.rateLimitExceeded=Demasiadas solicitudes, por favor intente nuevamente más tarde.\nform.error.accountDisabled=La cuenta ha sido deshabilitada.\nform.rememberMe.label=Mantener sesión iniciada\nform.submit=Iniciar sesión\n\notherLogin.label=Otras formas de inicio de sesión\n\n# Rule: `formAuthProviders.${provider.metadata.name}.displayName`\nformAuthProviders.local.displayName=Iniciar sesión con credenciales" }, { "path": "application/src/main/resources/templates/gateway_fragments/login_zh_TW.properties", "content": "form.messages.logoutSuccess=登出成功。\nform.messages.signupSuccess=恭喜！註冊成功，請立即登入。\nform.messages.oauth2Bind=當前登入未綁定至帳戶。請嘗試通過其他方法登入。成功登入後，帳戶將自動綁定。\nform.messages.passwordReset=密碼重置成功。請立即登入。\nform.error.invalidCredential=無效的憑證。\nform.error.rateLimitExceeded=請求過於頻繁，請稍後再試。\nform.error.accountDisabled=帳戶已被停用。\nform.form.rememberMe.label=保持登入會話\nform.form.submit=登入\n\notherLogin.label=其他登入方式\n\n# Rule: `formAuthProviders.${provider.metadata.name}.displayName`\nformAuthProviders.local.displayName=帳號密碼登入" }, { "path": "application/src/main/resources/templates/gateway_fragments/logout.html", "content": "
\n
\n \n
\n \n \n
\n
\n
\n \n
\n\n
\n \n
\n
\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/logout.properties", "content": "form.submit=退出登录\nform.cancel=取消\nform.currentUser.label=当前登录的用户：" }, { "path": "application/src/main/resources/templates/gateway_fragments/logout_en.properties", "content": "form.submit=Logout\nform.cancel=Cancel\nform.currentUser.label=Currently logged in user:" }, { "path": "application/src/main/resources/templates/gateway_fragments/logout_es.properties", "content": "form.submit=Cerrar Sesión\nform.cancel=Cancelar\nform.currentUser.label=Usuario actualmente conectado:\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/logout_zh_TW.properties", "content": "form.submit=退出登入\nform.cancel=取消\nform.currentUser.label=當前登入的使用者：" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_reset.html", "content": "\n
\n \n
\n
\n \n \n

\n
\n
\n \n \n

\n
\n
\n
\n
\n
\n \n
\n\n \n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_reset.properties", "content": "form.password.label=密码\nform.confirmPassword.label=确认密码\nform.password.tips=密码只能使用大小写字母 (A-Z, a-z)、数字 (0-9)，以及以下特殊字符: !@#$%^&*.?。\nform.submit=修改密码\nerror.rate_limit_exceeded=您的请求过于频繁，请稍后再试。\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_reset_en.properties", "content": "form.password.label=Password\nform.confirmPassword.label=Confirm Password\nform.password.tips=The password can only use uppercase and lowercase letters (A-Z, a-z), numbers (0-9), and the following special characters: !@#$%^&*.?\nform.submit=Change password\nerror.rate_limit_exceeded=Your request is too frequent, please try again later.\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_reset_es.properties", "content": "form.password.label=Contraseña\nform.confirmPassword.label=Confirmar Contraseña\nform.password.tips=La contraseña solo puede usar letras mayúsculas y minúsculas (A-Z, a-z), números (0-9) y los siguientes caracteres especiales: !@#$%^&*.?\nform.submit=Cambiar Contraseña\nerror.rate_limit_exceeded=Su solicitud es demasiado frecuente, por favor intente nuevamente más tarde.\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_reset_zh_TW.properties", "content": "form.password.label=密碼\nform.confirmPassword.label=確認密碼\nform.password.tips=密碼只能使用大小寫字母 (A-Z, a-z)、數字 (0-9)，以及以下特殊字符: !@#$%^&*.?\nform.submit=修改密碼\nerror.rate_limit_exceeded=您的請求過於頻繁，請稍後再試。\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_send.html", "content": "\n
\n
\n
\n
\n
\n \n
\n
\n
\n
0}\">\n \n
\n
\n \n
\n
\n \n
\n \n
\n

\n
\n
\n \n
\n
\n\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_send.properties", "content": "form.email.label=电子邮箱\nform.submit=提交\nform.sent.submit=返回到登录页面\nform.message.success=检查您的电子邮件中是否有重置密码的链接。如果几分钟内没有出现，请检查您的垃圾邮件文件夹。\nerror.rate_limit_exceeded=您的请求速度太快。请稍后再试。\nerror.invalid_reset_token=重置密码令牌无效。请重试。\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_send_en.properties", "content": "form.email.label=Email\nform.submit=Submit\nform.sent.submit=Return to login\nform.message.success=Check your email for a link to reset your password. If it doesn’t appear within a few minutes, check your spam folder.\nerror.rate_limit_exceeded=You are making requests too quickly. Please try again later.\nerror.invalid_reset_token=The reset password token is invalid. Please try again.\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_send_es.properties", "content": "form.email.label=Correo Electrónico\nform.submit=Enviar\nform.sent.submit=Volver a la Página de Inicio de Sesión\nform.message.success=Revisa tu correo electrónico para ver el enlace de restablecimiento de contraseña. Si no aparece en unos minutos, revisa tu carpeta de spam.\nerror.rate_limit_exceeded=Se ha superado el límite de intentos de restablecimiento de contraseña. Por favor, inténtalo de nuevo más tarde.\nerror.invalid_reset_token=El enlace de restablecimiento de contraseña no es válido o ha expirado. Por favor, solicita un nuevo enlace.\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/password_reset_email_send_zh_TW.properties", "content": "form.email.label=電子郵件\nform.submit=提交\nform.sent.submit=返回到登入頁面\nform.message.success=檢查您的電子郵件中是否有重置密碼的連結。如果幾分鐘內沒有出現，請檢查您的垃圾郵件資料夾。\nerror.rate_limit_exceeded=您的請求過於頻繁。請稍後再試。\nerror.invalid_reset_token=重置密碼連結無效。請重試。\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/signup.html", "content": "\n
\n \n \n \n
\n
\n \n \n \n
\n
\n \n \n \n
\n
\n \n \n \n
\n
\n
\n \n
\n \n
\n

\n
\n\n
\n \n
\n \n
\n

\n
\n
\n\n
\n
\n \n
\n \n
\n

\n
\n\n
\n \n
\n
\n \n
\n\n \n
\n

\n
\n
\n\n
\n \n \n

\n
\n\n
\n \n \n

\n
\n\n
\n \n
\n\n \n\n \n\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/signup.properties", "content": "form.username.label=用户名\nform.displayName.label=名称\nform.email.label=电子邮箱\nform.emailCode.label=邮箱验证码\nform.emailCode.sendButton=发送\nform.emailCode.send.emptyValidation=请先输入邮箱地址\nform.password.label=密码\nform.confirmPassword.label=确认密码\nform.submit=注册\nform.error.invalidEmailCode=无效的邮箱验证码\nform.error.duplicateUsername=用户名已经被注册\nform.error.rateLimitExceeded=请求过于频繁，请稍后再试\nform.error.protectedUsernames=用户名或名称被禁止注册" }, { "path": "application/src/main/resources/templates/gateway_fragments/signup_en.properties", "content": "form.username.label=Username\nform.displayName.label=Display Name\nform.email.label=Email\nform.emailCode.label=Email Verification Code\nform.emailCode.sendButton=Send\nform.emailCode.send.emptyValidation=Please enter your email address first\nform.password.label=Password\nform.confirmPassword.label=Confirm Password\nform.submit=Sign Up\nform.error.invalidEmailCode=Invalid Email Verification Code\nform.error.duplicateUsername=Username is already taken\nform.error.rateLimitExceeded=Too many requests, please try again later\nform.error.protectedUsernames=The username or display name is not allowed to be registered\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/signup_es.properties", "content": "form.username.label=Nombre de Usuario\nform.displayName.label=Nombre\nform.email.label=Correo Electrónico\nform.emailCode.label=Código de Verificación\nform.emailCode.sendButton=Enviar\nform.emailCode.send.emptyValidation=Por favor, introduce tu dirección de correo electrónico primero\nform.password.label=Contraseña\nform.confirmPassword.label=Confirmar Contraseña\nform.submit=Registrarse\nform.error.invalidEmailCode=Código de verificación del correo inválido\nform.error.duplicateUsername=El nombre de usuario ya está registrado\nform.error.rateLimitExceeded=Demasiadas solicitudes, por favor intente nuevamente más tarde\nform.error.protectedUsernames=Este nombre de usuario o nombre no están permitidos\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/signup_zh_TW.properties", "content": "form.username.label=使用者名稱\nform.displayName.label=名稱\nform.email.label=電子郵件\nform.emailCode.label=郵箱驗證碼\nform.emailCode.sendButton=發送\nform.emailCode.send.emptyValidation=請先輸入電子郵件地址\nform.password.label=密碼\nform.confirmPassword.label=確認密碼\nform.submit=註冊\nform.error.invalidEmailCode=無效的郵箱驗證碼\nform.error.duplicateUsername=使用者名稱已經被註冊\nform.error.rateLimitExceeded=請求過於頻繁，請稍後再試\nform.error.protectedUsernames=使用者名稱或名稱被禁止註冊\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/totp.html", "content": "\n
0}\">\n \n
\n
\n \n
\n \n
\n
\n
\n \n
\n
\n \n
\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/totp.properties", "content": "form.messages.invalidError=错误的验证码\nform.code.label=验证码\nform.submit=验证\nform.cancel=取消\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/totp_en.properties", "content": "form.messages.invalidError=Invalid TOTP code\nform.code.label=TOTP Code\nform.submit=Verify\nform.cancel=Cancel\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/totp_es.properties", "content": "form.messages.invalidError=Código de verificación incorrecto\nform.code.label=Código de Verificación\nform.submit=Verificar\nform.cancel=Cancelar\n" }, { "path": "application/src/main/resources/templates/gateway_fragments/totp_zh_TW.properties", "content": "form.messages.invalidError=錯誤的驗證碼\nform.code.label=驗證碼\nform.submit=驗證\nform.cancel=取消\n" }, { "path": "application/src/main/resources/templates/login.html", "content": "\n\n \n
\n
\n\n
\n
\n
\n
\n
\n\n
\n
\n
\n
\n \n\n" }, { "path": "application/src/main/resources/templates/login.properties", "content": "title=登录" }, { "path": "application/src/main/resources/templates/login_en.properties", "content": "title=Login\n" }, { "path": "application/src/main/resources/templates/login_es.properties", "content": "title=Iniciar Sesión\n" }, { "path": "application/src/main/resources/templates/login_local.html", "content": "
\n \n\n
\n \n\n
\n \n
\n
\n
\n
\n \n \n \n
\n\n \n
\n
\n" }, { "path": "application/src/main/resources/templates/login_local.properties", "content": "form.username.label=用户名或邮箱地址\nform.password.label=密码\nform.password.forgot=忘记密码？\n" }, { "path": "application/src/main/resources/templates/login_local_en.properties", "content": "form.username.label=Username or email address\nform.password.label=Password\nform.password.forgot=Forgot your password?\n" }, { "path": "application/src/main/resources/templates/login_local_es.properties", "content": "form.username.label=Nombre de usuario o dirección de correo electrónico\nform.password.label=Contraseña\nform.password.forgot=¿Olvidaste tu contraseña?\n" }, { "path": "application/src/main/resources/templates/login_local_zh_TW.properties", "content": "form.username.label=使用者名稱或電子郵件地址\nform.password.label=密碼\nform.password.forgot=忘記密碼？" }, { "path": "application/src/main/resources/templates/login_zh_TW.properties", "content": "title=登入\n" }, { "path": "application/src/main/resources/templates/logout.html", "content": "\n\n \n
\n
\n
\n

\n
\n
\n
\n
\n \n\n \n \n \n\n" }, { "path": "application/src/main/resources/templates/logout.properties", "content": "title=退出登录\nform.title=确定要退出登录吗？" }, { "path": "application/src/main/resources/templates/logout_en.properties", "content": "title=Logout\nform.title=Are you sure want to log out?" }, { "path": "application/src/main/resources/templates/logout_es.properties", "content": "title=Cerrar Sesión\nform.title=¿Estás seguro de que deseas cerrar sesión?" }, { "path": "application/src/main/resources/templates/logout_zh_TW.properties", "content": "title=退出登入\nform.title=確定要退出登入嗎？" }, { "path": "application/src/main/resources/templates/password-reset/email/reset.html", "content": "\n\n \n
\n
\n
\n

\n
\n
\n
\n
\n \n\n" }, { "path": "application/src/main/resources/templates/password-reset/email/reset.properties", "content": "title=为 {0} 修改密码\n" }, { "path": "application/src/main/resources/templates/password-reset/email/reset_en.properties", "content": "title=Change password for @{0}\n" }, { "path": "application/src/main/resources/templates/password-reset/email/reset_es.properties", "content": "title=Cambiar Contraseña para {0}\n" }, { "path": "application/src/main/resources/templates/password-reset/email/reset_zh_TW.properties", "content": "title=為 {0} 修改密碼\n" }, { "path": "application/src/main/resources/templates/password-reset/email/send.html", "content": "\n\n \n
\n
\n
\n

\n
\n\n
\n
\n\n
\n
\n \n\n" }, { "path": "application/src/main/resources/templates/password-reset/email/send.properties", "content": "title=重置密码\nsent.title=已发送重置密码的邮件" }, { "path": "application/src/main/resources/templates/password-reset/email/send_en.properties", "content": "title=Reset password\nsent.title=Password reset email has been sent" }, { "path": "application/src/main/resources/templates/password-reset/email/send_es.properties", "content": "title=Restablecer Contraseña\nsent.title=Correo de Restablecimiento de Contraseña Enviado" }, { "path": "application/src/main/resources/templates/password-reset/email/send_zh_TW.properties", "content": "title=重置密碼\nsent.title=已發送重置密碼的郵件" }, { "path": "application/src/main/resources/templates/setup.html", "content": "\n\n \n \n \n \n
\n
\n\n
\n

\n
\n \n
\n \n
\n
\n\n
\n \n
\n \n
\n
\n\n
\n \n
\n \n
\n

\n
\n\n
\n \n
\n \n
\n

\n
\n\n
\n \n
\n \n
\n

\n
\n\n
\n \n
\n \n
\n

\n
\n\n
\n \n \n

\n
\n\n
\n \n \n
\n\n
\n \n
\n
\n
\n
\n\n \n \n\n" }, { "path": "application/src/main/resources/templates/setup.properties", "content": "title=系统初始化\nform.language.label=语言\nform.siteTitle.label=站点标题\nform.username.label=用户名\nform.email.label=电子邮箱\nform.password.label=密码\nform.confirmPassword.label=确认密码\nform.externalUrl.label=外部访问地址\nform.submit=初始化\nform.messages.h2.title=警告：正在使用 H2 数据库\nform.messages.h2.content=H2 数据库仅适用于开发环境和测试环境，不推荐在生产环境中使用，H2 非常容易因为操作不当导致数据文件损坏。如果必须要使用，请按时进行数据备份。" }, { "path": "application/src/main/resources/templates/setup_en.properties", "content": "title=Setup\nform.language.label=Language\nform.siteTitle.label=Site title\nform.username.label=Username\nform.email.label=Email\nform.password.label=Password\nform.confirmPassword.label=Confirm Password\nform.externalUrl.label=External URL\nform.submit=Setup\nform.messages.h2.title=Warning: Using H2 Database\nform.messages.h2.content=The H2 database is only suitable for development and testing environments. It is not recommended for production environments, as H2 is very prone to data file corruption due to improper operations. If you must use it, please back up your data regularly." }, { "path": "application/src/main/resources/templates/setup_es.properties", "content": "title=Configuración\nform.language.label=Idioma\nform.siteTitle.label=Título del Sitio\nform.username.label=Nombre de Usuario\nform.email.label=Correo Electrónico\nform.password.label=Contraseña\nform.confirmPassword.label=Confirmar Contraseña\nform.externalUrl.label=URL Externa\nform.submit=Configurar\nform.messages.h2.title=Advertencia: Usando la base de datos H2\nform.messages.h2.content=La base de datos H2 solo es adecuada para entornos de desarrollo y prueba. No se recomienda su uso en entornos de producción, ya que H2 es muy susceptible a la corrupción de archivos de datos debido a un manejo inadecuado. Si debe usarla, realice copias de seguridad de los datos regularmente." }, { "path": "application/src/main/resources/templates/setup_zh_TW.properties", "content": "title=系統初始化\nform.language.label=語言\nform.siteTitle.label=站點標題\nform.username.label=使用者名稱\nform.email.label=電子郵件\nform.password.label=密碼\nform.confirmPassword.label=確認密碼\nform.externalUrl.label=外部訪問地址\nform.submit=初始化\nform.messages.h2.title=警告：正在使用 H2 資料庫\nform.messages.h2.content=H2 資料庫僅適用於開發環境和測試環境，不建議在生產環境中使用，H2 非常容易因為操作不當導致資料檔案損壞。如果必須要使用，請按時進行資料備份。" }, { "path": "application/src/main/resources/templates/signup.html", "content": "\n\n \n \n \n \n
\n
\n
\n

\n
\n
\n
\n
\n
\n
\n
\n \n\n" }, { "path": "application/src/main/resources/templates/signup.properties", "content": "title=注册" }, { "path": "application/src/main/resources/templates/signup_en.properties", "content": "title=Sign Up" }, { "path": "application/src/main/resources/templates/signup_es.properties", "content": "title=Registrarse" }, { "path": "application/src/main/resources/templates/signup_zh_TW.properties", "content": "title=註冊" }, { "path": "application/src/main/resources/thumbnailator.properties", "content": "# See https://github.com/coobird/thumbnailator/issues/69 for more\nthumbnailator.conserveMemoryWorkaround=true\n" }, { "path": "application/src/test/java/run/halo/app/ApplicationTests.java", "content": "package run.halo.app;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.boot.test.context.SpringBootTest;\n\n@SpringBootTest\nclass ApplicationTests {\n\n @Test\n void contextLoads() {\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/PathPrefixPredicateTest.java", "content": "package run.halo.app;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RestController;\nimport org.springframework.web.method.HandlerTypePredicate;\n\n/**\n * Test case for api path prefix predicate.\n *\n * @author guqing\n * @date 2022-04-13\n */\npublic class PathPrefixPredicateTest {\n\n @Test\n public void prefixPredicate() {\n boolean falseResult = HandlerTypePredicate.forAnnotation(RestController.class)\n .and(HandlerTypePredicate.forBasePackage(Application.class.getPackageName()))\n .test(getClass());\n assertThat(falseResult).isFalse();\n\n boolean result = HandlerTypePredicate.forAnnotation(RestController.class)\n .and(HandlerTypePredicate.forBasePackage(Application.class.getPackageName()))\n .test(TestController.class);\n assertThat(result).isTrue();\n }\n\n @RestController(\"controller-for-test\")\n @RequestMapping(\"/test-prefix\")\n class TestController {\n\n }\n\n\n @Test\n void urlTest() {\n URI uri = URI.create(\"https:///path\");\n System.out.println(uri);\n System.out.println(uri.getPath());\n System.out.println(URI.create(\"/\"));\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/XForwardHeaderTest.java", "content": "package run.halo.app;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.springframework.boot.test.context.SpringBootTest.WebEnvironment.RANDOM_PORT;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.GET;\nimport static org.springframework.web.reactive.function.server.RouterFunctions.route;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.test.web.server.LocalServerPort;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.web.reactive.function.client.WebClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.test.StepVerifier;\n\n@SpringBootTest(webEnvironment = RANDOM_PORT,\n properties = \"server.forward-headers-strategy=native\")\nclass XForwardHeaderTest {\n\n @LocalServerPort\n int port;\n\n @Test\n void shouldGetCorrectProtoFromXForwardHeaders() {\n var response = WebClient.create(\"http://localhost:\" + port)\n .get().uri(\"/print-uri\")\n .header(\"X-Forwarded-Proto\", \"https\")\n .header(\"X-Forwarded-Host\", \"halo.run\")\n .header(\"X-Forwarded-Port\", \"6666\")\n .retrieve()\n .toEntity(String.class);\n StepVerifier.create(response)\n .assertNext(entity -> {\n assertEquals(HttpStatus.OK, entity.getStatusCode());\n assertEquals(\"\\\"https://halo.run:6666/print-uri\\\"\", entity.getBody());\n })\n .verifyComplete();\n }\n\n @TestConfiguration\n static class Configuration {\n\n @Bean\n RouterFunction printUri() {\n return route(GET(\"/print-uri\"),\n request -> {\n var uri = request.exchange().getRequest().getURI();\n return ServerResponse.ok().bodyValue(uri);\n });\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/config/CorsTest.java", "content": "package run.halo.app.config;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.web.reactive.server.WebTestClient;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass CorsTest {\n\n @Autowired\n WebTestClient webClient;\n\n @Nested\n class RequestCorsEnabledApi {\n\n @Test\n @WithMockUser\n void shouldNotResponseAllowOriginHeaderWithSameOrigin() {\n webClient.get().uri(\"http://localhost:3000/apis/cors-enabled\")\n .header(HttpHeaders.ORIGIN, \"http://localhost:3000\")\n .header(HttpHeaders.AUTHORIZATION, \"fake-authorization\")\n .header(\"FakeHeader\", \"fake-header-value\")\n .accept(MediaType.APPLICATION_JSON)\n .exchange()\n .expectHeader()\n .doesNotExist(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN);\n }\n\n @Test\n @WithMockUser\n void shouldResponseAllowOriginHeaderWithDifferentOrigin() {\n webClient.get().uri(\"http://localhost:3000/apis/cors-enabled\")\n .header(HttpHeaders.ORIGIN, \"https://another.website\")\n .header(HttpHeaders.AUTHORIZATION, \"fake-authorization\")\n // .header(\"ForbiddenHeader\", \"fake value\")\n .accept(MediaType.APPLICATION_JSON)\n .exchange()\n .expectHeader()\n .exists(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN);\n }\n\n @Test\n @WithMockUser\n void shouldResponseAllowOriginHeaderWithForbiddenHeader() {\n webClient.get().uri(\"http://localhost:3000/apis/cors-enabled\")\n .header(HttpHeaders.ORIGIN, \"https://another.website\")\n .header(HttpHeaders.AUTHORIZATION, \"fake-authorization\")\n .header(\"FakeHeader\", \"fake-header-value\")\n // .header(\"ForbiddenHeader\", \"fake value\")\n .accept(MediaType.APPLICATION_JSON)\n .exchange()\n .expectHeader()\n .exists(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN);\n }\n }\n\n @Nested\n class RequestCorsDisabledApi {\n\n @Test\n @WithMockUser\n void shouldNotResponseAllowOriginHeaderWithDifferentOrigin() {\n webClient.get().uri(\"http://localhost:3000/cors-disabled\")\n .header(HttpHeaders.ORIGIN, \"https://another.website\")\n .header(HttpHeaders.AUTHORIZATION, \"fake-authorization\")\n .accept(MediaType.APPLICATION_JSON)\n .exchange()\n .expectHeader()\n .doesNotExist(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN);\n }\n\n @Test\n @WithMockUser\n void shouldNotResponseAllowOriginHeaderWithSameOrigin() {\n webClient.get().uri(\"http://localhost:3000/cors-disabled\")\n .header(HttpHeaders.ORIGIN, \"http://localhost:3000\")\n .header(HttpHeaders.AUTHORIZATION, \"fake-authorization\")\n .header(\"FakeHeader\", \"fake-header-value\")\n .accept(MediaType.APPLICATION_JSON)\n .exchange()\n .expectHeader()\n .doesNotExist(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN);\n }\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/config/ExtensionConfigurationTest.java", "content": "package run.halo.app.config;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.anySet;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\n\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.DisplayName;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.store.ExtensionStoreRepository;\n\n@DirtiesContext\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass ExtensionConfigurationTest {\n\n @Autowired\n WebTestClient webClient;\n\n @Autowired\n SchemeManager schemeManager;\n\n @MockitoBean\n RoleService roleService;\n\n @BeforeEach\n void setUp() {\n // disable authorization\n var rule = new Role.PolicyRule.Builder()\n .apiGroups(\"*\")\n .resources(\"*\")\n .verbs(\"*\")\n .build();\n var role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(\"supper-role\");\n role.setRules(List.of(rule));\n when(roleService.listDependenciesFlux(anySet())).thenReturn(Flux.just(role));\n // register scheme\n schemeManager.register(FakeExtension.class);\n\n webClient = webClient.mutateWith(csrf());\n }\n\n @AfterEach\n void cleanUp(@Autowired ExtensionStoreRepository repository) {\n var gvk = Scheme.buildFromType(FakeExtension.class).groupVersionKind();\n repository.deleteAll().block();\n schemeManager.fetch(GroupVersionKind.fromExtension(FakeExtension.class))\n .ifPresent(scheme -> schemeManager.unregister(scheme));\n }\n\n @Test\n @WithMockUser\n void shouldReturnNotFoundWhenSchemeNotRegistered() {\n // unregister the Extension if necessary\n schemeManager.fetch(Scheme.buildFromType(FakeExtension.class).groupVersionKind())\n .ifPresent(schemeManager::unregister);\n\n webClient.get()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes\")\n .exchange()\n .expectStatus().isNotFound();\n\n webClient.get()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .exchange()\n .expectStatus().isNotFound();\n\n webClient.post()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes\")\n .bodyValue(new FakeExtension())\n .exchange()\n .expectStatus().isNotFound();\n\n webClient.put()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .bodyValue(new FakeExtension())\n .exchange()\n .expectStatus().isNotFound();\n\n webClient.delete()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .exchange()\n .expectStatus().isNotFound();\n }\n\n @Nested\n @DisplayName(\"After creating extension\")\n class AfterCreatingExtension {\n\n @Autowired\n ExtensionClient extClient;\n\n FakeExtension createdFake;\n\n @BeforeEach\n void setUp() {\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n metadata.setLabels(Map.of(\"label-key\", \"label-value\"));\n var fake = new FakeExtension();\n fake.setMetadata(metadata);\n\n webClient.get()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/{}\", metadata.getName())\n .exchange()\n .expectStatus().isNotFound();\n\n createdFake = webClient.post()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(fake)\n .exchange()\n .expectStatus().isCreated()\n .expectHeader().location(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .expectBody(FakeExtension.class)\n .consumeWith(result -> {\n var gotFake = result.getResponseBody();\n assertNotNull(gotFake);\n assertEquals(\"my-fake\", gotFake.getMetadata().getName());\n assertNotNull(gotFake.getMetadata().getVersion());\n assertNotNull(gotFake.getMetadata().getCreationTimestamp());\n })\n .returnResult()\n .getResponseBody();\n }\n\n @Test\n @WithMockUser\n void shouldDeleteExtensionWhenSchemeRegistered() {\n webClient.delete()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\",\n createdFake.getMetadata().getName())\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody(FakeExtension.class)\n .consumeWith(result -> {\n var deletedFake = result.getResponseBody();\n assertNotNull(deletedFake);\n assertNotNull(deletedFake.getMetadata().getDeletionTimestamp());\n assertTrue(deletedFake.getMetadata().getDeletionTimestamp()\n .isBefore(Instant.now()));\n });\n }\n\n @Test\n @WithMockUser\n void shouldListExtensionsWhenSchemeRegistered() {\n webClient.get().uri(\"/apis/fake.halo.run/v1alpha1/fakes\")\n .exchange()\n .expectStatus().isOk()\n .expectBody().jsonPath(\"$.items.length()\").isEqualTo(1);\n }\n\n @Test\n @WithMockUser\n void shouldListExtensionsWithMatchedSelectors() {\n webClient.get().uri(uriBuilder -> uriBuilder\n .path(\"/apis/fake.halo.run/v1alpha1/fakes\")\n .queryParam(\"labelSelector\", \"label-key=label-value\")\n .queryParam(\"fieldSelector\", \"name=my-fake\")\n .build())\n .exchange()\n .expectStatus().isOk()\n .expectBody().jsonPath(\"$.items.length()\").isEqualTo(1);\n }\n\n @Test\n @WithMockUser\n void shouldListExtensionsWithMismatchedSelectors() {\n webClient.get().uri(uriBuilder -> uriBuilder\n .path(\"/apis/fake.halo.run/v1alpha1/fakes\")\n .queryParam(\"labelSelector\", \"label-key=invalid-label-value\")\n .queryParam(\"fieldSelector\", \"name=invalid-name\")\n .build())\n .exchange()\n .expectStatus().isOk()\n .expectBody().jsonPath(\"$.items.length()\").isEqualTo(0);\n }\n\n @Test\n @WithMockUser\n void shouldUpdateExtensionWhenSchemeRegistered() {\n var name = createdFake.getMetadata().getName();\n FakeExtension fakeToUpdate = getFakeExtension(name);\n fakeToUpdate.getMetadata().setLabels(Map.of(\"updated\", \"true\"));\n\n webClient.put()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\", name)\n .bodyValue(fakeToUpdate)\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody(FakeExtension.class)\n .consumeWith(result -> {\n var updatedFake = result.getResponseBody();\n assertNotNull(updatedFake);\n assertNotEquals(fakeToUpdate.getMetadata().getVersion(),\n updatedFake.getMetadata().getVersion());\n assertEquals(Map.of(\"updated\", \"true\"),\n updatedFake.getMetadata().getLabels());\n });\n }\n\n @Test\n @WithMockUser\n void shouldGetExtensionWhenSchemeRegistered() {\n var name = createdFake.getMetadata().getName();\n webClient.get()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\", name)\n .exchange()\n .expectStatus().isOk()\n .expectBody(FakeExtension.class)\n .consumeWith(result -> {\n var gotFake = result.getResponseBody();\n assertNotNull(gotFake);\n assertEquals(name, gotFake.getMetadata().getName());\n assertNotNull(gotFake.getMetadata().getVersion());\n assertNotNull(gotFake.getMetadata().getCreationTimestamp());\n });\n }\n\n FakeExtension getFakeExtension(String name) {\n return webClient.get()\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\", name)\n .exchange()\n .expectStatus().isOk()\n .expectBody(FakeExtension.class)\n .returnResult()\n .getResponseBody();\n }\n\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/config/HaloConfigurationTest.java", "content": "package run.halo.app.config;\n\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertNull;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.annotation.DirtiesContext;\nimport run.halo.app.search.SearchEngine;\nimport run.halo.app.search.lucene.LuceneSearchEngine;\n\nclass HaloConfigurationTest {\n\n @Nested\n @SpringBootTest\n class LuceneSearchEngineDisabled {\n\n @Test\n void shouldNotCreateLuceneSearchEngineBean(\n @Autowired ObjectProvider searchEngines) {\n var searchEngine = searchEngines.getIfAvailable();\n assertNull(searchEngine);\n }\n }\n\n @Nested\n @SpringBootTest(properties = \"halo.search-engine.lucene.enabled=true\")\n @DirtiesContext\n class LuceneSearchEngineEnabled {\n\n @Test\n void shouldCreateLuceneSearchEngineBean(\n @Autowired ObjectProvider searchEngines) {\n var searchEngine = searchEngines.getIfAvailable();\n assertNotNull(searchEngine);\n assertInstanceOf(LuceneSearchEngine.class, searchEngine);\n }\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/config/SecurityConfigTest.java", "content": "package run.halo.app.config;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.springframework.security.web.server.header.StrictTransportSecurityServerHttpHeadersWriter.STRICT_TRANSPORT_SECURITY;\n\nimport org.apache.commons.lang3.RandomStringUtils;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.test.web.reactive.server.WebTestClient;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass SecurityConfigTest {\n\n @Autowired\n WebTestClient webClient;\n\n @Test\n void shouldNotIncludeSubdomainForHstsHeader() {\n webClient.get()\n .uri(builder -> builder.scheme(\"https\").path(\"/fake\").build())\n .accept(MediaType.TEXT_HTML)\n .exchange()\n .expectHeader()\n .value(STRICT_TRANSPORT_SECURITY,\n hsts -> assertFalse(hsts.contains(\"includeSubDomains\")));\n\n webClient.get()\n .uri(builder -> builder.scheme(\"https\").path(\"/apis/fake\").build())\n .accept(MediaType.APPLICATION_JSON)\n .exchange()\n .expectHeader()\n .value(STRICT_TRANSPORT_SECURITY,\n hsts -> assertFalse(hsts.contains(\"includeSubDomains\")));\n }\n\n @Test\n void shouldAllowPasswordLengthMoreThan72(@Autowired PasswordEncoder passwordEncoder) {\n var encoded = passwordEncoder.encode(RandomStringUtils.secure().nextAlphanumeric(73));\n assertNotNull(encoded);\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/config/ServerCodecTest.java", "content": "package run.halo.app.config;\n\nimport static org.hamcrest.Matchers.equalTo;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.accept;\nimport static org.springframework.web.reactive.function.server.RequestPredicates.contentType;\nimport static org.springframework.web.reactive.function.server.RouterFunctions.route;\n\nimport java.time.Instant;\nimport java.time.LocalDateTime;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Import;\nimport org.springframework.core.ParameterizedTypeReference;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\n@Import(ServerCodecTest.TestConfig.class)\nclass ServerCodecTest {\n\n static final String INSTANT = \"2022-06-09T10:57:30Z\";\n\n static final String LOCAL_DATE_TIME = \"2022-06-10T10:57:30\";\n\n @Autowired\n WebTestClient webClient;\n\n @Test\n @WithMockUser\n void timeSerializationTest() {\n webClient.get().uri(\"/fake/api/times\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.instant\").value(equalTo(INSTANT))\n .jsonPath(\"$.localDateTime\").value(equalTo(LOCAL_DATE_TIME))\n ;\n }\n\n @Test\n @WithMockUser\n void timeDeserializationTest() {\n webClient\n .mutateWith(csrf())\n .post().uri(\"/fake/api/time/report\")\n .contentType(MediaType.APPLICATION_JSON)\n .accept(MediaType.APPLICATION_JSON)\n .bodyValue(Map.of(\"now\", Instant.parse(INSTANT)))\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody(new ParameterizedTypeReference>() {\n }).isEqualTo(Map.of(\"now\", Instant.parse(INSTANT)))\n ;\n }\n\n @TestConfiguration(proxyBeanMethods = false)\n static class TestConfig {\n\n @Bean\n RouterFunction timesRouter() {\n return route().GET(\"/fake/api/times\", request -> {\n var times = Map.of(\"instant\", Instant.parse(INSTANT),\n \"localDateTime\", LocalDateTime.parse(LOCAL_DATE_TIME));\n return ServerResponse\n .ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(times);\n }).build();\n }\n\n @Bean\n RouterFunction reportTime() {\n final var type = new ParameterizedTypeReference>() {\n };\n return route().POST(\"/fake/api/time/report\",\n contentType(MediaType.APPLICATION_JSON).and(accept(MediaType.APPLICATION_JSON)),\n request -> ServerResponse.ok()\n .body(request.bodyToMono(type), type))\n .build();\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/config/WebFluxConfigTest.java", "content": "package run.halo.app.config;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport java.util.List;\nimport java.util.Set;\nimport org.hamcrest.core.StringStartsWith;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.ValueSource;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.test.web.server.LocalServerPort;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Import;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.filter.reactive.ServerWebExchangeContextFilter;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.reactive.socket.WebSocketHandler;\nimport org.springframework.web.reactive.socket.WebSocketMessage;\nimport org.springframework.web.reactive.socket.client.ReactorNettyWebSocketClient;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.endpoint.WebSocketEndpoint;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.Metadata;\n\n@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)\n@Import({\n WebFluxConfigTest.WebSocketSupportTest.TestWebSocketConfiguration.class,\n WebFluxConfigTest.ServerWebExchangeContextFilterTest.TestConfig.class,\n WebFluxConfigTest.UrlHandlerFilterTest.TestConfig.class\n})\n@AutoConfigureWebTestClient\nclass WebFluxConfigTest {\n\n @Autowired\n WebTestClient webClient;\n\n @MockitoSpyBean\n RoleService roleService;\n\n @LocalServerPort\n int port;\n\n @Nested\n class WebSocketSupportTest {\n\n @Test\n void shouldInitializeWebSocketEndpoint() {\n var role = new Role();\n var metadata = new Metadata();\n metadata.setName(\"fake-role\");\n role.setMetadata(metadata);\n role.setRules(List.of(new Role.PolicyRule.Builder()\n .apiGroups(\"fake.halo.run\")\n .verbs(\"watch\")\n .resources(\"resources\")\n .build()));\n when(roleService.listDependenciesFlux(Set.of(\"anonymous\"))).thenReturn(Flux.just(role));\n var webSocketClient = new ReactorNettyWebSocketClient();\n webSocketClient.execute(\n URI.create(\"ws://localhost:\" + port + \"/apis/fake.halo.run/v1alpha1/resources\"),\n session -> {\n var send = session.send(Flux.just(session.textMessage(\"halo\")));\n var receive = session.receive().map(WebSocketMessage::getPayloadAsText)\n .next()\n .doOnNext(message -> assertEquals(\"HALO\", message));\n return send.and(receive);\n })\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @TestConfiguration\n static class TestWebSocketConfiguration {\n\n @Bean\n WebSocketEndpoint fakeWebSocketEndpoint() {\n return new FakeWebSocketEndpoint();\n }\n\n }\n\n static class FakeWebSocketEndpoint implements WebSocketEndpoint {\n\n @Override\n public String urlPath() {\n return \"/resources\";\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"fake.halo.run/v1alpha1\");\n }\n\n @Override\n public WebSocketHandler handler() {\n return session -> {\n var messages = session.receive()\n .map(message -> session.textMessage(\n message.getPayloadAsText().toUpperCase())\n );\n return session.send(messages).then(session.close());\n };\n }\n }\n\n }\n\n @Nested\n class UiPageRequest {\n\n @WithMockUser\n @ParameterizedTest\n @ValueSource(strings = {\n \"/console\",\n \"/console/index\",\n \"/console/index.html\",\n \"/console/dashboard\",\n \"/console/fake\"\n })\n void shouldRequestConsoleIndex(String uri) {\n webClient.get().uri(uri)\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class).value(StringStartsWith.startsWith(\"console index\"));\n }\n\n @WithMockUser\n @ParameterizedTest\n @ValueSource(strings = {\n \"/uc\",\n \"/uc/index\",\n \"/uc/index.html\",\n \"/uc/profile\",\n \"/uc/fake\"\n })\n void shouldRequestUcIndex(String uri) {\n webClient.get().uri(uri)\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class).value(StringStartsWith.startsWith(\"uc index\"));\n }\n\n @Test\n void shouldRedirectToLoginPageIfUnauthenticated() {\n webClient.get().uri(\"/console\")\n .exchange()\n .expectStatus().isFound()\n .expectHeader().location(\"/login?authentication_required\");\n }\n\n @Test\n @WithMockUser\n void shouldRequestUiAssetsCorrectly() {\n webClient.get().uri(\"/ui-assets/fake.txt\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class).value(StringStartsWith.startsWith(\"fake.\"));\n }\n\n @Test\n @WithMockUser\n void shouldResponseNotFoundWhenAssetsNotExist() {\n webClient.get().uri(\"/ui-assets/not-found.txt\")\n .exchange()\n .expectStatus().isNotFound();\n }\n }\n\n @Nested\n class StaticResourcesTest {\n\n @Test\n void shouldRespond404WhenThemeResourceNotFound() {\n webClient.get().uri(\"/themes/fake-theme/assets/favicon.ico\")\n .exchange()\n .expectStatus().isNotFound();\n }\n }\n\n\n @Nested\n class ServerWebExchangeContextFilterTest {\n\n @TestConfiguration\n static class TestConfig {\n\n @Bean\n RouterFunction assertServerWebExchangeRoute() {\n return RouterFunctions.route()\n .GET(\"/assert-server-web-exchange\",\n request -> Mono.deferContextual(contextView -> {\n var exchange = ServerWebExchangeContextFilter.getExchange(contextView);\n assertTrue(exchange.isPresent());\n return ServerResponse.ok().build();\n }))\n .build();\n }\n\n }\n\n @Test\n void shouldGetExchangeFromContextView() {\n webClient.get().uri(\"/assert-server-web-exchange\")\n .exchange()\n .expectStatus().isOk();\n }\n\n }\n\n @Nested\n class UrlHandlerFilterTest {\n\n @TestConfiguration\n static class TestConfig {\n\n @Bean\n RouterFunction urlHandlerFilterTestRoute() {\n return RouterFunctions.route()\n .GET(\"/fake\", request -> ServerResponse.ok().bodyValue(\"ok\"))\n .build();\n }\n\n }\n\n @Test\n void shouldHandleUrlWithTrailingSlash() {\n webClient.get().uri(\"/fake/\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class).isEqualTo(\"ok\");\n }\n\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/CategoryPostCountUpdaterTest.java", "content": "package run.halo.app.content;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.verify;\n\nimport java.time.Duration;\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.mockito.ArgumentCaptor;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport reactor.util.retry.Retry;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.SchemeManager;\n\n/**\n * Tests for {@link CategoryPostCountUpdater}.\n *\n * @author guqing\n * @since 2.15.0\n */\n@SpringBootTest\nclass CategoryPostCountUpdaterTest {\n\n\n private final List storedPosts = posts();\n\n private final List storedCategories = categories();\n\n @Autowired\n SchemeManager schemeManager;\n\n @MockitoSpyBean\n ExtensionClient client;\n\n @Autowired\n ReactiveExtensionClient reactiveClient;\n\n private CategoryPostCountUpdater.CategoryPostCountService categoryPostCountService;\n\n Mono deleteImmediately(Extension extension) {\n var name = extension.getMetadata().getName();\n var scheme = schemeManager.get(extension.getClass());\n return reactiveClient.fetch(scheme.type(), name)\n .flatMap(reactiveClient::delete)\n .flatMap(deleting -> reactiveClient.fetch(scheme.type(), name)\n .flatMap(e -> Mono.error(new IllegalStateException(\"Extension still exists\")))\n .retryWhen(Retry.backoff(10, Duration.ofMillis(100))\n .filter(IllegalStateException.class::isInstance)\n )\n .thenReturn(deleting)\n );\n }\n\n @BeforeEach\n void setUp() {\n categoryPostCountService =\n new CategoryPostCountUpdater.CategoryPostCountService(client);\n Flux.fromIterable(storedPosts)\n .flatMap(post -> reactiveClient.create(post))\n .as(StepVerifier::create)\n .expectNextCount(storedPosts.size())\n .verifyComplete();\n\n Flux.fromIterable(storedCategories)\n .flatMap(category -> reactiveClient.create(category))\n .as(StepVerifier::create)\n .expectNextCount(storedCategories.size())\n .verifyComplete();\n }\n\n @AfterEach\n void tearDown() {\n Flux.fromIterable(storedPosts)\n .flatMap(this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(storedPosts.size())\n .verifyComplete();\n\n Flux.fromIterable(storedCategories)\n .flatMap(this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(storedCategories.size())\n .verifyComplete();\n }\n\n @Test\n void reconcileStatusPostForCategoryA() {\n categoryPostCountService.recalculatePostCount(Set.of(\"category-A\"));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Category.class);\n verify(client).update(captor.capture());\n var value = captor.getValue();\n assertThat(value.getStatusOrDefault().getPostCount()).isEqualTo(1);\n assertThat(value.getStatusOrDefault().getVisiblePostCount()).isEqualTo(0);\n }\n\n @Test\n void reconcileStatusPostForCategoryB() {\n categoryPostCountService.recalculatePostCount(Set.of(\"category-B\"));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Category.class);\n verify(client).update(captor.capture());\n var category = captor.getValue();\n assertThat(category.getStatusOrDefault().getPostCount()).isEqualTo(1);\n assertThat(category.getStatusOrDefault().getVisiblePostCount()).isEqualTo(0);\n }\n\n @Test\n void reconcileStatusPostForCategoryC() {\n categoryPostCountService.recalculatePostCount(Set.of(\"category-C\"));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Category.class);\n verify(client).update(captor.capture());\n var value = captor.getValue();\n assertThat(value.getStatusOrDefault().getPostCount()).isEqualTo(2);\n assertThat(value.getStatusOrDefault().getVisiblePostCount()).isEqualTo(0);\n }\n\n @Test\n void reconcileStatusPostForCategoryD() {\n categoryPostCountService.recalculatePostCount(Set.of(\"category-D\"));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Category.class);\n verify(client).update(captor.capture());\n var value = captor.getValue();\n assertThat(value.getStatusOrDefault().postCount).isEqualTo(1);\n assertThat(value.getStatusOrDefault().visiblePostCount).isEqualTo(0);\n }\n\n private List categories() {\n /*\n * |-A(post-4)\n * |-B(post-3)\n * |-|-C(post-2,post-1)\n * |-D(post-1)\n */\n Category categoryA = category(\"category-A\");\n categoryA.getSpec().setChildren(List.of(\"category-B\", \"category-D\"));\n\n Category categoryB = category(\"category-B\");\n categoryB.getSpec().setChildren(List.of(\"category-C\"));\n\n Category categoryC = category(\"category-C\");\n Category categoryD = category(\"category-D\");\n return List.of(categoryA, categoryB, categoryC, categoryD);\n }\n\n private Category category(String name) {\n Category category = new Category();\n Metadata metadata = new Metadata();\n metadata.setName(name);\n category.setMetadata(metadata);\n category.setSpec(new Category.CategorySpec());\n category.setStatus(new Category.CategoryStatus());\n\n category.getSpec().setDisplayName(\"display-name\");\n category.getSpec().setSlug(\"slug\");\n category.getSpec().setPriority(0);\n return category;\n }\n\n private List posts() {\n /*\n * |-A(post-4)\n * |-B(post-3)\n * |-|-C(post-2,post-1)\n * |-D(post-1)\n */\n Post post1 = fakePost();\n post1.getMetadata().setName(\"post-1\");\n post1.getSpec().setCategories(List.of(\"category-D\", \"category-C\"));\n post1.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n\n Post post2 = fakePost();\n post2.getMetadata().setName(\"post-2\");\n post2.getSpec().setCategories(List.of(\"category-C\"));\n post2.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n\n Post post3 = fakePost();\n post3.getMetadata().setName(\"post-3\");\n post3.getSpec().setCategories(List.of(\"category-B\"));\n post3.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n\n Post post4 = fakePost();\n post4.getMetadata().setName(\"post-4\");\n post4.getSpec().setCategories(List.of(\"category-A\"));\n post4.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n return List.of(post1, post2, post3, post4);\n }\n\n Post fakePost() {\n var post = TestPost.postV1();\n post.getSpec().setAllowComment(true);\n post.getSpec().setDeleted(false);\n post.getSpec().setExcerpt(new Post.Excerpt());\n post.getSpec().getExcerpt().setAutoGenerate(false);\n post.getSpec().setPinned(false);\n post.getSpec().setPriority(0);\n post.getSpec().setPublish(false);\n post.getSpec().setSlug(\"fake-post\");\n return post;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/content/ContentRequestTest.java", "content": "package run.halo.app.content;\n\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link ContentRequest}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass ContentRequestTest {\n private ContentRequest contentRequest;\n\n @BeforeEach\n void setUp() {\n Ref ref = new Ref();\n ref.setKind(Post.KIND);\n ref.setGroup(\"content.halo.run\");\n ref.setName(\"test-post\");\n contentRequest = new ContentRequest(ref, \"snapshot-1\", null, \"\"\"\n Four score and seven\n years ago our fathers\n\n brought forth on this continent\n \"\"\",\n \"\"\"\n

Four score and seven

\n

years ago our fathers

\n
\n

brought forth on this continent

\n \"\"\",\n \"MARKDOWN\");\n }\n\n @Test\n void toSnapshot() throws JSONException {\n String expectedContentPath =\n \"

Four score and seven

\\\\n

years ago our fathers

\\\\n
\\\\n

brought forth \"\n + \"on this continent

\\\\n\";\n String expectedRawPatch =\n \"Four score and seven\\\\nyears ago our fathers\\\\n\\\\nbrought forth on this continent\\\\n\";\n Snapshot snapshot = contentRequest.toSnapshot();\n snapshot.getMetadata().setName(\"7b149646-ac60-4a5c-98ee-78b2dd0631b2\");\n JSONAssert.assertEquals(JsonUtils.objectToJson(snapshot),\n \"\"\"\n {\n \"spec\": {\n \"subjectRef\": {\n \"kind\": \"Post\",\n \"group\": \"content.halo.run\",\n \"name\": \"test-post\"\n },\n \"rawType\": \"MARKDOWN\",\n \"rawPatch\": \"%s\",\n \"contentPatch\": \"%s\"\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Snapshot\",\n \"metadata\": {\n \"name\": \"7b149646-ac60-4a5c-98ee-78b2dd0631b2\",\n \"annotations\": {}\n }\n }\n \"\"\".formatted(expectedRawPatch, expectedContentPath),\n true);\n }\n\n @Test\n void rawPatchFrom() throws JSONException {\n String s = contentRequest.rawPatchFrom(\"\"\"\n Four score and seven\n years ago our fathers\n \"\"\");\n JSONAssert.assertEquals(s,\n \"\"\"\n [\n {\n \"source\": {\n \"position\": 3,\n \"lines\": []\n },\n \"target\": {\n \"position\": 3,\n \"lines\": [\n \"brought forth on this continent\",\n \"\"\n ]\n },\n \"type\": \"INSERT\"\n }\n ]\n \"\"\", true);\n }\n\n @Test\n void contentPatchFrom() throws JSONException {\n String s = contentRequest.contentPatchFrom(\"\"\"\n

Four score and seven

\n

years ago our fathers

\n \"\"\");\n JSONAssert.assertEquals(s, \"\"\"\n [\n {\n \"source\": {\n \"position\": 2,\n \"lines\": []\n },\n \"target\": {\n \"position\": 2,\n \"lines\": [\n \"
\",\n \"

brought forth on this continent

\"\n ]\n },\n \"type\": \"INSERT\"\n }\n ]\n \"\"\", true);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/PostIntegrationTests.java", "content": "package run.halo.app.content;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.anySet;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.bean.override.mockito.MockitoBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataOperator;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Integration tests for {@link PostService}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@SpringBootTest\n@AutoConfigureWebTestClient\n@WithMockUser(username = \"fake-user\", password = \"fake-password\", roles = \"fake-super-role\")\npublic class PostIntegrationTests {\n\n @Autowired\n private WebTestClient webTestClient;\n\n @MockitoBean\n RoleService roleService;\n\n @BeforeEach\n void setUp() {\n var rule = new Role.PolicyRule.Builder()\n .apiGroups(\"*\")\n .resources(\"*\")\n .verbs(\"*\")\n .build();\n var role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(\"super-role\");\n role.setRules(List.of(rule));\n when(roleService.listDependenciesFlux(anySet())).thenReturn(Flux.just(role));\n webTestClient = webTestClient.mutateWith(csrf());\n }\n\n @Test\n void draftPost() {\n webTestClient.post()\n .uri(\"/apis/api.console.halo.run/v1alpha1/posts\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(postDraftRequest())\n .exchange()\n .expectBody(Post.class)\n .value(post -> {\n MetadataOperator metadata = post.getMetadata();\n Post.PostSpec spec = post.getSpec();\n assertThat(spec.getTitle()).isEqualTo(\"无标题文章\");\n assertThat(metadata.getCreationTimestamp()).isNotNull();\n assertThat(metadata.getName()).startsWith(\"post-\");\n assertThat(spec.getHeadSnapshot()).isNotNull();\n assertThat(spec.getHeadSnapshot()).isEqualTo(spec.getBaseSnapshot());\n assertThat(spec.getOwner()).isEqualTo(\"fake-user\");\n\n assertThat(post.getStatus()).isNotNull();\n assertThat(post.getStatus().getPhase()).isEqualTo(\"DRAFT\");\n assertThat(post.getStatus().getConditions().peek().getType()).isEqualTo(\"DRAFT\");\n });\n }\n\n @Test\n void draftPostAsPublish() {\n PostRequest postRequest = postDraftRequest();\n postRequest.post().getSpec().setPublish(true);\n webTestClient.post()\n .uri(\"/apis/api.console.halo.run/v1alpha1/posts\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(postRequest)\n .exchange()\n .expectBody(Post.class)\n .value(post -> {\n assertThat(post.getSpec().getReleaseSnapshot()).isNotNull();\n assertThat(post.getSpec().getReleaseSnapshot())\n .isEqualTo(post.getSpec().getHeadSnapshot());\n assertThat(post.getSpec().getHeadSnapshot())\n .isEqualTo(post.getSpec().getBaseSnapshot());\n });\n }\n\n PostRequest postDraftRequest() {\n String s = \"\"\"\n {\n \"post\": {\n \"spec\": {\n \"title\": \"无标题文章\",\n \"slug\": \"41c2ad39-21b4-45e4-a36b-5768245a0555\",\n \"template\": \"\",\n \"cover\": \"\",\n \"deleted\": false,\n \"publish\": true,\n \"publishTime\": \"\",\n \"pinned\": false,\n \"allowComment\": true,\n \"visible\": \"PUBLIC\",\n \"version\": 1,\n \"priority\": 0,\n \"excerpt\": {\n \"autoGenerate\": true,\n \"raw\": \"\"\n },\n \"categories\": [],\n \"tags\": [],\n \"htmlMetas\": []\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Post\",\n \"metadata\": {\n \"name\": \"\",\n \"generateName\": \"post-\"\n }\n },\n \"content\": {\n \"raw\": \"

hello world

\",\n \"content\": \"

hello world

\",\n \"rawType\": \"HTML\"\n }\n }\n \"\"\";\n return JsonUtils.jsonToObject(s, PostRequest.class);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/content/TestPost.java", "content": "package run.halo.app.content;\n\nimport java.time.Instant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataUtil;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\npublic class TestPost {\n public static Post postV1() {\n Post post = new Post();\n post.setKind(Post.KIND);\n post.setApiVersion(getApiVersion(Post.class));\n Metadata metadata = new Metadata();\n metadata.setName(\"post-A\");\n metadata.setVersion(1L);\n post.setMetadata(metadata);\n\n Post.PostSpec postSpec = new Post.PostSpec();\n post.setSpec(postSpec);\n\n postSpec.setTitle(\"post-A\");\n postSpec.setBaseSnapshot(snapshotV1().getMetadata().getName());\n postSpec.setHeadSnapshot(\"base-snapshot\");\n postSpec.setReleaseSnapshot(null);\n\n return post;\n }\n\n public static Snapshot snapshotV1() {\n Snapshot snapshot = new Snapshot();\n snapshot.setKind(Snapshot.KIND);\n snapshot.setApiVersion(getApiVersion(Snapshot.class));\n Metadata metadata = new Metadata();\n metadata.setName(\"snapshot-A\");\n metadata.setVersion(1L);\n metadata.setCreationTimestamp(Instant.now());\n snapshot.setMetadata(metadata);\n MetadataUtil.nullSafeAnnotations(snapshot).put(Snapshot.KEEP_RAW_ANNO, \"true\");\n Snapshot.SnapShotSpec spec = new Snapshot.SnapShotSpec();\n snapshot.setSpec(spec);\n\n Snapshot.addContributor(snapshot, \"guqing\");\n spec.setRawType(\"MARKDOWN\");\n spec.setRawPatch(\"A\");\n spec.setContentPatch(\"

A

\");\n\n return snapshot;\n }\n\n public static Snapshot snapshotV2() {\n Snapshot snapshot = new Snapshot();\n snapshot.setKind(Snapshot.KIND);\n snapshot.setApiVersion(getApiVersion(Snapshot.class));\n Metadata metadata = new Metadata();\n metadata.setCreationTimestamp(Instant.now().plusSeconds(10));\n metadata.setName(\"snapshot-B\");\n snapshot.setMetadata(metadata);\n Snapshot.SnapShotSpec spec = new Snapshot.SnapShotSpec();\n snapshot.setSpec(spec);\n Snapshot.addContributor(snapshot, \"guqing\");\n spec.setRawType(\"MARKDOWN\");\n spec.setRawPatch(PatchUtils.diffToJsonPatch(\"A\", \"B\"));\n spec.setContentPatch(PatchUtils.diffToJsonPatch(\"

A

\", \"

B

\"));\n\n return snapshot;\n }\n\n public static Snapshot snapshotV3() {\n Snapshot snapshotV3 = snapshotV2();\n snapshotV3.getMetadata().setName(\"snapshot-C\");\n snapshotV3.getMetadata().setCreationTimestamp(Instant.now().plusSeconds(20));\n Snapshot.SnapShotSpec spec = snapshotV3.getSpec();\n Snapshot.addContributor(snapshotV3, \"guqing\");\n spec.setRawType(\"MARKDOWN\");\n spec.setRawPatch(PatchUtils.diffToJsonPatch(\"B\", \"C\"));\n spec.setContentPatch(PatchUtils.diffToJsonPatch(\"

B

\", \"

C

\"));\n\n return snapshotV3;\n }\n\n public static String getApiVersion(Class extension) {\n GVK annotation = extension.getAnnotation(GVK.class);\n return annotation.group() + \"/\" + annotation.version();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/content/comment/CommentEmailOwnerTest.java", "content": "package run.halo.app.content.comment;\n\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link CommentEmailOwner}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass CommentEmailOwnerTest {\n\n @Test\n void constructorTest() throws JSONException {\n CommentEmailOwner commentEmailOwner =\n new CommentEmailOwner(\"example@example.com\", \"avatar\", \"displayName\", \"website\");\n JSONAssert.assertEquals(\"\"\"\n {\n \"email\": \"example@example.com\",\n \"avatar\": \"avatar\",\n \"displayName\": \"displayName\",\n \"website\": \"website\"\n }\n \"\"\",\n JsonUtils.objectToJson(commentEmailOwner),\n true);\n }\n\n @Test\n void toCommentOwner() throws JSONException {\n CommentEmailOwner commentEmailOwner =\n new CommentEmailOwner(\"example@example.com\", \"avatar\", \"displayName\", \"website\");\n Comment.CommentOwner commentOwner = commentEmailOwner.toCommentOwner();\n JSONAssert.assertEquals(\"\"\"\n {\n \"kind\": \"Email\",\n \"name\": \"example@example.com\",\n \"displayName\": \"displayName\",\n \"annotations\": {\n \"website\": \"website\",\n \"avatar\": \"avatar\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(commentOwner),\n true);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/CommentNotificationReasonPublisherTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport java.util.Optional;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.event.post.CommentCreatedEvent;\nimport run.halo.app.event.post.ReplyCreatedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.ExternalLinkProcessor;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.notification.NotificationReasonEmitter;\nimport run.halo.app.notification.ReasonPayload;\nimport run.halo.app.notification.UserIdentity;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Tests for {@link CommentNotificationReasonPublisher}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CommentNotificationReasonPublisherTest {\n\n @Mock\n private ExtensionClient client;\n\n @Mock\n CommentNotificationReasonPublisher.NewCommentOnPostReasonPublisher\n newCommentOnPostReasonPublisher;\n\n @Mock\n CommentNotificationReasonPublisher.NewCommentOnPageReasonPublisher\n newCommentOnPageReasonPublisher;\n\n @Mock\n CommentNotificationReasonPublisher.NewReplyReasonPublisher newReplyReasonPublisher;\n\n @InjectMocks\n private CommentNotificationReasonPublisher reasonPublisher;\n\n\n @Test\n void onNewCommentTest() {\n var comment = mock(Comment.class);\n var spyReasonPublisher = spy(reasonPublisher);\n\n doReturn(true).when(spyReasonPublisher).isPostComment(eq(comment));\n\n var event = new CommentCreatedEvent(this, comment);\n spyReasonPublisher.onNewComment(event);\n\n verify(newCommentOnPostReasonPublisher).publishReasonBy(eq(comment));\n\n doReturn(false).when(spyReasonPublisher).isPostComment(eq(comment));\n doReturn(true).when(spyReasonPublisher).isPageComment(eq(comment));\n\n spyReasonPublisher.onNewComment(event);\n verify(newCommentOnPageReasonPublisher).publishReasonBy(eq(comment));\n }\n\n @Test\n void onNewReplyTest() {\n var reply = mock(Reply.class);\n var spec = mock(Reply.ReplySpec.class);\n when(reply.getSpec()).thenReturn(spec);\n when(spec.getCommentName()).thenReturn(\"fake-comment\");\n\n var spyReasonPublisher = spy(reasonPublisher);\n var comment = mock(Comment.class);\n\n when(client.fetch(eq(Comment.class), eq(\"fake-comment\")))\n .thenReturn(Optional.of(comment));\n\n var event = new ReplyCreatedEvent(this, reply);\n spyReasonPublisher.onNewReply(event);\n\n verify(newReplyReasonPublisher).publishReasonBy(eq(reply), eq(comment));\n verify(spec).getCommentName();\n verify(client).fetch(eq(Comment.class), eq(\"fake-comment\"));\n }\n\n @Test\n void isPostCommentTest() {\n var comment = createComment();\n comment.getSpec()\n .setSubjectRef(Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class)));\n\n assertThat(reasonPublisher.isPostComment(comment)).isTrue();\n\n comment.getSpec()\n .setSubjectRef(Ref.of(\"fake-post\", GroupVersionKind.fromExtension(SinglePage.class)));\n\n assertThat(reasonPublisher.isPostComment(comment)).isFalse();\n }\n\n @Test\n void isPageComment() {\n var comment = createComment();\n comment.getSpec()\n .setSubjectRef(Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class)));\n\n assertThat(reasonPublisher.isPageComment(comment)).isFalse();\n\n comment.getSpec()\n .setSubjectRef(Ref.of(\"fake-post\", GroupVersionKind.fromExtension(SinglePage.class)));\n\n assertThat(reasonPublisher.isPageComment(comment)).isTrue();\n }\n\n @Nested\n @ExtendWith(MockitoExtension.class)\n class CommentContentConverterTest {\n @Mock\n ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n ExternalLinkProcessor externalLinkProcessor;\n\n @InjectMocks\n CommentNotificationReasonPublisher.CommentContentConverter commentContentConverter;\n\n @Test\n void shouldConvertRelativeImageLinksToAbsolute() {\n var content =\n \"

Test content \\\"Test

\";\n \n when(externalLinkProcessor.processLink(\"/upload/image.jpg\"))\n .thenReturn(\"https://example.com/upload/image.jpg\");\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).contains(\"https://example.com/upload/image.jpg\");\n assertThat(result).contains(\"Test content\");\n verify(externalLinkProcessor).processLink(\"/upload/image.jpg\");\n }\n\n @Test\n void shouldHandleRelativeImageLinksWithoutLeadingSlash() {\n var content = \"

\";\n \n when(externalLinkProcessor.processLink(\"upload/image.jpg\"))\n .thenReturn(\"https://example.com/upload/image.jpg\");\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).contains(\"https://example.com/upload/image.jpg\");\n verify(externalLinkProcessor).processLink(\"upload/image.jpg\");\n }\n\n @Test\n void shouldNotConvertAbsoluteImageLinks() {\n var content = \"

\";\n \n when(externalLinkProcessor.processLink(\"https://cdn.example.com/image.jpg\"))\n .thenReturn(\"https://cdn.example.com/image.jpg\");\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).contains(\"https://cdn.example.com/image.jpg\");\n verify(externalLinkProcessor).processLink(\"https://cdn.example.com/image.jpg\");\n }\n\n @Test\n void shouldHandleMultipleImages() {\n var content = \"

\"\n + \"\"\n + \"\"\n + \"\"\n + \"

\";\n \n when(externalLinkProcessor.processLink(\"/img1.jpg\"))\n .thenReturn(\"https://example.com/img1.jpg\");\n when(externalLinkProcessor.processLink(\"/img2.jpg\"))\n .thenReturn(\"https://example.com/img2.jpg\");\n when(externalLinkProcessor.processLink(\"https://example.com/img3.jpg\"))\n .thenReturn(\"https://example.com/img3.jpg\");\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).contains(\"https://example.com/img1.jpg\");\n assertThat(result).contains(\"https://example.com/img2.jpg\");\n assertThat(result).contains(\"https://example.com/img3.jpg\");\n verify(externalLinkProcessor).processLink(\"/img1.jpg\");\n verify(externalLinkProcessor).processLink(\"/img2.jpg\");\n verify(externalLinkProcessor).processLink(\"https://example.com/img3.jpg\");\n }\n\n @Test\n void shouldHandleContentWithoutImages() {\n var content = \"

This is a comment content without images

\";\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).contains(\"This is a comment content without images\");\n assertThat(result).doesNotContain(\"img\");\n }\n\n @Test\n void shouldHandleEmptyContent() {\n var content = \"\";\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).isEmpty();\n }\n\n @Test\n void shouldHandleComplexHtmlContent() {\n var content = \"\"\"\n
\n

Title

\n

Paragraph content

\n \"Photo\n

More text

\n \n
\n \"\"\";\n \n when(externalLinkProcessor.processLink(\"/images/photo1.png\"))\n .thenReturn(\"https://example.com/images/photo1.png\");\n when(externalLinkProcessor.processLink(\"assets/photo2.jpg\"))\n .thenReturn(\"https://example.com/assets/photo2.jpg\");\n\n var result = commentContentConverter.convertRelativeLinks(content);\n\n assertThat(result).contains(\"https://example.com/images/photo1.png\");\n assertThat(result).contains(\"https://example.com/assets/photo2.jpg\");\n assertThat(result).contains(\"Title\");\n assertThat(result).contains(\"Paragraph content\");\n verify(externalLinkProcessor).processLink(\"/images/photo1.png\");\n verify(externalLinkProcessor).processLink(\"assets/photo2.jpg\");\n }\n }\n\n @Nested\n @ExtendWith(MockitoExtension.class)\n class NewCommentOnPostReasonPublisherTest {\n @Mock\n ExtensionClient client;\n\n @Mock\n NotificationReasonEmitter emitter;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @Mock\n ExternalLinkProcessor externalLinkProcessor;\n\n @Mock\n CommentNotificationReasonPublisher.CommentContentConverter commentContentConverter;\n\n @InjectMocks\n CommentNotificationReasonPublisher.NewCommentOnPostReasonPublisher\n newCommentOnPostReasonPublisher;\n\n @Test\n void publishReasonByTest() {\n final var comment = createComment();\n comment.getSpec().getOwner().setDisplayName(\"fake-display-name\");\n comment.getSpec().setContent(\"fake-comment-content\");\n\n var post = mock(Post.class);\n final var spec = mock(Post.PostSpec.class);\n var metadata = new Metadata();\n metadata.setName(\"fake-post\");\n when(post.getMetadata()).thenReturn(metadata);\n when(post.getStatusOrDefault()).thenReturn(new Post.PostStatus());\n when(post.getSpec()).thenReturn(spec);\n when(spec.getTitle()).thenReturn(\"fake-title\");\n\n when(client.fetch(eq(Post.class), eq(metadata.getName())))\n .thenReturn(Optional.of(post));\n\n when(commentContentConverter.convertRelativeLinks(eq(\"fake-comment-content\")))\n .thenReturn(\"fake-comment-content\");\n\n when(emitter.emit(eq(\"new-comment-on-post\"), any()))\n .thenReturn(Mono.empty());\n\n newCommentOnPostReasonPublisher.publishReasonBy(comment);\n\n verify(client).fetch(eq(Post.class), eq(metadata.getName()));\n verify(emitter).emit(eq(\"new-comment-on-post\"), assertArg(consumer -> {\n var builder = ReasonPayload.builder();\n consumer.accept(builder);\n var reasonPayload = builder.build();\n var reasonSubject = Reason.Subject.builder()\n .apiVersion(post.getApiVersion())\n .kind(post.getKind())\n .name(post.getMetadata().getName())\n .title(post.getSpec().getTitle())\n .build();\n assertThat(reasonPayload.getSubject()).isEqualTo(reasonSubject);\n\n assertThat(reasonPayload.getAuthor())\n .isEqualTo(\n UserIdentity.anonymousWithEmail(comment.getSpec().getOwner().getName()));\n\n assertThat(reasonPayload.getAttributes()).containsAllEntriesOf(Map.of(\n \"postName\", post.getMetadata().getName(),\n \"postTitle\", post.getSpec().getTitle(),\n \"commenter\", comment.getSpec().getOwner().getDisplayName(),\n \"content\", comment.getSpec().getContent(),\n \"commentName\", comment.getMetadata().getName()\n ));\n }));\n }\n\n @Test\n void doNotEmitReasonTest() {\n final var comment = createComment();\n var commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(User.KIND);\n commentOwner.setName(\"fake-user\");\n comment.getSpec().setOwner(commentOwner);\n\n var post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"fake-post\");\n post.setSpec(new Post.PostSpec());\n post.getSpec().setOwner(\"fake-user\");\n\n // the username is the same as the comment owner\n assertThat(newCommentOnPostReasonPublisher.doNotEmitReason(comment, post)).isTrue();\n\n // not the same username\n commentOwner.setName(\"other\");\n assertThat(newCommentOnPostReasonPublisher.doNotEmitReason(comment, post)).isFalse();\n\n // the comment owner is email and the same as the post-owner user email\n commentOwner.setKind(Comment.CommentOwner.KIND_EMAIL);\n commentOwner.setName(\"example@example.com\");\n var user = new User();\n user.setSpec(new User.UserSpec());\n user.getSpec().setEmail(\"example@example.com\");\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Optional.of(user));\n\n assertThat(newCommentOnPostReasonPublisher.doNotEmitReason(comment, post)).isTrue();\n\n // the comment owner is email and not the same as the post-owner user email\n user.getSpec().setEmail(\"fake@example.com\");\n assertThat(newCommentOnPostReasonPublisher.doNotEmitReason(comment, post)).isFalse();\n }\n }\n\n @Nested\n @ExtendWith(MockitoExtension.class)\n class NewCommentOnPageReasonPublisherTest {\n @Mock\n ExtensionClient client;\n\n @Mock\n NotificationReasonEmitter emitter;\n\n @Mock\n ExternalLinkProcessor externalLinkProcessor;\n\n @Mock\n CommentNotificationReasonPublisher.CommentContentConverter commentContentConverter;\n\n @InjectMocks\n CommentNotificationReasonPublisher.NewCommentOnPageReasonPublisher\n newCommentOnPageReasonPublisher;\n\n @Test\n void publishReasonByTest() {\n final var comment = createComment();\n comment.getSpec().getOwner().setDisplayName(\"fake-display-name\");\n comment.getSpec().setContent(\"fake-comment-content\");\n comment.getSpec().setSubjectRef(\n Ref.of(\"fake-page\", GroupVersionKind.fromExtension(SinglePage.class)));\n\n var page = mock(SinglePage.class);\n final var spec = mock(SinglePage.SinglePageSpec.class);\n var metadata = new Metadata();\n metadata.setName(\"fake-page\");\n when(page.getMetadata()).thenReturn(metadata);\n when(page.getStatusOrDefault()).thenReturn(new SinglePage.SinglePageStatus());\n when(page.getSpec()).thenReturn(spec);\n when(spec.getTitle()).thenReturn(\"fake-title\");\n\n when(client.fetch(eq(SinglePage.class), eq(metadata.getName())))\n .thenReturn(Optional.of(page));\n\n when(commentContentConverter.convertRelativeLinks(eq(\"fake-comment-content\")))\n .thenReturn(\"fake-comment-content\");\n\n when(emitter.emit(eq(\"new-comment-on-single-page\"), any()))\n .thenReturn(Mono.empty());\n\n newCommentOnPageReasonPublisher.publishReasonBy(comment);\n\n verify(client).fetch(eq(SinglePage.class), eq(metadata.getName()));\n verify(emitter).emit(eq(\"new-comment-on-single-page\"), assertArg(consumer -> {\n var builder = ReasonPayload.builder();\n consumer.accept(builder);\n var reasonPayload = builder.build();\n var reasonSubject = Reason.Subject.builder()\n .apiVersion(page.getApiVersion())\n .kind(page.getKind())\n .name(page.getMetadata().getName())\n .title(page.getSpec().getTitle())\n .build();\n assertThat(reasonPayload.getSubject()).isEqualTo(reasonSubject);\n\n assertThat(reasonPayload.getAuthor())\n .isEqualTo(\n UserIdentity.anonymousWithEmail(comment.getSpec().getOwner().getName()));\n\n assertThat(reasonPayload.getAttributes()).containsAllEntriesOf(Map.of(\n \"pageName\", page.getMetadata().getName(),\n \"pageTitle\", page.getSpec().getTitle(),\n \"commenter\", comment.getSpec().getOwner().getDisplayName(),\n \"content\", comment.getSpec().getContent(),\n \"commentName\", comment.getMetadata().getName()\n ));\n }));\n }\n\n @Test\n void doNotEmitReasonTest() {\n final var comment = createComment();\n var commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(User.KIND);\n commentOwner.setName(\"fake-user\");\n comment.getSpec().setOwner(commentOwner);\n\n var page = new SinglePage();\n page.setMetadata(new Metadata());\n page.getMetadata().setName(\"fake-page\");\n page.setSpec(new SinglePage.SinglePageSpec());\n page.getSpec().setOwner(\"fake-user\");\n\n // the username is the same as the comment owner\n assertThat(newCommentOnPageReasonPublisher.doNotEmitReason(comment, page)).isTrue();\n\n // not the same username\n commentOwner.setName(\"other\");\n assertThat(newCommentOnPageReasonPublisher.doNotEmitReason(comment, page)).isFalse();\n\n // the comment owner is email and the same as the page-owner user email\n commentOwner.setKind(Comment.CommentOwner.KIND_EMAIL);\n commentOwner.setName(\"example@example.com\");\n var user = new User();\n user.setSpec(new User.UserSpec());\n user.getSpec().setEmail(\"example@example.com\");\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Optional.of(user));\n\n assertThat(newCommentOnPageReasonPublisher.doNotEmitReason(comment, page)).isTrue();\n\n // the comment owner is email and not the same as the post-owner user email\n user.getSpec().setEmail(\"fake@example.com\");\n assertThat(newCommentOnPageReasonPublisher.doNotEmitReason(comment, page)).isFalse();\n }\n }\n\n @Nested\n @ExtendWith(MockitoExtension.class)\n class NewReplyReasonPublisherTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n NotificationReasonEmitter notificationReasonEmitter;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @Mock\n CommentNotificationReasonPublisher.CommentContentConverter commentContentConverter;\n\n @InjectMocks\n CommentNotificationReasonPublisher.NewReplyReasonPublisher newReplyReasonPublisher;\n\n @Test\n void publishReasonByTest() {\n when(extensionGetter.getExtensions(CommentSubject.class))\n .thenReturn(Flux.empty());\n var reply = createReply(\"fake-reply\");\n\n reply.getSpec().setQuoteReply(\"fake-quote-reply\");\n var quoteReply = createReply(\"fake-quote-reply\");\n\n when(client.fetch(eq(Reply.class), eq(\"fake-quote-reply\")))\n .thenReturn(Optional.of(quoteReply));\n\n var spyNewReplyReasonPublisher = spy(newReplyReasonPublisher);\n\n var comment = createComment();\n comment.getSpec().setContent(\"fake-comment-content\");\n\n doReturn(false).when(spyNewReplyReasonPublisher)\n .doNotEmitReason(any(), any(), any());\n \n // Mock commentContentConverter for all content conversions\n when(commentContentConverter.convertRelativeLinks(eq(\"fake-comment-content\")))\n .thenReturn(\"fake-comment-content\");\n when(commentContentConverter.convertRelativeLinks(eq(\"fake-reply-content\")))\n .thenReturn(\"fake-reply-content\");\n \n when(notificationReasonEmitter.emit(any(), any()))\n .thenReturn(Mono.empty());\n\n // execute target method\n spyNewReplyReasonPublisher.publishReasonBy(reply, comment);\n\n verify(notificationReasonEmitter)\n .emit(eq(NotificationReasonConst.SOMEONE_REPLIED_TO_YOU), assertArg(consumer -> {\n var builder = ReasonPayload.builder();\n consumer.accept(builder);\n var reasonPayload = builder.build();\n var reasonSubject = Reason.Subject.builder()\n .apiVersion(quoteReply.getApiVersion())\n .kind(quoteReply.getKind())\n .name(quoteReply.getMetadata().getName())\n .title(quoteReply.getSpec().getContent())\n .build();\n assertThat(reasonPayload.getSubject()).isEqualTo(reasonSubject);\n\n assertThat(reasonPayload.getAuthor())\n .isEqualTo(\n UserIdentity.of(reply.getSpec().getOwner().getName()));\n\n assertThat(reasonPayload.getAttributes()).containsAllEntriesOf(Map.of(\n \"commentContent\", comment.getSpec().getContent(),\n \"isQuoteReply\", true,\n \"quoteContent\", quoteReply.getSpec().getContent(),\n \"commentName\", comment.getMetadata().getName(),\n \"replier\", reply.getSpec().getOwner().getDisplayName(),\n \"content\", reply.getSpec().getContent(),\n \"replyName\", reply.getMetadata().getName()\n ));\n }));\n }\n\n @Test\n void doNotEmitReasonTest() {\n final var currentReply = createReply(\"current\");\n currentReply.getSpec().setQuoteReply(\"quote\");\n final var quoteReply = createReply(\"quote\");\n final var comment = createComment();\n\n assertThat(newReplyReasonPublisher\n .doNotEmitReason(currentReply, quoteReply, comment)).isTrue();\n\n currentReply.getSpec().getOwner().setName(\"other\");\n assertThat(newReplyReasonPublisher\n .doNotEmitReason(currentReply, quoteReply, comment)).isFalse();\n\n currentReply.getSpec().setQuoteReply(null);\n assertThat(newReplyReasonPublisher\n .doNotEmitReason(currentReply, quoteReply, comment)).isFalse();\n\n currentReply.getSpec().setOwner(comment.getSpec().getOwner());\n assertThat(newReplyReasonPublisher\n .doNotEmitReason(currentReply, quoteReply, comment)).isTrue();\n }\n\n static Reply createReply(String name) {\n var reply = new Reply();\n reply.setMetadata(new Metadata());\n reply.getMetadata().setName(name);\n reply.setSpec(new Reply.ReplySpec());\n reply.getSpec().setCommentName(\"fake-comment\");\n var owner = new Comment.CommentOwner();\n owner.setKind(User.KIND);\n owner.setName(\"fake-user\");\n owner.setDisplayName(\"fake-display-name\");\n reply.getSpec().setOwner(owner);\n reply.getSpec().setContent(\"fake-reply-content\");\n return reply;\n }\n }\n\n static Comment createComment() {\n var comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(\"fake-comment\");\n comment.setSpec(new Comment.CommentSpec());\n var commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(Comment.CommentOwner.KIND_EMAIL);\n commentOwner.setName(\"example@example.com\");\n comment.getSpec().setOwner(commentOwner);\n comment.getSpec().setSubjectRef(\n Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class)));\n return comment;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/content/comment/CommentRequestTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link CommentRequest}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass CommentRequestTest {\n\n @Test\n void constructor() throws JSONException {\n CommentRequest commentRequest = createCommentRequest();\n\n JSONAssert.assertEquals(\"\"\"\n {\n \"subjectRef\": {\n \"group\": \"fake.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"Fake\",\n \"name\": \"fake\"\n },\n \"raw\": \"raw\",\n \"content\": \"content\",\n \"allowNotification\": true\n }\n \"\"\",\n JsonUtils.objectToJson(commentRequest),\n true);\n }\n\n @Test\n void toComment() throws JSONException {\n CommentRequest commentRequest = createCommentRequest();\n Comment comment = commentRequest.toComment();\n assertThat(comment.getMetadata().getName()).isNotNull();\n\n comment.getMetadata().setName(\"fake\");\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"raw\": \"raw\",\n \"content\": \"content\",\n \"allowNotification\": true,\n \"subjectRef\": {\n \"group\": \"fake.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"Fake\",\n \"name\": \"fake\"\n }\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"name\": \"fake\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(comment),\n true);\n }\n\n private static CommentRequest createCommentRequest() {\n CommentRequest commentRequest = new CommentRequest();\n commentRequest.setRaw(\"raw\");\n commentRequest.setContent(\"content\");\n commentRequest.setAllowNotification(true);\n\n FakeExtension fakeExtension = new FakeExtension();\n fakeExtension.setMetadata(new Metadata());\n fakeExtension.getMetadata().setName(\"fake\");\n commentRequest.setSubjectRef(Ref.of(fakeExtension));\n return commentRequest;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/CommentServiceImplIntegrationTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionStoreUtil;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Integration tests for {@link CommentServiceImpl}.\n *\n * @author guqing\n * @since 2.15.0\n */\nclass CommentServiceImplIntegrationTest {\n\n @Nested\n @DirtiesContext\n @SpringBootTest\n class CommentRemoveTest {\n private final List storedComments = createComments(350);\n\n @Autowired\n private SchemeManager schemeManager;\n\n @MockitoSpyBean\n private ReactiveExtensionClient reactiveClient;\n\n @Autowired\n private ReactiveExtensionStoreClient storeClient;\n\n @MockitoSpyBean\n private CommentServiceImpl commentService;\n\n Mono deleteImmediately(Extension extension) {\n var name = extension.getMetadata().getName();\n var scheme = schemeManager.get(extension.getClass());\n\n // delete from db\n var storeName = ExtensionStoreUtil.buildStoreName(scheme, name);\n return storeClient.delete(storeName, extension.getMetadata().getVersion())\n .thenReturn(extension);\n }\n\n @BeforeEach\n void setUp() {\n Flux.fromIterable(storedComments)\n .flatMap(post -> reactiveClient.create(post))\n .as(StepVerifier::create)\n .expectNextCount(storedComments.size())\n .verifyComplete();\n }\n\n @AfterEach\n void tearDown() {\n Flux.fromIterable(storedComments)\n .flatMap(this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(storedComments.size())\n .verifyComplete();\n }\n\n @Test\n void commentBatchDeletionTest() {\n Ref ref = Ref.of(\"67\",\n GroupVersionKind.fromAPIVersionAndKind(\"content.halo.run/v1alpha1\", \"SinglePage\"));\n commentService.removeBySubject(ref)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(reactiveClient, times(storedComments.size())).delete(any(Comment.class));\n verify(commentService, times(2)).listCommentsByRef(eq(ref), any());\n\n commentService.listCommentsByRef(ref, PageRequestImpl.ofSize(1))\n .as(StepVerifier::create)\n .consumeNextWith(result -> {\n assertThat(result.getTotal()).isEqualTo(0);\n })\n .verifyComplete();\n }\n\n List createComments(int size) {\n List comments = new ArrayList<>(size);\n for (int i = 0; i < size; i++) {\n var comment = createComment();\n comment.getMetadata().setName(\"comment-\" + i);\n comments.add(comment);\n }\n return comments;\n }\n }\n\n Comment createComment() {\n return JsonUtils.jsonToObject(\"\"\"\n {\n \"spec\": {\n \"raw\": \"fake-raw\",\n \"content\": \"fake-content\",\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"fake-user\"\n },\n \"userAgent\": \"\",\n \"ipAddress\": \"\",\n \"approvedTime\": \"2024-02-28T09:15:16.095Z\",\n \"creationTime\": \"2024-02-28T06:23:42.923294424Z\",\n \"priority\": 0,\n \"top\": false,\n \"allowNotification\": false,\n \"approved\": true,\n \"hidden\": false,\n \"subjectRef\": {\n \"group\": \"content.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"SinglePage\",\n \"name\": \"67\"\n },\n \"lastReadTime\": \"2024-02-29T03:39:04.230Z\"\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"generateName\": \"comment-\"\n }\n }\n \"\"\", Comment.class);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/CommentServiceImplTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport org.springframework.util.LinkedMultiValueMap;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.counter.MeterUtils;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.security.authorization.AuthorityUtils;\n\n/**\n * Tests for {@link CommentServiceImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\nclass CommentServiceImplTest {\n\n @Mock\n SystemConfigFetcher environmentFetcher;\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n UserService userService;\n\n @Mock\n RoleService roleService;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @InjectMocks\n CommentServiceImpl commentService;\n\n @Mock\n CounterService counterService;\n\n private static User createUser(String name) {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(name);\n user.setSpec(new User.UserSpec());\n user.getSpec().setAvatar(name + \"-avatar\");\n user.getSpec().setDisplayName(name + \"-displayName\");\n user.getSpec().setEmail(name + \"-email\");\n return user;\n }\n\n @Test\n void listComment() {\n var comments = new ListResult(1, 10, 3, comments());\n when(client.listBy(eq(Comment.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(comments));\n\n PostCommentSubject postCommentSubject = Mockito.mock(PostCommentSubject.class);\n when(extensionGetter.getExtensions(CommentSubject.class))\n .thenReturn(Flux.just(postCommentSubject));\n\n when(postCommentSubject.supports(any())).thenReturn(true);\n when(postCommentSubject.get(eq(\"fake-post\"))).thenReturn(Mono.just(post()));\n\n when(userService.getUserOrGhost(any()))\n .thenReturn(Mono.just(ghostUser()));\n // when(userService.getUserOrGhost(\"A-owner\"))\n // .thenReturn(Mono.just(createUser(\"A-owner\")));\n when(userService.getUserOrGhost(\"B-owner\"))\n .thenReturn(Mono.just(createUser(\"B-owner\")));\n\n ServerWebExchange exchange = mock(ServerWebExchange.class);\n MultiValueMap queryParams = new LinkedMultiValueMap<>();\n MockServerRequest request = MockServerRequest.builder()\n .queryParams(queryParams)\n .exchange(exchange)\n .build();\n ServerHttpRequest httpRequest = mock(ServerHttpRequest.class);\n when(exchange.getRequest()).thenReturn(httpRequest);\n when(httpRequest.getQueryParams()).thenReturn(queryParams);\n final var listResultMono = commentService.listComment(new CommentQuery(request));\n Counter counterA = new Counter();\n counterA.setUpvote(3);\n String commentACounter = MeterUtils.nameOf(Comment.class, \"A\");\n when(counterService.getByName(eq(commentACounter))).thenReturn(Mono.just(counterA));\n\n Counter counterB = new Counter();\n counterB.setUpvote(9);\n String commentBCounter = MeterUtils.nameOf(Comment.class, \"B\");\n when(counterService.getByName(eq(commentBCounter))).thenReturn(Mono.just(counterB));\n\n Counter counterC = new Counter();\n counterC.setUpvote(0);\n String commentCCounter = MeterUtils.nameOf(Comment.class, \"C\");\n when(counterService.getByName(eq(commentCCounter))).thenReturn(Mono.just(counterC));\n\n StepVerifier.create(listResultMono)\n .consumeNextWith(result -> {\n try {\n JSONAssert.assertEquals(expectListResultJson(),\n JsonUtils.objectToJson(result),\n true);\n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n }\n\n @Test\n @WithMockUser(username = \"B-owner\")\n void create() throws JSONException {\n var commentSetting = getCommentSetting();\n when(environmentFetcher.fetchComment()).thenReturn(Mono.just(commentSetting));\n when(roleService.contains(Set.of(\"USER\"),\n Set.of(AuthorityUtils.COMMENT_MANAGEMENT_ROLE_NAME)))\n .thenReturn(Mono.just(false));\n\n CommentRequest commentRequest = new CommentRequest();\n commentRequest.setRaw(\"fake-raw\");\n commentRequest.setContent(\"fake-content\");\n commentRequest.setAllowNotification(true);\n commentRequest.setSubjectRef(Ref.of(post()));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Comment.class);\n\n when(client.fetch(eq(User.class), eq(\"B-owner\")))\n .thenReturn(Mono.just(createUser(\"B-owner\")));\n Comment commentToCreate = commentRequest.toComment();\n commentToCreate.getMetadata().setName(\"fake\");\n Mono commentMono = commentService.create(commentToCreate);\n when(client.create(any())).thenReturn(Mono.empty());\n StepVerifier.create(commentMono)\n .verifyComplete();\n\n verify(client, times(1)).create(captor.capture());\n Comment comment = captor.getValue();\n comment.getSpec().setCreationTime(null);\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"raw\": \"fake-raw\",\n \"content\": \"fake-content\",\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"B-owner\",\n \"displayName\": \"B-owner-displayName\"\n },\n \"priority\": 0,\n \"top\": false,\n \"allowNotification\": true,\n \"approved\": false,\n \"hidden\": false,\n \"subjectRef\": {\n \"group\": \"content.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"Post\",\n \"name\": \"fake-post\"\n }\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"name\": \"fake\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(comment),\n true);\n }\n\n private List comments() {\n Comment a = comment(\"A\");\n a.getSpec().getOwner().setKind(Comment.CommentOwner.KIND_EMAIL);\n a.getSpec().getOwner()\n .setAnnotations(Map.of(Comment.CommentOwner.AVATAR_ANNO, \"avatar\",\n Comment.CommentOwner.WEBSITE_ANNO, \"website\"));\n return List.of(a, comment(\"B\"), comment(\"C\"));\n }\n\n private Comment comment(String name) {\n Comment comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(name);\n\n comment.setSpec(new Comment.CommentSpec());\n Comment.CommentOwner commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(User.KIND);\n commentOwner.setDisplayName(\"displayName\");\n commentOwner.setName(name + \"-owner\");\n comment.getSpec().setOwner(commentOwner);\n\n comment.getSpec().setSubjectRef(Ref.of(post()));\n\n comment.setStatus(new Comment.CommentStatus());\n return comment;\n }\n\n private Post post() {\n Post post = TestPost.postV1();\n post.getMetadata().setName(\"fake-post\");\n return post;\n }\n\n private static SystemSetting.Comment getCommentSetting() {\n SystemSetting.Comment commentSetting = new SystemSetting.Comment();\n commentSetting.setEnable(true);\n commentSetting.setSystemUserOnly(true);\n commentSetting.setRequireReviewForNew(true);\n return commentSetting;\n }\n\n User ghostUser() {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"ghost\");\n user.setSpec(new User.UserSpec());\n user.getSpec().setDisplayName(\"Ghost\");\n user.getSpec().setEmail(\"\");\n return user;\n }\n\n private String expectListResultJson() {\n return \"\"\"\n {\n \"page\": 1,\n \"size\": 10,\n \"total\": 3,\n \"totalPages\": 1,\n \"items\": [\n {\n \"comment\": {\n \"spec\": {\n \"owner\": {\n \"kind\": \"Email\",\n \"name\": \"A-owner\",\n \"displayName\": \"displayName\",\n \"annotations\": {\n \"website\": \"website\",\n \"avatar\": \"avatar\"\n }\n },\n \"subjectRef\": {\n \"group\": \"content.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"Post\",\n \"name\": \"fake-post\"\n }\n },\n \"status\": {},\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"name\": \"A\"\n }\n },\n \"owner\": {\n \"kind\": \"Email\",\n \"name\": \"A-owner\",\n \"displayName\": \"displayName\",\n \"avatar\": \"avatar\",\n \"email\": \"A-owner\"\n },\n \"subject\": {\n \"spec\": {\n \"title\": \"post-A\",\n \"headSnapshot\": \"base-snapshot\",\n \"baseSnapshot\": \"snapshot-A\"\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Post\",\n \"metadata\": {\n \"name\": \"fake-post\",\n \"version\": 1\n }\n },\n \"stats\": {\n \"upvote\": 3\n }\n },\n {\n \"comment\": {\n \"spec\": {\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"B-owner\",\n \"displayName\": \"displayName\"\n },\n \"subjectRef\": {\n \"group\": \"content.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"Post\",\n \"name\": \"fake-post\"\n }\n },\n \"status\": {},\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"name\": \"B\"\n }\n },\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"B-owner\",\n \"displayName\": \"B-owner-displayName\",\n \"avatar\": \"B-owner-avatar\",\n \"email\": \"B-owner-email\"\n },\n \"subject\": {\n \"spec\": {\n \"title\": \"post-A\",\n \"headSnapshot\": \"base-snapshot\",\n \"baseSnapshot\": \"snapshot-A\"\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Post\",\n \"metadata\": {\n \"name\": \"fake-post\",\n \"version\": 1\n }\n },\n \"stats\": {\n \"upvote\": 9\n }\n },\n {\n \"comment\": {\n \"spec\": {\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"C-owner\",\n \"displayName\": \"displayName\"\n },\n \"subjectRef\": {\n \"group\": \"content.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"Post\",\n \"name\": \"fake-post\"\n }\n },\n \"status\": {},\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"name\": \"C\"\n }\n },\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"ghost\",\n \"displayName\": \"Ghost\",\n \"email\": \"\"\n },\n \"subject\": {\n \"spec\": {\n \"title\": \"post-A\",\n \"headSnapshot\": \"base-snapshot\",\n \"baseSnapshot\": \"snapshot-A\"\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Post\",\n \"metadata\": {\n \"name\": \"fake-post\",\n \"version\": 1\n }\n },\n \"stats\": {\n \"upvote\": 0\n }\n }\n ],\n \"first\": true,\n \"last\": true,\n \"hasNext\": false,\n \"hasPrevious\": false\n }\n \"\"\";\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/PostCommentSubjectTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\n\n/**\n * Tests for {@link PostCommentSubject}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostCommentSubjectTest {\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private PostCommentSubject postCommentSubject;\n\n @Test\n void get() {\n when(client.fetch(eq(Post.class), any()))\n .thenReturn(Mono.empty());\n when(client.fetch(eq(Post.class), eq(\"fake-post\")))\n .thenReturn(Mono.just(TestPost.postV1()));\n\n postCommentSubject.get(\"fake-post\")\n .as(StepVerifier::create)\n .expectNext(TestPost.postV1())\n .verifyComplete();\n\n postCommentSubject.get(\"fake-post2\")\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void supports() {\n Post post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"test\");\n boolean supports = postCommentSubject.supports(Ref.of(post));\n assertThat(supports).isTrue();\n\n FakeExtension fakeExtension = new FakeExtension();\n fakeExtension.setMetadata(new Metadata());\n fakeExtension.getMetadata().setName(\"test\");\n supports = postCommentSubject.supports(Ref.of(fakeExtension));\n assertThat(supports).isFalse();\n }\n\n @Test\n void shouldSupportRefWithoutVersion() {\n var ref = new Ref();\n ref.setName(\"fake-post\");\n ref.setGroup(Constant.GROUP);\n ref.setKind(Post.KIND);\n assertTrue(postCommentSubject.supports(ref));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/ReplyNotificationSubscriptionHelperTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.content.comment.ReplyNotificationSubscriptionHelper.identityFrom;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.notification.UserIdentity;\n\n/**\n * Tests for {@link ReplyNotificationSubscriptionHelper}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ReplyNotificationSubscriptionHelperTest {\n\n @Mock\n NotificationCenter notificationCenter;\n\n @InjectMocks\n ReplyNotificationSubscriptionHelper notificationSubscriptionHelper;\n\n @Test\n void subscribeNewReplyReasonForCommentTest() {\n var comment = createComment();\n var spyNotificationSubscriptionHelper = spy(notificationSubscriptionHelper);\n\n doNothing().when(spyNotificationSubscriptionHelper).subscribeReply(any(UserIdentity.class));\n\n spyNotificationSubscriptionHelper.subscribeNewReplyReasonForComment(comment);\n\n verify(spyNotificationSubscriptionHelper).subscribeReply(\n eq(ReplyNotificationSubscriptionHelper.identityFrom(\n comment.getSpec().getOwner()))\n );\n }\n\n @Test\n void subscribeNewReplyReasonForReplyTest() {\n var reply = new Reply();\n reply.setMetadata(new Metadata());\n reply.getMetadata().setName(\"fake-reply\");\n reply.setSpec(new Reply.ReplySpec());\n reply.getSpec().setCommentName(\"fake-comment\");\n var owner = new Comment.CommentOwner();\n owner.setKind(User.KIND);\n owner.setName(\"fake-user\");\n reply.getSpec().setOwner(owner);\n\n var spyNotificationSubscriptionHelper = spy(notificationSubscriptionHelper);\n\n doNothing().when(spyNotificationSubscriptionHelper).subscribeReply(any(UserIdentity.class));\n\n spyNotificationSubscriptionHelper.subscribeNewReplyReasonForReply(reply);\n\n verify(spyNotificationSubscriptionHelper).subscribeReply(\n eq(ReplyNotificationSubscriptionHelper.identityFrom(\n reply.getSpec().getOwner()))\n );\n }\n\n @Test\n void subscribeReplyTest() {\n var comment = createComment();\n var identity = ReplyNotificationSubscriptionHelper.identityFrom(\n comment.getSpec().getOwner());\n\n when(notificationCenter.subscribe(any(), any())).thenReturn(Mono.empty());\n\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(identity.name());\n\n notificationSubscriptionHelper.subscribeReply(identity);\n\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(NotificationReasonConst.SOMEONE_REPLIED_TO_YOU);\n interestReason.setExpression(\"props.repliedOwner == '%s'\".formatted(subscriber.getName()));\n verify(notificationCenter).subscribe(eq(subscriber), eq(interestReason));\n }\n\n @Nested\n class IdentityTest {\n\n @Test\n void identityFromTest() {\n var owner = new Comment.CommentOwner();\n owner.setKind(User.KIND);\n owner.setName(\"fake-user\");\n\n assertThat(identityFrom(owner))\n .isEqualTo(UserIdentity.of(owner.getName()));\n\n owner.setKind(Comment.CommentOwner.KIND_EMAIL);\n owner.setName(\"example@example.com\");\n assertThat(identityFrom(owner))\n .isEqualTo(UserIdentity.anonymousWithEmail(owner.getName()));\n }\n }\n\n static Comment createComment() {\n var comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(\"fake-comment\");\n comment.setSpec(new Comment.CommentSpec());\n var commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(Comment.CommentOwner.KIND_EMAIL);\n commentOwner.setName(\"example@example.com\");\n comment.getSpec().setOwner(commentOwner);\n comment.getSpec().setSubjectRef(\n Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class)));\n return comment;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/ReplyServiceImplIntegrationTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionStoreUtil;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Integration tests for {@link ReplyServiceImpl}.\n *\n * @author guqing\n * @since 2.15.0\n */\nclass ReplyServiceImplIntegrationTest {\n\n @Nested\n @DirtiesContext\n @SpringBootTest\n class ReplyRemoveTest {\n private final List storedReplies = createReplies(320);\n\n private List createReplies(int size) {\n List replies = new ArrayList<>(size);\n for (int i = 0; i < size; i++) {\n var reply = JsonUtils.jsonToObject(fakeReplyJson(), Reply.class);\n reply.getMetadata().setName(\"reply-\" + i);\n replies.add(reply);\n }\n return replies;\n }\n\n @Autowired\n private SchemeManager schemeManager;\n\n @MockitoSpyBean\n private ReactiveExtensionClient reactiveClient;\n\n @Autowired\n private ReactiveExtensionStoreClient storeClient;\n\n @MockitoSpyBean\n private ReplyServiceImpl replyService;\n\n Mono deleteImmediately(Extension extension) {\n var name = extension.getMetadata().getName();\n var scheme = schemeManager.get(extension.getClass());\n\n // delete from db\n var storeName = ExtensionStoreUtil.buildStoreName(scheme, name);\n return storeClient.delete(storeName, extension.getMetadata().getVersion())\n .thenReturn(extension);\n }\n\n @BeforeEach\n void setUp() {\n Flux.fromIterable(storedReplies)\n .flatMap(post -> reactiveClient.create(post))\n .as(StepVerifier::create)\n .expectNextCount(storedReplies.size())\n .verifyComplete();\n }\n\n @AfterEach\n void tearDown() {\n Flux.fromIterable(storedReplies)\n .flatMap(this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(storedReplies.size())\n .verifyComplete();\n }\n\n @Test\n void removeAllByComment() {\n String commentName = \"fake-comment\";\n replyService.removeAllByComment(commentName)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(reactiveClient, times(storedReplies.size())).delete(any(Reply.class));\n verify(replyService, times(2)).listRepliesByComment(eq(commentName), any());\n\n replyService.listRepliesByComment(commentName, PageRequestImpl.ofSize(1))\n .as(StepVerifier::create)\n .consumeNextWith(result -> assertThat(result.getTotal()).isEqualTo(0))\n .verifyComplete();\n }\n }\n\n String fakeReplyJson() {\n return \"\"\"\n {\n \"metadata\":{\n \"name\":\"fake-reply\"\n },\n \"spec\":{\n \"raw\":\"fake-raw\",\n \"content\":\"fake-content\",\n \"owner\":{\n \"kind\":\"User\",\n \"name\":\"fake-user\",\n \"displayName\":\"fake-display-name\"\n },\n \"creationTime\": \"2024-03-11T06:23:42.923294424Z\",\n \"ipAddress\":\"\",\n \"approved\": true,\n \"hidden\": false,\n \"allowNotification\": false,\n \"top\": false,\n \"priority\": 0,\n \"commentName\":\"fake-comment\"\n },\n \"owner\":{\n \"kind\":\"User\",\n \"displayName\":\"fake-display-name\"\n },\n \"stats\":{\n \"upvote\":0\n }\n }\n \"\"\";\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/comment/SinglePageCommentSubjectTest.java", "content": "package run.halo.app.content.comment;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\n\n/**\n * Tests for {@link SinglePageCommentSubject}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageCommentSubjectTest {\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private SinglePageCommentSubject singlePageCommentSubject;\n\n @Test\n void get() {\n when(client.fetch(eq(SinglePage.class), any()))\n .thenReturn(Mono.empty());\n\n SinglePage singlePage = new SinglePage();\n singlePage.setMetadata(new Metadata());\n singlePage.getMetadata().setName(\"fake-single-page\");\n\n when(client.fetch(eq(SinglePage.class), eq(\"fake-single-page\")))\n .thenReturn(Mono.just(singlePage));\n\n singlePageCommentSubject.get(\"fake-single-page\")\n .as(StepVerifier::create)\n .expectNext(singlePage)\n .verifyComplete();\n\n singlePageCommentSubject.get(\"fake-single-page-2\")\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(client, times(1)).fetch(eq(SinglePage.class), eq(\"fake-single-page\"));\n }\n\n @Test\n void supports() {\n SinglePage singlePage = new SinglePage();\n singlePage.setMetadata(new Metadata());\n singlePage.getMetadata().setName(\"test\");\n boolean supports = singlePageCommentSubject.supports(Ref.of(singlePage));\n assertThat(supports).isTrue();\n\n FakeExtension fakeExtension = new FakeExtension();\n fakeExtension.setMetadata(new Metadata());\n fakeExtension.getMetadata().setName(\"test\");\n supports = singlePageCommentSubject.supports(Ref.of(fakeExtension));\n assertThat(supports).isFalse();\n }\n\n\n @Test\n void shouldSupportRefWithoutVersion() {\n var ref = new Ref();\n ref.setName(\"fake-post\");\n ref.setGroup(Constant.GROUP);\n ref.setKind(SinglePage.KIND);\n assertTrue(singlePageCommentSubject.supports(ref));\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/content/permalinks/CategoryPermalinkPolicyTest.java", "content": "package run.halo.app.content.permalinks;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\n\n/**\n * Tests for {@link CategoryPermalinkPolicy}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CategoryPermalinkPolicyTest {\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n private CategoryPermalinkPolicy categoryPermalinkPolicy;\n\n @BeforeEach\n void setUp() {\n categoryPermalinkPolicy =\n new CategoryPermalinkPolicy(externalUrlSupplier, environmentFetcher);\n }\n\n @Test\n void permalink() {\n Category category = new Category();\n Metadata metadata = new Metadata();\n metadata.setName(\"category-test\");\n category.setMetadata(metadata);\n Category.CategorySpec categorySpec = new Category.CategorySpec();\n categorySpec.setSlug(\"slug-test\");\n category.setSpec(categorySpec);\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n String permalink = categoryPermalinkPolicy.permalink(category);\n assertThat(permalink).isEqualTo(\"/categories/slug-test\");\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"http://exmaple.com\"));\n permalink = categoryPermalinkPolicy.permalink(category);\n assertThat(permalink).isEqualTo(\"http://exmaple.com/categories/slug-test\");\n String path = URI.create(permalink).getPath();\n assertThat(path).isEqualTo(\"/categories/slug-test\");\n\n category.getSpec().setSlug(\"中文 slug\");\n permalink = categoryPermalinkPolicy.permalink(category);\n assertThat(permalink).isEqualTo(\"http://exmaple.com/categories/%E4%B8%AD%E6%96%87%20slug\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/permalinks/PostPermalinkPolicyTest.java", "content": "package run.halo.app.content.permalinks;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport java.text.DecimalFormat;\nimport java.text.NumberFormat;\nimport java.time.Instant;\nimport java.time.ZoneId;\nimport java.time.ZonedDateTime;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationContext;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.utils.PathUtils;\n\n/**\n * Tests for {@link PostPermalinkPolicy}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostPermalinkPolicyTest {\n private static final NumberFormat NUMBER_FORMAT = new DecimalFormat(\"00\");\n\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @Mock\n private PostService postService;\n\n private PostPermalinkPolicy postPermalinkPolicy;\n\n @BeforeEach\n void setUp() {\n lenient().when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n lenient().when(postService.listCategories(any())).thenReturn(Flux.empty());\n postPermalinkPolicy =\n new PostPermalinkPolicy(environmentFetcher, externalUrlSupplier, postService);\n }\n\n @Test\n void permalink() {\n Post post = TestPost.postV1();\n Map annotations = MetadataUtil.nullSafeAnnotations(post);\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/{year}/{month}/{day}/{slug}\");\n post.getMetadata().setName(\"test-post\");\n post.getSpec().setSlug(\"test-post-slug\");\n Instant now = Instant.now();\n post.getSpec().setPublishTime(now);\n\n ZonedDateTime zonedDateTime = now.atZone(ZoneId.systemDefault());\n String year = String.valueOf(zonedDateTime.getYear());\n String month = NUMBER_FORMAT.format(zonedDateTime.getMonthValue());\n String day = NUMBER_FORMAT.format(zonedDateTime.getDayOfMonth());\n\n String permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink)\n .isEqualTo(PathUtils.combinePath(year, month, day, post.getSpec().getSlug()));\n\n // pattern {month}/{day}/{slug}\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/{month}/{day}/{slug}\");\n permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink)\n .isEqualTo(PathUtils.combinePath(month, day, post.getSpec().getSlug()));\n\n // pattern /?p={name}\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/?p={name}\");\n permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink).isEqualTo(\"/?p=test-post\");\n\n // pattern /posts/{slug}\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/posts/{slug}\");\n permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink).isEqualTo(\"/posts/test-post-slug\");\n\n // pattern /posts/{name}\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/posts/{name}\");\n permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink).isEqualTo(\"/posts/test-post\");\n }\n\n @Test\n void permalinkForCategory() {\n Post post = TestPost.postV1();\n post.getSpec().setCategories(List.of(\"test-category\"));\n Map annotations = MetadataUtil.nullSafeAnnotations(post);\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/{categorySlug}/{slug}\");\n post.getMetadata().setName(\"test-post\");\n post.getSpec().setSlug(\"test-post-slug\");\n Instant now = Instant.now();\n post.getSpec().setPublishTime(now);\n\n var category = createCategory(\"test-category\", \"test-category-slug\");\n when(postService.listCategories(post.getSpec().getCategories()))\n .thenReturn(Flux.just(category));\n var permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink).isEqualTo(\"/test-category-slug/test-post-slug\");\n }\n\n @Test\n void permalinkWithExternalUrl() {\n Post post = TestPost.postV1();\n Map annotations = MetadataUtil.nullSafeAnnotations(post);\n annotations.put(Constant.PERMALINK_PATTERN_ANNO, \"/{year}/{month}/{day}/{slug}\");\n post.getMetadata().setName(\"test-post\");\n post.getSpec().setSlug(\"test-post-slug\");\n Instant now = Instant.parse(\"2022-11-01T02:40:06.806310Z\");\n post.getSpec().setPublishTime(now);\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"http://example.com\"));\n\n String permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink).isEqualTo(\"http://example.com/2022/11/01/test-post-slug\");\n\n post.getSpec().setSlug(\"中文 slug\");\n permalink = postPermalinkPolicy.permalink(post);\n assertThat(permalink).isEqualTo(\"http://example.com/2022/11/01/%E4%B8%AD%E6%96%87%20slug\");\n }\n\n private Category createCategory(String name, String slug) {\n Category category = new Category();\n Metadata metadata = new Metadata();\n metadata.setName(name);\n category.setMetadata(metadata);\n category.setSpec(new Category.CategorySpec());\n category.setStatus(new Category.CategoryStatus());\n\n category.getSpec().setDisplayName(\"display-name\");\n category.getSpec().setSlug(slug);\n category.getSpec().setPriority(0);\n return category;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/content/permalinks/TagPermalinkPolicyTest.java", "content": "package run.halo.app.content.permalinks;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationContext;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\n\n/**\n * Tests for {@link TagPermalinkPolicy}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass TagPermalinkPolicyTest {\n\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n private TagPermalinkPolicy tagPermalinkPolicy;\n\n @BeforeEach\n void setUp() {\n tagPermalinkPolicy = new TagPermalinkPolicy(externalUrlSupplier, environmentFetcher);\n }\n\n @Test\n void permalink() {\n Tag tag = new Tag();\n Metadata metadata = new Metadata();\n metadata.setName(\"test-tag\");\n tag.setMetadata(metadata);\n Tag.TagSpec tagSpec = new Tag.TagSpec();\n tagSpec.setSlug(\"test-slug\");\n tag.setSpec(tagSpec);\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n\n String permalink = tagPermalinkPolicy.permalink(tag);\n assertThat(permalink).isEqualTo(\"/tags/test-slug\");\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"http://example.com\"));\n\n permalink = tagPermalinkPolicy.permalink(tag);\n assertThat(permalink).isEqualTo(\"http://example.com/tags/test-slug\");\n\n tag.getSpec().setSlug(\"中文slug\");\n permalink = tagPermalinkPolicy.permalink(tag);\n assertThat(permalink).isEqualTo(\"http://example.com/tags/%E4%B8%AD%E6%96%87slug\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/PolicyConfigChangeDetectorTest.java", "content": "package run.halo.app.core.attachment;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n * Tests for {@link PolicyConfigChangeDetector}.\n *\n * @author guqing\n * @since 2.20.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PolicyConfigChangeDetectorTest {\n\n @Mock\n private PolicyConfigChangeDetector.AttachmentUpdateTrigger updateTrigger;\n\n @Mock\n private ExtensionClient client;\n\n @InjectMocks\n private PolicyConfigChangeDetector policyConfigChangeDetector;\n\n @Test\n void reconcileTest() {\n final var spyDetector = spy(policyConfigChangeDetector);\n\n var configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setLabels(Map.of(Policy.POLICY_OWNER_LABEL, \"fake-policy\"));\n\n when(client.fetch(eq(ConfigMap.class), eq(\"fake-config\")))\n .thenReturn(Optional.of(configMap));\n when(client.listAllNames(same(Attachment.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(List.of(\"fake-attachment\"));\n\n spyDetector.reconcile(new Reconciler.Request(\"fake-config\"));\n\n verify(updateTrigger).addAll(List.of(\"fake-attachment\"));\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/attachment/endpoint/LocalAttachmentUploadHandlerTest.java", "content": "package run.halo.app.core.attachment.endpoint;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.junit.jupiter.params.provider.Arguments.arguments;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport java.nio.charset.StandardCharsets;\nimport java.nio.file.Path;\nimport java.time.Clock;\nimport java.time.Instant;\nimport java.time.ZoneId;\nimport java.util.Map;\nimport java.util.function.Consumer;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DefaultDataBufferFactory;\nimport org.springframework.http.MediaType;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.thumbnail.LocalThumbnailService;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Constant;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.core.extension.attachment.endpoint.AttachmentHandler;\nimport run.halo.app.core.extension.attachment.endpoint.UploadOption;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.ExternalUrlSupplier;\n\n@ExtendWith(MockitoExtension.class)\nclass LocalAttachmentUploadHandlerTest {\n\n @InjectMocks\n LocalAttachmentUploadHandler uploadHandler;\n\n @Mock\n AttachmentRootGetter attachmentRootGetter;\n\n @Mock\n ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n LocalThumbnailService localThumbnailService;\n\n @TempDir\n Path attachmentRoot;\n\n static Clock clock = Clock.fixed(Instant.now(), ZoneId.systemDefault());\n\n @BeforeEach\n void setUp() {\n uploadHandler.setClock(clock);\n lenient().when(externalUrlSupplier.get()).thenReturn(URI.create(\"/\"));\n }\n\n public static Stream testUploadWithRenameStrategy() {\n return Stream.of(arguments(\n \"Random file name with length 10\",\n \"\"\"\n {\n \"alwaysRenameFilename\": true,\n \"renameStrategy\": {\n \"method\": \"RANDOM\",\n \"randomLength\": 10\n }\n }\n \"\"\",\n (Consumer) attachment -> {\n var displayName = attachment.getSpec().getDisplayName();\n assertTrue(displayName.startsWith(\"halo-\"));\n assertTrue(displayName.endsWith(\".png\"));\n // halo-xxxxxx.png\n assertEquals(4 + 10 + 5, displayName.length());\n // fake-content\n assertEquals(12L, attachment.getSpec().getSize());\n }),\n arguments(\n \"Random file name with length 10 but without original filename\",\n \"\"\"\n {\n \"alwaysRenameFilename\": true,\n \"renameStrategy\": {\n \"method\": \"RANDOM\",\n \"randomLength\": 10,\n \"excludeOriginalFilename\": true\n }\n }\n \"\"\",\n (Consumer) attachment -> {\n var displayName = attachment.getSpec().getDisplayName();\n assertFalse(displayName.startsWith(\"halo-\"));\n assertTrue(displayName.endsWith(\".png\"));\n // halo-xxxxxx.png\n assertEquals(10 + 4, displayName.length());\n // fake-content\n assertEquals(12L, attachment.getSpec().getSize());\n }),\n arguments(\n \"Rename filename with UUID but exclude original filename\",\n \"\"\"\n {\n \"alwaysRenameFilename\": true,\n \"renameStrategy\": {\n \"method\": \"UUID\",\n \"excludeOriginalFilename\": true\n }\n }\n \"\"\",\n (Consumer) attachment -> {\n var displayName = attachment.getSpec().getDisplayName();\n assertFalse(displayName.startsWith(\"halo-\"));\n assertTrue(displayName.endsWith(\".png\"));\n // xxxxxx.png\n assertEquals(36 + 4, displayName.length());\n // fake-content\n assertEquals(12L, attachment.getSpec().getSize());\n }\n ),\n arguments(\n \"Rename filename with UUID\",\n \"\"\"\n {\n \"alwaysRenameFilename\": true,\n \"renameStrategy\": {\n \"method\": \"UUID\",\n \"excludeOriginalFilename\": false\n }\n }\n \"\"\",\n (Consumer) attachment -> {\n var displayName = attachment.getSpec().getDisplayName();\n assertTrue(displayName.startsWith(\"halo-\"));\n assertTrue(displayName.endsWith(\".png\"));\n // xxxxxx.png\n assertEquals(5 + 36 + 4, displayName.length());\n // fake-content\n assertEquals(12L, attachment.getSpec().getSize());\n }\n ),\n arguments(\n \"Rename filename with timestamp but without original filename\",\n \"\"\"\n {\n \"alwaysRenameFilename\": true,\n \"renameStrategy\": {\n \"method\": \"TIMESTAMP\",\n \"excludeOriginalFilename\": true\n }\n }\n \"\"\",\n (Consumer) attachment -> {\n var expect = clock.instant().toEpochMilli() + \".png\";\n assertEquals(expect, attachment.getSpec().getDisplayName());\n }\n ),\n arguments(\n \"Rename filename with timestamp\",\n \"\"\"\n {\n \"alwaysRenameFilename\": true,\n \"renameStrategy\": {\n \"method\": \"TIMESTAMP\"\n }\n }\n \"\"\",\n (Consumer) attachment -> {\n var expect = \"halo-\" + clock.instant().toEpochMilli() + \".png\";\n assertEquals(expect, attachment.getSpec().getDisplayName());\n }\n )\n );\n }\n\n @ParameterizedTest(name = \"{0}\")\n @MethodSource\n void testUploadWithRenameStrategy(String name, String config, Consumer assertion) {\n assertNotNull(uploadHandler);\n var dataBufferFactory = new DefaultDataBufferFactory();\n var dataBuffer = dataBufferFactory.allocateBuffer(1024);\n dataBuffer.write(\"fake content\".getBytes(StandardCharsets.UTF_8));\n var content = Flux.just(dataBuffer);\n\n var policy = new Policy();\n var policySpec = new Policy.PolicySpec();\n policy.setSpec(policySpec);\n policySpec.setTemplateName(\"local\");\n\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\"default\", config));\n\n var uploadOption =\n UploadOption.from(\"halo.png\", content, MediaType.IMAGE_PNG, policy, configMap);\n\n when(attachmentRootGetter.get()).thenReturn(attachmentRoot);\n uploadHandler.upload(uploadOption)\n .as(StepVerifier::create)\n .assertNext(attachment -> {\n assertion.accept(attachment);\n assertNotNull(attachment.getStatus().getPermalink());\n assertNotNull(attachment.getStatus().getThumbnails());\n })\n .verifyComplete();\n\n }\n\n @Test\n void shouldGetPermalinkWhenUriContainsIllegalChars() {\n var attachment = new Attachment();\n attachment.setMetadata(new Metadata());\n attachment.getMetadata().setAnnotations(Map.of(\n Constant.URI_ANNO_KEY, \"/path/with space.png\"\n ));\n var permalink = uploadHandler.doGetPermalink(attachment);\n assertTrue(permalink.isPresent());\n assertEquals(\"/path/with%20space.png\", permalink.get().toASCIIString());\n }\n\n @Test\n void shouldDeleteWithThumbnails() {\n var deleteContext = Mockito.mock(AttachmentHandler.DeleteContext.class);\n when(deleteContext.policy()).thenReturn(createPolicy(\"local\"));\n var attachment =\n createAttachment(Map.of(Constant.LOCAL_REL_PATH_ANNO_KEY, \"path/to/file.png\"));\n when(deleteContext.attachment()).thenReturn(attachment);\n when(attachmentRootGetter.get()).thenReturn(attachmentRoot);\n uploadHandler.delete(deleteContext)\n .as(StepVerifier::create)\n .expectNext(attachment)\n .verifyComplete();\n\n verify(this.localThumbnailService).delete(attachmentRoot\n .resolve(\"path\")\n .resolve(\"to\")\n .resolve(\"file.png\")\n );\n }\n\n Attachment createAttachment(Map annotations) {\n var attachment = new Attachment();\n attachment.setMetadata(new Metadata());\n attachment.getMetadata().setName(\"fake-attachment\");\n attachment.getMetadata().setAnnotations(annotations);\n return attachment;\n }\n\n Policy createPolicy(String templateName) {\n var policy = new Policy();\n policy.setMetadata(new Metadata());\n policy.getMetadata().setName(\"fake-policy\");\n policy.setSpec(new Policy.PolicySpec());\n policy.getSpec().setTemplateName(templateName);\n return policy;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/endpoint/PolicyEndpointTest.java", "content": "package run.halo.app.core.attachment.endpoint;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.HashMap;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.transaction.ReactiveTransaction;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\nimport tools.jackson.databind.json.JsonMapper;\n\n@ExtendWith(MockitoExtension.class)\nclass PolicyEndpointTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Spy\n JsonMapper jsonMapper = JsonMapper.shared();\n\n @Mock\n ReactiveTransactionManager txManager;\n\n @InjectMocks\n PolicyEndpoint endpoint;\n\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .build();\n }\n\n @Test\n void shouldRespondNotFoundIfPolicyNotFound() {\n // Implement test logic here\n var policyScheme = Scheme.buildFromType(Policy.class);\n when(client.get(Policy.class, \"fake-policy\"))\n .thenReturn(Mono.error(() -> new ExtensionNotFoundException(\n policyScheme.groupVersionKind(), \"fake-policy\")\n ));\n webClient.get().uri(\"/policies/fake-policy/configs/fake-group\")\n .exchange()\n .expectStatus().isNotFound();\n }\n\n @Test\n void shouldRespondNullIfNoConfigFound() {\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.fromSupplier(() -> {\n var policy = new Policy();\n policy.setSpec(new Policy.PolicySpec());\n policy.getSpec().setConfigMapName(\"fake-config-map\");\n return policy;\n }));\n\n when(client.fetch(ConfigMap.class, \"fake-config-map\"))\n .thenReturn(Mono.empty());\n\n webClient.get().uri(\"/policies/fake-policy/configs/fake-group\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class)\n .isEqualTo(\"null\");\n }\n\n @Test\n void shouldRespondNullIfGroupNotFound() {\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.fromSupplier(() -> {\n var policy = new Policy();\n policy.setSpec(new Policy.PolicySpec());\n policy.getSpec().setConfigMapName(\"fake-config-map\");\n return policy;\n }));\n\n when(client.fetch(ConfigMap.class, \"fake-config-map\"))\n .thenReturn(Mono.fromSupplier(() -> {\n var cm = new ConfigMap();\n cm.setData(new HashMap<>());\n return cm;\n }));\n\n webClient.get().uri(\"/policies/fake-policy/configs/fake-group\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class)\n .isEqualTo(\"null\");\n }\n\n @Test\n void shouldRespondConfigIfGroupFound() {\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.fromSupplier(() -> {\n var policy = new Policy();\n policy.setSpec(new Policy.PolicySpec());\n policy.getSpec().setConfigMapName(\"fake-config-map\");\n return policy;\n }));\n\n when(client.fetch(ConfigMap.class, \"fake-config-map\"))\n .thenReturn(Mono.fromSupplier(() -> {\n var cm = new ConfigMap();\n cm.setData(new HashMap<>());\n cm.getData().put(\"fake-group\", \"\"\"\n {\n \"halo\": \"awesome\"\n }\"\"\");\n return cm;\n }));\n\n webClient.get().uri(\"/policies/fake-policy/configs/fake-group\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.halo\").isEqualTo(\"awesome\");\n }\n\n\n @Test\n void shouldUpdateConfigIfPresent() {\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.fromSupplier(() -> {\n var policy = new Policy();\n policy.setSpec(new Policy.PolicySpec());\n policy.getSpec().setConfigMapName(\"fake-config-map\");\n return policy;\n }));\n\n var cm = new ConfigMap();\n cm.setMetadata(new Metadata());\n cm.getMetadata().setName(\"fake-config-map\");\n cm.getMetadata().setVersion(1L);\n cm.setData(new HashMap<>());\n cm.getData().put(\"fake-group\", \"\"\"\n {\n \"halo\": \"awesome\"\n }\"\"\");\n when(client.fetch(ConfigMap.class, \"fake-config-map\"))\n .thenReturn(Mono.just(cm));\n\n var tx = mock(ReactiveTransaction.class);\n when(txManager.getReactiveTransaction(any())).thenReturn(Mono.just(tx));\n when(txManager.commit(tx)).thenReturn(Mono.empty());\n\n when(client.update(cm)).thenReturn(Mono.just(cm));\n\n var body = \"\"\"\n {\n \"halo\": \"nice\",\n \"key\": \"value\"\n }\"\"\";\n\n webClient.put().uri(\"/policies/fake-policy/configs/fake-group\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(body)\n .exchange()\n .expectStatus().isNoContent();\n\n verify(client).update(assertArg(gotCm -> {\n var data = gotCm.getData();\n JSONAssert.assertEquals(body, data.get(\"fake-group\"), true);\n }));\n }\n\n @Test\n void shouldCreateConfigIfAbsent() {\n var policy = new Policy();\n policy.setSpec(new Policy.PolicySpec());\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.just(policy));\n\n\n var tx = mock(ReactiveTransaction.class);\n when(txManager.getReactiveTransaction(any())).thenReturn(Mono.just(tx));\n when(txManager.commit(tx)).thenReturn(Mono.empty());\n\n var cm = new ConfigMap();\n cm.setMetadata(new Metadata());\n cm.getMetadata().setName(\"fake-config-map\");\n cm.getMetadata().setVersion(1L);\n cm.setData(new HashMap<>());\n cm.getData().put(\"fake-group\", \"\"\"\n {\n \"halo\": \"nice\",\n \"key\": \"value\"\n }\\\n \"\"\");\n when(client.create(any(ConfigMap.class))).thenReturn(Mono.just(cm));\n when(client.update(policy)).thenReturn(Mono.just(policy));\n\n var body = \"\"\"\n {\n \"halo\": \"nice\",\n \"key\": \"value\"\n }\"\"\";\n\n webClient.put().uri(\"/policies/fake-policy/configs/fake-group\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(body)\n .exchange()\n .expectStatus().isNoContent();\n\n verify(client).create(assertArg(gotCm -> {\n var data = gotCm.getData();\n JSONAssert.assertEquals(body, data.get(\"fake-group\"), true);\n }));\n\n verify(client).update(assertArg(\n gotPolicy -> assertEquals(\"fake-config-map\", gotPolicy.getSpec().getConfigMapName())\n ));\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/attachment/impl/AttachmentRootGetterImplTest.java", "content": "package run.halo.app.core.attachment.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.infra.properties.HaloProperties;\n\n/**\n * Tests for {@link AttachmentRootGetterImpl}.\n *\n * @author guqing\n * @since 2.19.0\n */\n@ExtendWith(MockitoExtension.class)\nclass AttachmentRootGetterImplTest {\n @Mock\n private HaloProperties haloProperties;\n\n @InjectMocks\n private AttachmentRootGetterImpl localAttachmentDirGetter;\n\n @Test\n void get() {\n var rootPath = Path.of(\"/tmp\");\n when(haloProperties.getWorkDir()).thenReturn(rootPath);\n var dir = localAttachmentDirGetter.get();\n assertThat(dir).isEqualTo(rootPath.resolve(\"attachments\"));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/thumbnail/DefaultLocalThumbnailServiceTest.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport com.google.common.util.concurrent.MoreExecutors;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.util.ResourceUtils;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.attachment.AttachmentRootGetter;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.infra.properties.AttachmentProperties;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultLocalThumbnailServiceTest {\n\n @Mock\n AttachmentRootGetter attachmentRootGetter;\n\n @Mock\n HaloProperties haloProperties;\n\n @Mock\n AttachmentProperties.ThumbnailProperties thumbnailProperties;\n\n DefaultLocalThumbnailService generator;\n\n Path source;\n\n @TempDir\n Path attachmentRoot;\n\n @BeforeEach\n void setUp() throws IOException {\n var attachmentProperties = mock(AttachmentProperties.class);\n when(attachmentProperties.getThumbnail()).thenReturn(thumbnailProperties);\n when(haloProperties.getAttachment()).thenReturn(attachmentProperties);\n when(thumbnailProperties.isDisabled()).thenReturn(false);\n when(thumbnailProperties.getConcurrentThreads()).thenReturn(1);\n var imagePath =\n ResourceUtils.getFile(\"classpath:static/images/halo-logo-401x401.png\").toPath();\n lenient().when(attachmentRootGetter.get()).thenReturn(attachmentRoot);\n this.source = attachmentRoot.resolve(\"static\").resolve(\"hal-logo-401x401.png\");\n Files.createDirectories(this.source.getParent());\n Files.copy(imagePath, this.source);\n\n this.generator =\n new DefaultLocalThumbnailService(this.attachmentRootGetter, this.haloProperties);\n var executorService = MoreExecutors.newDirectExecutorService();\n this.generator.setExecutorService(executorService);\n }\n\n @AfterEach\n void cleanUp() throws Exception {\n this.generator.destroy();\n }\n\n @Test\n void shouldGenerateThumbnail() {\n this.generator.generate(source, ThumbnailSize.S)\n .as(StepVerifier::create)\n .assertNext(resource -> {\n assertTrue(resource.isReadable());\n assertDoesNotThrow(() -> {\n var thumbnailSize = resource.contentLength();\n var sourceSize = Files.size(source);\n assertTrue(thumbnailSize < sourceSize);\n });\n })\n .verifyComplete();\n }\n\n @Test\n void shouldReplaceWithSourceIfSizeIsLarger() {\n this.generator.generate(source, ThumbnailSize.M)\n .as(StepVerifier::create)\n .assertNext(resource -> {\n assertTrue(resource.isReadable());\n assertDoesNotThrow(() -> {\n var thumbnailSize = resource.contentLength();\n var sourceSize = Files.size(source);\n assertEquals(thumbnailSize, sourceSize);\n });\n })\n .verifyComplete();\n }\n\n @Test\n void shouldDisableThumbnailGeneration() {\n when(thumbnailProperties.isDisabled()).thenReturn(true);\n this.generator.generate(source, ThumbnailSize.S)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/thumbnail/DefaultThumbnailServiceTest.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ExternalUrlSupplier;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultThumbnailServiceTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n ExternalUrlSupplier externalUrlSupplier;\n\n @InjectMocks\n DefaultThumbnailService thumbnailService;\n\n @Test\n void shouldGetThumbnailDirectlyIfPermalinkIsRelative() {\n thumbnailService.get(URI.create(\"/images/fake.png\"), ThumbnailSize.M)\n .as(StepVerifier::create)\n .expectNext(URI.create(\"/images/fake.png?width=800\"))\n .verifyComplete();\n }\n\n @Test\n void shouldGetThumbnailDirectlyIfPermalinkContainsSpecialChars() {\n thumbnailService.get(URI.create(\"/images/中文.png\"), ThumbnailSize.M)\n .as(StepVerifier::create)\n .expectNext(URI.create(\"/images/%E4%B8%AD%E6%96%87.png?width=800\"))\n .verifyComplete();\n\n thumbnailService.get(URI.create(\"/images/space%20space.png\"), ThumbnailSize.M)\n .as(StepVerifier::create)\n .expectNext(URI.create(\"/images/space%20space.png?width=800\"))\n .verifyComplete();\n\n thumbnailService.get(URI.create(\"/images/percent%2f.png\"), ThumbnailSize.M)\n .as(StepVerifier::create)\n .expectNext(URI.create(\"/images/percent%2f.png?width=800\"))\n .verifyComplete();\n }\n\n @Test\n void shouldGetThumbnailDirectlyIfPermalinkIsInSite() throws MalformedURLException {\n when(externalUrlSupplier.getRaw()).thenReturn(URI.create(\"https://www.halo.run\").toURL());\n thumbnailService.get(URI.create(\"https://www.halo.run/images/fake.png\"), ThumbnailSize.M)\n .as(StepVerifier::create)\n .expectNext(URI.create(\"https://www.halo.run/images/fake.png?width=800\"))\n .verifyComplete();\n }\n\n @Test\n void shouldGetEmptyThumbnailIfNoAttachmentsFound() throws MalformedURLException {\n when(externalUrlSupplier.getRaw()).thenReturn(URI.create(\"https://www.halo.run\").toURL());\n Mockito.when(\n client.listAll(same(Attachment.class), isA(ListOptions.class), isA(Sort.class))\n )\n .thenReturn(Flux.empty());\n thumbnailService.get(URI.create(\"https://fake.halo.run/fake.png\"))\n .as(StepVerifier::create)\n .expectNext(Map.of())\n .verifyComplete();\n\n // Only invoke once due to caching\n verify(client).listAll(same(Attachment.class), isA(ListOptions.class), isA(Sort.class));\n }\n\n @Test\n void shouldGetThumbnailsIfAttachmentsFound() throws MalformedURLException {\n when(externalUrlSupplier.getRaw()).thenReturn(URI.create(\"https://www.halo.run\").toURL());\n Mockito.when(\n client.listAll(same(Attachment.class), isA(ListOptions.class), isA(Sort.class))\n )\n .thenReturn(Flux.just(\n createAttachment(\"fake-png\", \"https://fake.halo.run/fake.png\",\n Map.of(\"s\", \"/fake.png?width=400\")),\n createAttachment(\"fake-png\", \"https://fake.halo.run/fake.png\",\n Map.of(\"m\", \"/fake.png?width=800\"))\n ));\n\n thumbnailService.get(URI.create(\"https://fake.halo.run/fake.png\"))\n .as(StepVerifier::create)\n .expectNext(Map.of(ThumbnailSize.S, URI.create(\"/fake.png?width=400\")))\n .verifyComplete();\n\n // Only invoke once due to caching\n verify(client).listAll(same(Attachment.class), isA(ListOptions.class), isA(Sort.class));\n }\n\n Attachment createAttachment(String name, String permalink, Map thumbnails) {\n var attachment = new Attachment();\n attachment.setMetadata(new Metadata());\n attachment.getMetadata().setName(name);\n attachment.setSpec(new Attachment.AttachmentSpec());\n attachment.setStatus(new Attachment.AttachmentStatus());\n attachment.getStatus().setPermalink(permalink);\n attachment.getStatus().setThumbnails(thumbnails);\n return attachment;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/thumbnail/ThumbnailImgTagPostProcessorTest.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.when;\nimport static org.thymeleaf.templatemode.TemplateMode.HTML;\n\nimport java.net.URI;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.engine.StandardModelFactory;\nimport org.thymeleaf.model.AttributeValueQuotes;\nimport org.thymeleaf.model.IModelFactory;\nimport org.thymeleaf.spring6.SpringTemplateEngine;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\n@ExtendWith(MockitoExtension.class)\nclass ThumbnailImgTagPostProcessorTest {\n\n @Mock\n ThumbnailService thumbnailService;\n\n @Mock\n ITemplateContext templateContext;\n\n @InjectMocks\n ThumbnailImgTagPostProcessor processor;\n\n IModelFactory modelFactory;\n\n @BeforeEach\n void setUp() {\n var templateEngine = new SpringTemplateEngine();\n this.modelFactory = new StandardModelFactory(templateEngine.getConfiguration(), HTML);\n }\n\n @Test\n void shouldReturnEmptyIfImgTagWithoutSrc() {\n var imgTag = modelFactory.createStandaloneElementTag(\"img\");\n\n processor.process(templateContext, imgTag)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnEmptyIfImgTagWithSrcSet() {\n var imgTag = modelFactory.createStandaloneElementTag(\n \"img\",\n Map.of(\"src\", \"/halo.png\",\n \"srcset\", \"fake-srcset\"),\n AttributeValueQuotes.DOUBLE,\n true,\n true);\n\n processor.process(templateContext, imgTag)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnEmptyIfNotImgTag() {\n var imgTag = modelFactory.createStandaloneElementTag(\"not-a-img\");\n\n processor.process(templateContext, imgTag)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnEmptyIfNoThumbnailsFound() {\n var imgTag = modelFactory.createStandaloneElementTag(\"img\", \"src\", \"/halo.png\");\n\n when(thumbnailService.get(URI.create(\"/halo.png\")))\n .thenReturn(Mono.just(Map.of()));\n\n processor.process(templateContext, imgTag)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnTagIfImgTagWithSrc() {\n var imgTag = modelFactory.createStandaloneElementTag(\"img\", \"src\", \"/halo.png\");\n\n when(templateContext.getModelFactory()).thenReturn(modelFactory);\n when(thumbnailService.get(URI.create(\"/halo.png\")))\n .thenReturn(Mono.just(Map.of(ThumbnailSize.S, URI.create(\"/halo.png?width=400\"))));\n\n processor.process(templateContext, imgTag)\n .as(StepVerifier::create)\n .assertNext(tag -> {\n var srcset = tag.getAttribute(\"srcset\");\n assertEquals(\"/halo.png?width=400 400w\", srcset.getValue());\n assertTrue(tag.hasAttribute(\"sizes\"));\n })\n .verifyComplete();\n }\n\n @Test\n void shouldReturnTagIfImgTagWithSrcAndSizes() {\n var imgTag = modelFactory.createStandaloneElementTag(\n \"img\",\n Map.of(\"src\", \"/halo.png\",\n \"sizes\", \"fake-sizes\"),\n AttributeValueQuotes.DOUBLE,\n true,\n true);\n\n when(templateContext.getModelFactory()).thenReturn(modelFactory);\n when(thumbnailService.get(URI.create(\"/halo.png\")))\n .thenReturn(Mono.just(Map.of(ThumbnailSize.S, URI.create(\"/halo.png?width=400\"))));\n\n processor.process(templateContext, imgTag)\n .as(StepVerifier::create)\n .assertNext(tag -> {\n assertEquals(\"/halo.png?width=400 400w\", tag.getAttribute(\"srcset\").getValue());\n assertEquals(\"fake-sizes\", tag.getAttribute(\"sizes\").getValue());\n })\n .verifyComplete();\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/thumbnail/ThumbnailResourceTransformerTest.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.when;\n\nimport java.io.IOException;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.io.Resource;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.web.reactive.resource.ResourceTransformerChain;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\n@ExtendWith(MockitoExtension.class)\nclass ThumbnailResourceTransformerTest {\n\n @Mock\n LocalThumbnailService localThumbnailService;\n\n @Mock\n ResourceTransformerChain transformerChain;\n\n @Mock\n Resource resource;\n\n @InjectMocks\n ThumbnailResourceTransformer thumbnailResourceTransformer;\n\n @Test\n void shouldNotTransformWithoutWidthQuery() {\n var exchange = MockServerWebExchange.builder(MockServerHttpRequest.get(\"/halo.png\").build())\n .build();\n when(this.transformerChain.transform(exchange, this.resource))\n .thenReturn(Mono.just(this.resource));\n\n thumbnailResourceTransformer.transform(exchange, this.resource, this.transformerChain)\n .as(StepVerifier::create)\n .expectNext(this.resource)\n .verifyComplete();\n }\n\n @Test\n void shouldNotTransformWithNonFileResource() {\n var exchange = MockServerWebExchange.builder(\n MockServerHttpRequest.get(\"/halo.png\").queryParam(\"width\", \"400\").build())\n .build();\n when(this.resource.isFile()).thenReturn(false);\n when(this.transformerChain.transform(exchange, this.resource))\n .thenReturn(Mono.just(this.resource));\n\n thumbnailResourceTransformer.transform(exchange, this.resource, this.transformerChain)\n .as(StepVerifier::create)\n .expectNext(this.resource)\n .verifyComplete();\n }\n\n @Test\n void shouldNotTransformWithUnsupportedImageType() {\n var exchange = MockServerWebExchange.builder(\n MockServerHttpRequest.get(\"/halo.svg\").queryParam(\"width\", \"400\").build())\n .build();\n when(this.resource.isFile()).thenReturn(true);\n when(this.resource.getFilename()).thenReturn(\"halo.svg\");\n when(this.transformerChain.transform(exchange, this.resource))\n .thenReturn(Mono.just(this.resource));\n\n thumbnailResourceTransformer.transform(exchange, this.resource, this.transformerChain)\n .as(StepVerifier::create)\n .expectNext(this.resource)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnSourceIfEmptyGeneration() throws IOException {\n var exchange = MockServerWebExchange.builder(\n MockServerHttpRequest.get(\"/halo.png\").queryParam(\"width\", \"400\").build())\n .build();\n var attachmentRoot = Path.of(\"attachments\").toAbsolutePath();\n var sourcePath = attachmentRoot.resolve(\"upload\").resolve(\"halo.png\");\n when(this.resource.isFile()).thenReturn(true);\n when(this.resource.getFilename()).thenReturn(sourcePath.getFileName().toString());\n when(this.resource.getFile()).thenReturn(sourcePath.toFile());\n thumbnailResourceTransformer = spy(thumbnailResourceTransformer);\n\n when(localThumbnailService.generate(sourcePath, ThumbnailSize.S)).thenReturn(Mono.empty());\n\n when(this.transformerChain.transform(eq(exchange), isA(Resource.class)))\n .thenAnswer(invocation -> Mono.just(invocation.getArgument(1)));\n\n thumbnailResourceTransformer.transform(exchange, this.resource, this.transformerChain)\n .as(StepVerifier::create)\n .assertNext(resource -> assertDoesNotThrow(\n () -> assertEquals(sourcePath.toUri(), resource.getURI())\n ))\n .verifyComplete();\n }\n\n @Test\n void shouldReturnIfThumbnailExists() throws IOException {\n var exchange = MockServerWebExchange.builder(\n MockServerHttpRequest.get(\"/halo.png\").queryParam(\"width\", \"400\").build())\n .build();\n\n var attachmentRoot = Path.of(\"attachments\").toAbsolutePath();\n var sourcePath = attachmentRoot.resolve(\"upload\").resolve(\"halo.png\");\n when(this.resource.isFile()).thenReturn(true);\n when(this.resource.getFilename()).thenReturn(sourcePath.getFileName().toString());\n when(this.resource.getFile()).thenReturn(sourcePath.toFile());\n thumbnailResourceTransformer = spy(thumbnailResourceTransformer);\n\n var generatedResource = mock(Resource.class);\n when(this.localThumbnailService.generate(sourcePath, ThumbnailSize.S))\n .thenReturn(Mono.just(generatedResource));\n when(this.transformerChain.transform(exchange, generatedResource))\n .thenReturn(Mono.just(generatedResource));\n\n thumbnailResourceTransformer.transform(exchange, this.resource, this.transformerChain)\n .as(StepVerifier::create)\n .expectNext(generatedResource)\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/attachment/thumbnail/ThumbnailUtilsTest.java", "content": "package run.halo.app.core.attachment.thumbnail;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.ValueSource;\nimport org.springframework.http.MediaType;\nimport run.halo.app.core.attachment.ThumbnailSize;\n\nclass ThumbnailUtilsTest {\n\n @ParameterizedTest\n @ValueSource(strings = {\n \"image/jpg\", \"image/jpeg\", \"image/png\", \"image/bmp\", \"image/vnd.wap.wbmp\",\n })\n void shouldBeSupportedImageType(String mimeType) {\n Assertions.assertTrue(ThumbnailUtils.isSupportedImage(MediaType.parseMediaType(mimeType)));\n }\n\n @ParameterizedTest\n @ValueSource(strings = {\n \"image/svg+xml\", \"image/gif\", \"image/webp\", \"image/x-icon\", \"image/avif\", \"image/tiff\",\n \"application/json\", \"text/plain\", \"application/octet-stream\"\n })\n void shouldNotBeSupportedImageType(String mimeType) {\n assertFalse(ThumbnailUtils.isSupportedImage(MediaType.parseMediaType(mimeType)));\n }\n\n @ParameterizedTest\n @ValueSource(strings = {\n \"jpg\", \"jpeg\", \"png\", \"bmp\", \"wbmp\", \"JPG\", \"JPEG\", \"PNG\", \"BMP\", \"WBMP\"\n })\n void shouldBeSupportedImageSuffix(String suffix) {\n assertTrue(ThumbnailUtils.isSupportedImage(suffix));\n }\n\n @ParameterizedTest\n @ValueSource(strings = {\n \"svg\", \"avif\", \"gif\", \"webp\", \"x-icon\", \"tiff\", \"json\", \"txt\", \"\", \" \", \" \", \".jpg\"\n })\n void shouldNotBeSupportedImageSuffix(String suffix) {\n assertFalse(ThumbnailUtils.isSupportedImage(suffix));\n }\n\n @Test\n void shouldBuildSrcSetWithUriWithSpecialCharacters() {\n var permalink = URI.create(\"/中文.png\").toASCIIString();\n var srcsetMap = ThumbnailUtils.buildSrcsetMap(URI.create(permalink));\n assertEquals(\"/%E4%B8%AD%E6%96%87.png?width=400\",\n srcsetMap.get(ThumbnailSize.S).toString());\n assertEquals(\"/%E4%B8%AD%E6%96%87.png?width=800\",\n srcsetMap.get(ThumbnailSize.M).toString());\n assertEquals(\"/%E4%B8%AD%E6%96%87.png?width=1200\",\n srcsetMap.get(ThumbnailSize.L).toString());\n assertEquals(\"/%E4%B8%AD%E6%96%87.png?width=1600\",\n srcsetMap.get(ThumbnailSize.XL).toString());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/counter/MeterUtilsTest.java", "content": "package run.halo.app.core.counter;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport io.micrometer.core.instrument.Counter;\nimport io.micrometer.core.instrument.Meter;\nimport io.micrometer.core.instrument.MeterRegistry;\nimport io.micrometer.core.instrument.search.RequiredSearch;\nimport io.micrometer.core.instrument.simple.SimpleMeterRegistry;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.core.extension.content.Post;\n\n/**\n * Tests for {@link MeterUtils}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass MeterUtilsTest {\n\n @Test\n void nameOf() {\n String s = MeterUtils.nameOf(Post.class, \"fake-post\");\n assertThat(s).isEqualTo(\"posts.content.halo.run/fake-post\");\n }\n\n @Test\n void testNameOf() {\n String s = MeterUtils.nameOf(\"content.halo.run\", \"posts\", \"fake-post\");\n assertThat(s).isEqualTo(\"posts.content.halo.run/fake-post\");\n }\n\n @Test\n void visitCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n MeterUtils.visitCounter(meterRegistry, \"posts.content.halo.run/fake-post\")\n .increment();\n RequiredSearch requiredSearch = meterRegistry.get(\"posts.content.halo.run/fake-post\");\n assertThat(requiredSearch.counter().count()).isEqualTo(1);\n Meter.Id id = requiredSearch.counter().getId();\n assertThat(id.getTag(MeterUtils.SCENE)).isEqualTo(MeterUtils.VISIT_SCENE);\n assertThat(id.getTag(MeterUtils.METRICS_COMMON_TAG.getKey()))\n .isEqualTo(MeterUtils.METRICS_COMMON_TAG.getValue());\n }\n\n @Test\n void upvoteCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n MeterUtils.upvoteCounter(meterRegistry, \"posts.content.halo.run/fake-post\")\n .increment(2);\n RequiredSearch requiredSearch = meterRegistry.get(\"posts.content.halo.run/fake-post\");\n assertThat(requiredSearch.counter().count()).isEqualTo(2);\n Meter.Id id = requiredSearch.counter().getId();\n assertThat(id.getTag(MeterUtils.SCENE)).isEqualTo(MeterUtils.UPVOTE_SCENE);\n assertThat(id.getTag(MeterUtils.METRICS_COMMON_TAG.getKey()))\n .isEqualTo(MeterUtils.METRICS_COMMON_TAG.getValue());\n }\n\n @Test\n void totalCommentCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n MeterUtils.totalCommentCounter(meterRegistry, \"content.halo.run.posts.fake-post\")\n .increment(3);\n RequiredSearch requiredSearch = meterRegistry.get(\"content.halo.run.posts.fake-post\");\n assertThat(requiredSearch.counter().count()).isEqualTo(3);\n Meter.Id id = requiredSearch.counter().getId();\n assertThat(id.getTag(MeterUtils.SCENE)).isEqualTo(MeterUtils.TOTAL_COMMENT_SCENE);\n assertThat(id.getTag(MeterUtils.METRICS_COMMON_TAG.getKey()))\n .isEqualTo(MeterUtils.METRICS_COMMON_TAG.getValue());\n }\n\n @Test\n void approvedCommentCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n MeterUtils.approvedCommentCounter(meterRegistry, \"posts.content.halo.run/fake-post\")\n .increment(2);\n RequiredSearch requiredSearch = meterRegistry.get(\"posts.content.halo.run/fake-post\");\n assertThat(requiredSearch.counter().count()).isEqualTo(2);\n Meter.Id id = requiredSearch.counter().getId();\n assertThat(id.getTag(MeterUtils.SCENE)).isEqualTo(MeterUtils.APPROVED_COMMENT_SCENE);\n assertThat(id.getTag(MeterUtils.METRICS_COMMON_TAG.getKey()))\n .isEqualTo(MeterUtils.METRICS_COMMON_TAG.getValue());\n }\n\n @Test\n void isVisitCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n Counter visitCounter =\n MeterUtils.visitCounter(meterRegistry, \"posts.content.halo.run/fake-post\");\n assertThat(MeterUtils.isVisitCounter(visitCounter)).isTrue();\n }\n\n @Test\n void isUpvoteCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n Counter upvoteCounter =\n MeterUtils.upvoteCounter(meterRegistry, \"posts.content.halo.run/fake-post\");\n assertThat(MeterUtils.isUpvoteCounter(upvoteCounter)).isTrue();\n assertThat(MeterUtils.isVisitCounter(upvoteCounter)).isFalse();\n }\n\n @Test\n void isDownvoteCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n Counter downvoteCounter =\n MeterUtils.downvoteCounter(meterRegistry, \"posts.content.halo.run/fake-post\");\n assertThat(MeterUtils.isDownvoteCounter(downvoteCounter)).isTrue();\n assertThat(MeterUtils.isVisitCounter(downvoteCounter)).isFalse();\n }\n\n @Test\n void isTotalCommentCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n Counter totalCommentCounter =\n MeterUtils.totalCommentCounter(meterRegistry, \"posts.content.halo.run/fake-post\");\n assertThat(MeterUtils.isTotalCommentCounter(totalCommentCounter)).isTrue();\n assertThat(MeterUtils.isVisitCounter(totalCommentCounter)).isFalse();\n }\n\n @Test\n void isApprovedCommentCounter() {\n MeterRegistry meterRegistry = new SimpleMeterRegistry();\n Counter approvedCommentCounter =\n MeterUtils.approvedCommentCounter(meterRegistry, \"posts.content.halo.run/fake-post\");\n assertThat(MeterUtils.isApprovedCommentCounter(approvedCommentCounter)).isTrue();\n assertThat(MeterUtils.isVisitCounter(approvedCommentCounter)).isFalse();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/WebSocketHandlerMappingTest.java", "content": "package run.halo.app.core.endpoint;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.web.reactive.socket.WebSocketHandler;\nimport org.springframework.web.reactive.socket.WebSocketSession;\nimport run.halo.app.extension.GroupVersion;\n\n@ExtendWith(MockitoExtension.class)\nclass WebSocketHandlerMappingTest {\n\n @InjectMocks\n WebSocketHandlerMapping handlerMapping;\n\n @Test\n void shouldRegisterEndpoint() {\n var endpoint = new FakeWebSocketEndpoint();\n handlerMapping.register(List.of(endpoint));\n assertTrue(handlerMapping.getEndpointMap().containsValue(endpoint));\n }\n\n @Test\n void shouldUnregisterEndpoint() {\n var endpoint = new FakeWebSocketEndpoint();\n handlerMapping.register(List.of(endpoint));\n assertTrue(handlerMapping.getEndpointMap().containsValue(endpoint));\n handlerMapping.unregister(List.of(endpoint));\n assertFalse(handlerMapping.getEndpointMap().containsValue(endpoint));\n }\n\n static class FakeWebSocketEndpoint implements WebSocketEndpoint {\n\n @Override\n public String urlPath() {\n return \"/resources\";\n }\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseAPIVersion(\"fake.halo.run/v1alpha1\");\n }\n\n @Override\n public WebSocketHandler handler() {\n return WebSocketSession::close;\n }\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/EmailVerificationCodeTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.springSecurity;\n\nimport io.github.resilience4j.ratelimiter.RateLimiterConfig;\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport java.time.Duration;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.validation.Validator;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.user.service.EmailVerificationService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tests for a part of {@link UserEndpoint} about sending email verification code.\n *\n * @author guqing\n * @see UserEndpoint\n * @see EmailVerificationService\n * @since 2.11.0\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\n@WithMockUser(username = \"fake-user\", password = \"fake-password\")\nclass EmailVerificationCodeTest {\n\n WebTestClient webClient;\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n EmailVerificationService emailVerificationService;\n\n @Mock\n UserService userService;\n\n @Mock\n RateLimiterRegistry rateLimiterRegistry;\n\n @Mock\n Validator validator;\n\n @InjectMocks\n UserEndpoint endpoint;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .apply(springSecurity())\n .build();\n }\n\n @Test\n void sendEmailVerificationCode() {\n var config = RateLimiterConfig.custom()\n .limitRefreshPeriod(Duration.ofSeconds(10))\n .limitForPeriod(1)\n .build();\n var sendCodeRateLimiter = RateLimiterRegistry.of(config)\n .rateLimiter(\"send-email-verification-code-fake-user:hi@halo.run\");\n when(rateLimiterRegistry.rateLimiter(\n \"send-email-verification-code-fake-user:hi@halo.run\",\n \"send-email-verification-code\")\n ).thenReturn(sendCodeRateLimiter);\n\n var user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-user\");\n user.setSpec(new User.UserSpec());\n user.getSpec().setEmail(\"hi@halo.run\");\n when(emailVerificationService.sendVerificationCode(anyString(), anyString()))\n .thenReturn(Mono.empty());\n webClient.post()\n .uri(\"/users/-/send-email-verification-code\")\n .bodyValue(Map.of(\"email\", \"hi@halo.run\"))\n .exchange()\n .expectStatus()\n .isOk();\n\n // request again to trigger rate limit\n webClient.post()\n .uri(\"/users/-/send-email-verification-code\")\n .bodyValue(Map.of(\"email\", \"hi@halo.run\"))\n .exchange()\n .expectStatus()\n .isEqualTo(HttpStatus.TOO_MANY_REQUESTS);\n }\n\n @Test\n void verifyEmail() {\n var config = RateLimiterConfig.custom()\n .limitRefreshPeriod(Duration.ofSeconds(10))\n .limitForPeriod(1)\n .build();\n\n var verifyEmailRateLimiter = RateLimiterRegistry.of(config)\n .rateLimiter(\"verify-email-fake-user\");\n when(rateLimiterRegistry.rateLimiter(\"verify-email-fake-user\", \"verify-email\"))\n .thenReturn(verifyEmailRateLimiter);\n\n when(emailVerificationService.verify(anyString(), anyString()))\n .thenReturn(Mono.empty());\n when(userService.confirmPassword(anyString(), anyString()))\n .thenReturn(Mono.just(true));\n webClient.post()\n .uri(\"/users/-/verify-email\")\n .bodyValue(Map.of(\"code\", \"fake-code-1\", \"password\", \"123456\"))\n .exchange()\n .expectStatus()\n .isOk();\n\n // request again to trigger rate limit\n webClient.post()\n .uri(\"/users/-/verify-email\")\n .bodyValue(Map.of(\"code\", \"fake-code-2\", \"password\", \"123456\"))\n .exchange()\n .expectStatus()\n .isEqualTo(HttpStatus.TOO_MANY_REQUESTS);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/PluginEndpointTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static java.util.Objects.requireNonNull;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.test.web.reactive.server.WebTestClient.bindToRouterFunction;\nimport static org.springframework.web.reactive.function.BodyInserters.fromMultipartData;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.nio.charset.StandardCharsets;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.core.io.ByteArrayResource;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.http.CacheControl;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.client.MultipartBodyBuilder;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.user.service.SettingConfigService;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.plugin.PluginService;\n\n@Slf4j\n@ExtendWith(MockitoExtension.class)\nclass PluginEndpointTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n SystemVersionSupplier systemVersionSupplier;\n\n @Mock\n PluginService pluginService;\n\n @Mock\n SettingConfigService settingConfigService;\n\n @Spy\n WebProperties webProperties = new WebProperties();\n\n @InjectMocks\n PluginEndpoint endpoint;\n\n @Nested\n class PluginListTest {\n\n @Test\n void shouldListEmptyPluginsWhenNoPlugins() {\n when(client.listBy(same(Plugin.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(ListResult.emptyResult()));\n\n bindToRouterFunction(endpoint.endpoint())\n .build()\n .get().uri(\"/plugins\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(0)\n .jsonPath(\"$.total\").isEqualTo(0);\n }\n\n @Test\n void shouldListPluginsWhenPluginPresent() {\n var plugins = List.of(\n createPlugin(\"fake-plugin-1\"),\n createPlugin(\"fake-plugin-2\"),\n createPlugin(\"fake-plugin-3\")\n );\n var expectResult = new ListResult<>(plugins);\n when(client.listBy(same(Plugin.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n\n bindToRouterFunction(endpoint.endpoint())\n .build()\n .get().uri(\"/plugins\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(3)\n .jsonPath(\"$.total\").isEqualTo(3);\n }\n\n @Test\n void shouldFilterPluginsWhenKeywordProvided() {\n var expectPlugin =\n createPlugin(\"fake-plugin-2\", \"expected display name\", \"\", false);\n var unexpectedPlugin1 =\n createPlugin(\"fake-plugin-1\", \"first fake display name\", \"\", false);\n var unexpectedPlugin2 =\n createPlugin(\"fake-plugin-3\", \"second fake display name\", \"\", false);\n var plugins = List.of(\n expectPlugin\n );\n var expectResult = new ListResult<>(plugins);\n when(client.listBy(same(Plugin.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n\n bindToRouterFunction(endpoint.endpoint())\n .build()\n .get().uri(\"/plugins?keyword=Expected\")\n .exchange()\n .expectStatus().isOk();\n }\n\n @Test\n void shouldFilterPluginsWhenEnabledProvided() {\n var expectPlugin =\n createPlugin(\"fake-plugin-2\", \"expected display name\", \"\", true);\n var plugins = List.of(\n expectPlugin\n );\n var expectResult = new ListResult<>(plugins);\n\n when(client.listBy(same(Plugin.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n\n bindToRouterFunction(endpoint.endpoint())\n .build()\n .get().uri(\"/plugins?enabled=true\")\n .exchange()\n .expectStatus().isOk();\n }\n\n @Test\n void shouldSortPluginsWhenCreationTimestampSet() {\n var expectPlugin =\n createPlugin(\"fake-plugin-2\", \"expected display name\", \"\", true);\n var expectResult = new ListResult<>(List.of(expectPlugin));\n when(client.listBy(same(Plugin.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n\n bindToRouterFunction(endpoint.endpoint())\n .build()\n .get().uri(\"/plugins?sort=creationTimestamp,desc\")\n .exchange()\n .expectStatus().isOk();\n }\n }\n\n @Nested\n class PluginUpgradeTest {\n\n WebTestClient webClient;\n\n Path tempDirectory;\n\n Path plugin002;\n\n @BeforeEach\n void setUp() throws URISyntaxException, IOException {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .build();\n\n lenient().when(systemVersionSupplier.get()).thenReturn(Version.parse(\"0.0.0\"));\n tempDirectory = Files.createTempDirectory(\"halo-test-plugin-upgrade-\");\n plugin002 = tempDirectory.resolve(\"plugin-0.0.2.jar\");\n\n var plugin002Uri = requireNonNull(\n getClass().getClassLoader().getResource(\"plugin/plugin-0.0.2\")).toURI();\n\n FileUtils.jar(Paths.get(plugin002Uri), tempDirectory.resolve(\"plugin-0.0.2.jar\"));\n }\n\n @AfterEach\n void cleanUp() {\n FileUtils.deleteRecursivelyAndSilently(tempDirectory);\n }\n\n @Test\n void shouldResponseBadRequestIfNoPluginInstalledBefore() {\n var bodyBuilder = new MultipartBodyBuilder();\n bodyBuilder.part(\"file\", new FileSystemResource(plugin002))\n .contentType(MediaType.MULTIPART_FORM_DATA);\n\n when(pluginService.upgrade(eq(\"fake-plugin\"), isA(Path.class)))\n .thenReturn(Mono.error(new ServerWebInputException(\"plugin not found\")));\n\n webClient.post().uri(\"/plugins/fake-plugin/upgrade\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(fromMultipartData(bodyBuilder.build()))\n .exchange()\n .expectStatus().isBadRequest();\n\n verify(pluginService).upgrade(eq(\"fake-plugin\"), isA(Path.class));\n }\n\n }\n\n @Nested\n class UpdatePluginConfigTest {\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint()).build();\n }\n\n @Test\n void updateWhenConfigMapNameIsNull() {\n Plugin plugin = createPlugin(\"fake-plugin\");\n plugin.getSpec().setConfigMapName(null);\n\n when(client.fetch(eq(Plugin.class), eq(\"fake-plugin\"))).thenReturn(Mono.just(plugin));\n webClient.put()\n .uri(\"/plugins/fake-plugin/json-config\")\n .exchange()\n .expectStatus().isBadRequest();\n }\n\n @Test\n void updateJsonConfigTest() {\n Plugin plugin = createPlugin(\"fake-plugin\");\n plugin.getSpec().setConfigMapName(\"fake-config-map\");\n\n when(client.fetch(eq(Plugin.class), eq(\"fake-plugin\"))).thenReturn(Mono.just(plugin));\n when(settingConfigService.upsertConfig(eq(\"fake-config-map\"), any()))\n .thenReturn(Mono.empty());\n\n webClient.put()\n .uri(\"/plugins/fake-plugin/json-config\")\n .body(Mono.just(Map.of()), Map.class)\n .exchange()\n .expectStatus().is2xxSuccessful();\n }\n }\n\n @Nested\n class PluginConfigAndSettingFetchTest {\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .build();\n }\n\n @Test\n void fetchSetting() {\n Plugin plugin = createPlugin(\"fake\");\n plugin.getSpec().setSettingName(\"fake-setting\");\n\n when(client.fetch(eq(Setting.class), eq(\"fake-setting\")))\n .thenReturn(Mono.just(new Setting()));\n\n when(client.fetch(eq(Plugin.class), eq(\"fake\"))).thenReturn(Mono.just(plugin));\n webClient.get()\n .uri(\"/plugins/fake/setting\")\n .exchange()\n .expectStatus().isOk();\n\n verify(client).fetch(eq(Setting.class), eq(\"fake-setting\"));\n verify(client).fetch(eq(Plugin.class), eq(\"fake\"));\n }\n\n @Test\n void fetchJsonConfig() {\n Plugin plugin = createPlugin(\"fake\");\n plugin.getSpec().setConfigMapName(\"fake-config\");\n\n when(settingConfigService.fetchConfig(eq(\"fake-config\")))\n .thenReturn(Mono.empty());\n when(client.fetch(eq(Plugin.class), eq(\"fake\"))).thenReturn(Mono.just(plugin));\n webClient.get()\n .uri(\"/plugins/fake/json-config\")\n .exchange()\n .expectStatus().isOk();\n\n verify(settingConfigService).fetchConfig(eq(\"fake-config\"));\n verify(client).fetch(eq(Plugin.class), eq(\"fake\"));\n }\n }\n\n Plugin createPlugin(String name) {\n return createPlugin(name, \"fake display name\", \"fake description\", null);\n }\n\n Plugin createPlugin(String name, String displayName, String description, Boolean enabled) {\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setCreationTimestamp(Instant.now());\n var spec = new Plugin.PluginSpec();\n spec.setDisplayName(displayName);\n spec.setDescription(description);\n spec.setEnabled(enabled);\n var plugin = new Plugin();\n plugin.setMetadata(metadata);\n plugin.setSpec(spec);\n return plugin;\n }\n\n Plugin createPlugin(String name, Instant creationTimestamp) {\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setCreationTimestamp(creationTimestamp);\n var spec = new Plugin.PluginSpec();\n var plugin = new Plugin();\n plugin.setMetadata(metadata);\n plugin.setSpec(spec);\n return plugin;\n }\n\n @Nested\n class BundleResourceEndpointTest {\n\n private long lastModified;\n\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint()).build();\n long currentTimeMillis = System.currentTimeMillis();\n // We should ignore milliseconds here\n // See https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1 for more.\n this.lastModified = currentTimeMillis - currentTimeMillis % 1_000;\n }\n\n @Test\n void shouldBeRedirectedWhileFetchingBundleJsWithoutVersion() {\n when(pluginService.generateBundleVersion()).thenReturn(Mono.just(\"fake-version\"));\n webClient.get().uri(\"/plugins/-/bundle.js\")\n .exchange()\n .expectStatus().is3xxRedirection()\n .expectHeader().cacheControl(CacheControl.noStore())\n .expectHeader().location(\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.js?v=fake-version\");\n }\n\n @Test\n void shouldBeRedirectedWhileFetchingBundleCssWithoutVersion() {\n when(pluginService.generateBundleVersion()).thenReturn(Mono.just(\"fake-version\"));\n webClient.get().uri(\"/plugins/-/bundle.css\")\n .exchange()\n .expectStatus().is3xxRedirection()\n .expectHeader().cacheControl(CacheControl.noStore())\n .expectHeader().location(\n \"/apis/api.console.halo.run/v1alpha1/plugins/-/bundle.css?v=fake-version\");\n }\n\n @Test\n void shouldFetchBundleCssWithCacheControl() {\n var cache = webProperties.getResources().getCache();\n cache.setUseLastModified(true);\n var cachecontrol = cache.getCachecontrol();\n cachecontrol.setNoCache(true);\n endpoint.afterPropertiesSet();\n\n when(pluginService.getCssBundle(\"fake-version\"))\n .thenReturn(Mono.fromSupplier(() -> mockResource(\"fake-css\")));\n webClient.get().uri(\"/plugins/-/bundle.css?v=fake-version\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().cacheControl(CacheControl.noCache())\n .expectHeader().contentType(\"text/css\")\n .expectHeader().lastModified(lastModified)\n .expectBody(String.class).isEqualTo(\"fake-css\");\n }\n\n @Test\n void shouldFetchBundleJsWithCacheControl() {\n var cache = webProperties.getResources().getCache();\n cache.setUseLastModified(true);\n var cachecontrol = cache.getCachecontrol();\n cachecontrol.setNoStore(true);\n endpoint.afterPropertiesSet();\n\n when(pluginService.getJsBundle(\"fake-version\"))\n .thenReturn(Mono.fromSupplier(() -> mockResource(\"fake-js\")));\n webClient.get().uri(\"/plugins/-/bundle.js?v=fake-version\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().cacheControl(CacheControl.noStore())\n .expectHeader().contentType(\"text/javascript\")\n .expectHeader().lastModified(lastModified)\n .expectBody(String.class).isEqualTo(\"fake-js\");\n }\n\n @Test\n void shouldFetchBundleCss() {\n when(pluginService.getCssBundle(\"fake-version\"))\n .thenReturn(Mono.fromSupplier(() -> mockResource(\"fake-css\")));\n webClient.get().uri(\"/plugins/-/bundle.css?v=fake-version\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().cacheControl(CacheControl.empty())\n .expectHeader().contentType(\"text/css\")\n .expectHeader().lastModified(-1)\n .expectBody(String.class).isEqualTo(\"fake-css\");\n }\n\n @Test\n void shouldFetchBundleJs() {\n when(pluginService.getJsBundle(\"fake-version\"))\n .thenReturn(Mono.fromSupplier(() -> mockResource(\"fake-js\")));\n webClient.get().uri(\"/plugins/-/bundle.js?v=fake-version\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().cacheControl(CacheControl.empty())\n .expectHeader().contentType(\"text/javascript\")\n .expectHeader().lastModified(-1)\n .expectBody(String.class).isEqualTo(\"fake-js\");\n }\n\n Resource mockResource(String content) {\n var resource = new ByteArrayResource(content.getBytes(StandardCharsets.UTF_8));\n resource = spy(resource);\n try {\n doReturn(lastModified).when(resource).lastModified();\n } catch (IOException e) {\n // should never happen\n throw new RuntimeException(e);\n }\n return resource;\n }\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/PostEndpointTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentUpdateParam;\nimport run.halo.app.content.PostRequest;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Post.PostSpec;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tests for @{@link PostEndpoint}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostEndpointTest {\n\n @Mock\n PostService postService;\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n ApplicationEventPublisher eventPublisher;\n\n @InjectMocks\n PostEndpoint postEndpoint;\n\n WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n postEndpoint.setMaxAttemptsWaitForPublish(3);\n webTestClient = WebTestClient\n .bindToRouterFunction(postEndpoint.endpoint())\n .build();\n }\n\n @Test\n void draftPost() {\n when(postService.draftPost(any())).thenReturn(Mono.just(TestPost.postV1()));\n webTestClient.post()\n .uri(\"/posts\")\n .bodyValue(postRequest(TestPost.postV1()))\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(Post.class)\n .value(post -> assertThat(post).isEqualTo(TestPost.postV1()));\n }\n\n @Test\n void updatePost() {\n when(postService.updatePost(any())).thenReturn(Mono.just(TestPost.postV1()));\n\n webTestClient.put()\n .uri(\"/posts/post-A\")\n .bodyValue(postRequest(TestPost.postV1()))\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(Post.class)\n .value(post -> assertThat(post).isEqualTo(TestPost.postV1()));\n }\n\n @Test\n void publishRetryOnOptimisticLockingFailure() {\n var post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"post-1\");\n post.setSpec(new PostSpec());\n when(client.get(eq(Post.class), eq(\"post-1\"))).thenReturn(Mono.just(post));\n\n when(client.update(any(Post.class)))\n .thenReturn(Mono.error(new OptimisticLockingFailureException(\"fake-error\")));\n\n // Send request\n webTestClient.put()\n .uri(\"/posts/{name}/publish?async=false\", \"post-1\")\n .exchange()\n .expectStatus()\n .is5xxServerError();\n\n // Verify WebClient retry behavior\n verify(client, times(6)).get(eq(Post.class), eq(\"post-1\"));\n verify(client, times(6)).update(any(Post.class));\n }\n\n @Test\n void publishSuccess() {\n var post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"post-1\");\n post.setSpec(new PostSpec());\n\n var publishedPost = new Post();\n var publishedMetadata = new Metadata();\n publishedMetadata.setAnnotations(Map.of(Post.LAST_RELEASED_SNAPSHOT_ANNO, \"my-release\"));\n publishedPost.setMetadata(publishedMetadata);\n var publishedPostSpec = new PostSpec();\n publishedPostSpec.setReleaseSnapshot(\"my-release\");\n publishedPost.setSpec(publishedPostSpec);\n\n when(client.get(eq(Post.class), eq(\"post-1\")))\n .thenReturn(Mono.just(post))\n .thenReturn(Mono.just(publishedPost));\n\n when(client.update(any(Post.class)))\n .thenReturn(Mono.just(post));\n\n // Send request\n webTestClient.put()\n .uri(\"/posts/{name}/publish?async=false\", \"post-1\")\n .exchange()\n .expectStatus()\n .is2xxSuccessful();\n\n // Verify WebClient retry behavior\n verify(client, times(2)).get(eq(Post.class), eq(\"post-1\"));\n verify(client).update(any(Post.class));\n }\n\n @Test\n void shouldFailIfWaitTimeoutForPublishedStatus() {\n var post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"post-1\");\n post.setSpec(new PostSpec());\n\n var publishedPost = new Post();\n var publishedMetadata = new Metadata();\n publishedMetadata.setAnnotations(\n Map.of(Post.LAST_RELEASED_SNAPSHOT_ANNO, \"old-my-release\"));\n publishedPost.setMetadata(publishedMetadata);\n var publishedPostSpec = new PostSpec();\n publishedPostSpec.setReleaseSnapshot(\"my-release\");\n publishedPost.setSpec(publishedPostSpec);\n\n when(client.get(eq(Post.class), eq(\"post-1\")))\n .thenReturn(Mono.just(post))\n .thenReturn(Mono.just(publishedPost));\n\n when(client.update(any(Post.class)))\n .thenReturn(Mono.just(post));\n\n // Send request\n webTestClient.put()\n .uri(\"/posts/{name}/publish?async=false\", \"post-1\")\n .exchange()\n .expectStatus()\n .is5xxServerError();\n\n // Verify WebClient retry behavior\n verify(client, times(5)).get(eq(Post.class), eq(\"post-1\"));\n verify(client).update(any(Post.class));\n }\n\n PostRequest postRequest(Post post) {\n return new PostRequest(post, new ContentUpdateParam(null, \"B\", \"

B

\", \"MARKDOWN\"));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/SinglePageEndpointTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tests for @{@link SinglePageEndpoint}.\n *\n * @author guqing\n * @since 2.3.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageEndpointTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n SinglePageEndpoint singlePageEndpoint;\n\n WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n webTestClient = WebTestClient\n .bindToRouterFunction(singlePageEndpoint.endpoint())\n .build();\n }\n\n @Test\n void publishRetryOnOptimisticLockingFailure() {\n var page = new SinglePage();\n page.setMetadata(new Metadata());\n page.getMetadata().setName(\"page-1\");\n page.setSpec(new SinglePage.SinglePageSpec());\n when(client.get(eq(SinglePage.class), eq(\"page-1\"))).thenReturn(Mono.just(page));\n\n when(client.update(any(SinglePage.class)))\n .thenReturn(Mono.error(new OptimisticLockingFailureException(\"fake-error\")));\n\n // Send request\n webTestClient.put()\n .uri(\"/singlepages/{name}/publish?async=false\", \"page-1\")\n .exchange()\n .expectStatus()\n .is5xxServerError();\n\n // Verify WebClient retry behavior\n verify(client, times(6)).get(eq(SinglePage.class), eq(\"page-1\"));\n verify(client, times(6)).update(any(SinglePage.class));\n }\n\n @Test\n void publishSuccess() {\n var page = new SinglePage();\n page.setMetadata(new Metadata());\n page.getMetadata().setName(\"page-1\");\n page.setSpec(new SinglePage.SinglePageSpec());\n\n when(client.get(eq(SinglePage.class), eq(\"page-1\"))).thenReturn(Mono.just(page));\n when(client.fetch(eq(SinglePage.class), eq(\"page-1\"))).thenReturn(Mono.empty());\n\n when(client.update(any(SinglePage.class))).thenReturn(Mono.just(page));\n\n // Send request\n webTestClient.put()\n .uri(\"/singlepages/{name}/publish?async=false\", \"page-1\")\n .exchange()\n .expectStatus()\n .is2xxSuccessful();\n\n // Verify WebClient retry behavior\n verify(client, times(1)).get(eq(SinglePage.class), eq(\"page-1\"));\n verify(client, times(1)).update(any(SinglePage.class));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/TagEndpointTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.springSecurity;\nimport static org.springframework.test.web.reactive.server.WebTestClient.bindToRouterFunction;\n\nimport java.time.Instant;\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tag endpoint test.\n *\n * @author LIlGG\n */\n@ExtendWith(MockitoExtension.class)\nclass TagEndpointTest {\n @Mock\n ReactiveExtensionClient client;\n\n @InjectMocks\n TagEndpoint tagEndpoint;\n\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(tagEndpoint.endpoint())\n .apply(springSecurity())\n .build();\n }\n\n @Nested\n class TagListTest {\n\n @Test\n void shouldListEmptyTagsWhenNoTags() {\n when(client.listBy(same(Tag.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(ListResult.emptyResult()));\n\n bindToRouterFunction(tagEndpoint.endpoint())\n .build()\n .get().uri(\"/tags\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(0)\n .jsonPath(\"$.total\").isEqualTo(0);\n }\n\n @Test\n void shouldListTagsWhenTagPresent() {\n var tags = List.of(\n createTag(\"fake-tag-1\"),\n createTag(\"fake-tag-2\")\n );\n var expectResult = new ListResult<>(tags);\n when(client.listBy(same(Tag.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n\n bindToRouterFunction(tagEndpoint.endpoint())\n .build()\n .get().uri(\"/tags\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(2)\n .jsonPath(\"$.total\").isEqualTo(2);\n }\n\n Tag createTag(String name) {\n return createTag(name, \"fake display name\");\n }\n\n Tag createTag(String name, String displayName) {\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setCreationTimestamp(Instant.now());\n var spec = new Tag.TagSpec();\n spec.setDisplayName(displayName);\n spec.setSlug(name);\n var tag = new Tag();\n tag.setMetadata(metadata);\n tag.setSpec(spec);\n return tag;\n }\n\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/UserEndpointIntegrationTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.mockito.ArgumentMatchers.anySet;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\n\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\n@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_METHOD)\n@WithMockUser(username = \"fake-user\", password = \"fake-password\", roles = \"fake-super-role\")\npublic class UserEndpointIntegrationTest {\n @Autowired\n WebTestClient webClient;\n\n @Autowired\n ReactiveExtensionClient client;\n\n @MockitoBean\n RoleService roleService;\n\n @BeforeEach\n void setUp() {\n var rule = new Role.PolicyRule.Builder()\n .apiGroups(\"*\")\n .resources(\"*\")\n .verbs(\"*\")\n .build();\n var role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(\"fake-super-role\");\n role.setRules(List.of(rule));\n when(roleService.listDependenciesFlux(anySet())).thenReturn(Flux.just(role));\n webClient = webClient.mutateWith(csrf());\n }\n\n @Nested\n class UserListTest {\n @Test\n void shouldFilterUsersWhenDisplayNameKeywordProvided() {\n var expectUser =\n createUser(\"fake-user-2\", \"expected display name\");\n var unexpectedUser1 =\n createUser(\"fake-user-1\", \"first fake display name\");\n var unexpectedUser2 =\n createUser(\"fake-user-3\", \"second fake display name\");\n\n client.create(expectUser).block();\n client.create(unexpectedUser1).block();\n client.create(unexpectedUser2).block();\n\n when(roleService.list(anySet())).thenReturn(Flux.empty());\n when(roleService.getRolesByUsernames(\n List.of(\"fake-user-2\")\n )).thenReturn(Mono.just(Map.of(\"fake-user-2\", Set.of(\"fake-super-role\"))));\n\n webClient.get().uri(\"/apis/api.console.halo.run/v1alpha1/users?keyword=Expected\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(1)\n .jsonPath(\"$.items[0].user.metadata.name\").isEqualTo(\"fake-user-2\");\n\n }\n\n @Test\n void shouldFilterUsersWhenUserNameKeywordProvided() {\n var expectUser =\n createUser(\"fake-user\", \"expected display name\");\n var unexpectedUser1 =\n createUser(\"fake-user-1\", \"first fake display name\");\n var unexpectedUser2 =\n createUser(\"fake-user-3\", \"second fake display name\");\n\n client.create(expectUser).block();\n client.create(unexpectedUser1).block();\n client.create(unexpectedUser2).block();\n\n when(roleService.list(anySet())).thenReturn(Flux.empty());\n when(roleService.getRolesByUsernames(List.of(\"fake-user\")))\n .thenReturn(Mono.just(Map.of(\"fake-user\", Set.of(\"fake-super-role\"))));\n\n webClient.get().uri(\"/apis/api.console.halo.run/v1alpha1/users?keyword=fake-user\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(1)\n .jsonPath(\"$.items[0].user.metadata.name\").isEqualTo(\"fake-user\");\n }\n }\n\n User createUser(String name, String displayName) {\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setCreationTimestamp(Instant.now());\n var spec = new User.UserSpec();\n spec.setEmail(\"fake-email\");\n spec.setDisplayName(displayName);\n var user = new User();\n user.setMetadata(metadata);\n user.setSpec(spec);\n return user;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/console/UserEndpointTest.java", "content": "package run.halo.app.core.endpoint.console;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anySet;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.mockUser;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.springSecurity;\n\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.DisplayName;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.client.MultipartBodyBuilder;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.BodyInserters;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.service.AttachmentService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.UserNotFoundException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@ExtendWith(MockitoExtension.class)\nclass UserEndpointTest {\n\n WebTestClient webClient;\n\n @Mock\n RoleService roleService;\n\n @Mock\n AttachmentService attachmentService;\n\n @Mock\n SystemConfigFetcher environmentFetcher;\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n UserService userService;\n\n @InjectMocks\n UserEndpoint endpoint;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .apply(springSecurity())\n .build()\n .mutateWith(mockUser(\"fake-user\").password(\"fake-password\").roles(\"fake-super-role\"));\n }\n\n @Nested\n class UserListTest {\n\n @Test\n void shouldListEmptyUsersWhenNoUsers() {\n when(roleService.getRolesByUsernames(any())).thenReturn(Mono.just(Map.of()));\n when(roleService.list(any())).thenReturn(Flux.empty());\n when(client.listBy(same(User.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(ListResult.emptyResult()));\n\n webClient.get().uri(\"/users\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(0)\n .jsonPath(\"$.total\").isEqualTo(0);\n }\n\n @Test\n void shouldListUsersWhenUserPresent() {\n var users = List.of(\n createUser(\"fake-user-1\"),\n createUser(\"fake-user-2\"),\n createUser(\"fake-user-3\")\n );\n var expectResult = new ListResult<>(users);\n when(roleService.getRolesByUsernames(any())).thenReturn(Mono.just(Map.of()));\n when(roleService.list(anySet())).thenReturn(Flux.empty());\n when(client.listBy(same(User.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n\n webClient.get().uri(\"/users\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.items.length()\").isEqualTo(3)\n .jsonPath(\"$.total\").isEqualTo(3);\n }\n\n @Test\n void shouldFilterUsersWhenRoleProvided() {\n var expectUser =\n JsonUtils.jsonToObject(\"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"User\",\n \"metadata\": {\n \"name\": \"alice\",\n \"annotations\": {\n \"rbac.authorization.halo.run/role-names\": \"[\\\\\"guest\\\\\"]\"\n }\n }\n }\n \"\"\", User.class);\n var users = List.of(\n expectUser\n );\n var expectResult = new ListResult<>(users);\n when(client.listBy(same(User.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n when(roleService.getRolesByUsernames(any())).thenReturn(Mono.just(Map.of()));\n when(roleService.list(anySet())).thenReturn(Flux.empty());\n\n webClient.get().uri(\"/users?role=guest\")\n .exchange()\n .expectStatus().isOk();\n }\n\n @Test\n void shouldSortUsersWhenCreationTimestampSet() {\n var expectUser =\n createUser(\"fake-user-2\", \"expected display name\");\n var expectResult = new ListResult<>(List.of(expectUser));\n when(client.listBy(same(User.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(expectResult));\n when(roleService.getRolesByUsernames(any())).thenReturn(Mono.just(Map.of()));\n when(roleService.list(anySet())).thenReturn(Flux.empty());\n\n webClient.get().uri(\"/users?sort=creationTimestamp,desc\")\n .exchange()\n .expectStatus().isOk();\n }\n\n User createUser(String name) {\n return createUser(name, \"fake display name\");\n }\n\n User createUser(String name, String displayName) {\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setCreationTimestamp(Instant.now());\n var spec = new User.UserSpec();\n spec.setDisplayName(displayName);\n var user = new User();\n user.setMetadata(metadata);\n user.setSpec(spec);\n return user;\n }\n\n }\n\n @Nested\n @DisplayName(\"GetUserDetail\")\n class GetUserDetailTest {\n\n @Test\n void shouldResponseErrorIfUserNotFound() {\n when(userService.getUser(\"fake-user\"))\n .thenReturn(Mono.error(new UserNotFoundException(\"fake-user\")));\n webClient.get().uri(\"/users/-\")\n .exchange()\n .expectStatus().isNotFound();\n\n verify(userService).getUser(eq(\"fake-user\"));\n }\n\n @Test\n void shouldGetCurrentUserDetail() {\n var metadata = new Metadata();\n metadata.setName(\"fake-user\");\n var user = new User();\n user.setMetadata(metadata);\n when(userService.getUser(\"fake-user\")).thenReturn(Mono.just(user));\n Role role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(\"fake-super-role\");\n role.setRules(List.of());\n when(roleService.list(Set.of(\"fake-super-role\"), true)).thenReturn(Flux.just(role));\n webClient.get().uri(\"/users/-\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody(UserEndpoint.DetailedUser.class)\n .isEqualTo(new UserEndpoint.DetailedUser(user, List.of(role)));\n }\n }\n\n @Nested\n @DisplayName(\"UpdateProfile\")\n class UpdateProfileTest {\n\n @Test\n void shouldUpdateProfileCorrectly() {\n var currentUser = createUser(\"fake-user\");\n var updatedUser = createUser(\"fake-user\");\n var requestUser = createUser(\"fake-user\");\n\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(currentUser));\n when(client.update(currentUser)).thenReturn(Mono.just(updatedUser));\n\n webClient.put().uri(\"/users/-\")\n .bodyValue(requestUser)\n .exchange()\n .expectStatus().isOk()\n .expectBody(User.class)\n .isEqualTo(updatedUser);\n\n verify(client).get(User.class, \"fake-user\");\n verify(client).update(currentUser);\n }\n\n @Test\n void shouldGetErrorIfUsernameMismatch() {\n var currentUser = createUser(\"fake-user\");\n var requestUser = createUser(\"another-fake-user\");\n\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(currentUser));\n\n webClient.put().uri(\"/users/-\")\n .bodyValue(requestUser)\n .exchange()\n .expectStatus().isBadRequest();\n\n verify(client).get(User.class, \"fake-user\");\n verify(client, never()).update(currentUser);\n }\n\n User createUser(String name) {\n var spec = new User.UserSpec();\n spec.setEmail(\"hi@halo.run\");\n spec.setBio(\"Fake bio\");\n spec.setDisplayName(\"Faker\");\n spec.setPassword(\"fake-password\");\n\n var metadata = new Metadata();\n metadata.setName(name);\n\n var user = new User();\n user.setSpec(spec);\n user.setMetadata(metadata);\n return user;\n }\n }\n\n @Nested\n @DisplayName(\"ChangePassword\")\n class ChangePasswordTest {\n\n @Test\n void shouldUpdateMyPasswordCorrectly() {\n var user = new User();\n when(userService.updateWithRawPassword(\"fake-user\", \"new-password\"))\n .thenReturn(Mono.just(user));\n when(userService.confirmPassword(\"fake-user\", \"old-password\"))\n .thenReturn(Mono.just(true));\n webClient.put().uri(\"/users/-/password\")\n .bodyValue(\n new UserEndpoint.ChangeOwnPasswordRequest(\"old-password\", \"new-password\"))\n .exchange()\n .expectStatus().isOk()\n .expectBody(User.class)\n .isEqualTo(user);\n\n verify(userService, times(1)).updateWithRawPassword(\"fake-user\", \"new-password\");\n }\n\n @Test\n void shouldUpdateOtherPasswordCorrectly() {\n var user = new User();\n when(userService.updateWithRawPassword(\"another-fake-user\", \"new-password\"))\n .thenReturn(Mono.just(user));\n webClient.put()\n .uri(\"/users/another-fake-user/password\")\n .bodyValue(\n new UserEndpoint.ChangeOwnPasswordRequest(\"old-password\", \"new-password\"))\n .exchange()\n .expectStatus().isOk()\n .expectBody(User.class)\n .isEqualTo(user);\n\n verify(userService, times(1)).updateWithRawPassword(\"another-fake-user\",\n \"new-password\");\n }\n\n }\n\n @Nested\n @DisplayName(\"GrantPermission\")\n class GrantPermissionEndpointTest {\n\n @Test\n void shouldGetBadRequestIfRequestBodyIsEmpty() {\n webClient.post().uri(\"/users/fake-user/permissions\")\n .contentType(MediaType.APPLICATION_JSON)\n .exchange()\n .expectStatus().isBadRequest();\n\n // Why one more time to verify? Because the SuperAdminInitializer will fetch admin user.\n verify(client, never()).fetch(same(User.class), eq(\"fake-user\"));\n verify(client, never()).fetch(same(Role.class), eq(\"fake-role\"));\n }\n\n @Test\n void shouldGrantPermission() {\n when(userService.grantRoles(\"fake-user\", Set.of(\"fake-role\"))).thenReturn(Mono.empty());\n\n webClient.post().uri(\"/users/fake-user/permissions\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(new UserEndpoint.GrantRequest(Set.of(\"fake-role\")))\n .exchange()\n .expectStatus().isOk();\n }\n\n @Test\n void shouldGetPermission() {\n Role roleA = JsonUtils.jsonToObject(\"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Role\",\n \"metadata\": {\n \"name\": \"test-A\",\n \"annotations\": {\n \"rbac.authorization.halo.run/ui-permissions\": \\\n \"[\\\\\"permission-A\\\\\", \\\\\"permission-A\\\\\"]\"\n }\n },\n \"rules\": []\n }\n \"\"\", Role.class);\n when(roleService.listPermissions(eq(Set.of(\"test-A\")))).thenReturn(Flux.just(roleA));\n when(roleService.getRolesByUsername(\"fake-user\")).thenReturn(Flux.just(\"test-A\"));\n when(roleService.list(Set.of(\"test-A\"), true)).thenReturn(Flux.just(roleA));\n\n webClient.get().uri(\"/users/fake-user/permissions\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(UserEndpoint.UserPermission.class)\n .value(userPermission -> {\n assertEquals(List.of(roleA), userPermission.getRoles());\n assertEquals(List.of(roleA), userPermission.getPermissions());\n assertEquals(List.of(\"permission-A\"), userPermission.getUiPermissions());\n });\n }\n }\n\n @Test\n void createWhenNameDuplicate() {\n when(userService.createUser(any(User.class), anySet()))\n .thenReturn(Mono.just(new User()));\n var userRequest = new UserEndpoint.CreateUserRequest(\"fake-user\",\n \"fake-email\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n Map.of(),\n Set.of());\n webClient.post().uri(\"/users\")\n .bodyValue(userRequest)\n .exchange()\n .expectStatus().isOk();\n }\n\n @Nested\n class AvatarUploadTest {\n @Test\n void respondWithErrorIfTypeNotPNG() {\n\n var multipartBodyBuilder = new MultipartBodyBuilder();\n multipartBodyBuilder.part(\"file\", \"fake-file\")\n .contentType(MediaType.IMAGE_JPEG)\n .filename(\"fake-filename.jpg\");\n\n when(environmentFetcher.fetch(\n SystemSetting.Attachment.GROUP, SystemSetting.Attachment.class\n )).thenReturn(Mono.fromSupplier(() -> SystemSetting.Attachment.builder()\n .avatar(null)\n .build())\n );\n when(environmentFetcher.fetch(\n SystemSetting.User.GROUP, SystemSetting.User.class)\n ).thenReturn(Mono.empty());\n\n webClient\n .post()\n .uri(\"/users/-/avatar\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(BodyInserters.fromMultipartData(multipartBodyBuilder.build()))\n .exchange()\n .expectStatus()\n .is4xxClientError();\n }\n\n @Test\n void shouldUploadSuccessfully() {\n var currentUser = createUser(\"fake-user\");\n\n Attachment attachment = new Attachment();\n Metadata metadata = new Metadata();\n metadata.setName(\"fake-attachment\");\n attachment.setMetadata(metadata);\n\n var multipartBodyBuilder = new MultipartBodyBuilder();\n multipartBodyBuilder.part(\"file\", \"fake-file\")\n .contentType(MediaType.IMAGE_PNG)\n .filename(\"fake-filename.png\");\n\n\n when(environmentFetcher.fetch(\n SystemSetting.Attachment.GROUP, SystemSetting.Attachment.class\n )).thenReturn(Mono.fromSupplier(() -> SystemSetting.Attachment.builder()\n .avatar(null)\n .build())\n );\n when(environmentFetcher.fetch(\n SystemSetting.User.GROUP, SystemSetting.User.class)\n ).thenReturn(Mono.empty());\n\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(currentUser));\n when(attachmentService.upload(eq(\"default-policy\"), anyString(), anyString(),\n any(), any(MediaType.IMAGE_PNG.getClass()))).thenReturn(Mono.just(attachment));\n\n when(client.update(currentUser)).thenReturn(Mono.just(currentUser));\n\n webClient.post()\n .uri(\"/users/-/avatar\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(BodyInserters.fromMultipartData(multipartBodyBuilder.build()))\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(User.class).isEqualTo(currentUser);\n\n verify(client).get(User.class, \"fake-user\");\n verify(client).update(currentUser);\n }\n\n @Test\n void shouldUseFallbackSetting() {\n var currentUser = createUser(\"fake-user\");\n\n Attachment attachment = new Attachment();\n Metadata metadata = new Metadata();\n metadata.setName(\"fake-attachment\");\n attachment.setMetadata(metadata);\n\n var multipartBodyBuilder = new MultipartBodyBuilder();\n multipartBodyBuilder.part(\"file\", \"fake-file\")\n .contentType(MediaType.IMAGE_PNG)\n .filename(\"fake-filename.png\");\n\n when(environmentFetcher.fetch(\n SystemSetting.Attachment.GROUP, SystemSetting.Attachment.class\n )).thenReturn(Mono.fromSupplier(() -> SystemSetting.Attachment.builder()\n .avatar(null)\n .build())\n );\n when(environmentFetcher.fetch(\n SystemSetting.User.GROUP, SystemSetting.User.class)\n ).thenReturn(Mono.fromSupplier(() -> {\n var us = new SystemSetting.User();\n us.setAvatarPolicy(\"fake-avatar-policy\");\n return us;\n }));\n\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(currentUser));\n when(attachmentService.upload(eq(\"fake-avatar-policy\"), anyString(), anyString(),\n any(), any(MediaType.IMAGE_PNG.getClass()))).thenReturn(Mono.just(attachment));\n\n when(client.update(currentUser)).thenReturn(Mono.just(currentUser));\n\n webClient.post()\n .uri(\"/users/-/avatar\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(BodyInserters.fromMultipartData(multipartBodyBuilder.build()))\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(User.class).isEqualTo(currentUser);\n\n verify(client).get(User.class, \"fake-user\");\n verify(client).update(currentUser);\n }\n\n User createUser(String name) {\n var spec = new User.UserSpec();\n spec.setEmail(\"hi@halo.run\");\n spec.setBio(\"Fake bio\");\n spec.setDisplayName(\"Faker\");\n spec.setAvatar(\"fake-avatar.png\");\n spec.setPassword(\"fake-password\");\n\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setAnnotations(new HashMap<>());\n\n var user = new User();\n user.setSpec(spec);\n user.setMetadata(metadata);\n return user;\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/CategoryQueryEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\n\n/**\n * Tests for {@link CategoryQueryEndpoint}.\n *\n * @author guqing\n * @since 2.5.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CategoryQueryEndpointTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private PostPublicQueryService postPublicQueryService;\n private CategoryQueryEndpoint endpoint;\n private WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n endpoint = new CategoryQueryEndpoint(client, postPublicQueryService);\n RouterFunction routerFunction = endpoint.endpoint();\n webTestClient = WebTestClient.bindToRouterFunction(routerFunction).build();\n }\n\n @Test\n void listCategories() {\n ListResult listResult = new ListResult<>(List.of());\n when(client.listBy(eq(Category.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(listResult));\n\n webTestClient.get()\n .uri(\"/categories?page=1&size=10\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.total\").isEqualTo(listResult.getTotal())\n .jsonPath(\"$.items\").isArray();\n }\n\n @Test\n void getByName() {\n Category category = new Category();\n category.setMetadata(new Metadata());\n category.getMetadata().setName(\"test\");\n when(client.get(eq(Category.class), eq(\"test\"))).thenReturn(Mono.just(category));\n\n webTestClient.get()\n .uri(\"/categories/test\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(category.getMetadata().getName());\n }\n\n @Test\n void listPostsByCategoryName() {\n ListResult listResult = new ListResult<>(List.of());\n when(postPublicQueryService.list(any(), any(PageRequest.class)))\n .thenReturn(Mono.just(listResult));\n\n webTestClient.get()\n .uri(\"/categories/test/posts?page=1&size=10\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.total\").isEqualTo(listResult.getTotal())\n .jsonPath(\"$.items\").isArray();\n }\n\n @Test\n void groupVersion() {\n GroupVersion groupVersion = endpoint.groupVersion();\n assertThat(groupVersion.toString()).isEqualTo(\"api.content.halo.run/v1alpha1\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/CommentFinderEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyInt;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport io.github.resilience4j.ratelimiter.RateLimiter;\nimport io.github.resilience4j.ratelimiter.RateLimiterConfig;\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport java.time.Duration;\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.comment.CommentRequest;\nimport run.halo.app.content.comment.CommentService;\nimport run.halo.app.content.comment.ReplyRequest;\nimport run.halo.app.content.comment.ReplyService;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.theme.finders.CommentFinder;\nimport run.halo.app.theme.finders.CommentPublicQueryService;\n\n/**\n * Tests for {@link CommentFinderEndpoint}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CommentFinderEndpointTest {\n @Mock\n private CommentFinder commentFinder;\n\n @Mock\n private CommentPublicQueryService commentPublicQueryService;\n\n @Mock\n private CommentService commentService;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @Mock\n private ReplyService replyService;\n\n @Mock\n private RateLimiterRegistry rateLimiterRegistry;\n\n @InjectMocks\n private CommentFinderEndpoint commentFinderEndpoint;\n\n private WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n lenient().when(environmentFetcher.fetchComment()).thenReturn(Mono.empty());\n webTestClient = WebTestClient\n .bindToRouterFunction(commentFinderEndpoint.endpoint())\n .build();\n }\n\n @Test\n void listComments() {\n when(commentPublicQueryService.list(any(), any(PageRequest.class)))\n .thenReturn(Mono.just(new ListResult<>(1, 10, 0, List.of())));\n\n Ref ref = new Ref();\n ref.setGroup(\"content.halo.run\");\n ref.setVersion(\"v1alpha1\");\n ref.setKind(\"Post\");\n ref.setName(\"test\");\n webTestClient.get()\n .uri(uriBuilder -> uriBuilder.path(\"/comments\")\n .queryParam(\"group\", ref.getGroup())\n .queryParam(\"version\", ref.getVersion())\n .queryParam(\"kind\", ref.getKind())\n .queryParam(\"name\", ref.getName())\n .queryParam(\"page\", 1)\n .queryParam(\"size\", 10)\n .build())\n .exchange()\n .expectStatus()\n .isOk();\n ArgumentCaptor refCaptor = ArgumentCaptor.forClass(Ref.class);\n verify(commentPublicQueryService, times(1))\n .list(refCaptor.capture(), any(PageRequest.class));\n Ref value = refCaptor.getValue();\n assertThat(value).isEqualTo(ref);\n }\n\n @Test\n void getComment() {\n when(commentPublicQueryService.getByName(any()))\n .thenReturn(null);\n\n webTestClient.get()\n .uri(\"/comments/test-comment\")\n .exchange()\n .expectStatus()\n .isOk();\n\n verify(commentPublicQueryService, times(1)).getByName(eq(\"test-comment\"));\n }\n\n @Test\n void listCommentReplies() {\n when(commentPublicQueryService.listReply(any(), anyInt(), anyInt()))\n .thenReturn(Mono.just(new ListResult<>(2, 20, 0, List.of())));\n\n webTestClient.get()\n .uri(uriBuilder -> uriBuilder.path(\"/comments/test-comment/reply\")\n .queryParam(\"page\", 2)\n .queryParam(\"size\", 20)\n .build())\n .exchange()\n .expectStatus()\n .isOk();\n\n verify(commentPublicQueryService, times(1)).listReply(eq(\"test-comment\"), eq(2), eq(20));\n }\n\n @Test\n void createComment() {\n when(commentService.create(any())).thenReturn(Mono.empty());\n\n RateLimiterConfig config = RateLimiterConfig.custom()\n .limitForPeriod(10)\n .limitRefreshPeriod(Duration.ofSeconds(1))\n .timeoutDuration(Duration.ofSeconds(10))\n .build();\n RateLimiter rateLimiter = RateLimiter.of(\"comment-creation-from-ip-\" + \"0:0:0:0:0:0:0:0\",\n config);\n when(rateLimiterRegistry.rateLimiter(anyString(), anyString())).thenReturn(rateLimiter);\n\n final CommentRequest commentRequest = new CommentRequest();\n Ref ref = new Ref();\n ref.setGroup(\"content.halo.run\");\n ref.setVersion(\"v1alpha1\");\n ref.setKind(\"Post\");\n ref.setName(\"test-post\");\n commentRequest.setSubjectRef(ref);\n commentRequest.setContent(\"content\");\n commentRequest.setRaw(\"raw\");\n commentRequest.setAllowNotification(false);\n webTestClient.post()\n .uri(\"/comments\")\n .bodyValue(commentRequest)\n .exchange()\n .expectStatus()\n .isOk();\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Comment.class);\n verify(commentService, times(1)).create(captor.capture());\n Comment value = captor.getValue();\n assertThat(value.getSpec().getIpAddress()).isNotNull();\n assertThat(value.getSpec().getUserAgent()).isNotNull();\n assertThat(value.getSpec().getSubjectRef()).isEqualTo(ref);\n }\n\n @Test\n void createReply() {\n when(replyService.create(any(), any())).thenReturn(Mono.empty());\n\n final ReplyRequest replyRequest = new ReplyRequest();\n replyRequest.setRaw(\"raw\");\n replyRequest.setContent(\"content\");\n replyRequest.setAllowNotification(true);\n\n when(rateLimiterRegistry.rateLimiter(\"comment-creation-from-ip-127.0.0.1\",\n \"comment-creation\"))\n .thenReturn(RateLimiter.ofDefaults(\"comment-creation\"));\n\n webTestClient.post()\n .uri(\"/comments/test-comment/reply\")\n .header(\"X-Forwarded-For\", \"127.0.0.1\")\n .bodyValue(replyRequest)\n .exchange()\n .expectStatus()\n .isOk();\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Reply.class);\n verify(replyService, times(1)).create(eq(\"test-comment\"), captor.capture());\n Reply value = captor.getValue();\n assertThat(value.getSpec().getIpAddress()).isNotNull();\n assertThat(value.getSpec().getUserAgent()).isNotNull();\n assertThat(value.getSpec().getQuoteReply()).isNull();\n\n verify(rateLimiterRegistry).rateLimiter(\"comment-creation-from-ip-127.0.0.1\",\n \"comment-creation\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/MenuQueryEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport lombok.NonNull;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.finders.MenuFinder;\nimport run.halo.app.theme.finders.vo.MenuItemVo;\nimport run.halo.app.theme.finders.vo.MenuVo;\n\n/**\n * Tests for {@link MenuQueryEndpoint}.\n *\n * @author guqing\n * @since 2.5.0\n */\n@ExtendWith(MockitoExtension.class)\nclass MenuQueryEndpointTest {\n\n @Mock\n private MenuFinder menuFinder;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @InjectMocks\n private MenuQueryEndpoint endpoint;\n\n private WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint()).build();\n }\n\n @Test\n void getPrimaryMenu() {\n Metadata metadata = new Metadata();\n metadata.setName(\"fake-primary\");\n MenuVo menuVo = MenuVo.builder()\n .metadata(metadata)\n .spec(new Menu.Spec())\n .menuItems(List.of(MenuItemVo.from(createMenuItem(\"item1\"))))\n .build();\n when(menuFinder.getByName(eq(\"fake-primary\")))\n .thenReturn(Mono.just(menuVo));\n\n SystemSetting.Menu menuSetting = new SystemSetting.Menu();\n menuSetting.setPrimary(\"fake-primary\");\n when(environmentFetcher.fetch(eq(SystemSetting.Menu.GROUP), eq(SystemSetting.Menu.class)))\n .thenReturn(Mono.just(menuSetting));\n\n webClient.get().uri(\"/menus/-\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(\"fake-primary\")\n .jsonPath(\"$.menuItems[0].metadata.name\").isEqualTo(\"item1\");\n\n verify(menuFinder).getByName(eq(\"fake-primary\"));\n verify(environmentFetcher).fetch(eq(SystemSetting.Menu.GROUP),\n eq(SystemSetting.Menu.class));\n }\n\n @NonNull\n private static MenuItem createMenuItem(String name) {\n MenuItem menuItem = new MenuItem();\n menuItem.setMetadata(new Metadata());\n menuItem.getMetadata().setName(name);\n menuItem.setSpec(new MenuItem.MenuItemSpec());\n menuItem.getSpec().setDisplayName(name);\n return menuItem;\n }\n\n @Test\n void getMenuByName() {\n Metadata metadata = new Metadata();\n metadata.setName(\"test-menu\");\n MenuVo menuVo = MenuVo.builder()\n .metadata(metadata)\n .spec(new Menu.Spec())\n .menuItems(List.of(MenuItemVo.from(createMenuItem(\"item2\"))))\n .build();\n when(menuFinder.getByName(eq(\"test-menu\")))\n .thenReturn(Mono.just(menuVo));\n\n webClient.get().uri(\"/menus/test-menu\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(\"test-menu\")\n .jsonPath(\"$.menuItems[0].metadata.name\").isEqualTo(\"item2\");\n\n verify(menuFinder).getByName(eq(\"test-menu\"));\n }\n\n @Test\n void groupVersion() {\n GroupVersion groupVersion = endpoint.groupVersion();\n assertThat(groupVersion.toString()).isEqualTo(\"api.halo.run/v1alpha1\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/PluginQueryEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.theme.finders.PluginFinder;\n\n/**\n * Tests for {@link PluginQueryEndpoint}.\n *\n * @author guqing\n * @since 2.5.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PluginQueryEndpointTest {\n\n @Mock\n private PluginFinder pluginFinder;\n\n @InjectMocks\n private PluginQueryEndpoint endpoint;\n\n private WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint()).build();\n }\n\n @Test\n void available() {\n when(pluginFinder.available(\"fake-plugin\")).thenReturn(true);\n webClient.get().uri(\"/plugins/fake-plugin/available\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$\").isEqualTo(true);\n }\n\n @Test\n void groupVersion() {\n GroupVersion groupVersion = endpoint.groupVersion();\n assertThat(groupVersion.toString()).isEqualTo(\"api.plugin.halo.run/v1alpha1\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/PostQueryEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.NavigationPostVo;\nimport run.halo.app.theme.finders.vo.PostVo;\n\n/**\n * Tests for {@link PostQueryEndpoint}.\n *\n * @author guqing\n * @since 2.5.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostQueryEndpointTest {\n\n private WebTestClient webClient;\n\n @Mock\n private PostFinder postFinder;\n\n @Mock\n private PostPublicQueryService postPublicQueryService;\n\n @InjectMocks\n private PostQueryEndpoint endpoint;\n\n @BeforeEach\n public void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .build();\n }\n\n @Test\n public void listPosts() {\n ListResult result = new ListResult<>(List.of());\n when(postPublicQueryService.list(any(), any(PageRequest.class)))\n .thenReturn(Mono.just(result));\n\n webClient.get().uri(\"/posts\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.items\").isArray();\n\n verify(postPublicQueryService).list(any(), any(PageRequest.class));\n }\n\n @Test\n public void getPostByName() {\n Metadata metadata = new Metadata();\n metadata.setName(\"test\");\n PostVo post = PostVo.builder()\n .metadata(metadata)\n .build();\n when(postFinder.getByName(anyString())).thenReturn(Mono.just(post));\n\n webClient.get().uri(\"/posts/{name}\", \"test\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(\"test\");\n\n verify(postFinder).getByName(anyString());\n }\n\n @Test\n public void testGetPostNavigationByName() {\n Metadata metadata = new Metadata();\n metadata.setName(\"test\");\n NavigationPostVo navigation = NavigationPostVo.builder()\n .next(ListedPostVo.builder().metadata(metadata).build())\n .build();\n when(postFinder.cursor(anyString()))\n .thenReturn(Mono.just(navigation));\n\n webClient.get().uri(\"/posts/{name}/navigation\", \"test\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.next.metadata.name\").isEqualTo(\"test\");\n\n verify(postFinder).cursor(anyString());\n }\n\n @Test\n void groupVersion() {\n GroupVersion groupVersion = endpoint.groupVersion();\n assertThat(groupVersion.toString()).isEqualTo(\"api.content.halo.run/v1alpha1\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/PublicApiUtilsTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.GroupVersion;\n\n/**\n * Tests for {@link PublicApiUtils}.\n *\n * @author guqing\n * @since 2.5.0\n */\nclass PublicApiUtilsTest {\n\n @Test\n void groupVersion() {\n GroupVersion groupVersion = PublicApiUtils.groupVersion(new FakExtension());\n assertThat(groupVersion.toString()).isEqualTo(\"api.halo.run/v1alpha1\");\n\n groupVersion = PublicApiUtils.groupVersion(new FakeGroupExtension());\n assertThat(groupVersion.toString()).isEqualTo(\"api.fake.halo.run/v1\");\n }\n\n @Test\n void containsElement() {\n assertThat(PublicApiUtils.containsElement(null, null)).isFalse();\n assertThat(PublicApiUtils.containsElement(null, \"test\")).isFalse();\n assertThat(PublicApiUtils.containsElement(List.of(\"test\"), null)).isFalse();\n assertThat(PublicApiUtils.containsElement(List.of(\"test\"), \"test\")).isTrue();\n assertThat(PublicApiUtils.containsElement(List.of(\"test\"), \"test1\")).isFalse();\n }\n\n @GVK(group = \"fake.halo.run\", version = \"v1\", kind = \"FakeGroupExtension\", plural =\n \"fakegroupextensions\", singular = \"fakegroupextension\")\n static class FakeGroupExtension extends AbstractExtension {\n\n }\n\n @GVK(group = \"\", version = \"v1alpha1\", kind = \"FakeExtension\", plural =\n \"fakeextensions\", singular = \"fakeextension\")\n static class FakExtension extends AbstractExtension {\n\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/SinglePageQueryEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.GroupVersion;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * Tests for {@link SinglePageQueryEndpoint}.\n *\n * @author guqing\n * @since 2.5.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageQueryEndpointTest {\n\n @Mock\n private SinglePageFinder singlePageFinder;\n\n @InjectMocks\n private SinglePageQueryEndpoint endpoint;\n\n private WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n webTestClient = WebTestClient.bindToRouterFunction(endpoint.endpoint()).build();\n }\n\n @Test\n void getByName() {\n SinglePageVo singlePage = SinglePageVo.builder()\n .metadata(metadata(\"fake-page\"))\n .spec(new SinglePage.SinglePageSpec())\n .build();\n\n when(singlePageFinder.getByName(eq(\"fake-page\")))\n .thenReturn(Mono.just(singlePage));\n\n webTestClient.get()\n .uri(\"/singlepages/fake-page\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().contentType(MediaType.APPLICATION_JSON)\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(\"fake-page\");\n\n verify(singlePageFinder).getByName(\"fake-page\");\n }\n\n Metadata metadata(String name) {\n Metadata metadata = new Metadata();\n metadata.setName(name);\n return metadata;\n }\n\n @Test\n void groupVersion() {\n GroupVersion groupVersion = endpoint.groupVersion();\n assertThat(groupVersion.toString()).isEqualTo(\"api.content.halo.run/v1alpha1\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/theme/ThumbnailEndpointTest.java", "content": "package run.halo.app.core.endpoint.theme;\n\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.ThumbnailSize;\nimport run.halo.app.core.attachment.thumbnail.ThumbnailService;\n\n/**\n * Tests for {@link ThumbnailEndpoint}.\n *\n * @author guqing\n * @since 2.19.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ThumbnailEndpointTest {\n\n WebTestClient webClient;\n\n @Mock\n private ThumbnailService thumbnailService;\n\n @InjectMocks\n private ThumbnailEndpoint endpoint;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .build();\n }\n\n @Test\n void thumbnailUriNotAccessible() {\n when(thumbnailService.get(URI.create(\"/myavatar.png\"), ThumbnailSize.L))\n .thenReturn(Mono.empty());\n webClient.get()\n .uri(\"/thumbnails/-/via-uri?size=l&uri=/myavatar.png\")\n .exchange()\n .expectHeader().location(\"/myavatar.png\")\n .expectStatus().is3xxRedirection();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/uc/AnnotationSettingEndpointTest.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.plugin.PluginService;\nimport run.halo.app.theme.service.ThemeService;\n\n@ExtendWith(MockitoExtension.class)\nclass AnnotationSettingEndpointTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n PluginService pluginService;\n\n @Mock\n ThemeService themeService;\n\n @InjectMocks\n AnnotationSettingEndpoint endpoint;\n\n WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n webTestClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .build();\n }\n\n @Test\n void shouldFetchAnnotationSettings() {\n when(themeService.fetchActivatedThemeName()).thenReturn(Mono.just(\"fake-theme\"));\n when(pluginService.getStartedPluginNames()).thenReturn(Flux.just(\"plugin-1\", \"plugin-2\"));\n\n var annotationSetting = new AnnotationSetting();\n annotationSetting.setMetadata(new Metadata());\n annotationSetting.getMetadata().setName(\"fake-annotation\");\n when(\n client.listAll(same(AnnotationSetting.class), any(ListOptions.class), any(Sort.class))\n ).thenReturn(Flux.just(annotationSetting));\n\n webTestClient.get()\n .uri(\"/annotationsettings?targetRef={targetRef}\", \"content.halo.run/Post\")\n .exchange()\n .expectStatus().isOk()\n .expectBodyList(AnnotationSetting.class)\n .isEqualTo(List.of(annotationSetting));\n\n verify(client).listAll(\n same(AnnotationSetting.class),\n assertArg(listOptions -> {\n var condition = listOptions.toCondition();\n assertEquals(\"\"\"\n (\\\n (metadata.labels['theme.halo.run/theme-name'] = 'fake-theme' \\\n OR metadata.labels['plugin.halo.run/plugin-name'] IN ('plugin-1', 'plugin-2')\\\n ) \\\n AND spec.targetRef = content.halo.run/Post\\\n )\"\"\", condition.toString());\n }),\n any(Sort.class));\n }\n\n @Test\n void shouldFetchAnnotationSettingsWithoutActivatedTheme() {\n when(themeService.fetchActivatedThemeName()).thenReturn(Mono.empty());\n when(pluginService.getStartedPluginNames()).thenReturn(Flux.just(\"plugin-1\", \"plugin-2\"));\n\n var annotationSetting = new AnnotationSetting();\n annotationSetting.setMetadata(new Metadata());\n annotationSetting.getMetadata().setName(\"fake-annotation\");\n when(\n client.listAll(same(AnnotationSetting.class), any(ListOptions.class), any(Sort.class))\n ).thenReturn(Flux.just(annotationSetting));\n\n webTestClient.get()\n .uri(\"/annotationsettings?targetRef={targetRef}\", \"content.halo.run/Post\")\n .exchange()\n .expectStatus().isOk()\n .expectBodyList(AnnotationSetting.class)\n .isEqualTo(List.of(annotationSetting));\n\n verify(client).listAll(\n same(AnnotationSetting.class),\n assertArg(listOptions -> {\n var condition = listOptions.toCondition();\n assertEquals(\"\"\"\n (\\\n metadata.labels['plugin.halo.run/plugin-name'] IN ('plugin-1', 'plugin-2') \\\n AND spec.targetRef = content.halo.run/Post\\\n )\"\"\", condition.toString());\n }),\n any(Sort.class));\n }\n\n @Test\n void shouldFetchAnnotationSettingsWithoutStartedPlugins() {\n when(themeService.fetchActivatedThemeName()).thenReturn(Mono.just(\"fake-theme\"));\n when(pluginService.getStartedPluginNames()).thenReturn(Flux.empty());\n\n var annotationSetting = new AnnotationSetting();\n annotationSetting.setMetadata(new Metadata());\n annotationSetting.getMetadata().setName(\"fake-annotation\");\n when(\n client.listAll(same(AnnotationSetting.class), any(ListOptions.class), any(Sort.class))\n ).thenReturn(Flux.just(annotationSetting));\n\n webTestClient.get()\n .uri(\"/annotationsettings?targetRef={targetRef}\", \"content.halo.run/Post\")\n .exchange()\n .expectStatus().isOk()\n .expectBodyList(AnnotationSetting.class)\n .isEqualTo(List.of(annotationSetting));\n\n verify(client).listAll(\n same(AnnotationSetting.class),\n assertArg(listOptions -> {\n var condition = listOptions.toCondition();\n assertEquals(\"\"\"\n (\\\n metadata.labels['theme.halo.run/theme-name'] = 'fake-theme' \\\n AND spec.targetRef = content.halo.run/Post\\\n )\"\"\", condition.toString());\n }),\n any(Sort.class));\n }\n\n @Test\n void shouldFetchAnnotationSettingsWithoutActivatedThemeAndStartedPlugins() {\n when(themeService.fetchActivatedThemeName()).thenReturn(Mono.empty());\n when(pluginService.getStartedPluginNames()).thenReturn(Flux.empty());\n\n var annotationSetting = new AnnotationSetting();\n annotationSetting.setMetadata(new Metadata());\n annotationSetting.getMetadata().setName(\"fake-annotation\");\n when(\n client.listAll(same(AnnotationSetting.class), any(ListOptions.class), any(Sort.class))\n ).thenReturn(Flux.just(annotationSetting));\n\n webTestClient.get()\n .uri(\"/annotationsettings?targetRef={targetRef}\", \"content.halo.run/Post\")\n .exchange()\n .expectStatus().isOk()\n .expectBodyList(AnnotationSetting.class)\n .isEqualTo(List.of(annotationSetting));\n\n verify(client).listAll(\n same(AnnotationSetting.class),\n assertArg(listOptions -> {\n var condition = listOptions.toCondition();\n assertEquals(\"\"\"\n (\\\n EMPTY AND spec.targetRef = content.halo.run/Post\\\n )\"\"\", condition.toString());\n }),\n any(Sort.class));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/endpoint/uc/UcUserPreferenceEndpointTest.java", "content": "package run.halo.app.core.endpoint.uc;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.core.authority.AuthorityUtils.createAuthorityList;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.mockAuthentication;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.mockUser;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.springSecurity;\n\nimport java.util.HashMap;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.authentication.AnonymousAuthenticationToken;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport tools.jackson.databind.JsonNode;\nimport tools.jackson.databind.json.JsonMapper;\nimport tools.jackson.databind.node.NullNode;\nimport tools.jackson.databind.node.ObjectNode;\n\n@ExtendWith(MockitoExtension.class)\nclass UcUserPreferenceEndpointTest {\n\n WebTestClient webClient;\n\n @InjectMocks\n UcUserPreferenceEndpoint endpoint;\n\n @Mock\n ReactiveExtensionClient client;\n\n @Spy\n JsonMapper mapper = JsonMapper.shared();\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .apply(springSecurity())\n .build();\n }\n\n @Test\n void testGroupVersion() {\n var gv = endpoint.groupVersion();\n assertEquals(\"uc.api.halo.run\", gv.group());\n assertEquals(\"v1alpha1\", gv.version());\n }\n\n @Test\n void shouldNotGetPreferenceWhenUnauthenticated() {\n webClient.mutate()\n .apply(mockAuthentication(new AnonymousAuthenticationToken(\n \"key\", \"anonymousUser\", createAuthorityList(\"ROLE_ANONYMOUS\")\n )))\n .build()\n .get()\n .uri(\"/user-preferences/fake\")\n .exchange()\n .expectStatus()\n .isForbidden();\n }\n\n @Test\n void shouldGetNullPreferenceWhenAuthenticatedAndConfigMapAbsent() {\n when(client.fetch(ConfigMap.class, \"user-preferences-faker\")).thenReturn(Mono.empty());\n webClient.mutate()\n .apply(mockUser(\"faker\"))\n .build()\n .get()\n .uri(\"/user-preferences/fake\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(JsonNode.class)\n .value(n -> {\n assertInstanceOf(NullNode.class, n);\n });\n }\n\n @Test\n void shouldGetPreferenceWhenAuthenticatedAndConfigMapPresent() {\n var cm = new ConfigMap();\n cm.setData(new HashMap<>());\n cm.getData().put(\"fake\", \"\"\"\n {\n \"key\": \"value\"\n }\\\n \"\"\");\n when(client.fetch(ConfigMap.class, \"user-preferences-faker\"))\n .thenReturn(Mono.just(cm));\n webClient.mutate()\n .apply(mockUser(\"faker\"))\n .build()\n .get()\n .uri(\"/user-preferences/fake\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody(ObjectNode.class)\n .value(node -> assertEquals(\"value\", node.get(\"key\").asString()));\n }\n\n @Test\n void shouldNotCreatePreferenceWhenUnauthenticated() {\n webClient.mutate()\n .apply(mockAuthentication(new AnonymousAuthenticationToken(\n \"key\", \"anonymousUser\", createAuthorityList(\"ROLE_ANONYMOUS\")\n )))\n .build()\n .put()\n .uri(\"/user-preferences/faker\")\n .exchange()\n .expectStatus()\n .isForbidden();\n }\n\n @Test\n void shouldCreatePreferenceWithoutConfigMap() {\n when(client.fetch(ConfigMap.class, \"user-preferences-faker\")).thenReturn(Mono.empty());\n when(client.create(any(ConfigMap.class))).thenReturn(Mono.just(new ConfigMap()));\n webClient.mutate()\n .apply(mockUser(\"faker\"))\n .build()\n .put()\n .uri(\"/user-preferences/fake\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(\"\"\"\n {\n \"key\": \"value\"\n }\\\n \"\"\")\n .exchange()\n .expectStatus()\n .isNoContent();\n\n verify(client).create(assertArg(cm -> JSONAssert.assertEquals(\n \"\"\"\n {\"key\":\"value\"}\\\n \"\"\",\n cm.getData().get(\"fake\"),\n true\n )));\n verify(client, never()).update(any());\n }\n\n @Test\n void shouldUpdatePreferenceWhenConfigMapExists() {\n var cm = new ConfigMap();\n cm.setMetadata(new Metadata());\n cm.getMetadata().setName(\"user-preferences-faker\");\n cm.getMetadata().setVersion(1L);\n cm.setData(new HashMap<>());\n cm.getData().put(\"fake1\", \"\"\"\n {\n \"key1\": \"value1\"\n }\\\n \"\"\");\n cm.getData().put(\"fake2\", \"\"\"\n {\n \"key2\": \"value2\"\n }\n \"\"\");\n when(client.fetch(ConfigMap.class, \"user-preferences-faker\")).thenReturn(Mono.just(cm));\n when(client.update(any(ConfigMap.class))).thenReturn(Mono.just(cm));\n webClient.mutate()\n .apply(mockUser(\"faker\"))\n .build()\n .put()\n .uri(\"/user-preferences/fake1\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(\"\"\"\n {\n \"newKey\": \"newValue\"\n }\\\n \"\"\")\n .exchange()\n .expectStatus()\n .isNoContent();\n\n verify(client).update(assertArg(cmToUpdate -> {\n JSONAssert.assertEquals(\n \"\"\"\n {\"newKey\":\"newValue\"}\\\n \"\"\",\n cmToUpdate.getData().get(\"fake1\"),\n true\n );\n JSONAssert.assertEquals(\n \"\"\"\n {\"key2\":\"value2\"}\\\n \"\"\",\n cmToUpdate.getData().get(\"fake2\"),\n true\n );\n }));\n\n verify(client, never()).create(any());\n }\n\n @Test\n void shouldNotUpdatePreferenceWhenNotChange() {\n var cm = new ConfigMap();\n cm.setMetadata(new Metadata());\n cm.getMetadata().setName(\"user-preferences-faker\");\n cm.getMetadata().setVersion(1L);\n cm.setData(new HashMap<>());\n cm.getData().put(\"fake\", \"\"\"\n {\"key\":\"value\"}\\\n \"\"\");\n when(client.fetch(ConfigMap.class, \"user-preferences-faker\")).thenReturn(Mono.just(cm));\n webClient.mutate()\n .apply(mockUser(\"faker\"))\n .build()\n .put()\n .uri(\"/user-preferences/fake\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(\"\"\"\n {\"key\":\"value\"}\\\n \"\"\")\n .exchange()\n .expectStatus()\n .isNoContent();\n\n verify(client, never()).update(any(ConfigMap.class));\n verify(client, never()).create(any(ConfigMap.class));\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/extension/PostTest.java", "content": "package run.halo.app.core.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport java.util.function.Function;\nimport org.junit.jupiter.api.Test;\nimport org.mockito.Mockito;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.MetadataOperator;\n\nclass PostTest {\n\n @Test\n void staticIsPublishedTest() {\n var test = (Function, Boolean>) (labels) -> {\n var metadata = Mockito.mock(MetadataOperator.class);\n when(metadata.getLabels()).thenReturn(labels);\n return Post.isPublished(metadata);\n };\n assertEquals(false, test.apply(Map.of()));\n assertEquals(false, test.apply(Map.of(\"content.halo.run/published\", \"false\")));\n assertEquals(false, test.apply(Map.of(\"content.halo.run/published\", \"False\")));\n assertEquals(false, test.apply(Map.of(\"content.halo.run/published\", \"0\")));\n assertEquals(false, test.apply(Map.of(\"content.halo.run/published\", \"1\")));\n assertEquals(false, test.apply(Map.of(\"content.halo.run/published\", \"T\")));\n assertEquals(false, test.apply(Map.of(\"content.halo.run/published\", \"\")));\n assertEquals(true, test.apply(Map.of(\"content.halo.run/published\", \"true\")));\n assertEquals(true, test.apply(Map.of(\"content.halo.run/published\", \"True\")));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/extension/RoleBindingTest.java", "content": "package run.halo.app.core.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.time.Instant;\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.Metadata;\n\nclass RoleBindingTest {\n\n @Test\n void shouldContainUser() {\n var subject = new RoleBinding.Subject();\n subject.setName(\"fake-name\");\n subject.setApiGroup(\"\");\n subject.setKind(\"User\");\n\n var binding = new RoleBinding();\n binding.setMetadata(new Metadata());\n binding.setSubjects(List.of(subject));\n assertTrue(RoleBinding.containsUser(\"fake-name\").test(binding));\n assertFalse(RoleBinding.containsUser(\"non-exist-fake-name\").test(binding));\n }\n\n @Test\n void shouldNotContainUserWhenBindingIsDeleted() {\n var subject = new RoleBinding.Subject();\n subject.setName(\"fake-name\");\n subject.setApiGroup(\"\");\n subject.setKind(\"User\");\n\n var binding = new RoleBinding();\n var metadata = new Metadata();\n metadata.setDeletionTimestamp(Instant.now());\n binding.setMetadata(metadata);\n binding.setSubjects(List.of(subject));\n assertFalse(RoleBinding.containsUser(\"fake-name\").test(binding));\n assertFalse(RoleBinding.containsUser(\"non-exist-fake-name\").test(binding));\n }\n\n @Test\n void subjectToStringTest() {\n assertEquals(\"User/fake-name\", createSubject(\"fake-name\", \"\", \"User\").toString());\n assertEquals(\n \"fake.group/User/fake-name\",\n createSubject(\"fake-name\", \"fake.group\", \"User\").toString()\n );\n }\n\n RoleBinding.Subject createSubject(String name, String apiGroup, String kind) {\n var subject = new RoleBinding.Subject();\n subject.setName(name);\n subject.setApiGroup(apiGroup);\n subject.setKind(kind);\n return subject;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/extension/SettingTest.java", "content": "package run.halo.app.core.extension;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.security.util.InMemoryResource;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\n/**\n * Tests for {@link Setting}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass SettingTest {\n\n @Test\n void setting() throws JSONException {\n String settingYaml = \"\"\"\n apiVersion: v1alpha1\n kind: Setting\n metadata:\n name: setting-name\n spec:\n forms:\n - group: basic\n label: 基本设置\n formSchema:\n - $el: h1\n children: Register\n - $formkit: text\n help: This will be used for your account.\n label: Email\n name: email\n validation: required|email\n - group: sns\n label: 社交资料\n formSchema:\n - $formkit: text\n help: This will be used for your theme.\n label: color\n name: color\n validation: required\n \"\"\";\n var unstructureds = new YamlUnstructuredLoader(\n new InMemoryResource(settingYaml.getBytes(UTF_8), \"In-memory setting YAML\"))\n .load();\n assertThat(unstructureds).hasSize(1);\n Unstructured unstructured = unstructureds.get(0);\n\n Setting setting = Unstructured.OBJECT_MAPPER.convertValue(unstructured, Setting.class);\n assertThat(setting).isNotNull();\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"forms\": [\n {\n \"group\": \"basic\",\n \"label\": \"基本设置\",\n \"formSchema\": [\n {\n \"$el\": \"h1\",\n \"children\": \"Register\"\n },\n {\n \"$formkit\": \"text\",\n \"help\": \"This will be used for your account.\",\n \"label\": \"Email\",\n \"name\": \"email\",\n \"validation\": \"required|email\"\n }\n ]\n },\n {\n \"group\": \"sns\",\n \"label\": \"社交资料\",\n \"formSchema\": [\n {\n \"$formkit\": \"text\",\n \"help\": \"This will be used for your theme.\",\n \"label\": \"color\",\n \"name\": \"color\",\n \"validation\": \"required\"\n }\n ]\n }\n ]\n },\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Setting\",\n \"metadata\": {\n \"name\": \"setting-name\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(setting), false);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/extension/TestRole.java", "content": "package run.halo.app.core.extension;\n\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Roles to test.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class TestRole {\n\n public static Role getRoleManage() {\n return JsonUtils.jsonToObject(\"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Role\",\n \"metadata\": {\n \"name\": \"role-template-apple-manage\"\n },\n \"rules\": [{\n \"resources\": [\"apples\"],\n \"verbs\": [\"create\"]\n }]\n }\n \"\"\", Role.class);\n }\n\n public static Role getRoleView() {\n return JsonUtils.jsonToObject(\"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Role\",\n \"metadata\": {\n \"name\": \"role-template-apple-view\"\n },\n \"rules\": [{\n \"resources\": [\"apples\"],\n \"verbs\": [\"list\"]\n }]\n }\n \"\"\", Role.class);\n }\n\n public static Role getRoleOther() {\n return JsonUtils.jsonToObject(\"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Role\",\n \"metadata\": {\n \"name\": \"role-template-apple-other\"\n },\n \"rules\": [{\n \"resources\": [\"apples\"],\n \"verbs\": [\"update\"]\n }]\n }\n \"\"\", Role.class);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/extension/ThemeTest.java", "content": "package run.halo.app.core.extension;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.List;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.security.util.InMemoryResource;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\n/**\n * Tests for {@link Theme}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass ThemeTest {\n\n @Test\n void constructor() throws JSONException {\n Theme theme = new Theme();\n Metadata metadata = new Metadata();\n metadata.setName(\"test-theme\");\n theme.setMetadata(metadata);\n\n\n Theme.ThemeSpec themeSpec = new Theme.ThemeSpec();\n theme.setSpec(themeSpec);\n themeSpec.setDisplayName(\"test-theme\");\n\n Theme.Author author = new Theme.Author();\n author.setName(\"test-author\");\n author.setWebsite(\"https://test.com\");\n themeSpec.setAuthor(author);\n\n themeSpec.setRepo(\"https://test.com\");\n themeSpec.setLogo(\"https://test.com\");\n themeSpec.setHomepage(\"https://test.com\");\n themeSpec.setDescription(\"test-description\");\n themeSpec.setConfigMapName(\"test-config-map\");\n themeSpec.setSettingName(\"test-setting\");\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"displayName\": \"test-theme\",\n \"author\": {\n \"name\": \"test-author\",\n \"website\": \"https://test.com\"\n },\n \"description\": \"test-description\",\n \"logo\": \"https://test.com\",\n \"homepage\": \"https://test.com\",\n \"repo\": \"https://test.com\",\n \"version\": \"*\",\n \"requires\": \"*\",\n \"settingName\": \"test-setting\",\n \"configMapName\": \"test-config-map\"\n },\n \"apiVersion\": \"theme.halo.run/v1alpha1\",\n \"kind\": \"Theme\",\n \"metadata\": {\n \"name\": \"test-theme\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(theme),\n true);\n\n themeSpec.setVersion(\"1.0.0\");\n themeSpec.setRequires(\"2.0.0\");\n assertThat(themeSpec.getVersion()).isEqualTo(\"1.0.0\");\n assertThat(themeSpec.getRequires()).isEqualTo(\"2.0.0\");\n }\n\n @Test\n void themeCustomTemplate() throws JSONException {\n String themeYaml = \"\"\"\n apiVersion: theme.halo.run/v1alpha1\n kind: Theme\n metadata:\n name: guqing-higan\n spec:\n displayName: higan\n customTemplates:\n post:\n - name: post-template-1\n description: description for post-template-1\n screenshot: foo.png\n file: post_template_1.html\n - name: post-template-2\n description: description for post-template-2\n screenshot: bar.png\n file: post_template_2.html\n category:\n - name: category-template-1\n description: description for category-template-1\n screenshot: foo.png\n file: category_template_1.html\n page:\n - name: page-template-1\n description: description for page-template-1\n screenshot: foo.png\n file: page_template_1.html\n \"\"\";\n List unstructuredList =\n new YamlUnstructuredLoader(new InMemoryResource(themeYaml)).load();\n assertThat(unstructuredList).hasSize(1);\n Theme theme = Unstructured.OBJECT_MAPPER.convertValue(unstructuredList.get(0), Theme.class);\n assertThat(theme).isNotNull();\n JSONAssert.assertEquals(\"\"\"\n {\n \"post\": [\n {\n \"name\": \"post-template-1\",\n \"description\": \"description for post-template-1\",\n \"screenshot\": \"foo.png\",\n \"file\": \"post_template_1.html\"\n },\n {\n \"name\": \"post-template-2\",\n \"description\": \"description for post-template-2\",\n \"screenshot\": \"bar.png\",\n \"file\": \"post_template_2.html\"\n }\n ],\n \"category\": [\n {\n \"name\": \"category-template-1\",\n \"description\": \"description for category-template-1\",\n \"screenshot\": \"foo.png\",\n \"file\": \"category_template_1.html\"\n }],\n \"page\": [\n {\n \"name\": \"page-template-1\",\n \"description\": \"description for page-template-1\",\n \"screenshot\": \"foo.png\",\n \"file\": \"page_template_1.html\"\n }]\n }\n \"\"\",\n JsonUtils.objectToJson(theme.getSpec().getCustomTemplates()),\n true);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/extension/attachment/endpoint/AttachmentEndpointTest.java", "content": "package run.halo.app.core.extension.attachment.endpoint;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.mockUser;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.springSecurity;\n\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.HttpStatusCode;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.ResponseEntity;\nimport org.springframework.http.client.MultipartBodyBuilder;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.BodyInserters;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.attachment.AttachmentLister;\nimport run.halo.app.core.attachment.endpoint.AttachmentEndpoint;\nimport run.halo.app.core.extension.attachment.Attachment;\nimport run.halo.app.core.extension.attachment.Group;\nimport run.halo.app.core.extension.attachment.Policy;\nimport run.halo.app.core.extension.attachment.Policy.PolicySpec;\nimport run.halo.app.core.user.service.impl.DefaultAttachmentService;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ReactiveUrlDataBufferFetcher;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@ExtendWith(MockitoExtension.class)\nclass AttachmentEndpointTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @Mock\n ReactiveUrlDataBufferFetcher dataBufferFetcher;\n\n @Mock\n AttachmentLister attachmentLister;\n\n AttachmentEndpoint endpoint;\n\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n var attachmentService =\n new DefaultAttachmentService(client, extensionGetter, dataBufferFetcher);\n endpoint = new AttachmentEndpoint(attachmentService, attachmentLister);\n webClient = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .apply(springSecurity())\n .build();\n }\n\n @Nested\n class UploadTest {\n\n @Test\n void shouldResponseErrorIfNotLogin() {\n var policySpec = new PolicySpec();\n policySpec.setConfigMapName(\"fake-configmap\");\n var policyMetadata = new Metadata();\n policyMetadata.setName(\"fake-policy\");\n var policy = new Policy();\n policy.setSpec(policySpec);\n policy.setMetadata(policyMetadata);\n\n var cm = new ConfigMap();\n var cmMetadata = new Metadata();\n cmMetadata.setName(\"fake-configmap\");\n cm.setData(Map.of());\n\n var handler = mock(AttachmentHandler.class);\n var metadata = new Metadata();\n metadata.setName(\"fake-attachment\");\n var attachment = new Attachment();\n attachment.setMetadata(metadata);\n\n var builder = new MultipartBodyBuilder();\n builder.part(\"policyName\", \"fake-policy\");\n builder.part(\"groupName\", \"fake-group\");\n builder.part(\"file\", \"fake-file\")\n .contentType(MediaType.TEXT_PLAIN)\n .filename(\"fake-filename\");\n webClient\n .post()\n .uri(\"/attachments/upload\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(BodyInserters.fromMultipartData(builder.build()))\n .exchange()\n .expectStatus().isUnauthorized();\n\n verify(client, never()).get(Policy.class, \"fake-policy\");\n verify(client, never()).get(ConfigMap.class, \"fake-configmap\");\n verify(client, never()).create(attachment);\n verify(extensionGetter, never()).getExtensions(AttachmentHandler.class);\n verify(handler, never()).upload(any());\n }\n\n @Test\n void shouldResponseErrorIfNoBodyProvided() {\n webClient\n .mutateWith(mockUser(\"fake-user\").password(\"fake-password\"))\n .post()\n .uri(\"/attachments/upload\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .exchange()\n .expectStatus().is5xxServerError();\n }\n\n @Test\n void shouldResponseErrorIfPolicyNameIsMissing() {\n var builder = new MultipartBodyBuilder();\n builder.part(\"file\", \"fake-file\")\n .contentType(MediaType.TEXT_PLAIN)\n .filename(\"fake-filename\");\n webClient\n .mutateWith(mockUser(\"fake-user\").password(\"fake-password\"))\n .post()\n .uri(\"/attachments/upload\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(BodyInserters.fromMultipartData(builder.build()))\n .exchange()\n .expectStatus().isBadRequest();\n }\n\n @Test\n void shouldUploadSuccessfully() {\n var policySpec = new PolicySpec();\n policySpec.setConfigMapName(\"fake-configmap\");\n var policyMetadata = new Metadata();\n policyMetadata.setName(\"fake-policy\");\n var policy = new Policy();\n policy.setSpec(policySpec);\n policy.setMetadata(policyMetadata);\n\n var cm = new ConfigMap();\n var cmMetadata = new Metadata();\n cmMetadata.setName(\"fake-configmap\");\n cm.setData(Map.of());\n\n var group = new Group();\n group.setMetadata(new Metadata());\n group.getMetadata().setName(\"fake-group\");\n\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.just(policy));\n when(client.get(ConfigMap.class, \"fake-configmap\")).thenReturn(Mono.just(cm));\n when(client.get(Group.class, \"fake-group\")).thenReturn(Mono.just(group));\n\n var handler = mock(AttachmentHandler.class);\n var metadata = new Metadata();\n metadata.setName(\"fake-attachment\");\n var attachment = new Attachment();\n attachment.setMetadata(metadata);\n\n when(handler.upload(any())).thenReturn(Mono.just(attachment));\n when(extensionGetter.getExtensions(AttachmentHandler.class))\n .thenReturn(Flux.just(handler));\n when(client.create(attachment)).thenReturn(Mono.just(attachment));\n\n var builder = new MultipartBodyBuilder();\n builder.part(\"policyName\", \"fake-policy\");\n builder.part(\"groupName\", \"fake-group\");\n builder.part(\"file\", \"fake-file\")\n .contentType(MediaType.TEXT_PLAIN)\n .filename(\"fake-filename\");\n webClient\n .mutateWith(mockUser(\"fake-user\").password(\"fake-password\"))\n .post()\n .uri(\"/attachments/upload\")\n .contentType(MediaType.MULTIPART_FORM_DATA)\n .body(BodyInserters.fromMultipartData(builder.build()))\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(\"fake-attachment\")\n .jsonPath(\"$.spec.ownerName\").isEqualTo(\"fake-user\")\n .jsonPath(\"$.spec.policyName\").isEqualTo(\"fake-policy\")\n .jsonPath(\"$.spec.groupName\").isEqualTo(\"fake-group\")\n ;\n\n verify(client).get(Policy.class, \"fake-policy\");\n verify(client).get(ConfigMap.class, \"fake-configmap\");\n verify(client).get(Group.class, \"fake-group\");\n verify(client).create(attachment);\n verify(handler).upload(assertArg(context -> {\n assertEquals(policy, context.policy());\n assertEquals(cm, context.configMap());\n assertEquals(group, context.group());\n }));\n }\n }\n\n @Nested\n class SearchTest {\n\n @Test\n void shouldListUngroupedAttachments() {\n when(attachmentLister.listBy(any())).thenReturn(Mono.just(ListResult.emptyResult()));\n\n webClient\n .get()\n .uri(\"/attachments\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"items.length()\").isEqualTo(0);\n }\n\n @Test\n void searchAttachmentWhenGroupIsEmpty() {\n when(attachmentLister.listBy(any())).thenReturn(Mono.just(ListResult.emptyResult()));\n\n webClient\n .get()\n .uri(\"/attachments\")\n .exchange()\n .expectStatus().isOk();\n\n verify(attachmentLister).listBy(any());\n }\n }\n\n @Nested\n class ExternalTransferTest {\n @Test\n void shouldResponseErrorIfNoPermalinkProvided() {\n webClient\n .mutateWith(mockUser(\"fake-user\").password(\"fake-password\"))\n .post()\n .uri(\"/attachments/-/upload-from-url\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(Map.of(\"policyName\", \"fake-policy\"))\n .exchange()\n .expectStatus().isBadRequest();\n }\n\n @Test\n void shouldTransferSuccessfully() {\n var policySpec = new PolicySpec();\n policySpec.setConfigMapName(\"fake-configmap\");\n var policyMetadata = new Metadata();\n policyMetadata.setName(\"fake-policy\");\n var policy = new Policy();\n policy.setSpec(policySpec);\n policy.setMetadata(policyMetadata);\n\n var cm = new ConfigMap();\n var cmMetadata = new Metadata();\n cmMetadata.setName(\"fake-configmap\");\n cm.setData(Map.of());\n\n when(client.get(Policy.class, \"fake-policy\")).thenReturn(Mono.just(policy));\n when(client.get(ConfigMap.class, \"fake-configmap\")).thenReturn(Mono.just(cm));\n\n var handler = mock(AttachmentHandler.class);\n var metadata = new Metadata();\n metadata.setName(\"fake-attachment\");\n var attachment = new Attachment();\n attachment.setMetadata(metadata);\n\n ResponseEntity response = new ResponseEntity<>(HttpStatusCode.valueOf(200));\n HttpHeaders headers = response.getHeaders();\n DataBuffer dataBuffer = mock(DataBuffer.class);\n\n when(handler.upload(any())).thenReturn(Mono.just(attachment));\n when(dataBufferFetcher.head(any())).thenReturn(Mono.just(headers));\n when(dataBufferFetcher.fetch(any())).thenReturn(Flux.just(dataBuffer));\n when(extensionGetter.getExtensions(AttachmentHandler.class))\n .thenReturn(Flux.just(handler));\n when(client.create(attachment)).thenReturn(Mono.just(attachment));\n\n var fakeValue =\n Map.of(\"policyName\", \"fake-policy\", \"url\",\n \"http://localhost:8090/fake-url.jpg\");\n webClient\n .mutateWith(mockUser(\"fake-user\").password(\"fake-password\"))\n .post()\n .uri(\"/attachments/-/upload-from-url\")\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(fakeValue)\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .jsonPath(\"$.metadata.name\").isEqualTo(\"fake-attachment\")\n .jsonPath(\"$.spec.ownerName\").isEqualTo(\"fake-user\")\n .jsonPath(\"$.spec.policyName\").isEqualTo(\"fake-policy\")\n ;\n\n verify(client).get(Policy.class, \"fake-policy\");\n verify(client).get(ConfigMap.class, \"fake-configmap\");\n verify(client).create(attachment);\n verify(dataBufferFetcher).head(any());\n verify(dataBufferFetcher).fetch(any());\n verify(handler).upload(any());\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/CommentReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.HashSet;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.comment.ReplyService;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.reconciler.CommentReconciler;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n * Tests for {@link CommentReconciler}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CommentReconcilerTest {\n\n @Mock\n private ExtensionClient client;\n\n @Mock\n SchemeManager schemeManager;\n\n @Mock\n ReplyService replyService;\n\n @InjectMocks\n private CommentReconciler commentReconciler;\n\n private final Instant now = Instant.now();\n\n @Test\n void reconcileDelete() {\n Comment comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(\"test\");\n comment.getMetadata().setDeletionTimestamp(Instant.now());\n Set finalizers = new HashSet<>();\n finalizers.add(CommentReconciler.FINALIZER_NAME);\n comment.getMetadata().setFinalizers(finalizers);\n comment.setSpec(new Comment.CommentSpec());\n comment.getSpec().setSubjectRef(getRef());\n comment.getSpec().setLastReadTime(now.plusSeconds(5));\n comment.setStatus(new Comment.CommentStatus());\n\n when(client.fetch(eq(Comment.class), eq(\"test\")))\n .thenReturn(Optional.of(comment));\n\n when(replyService.removeAllByComment(eq(comment.getMetadata().getName())))\n .thenReturn(Mono.empty());\n when(client.listBy(eq(Comment.class), any(ListOptions.class), isA(PageRequest.class)))\n .thenReturn(ListResult.emptyResult());\n\n Reconciler.Result reconcile = commentReconciler.reconcile(new Reconciler.Request(\"test\"));\n assertThat(reconcile.reEnqueue()).isFalse();\n assertThat(reconcile.retryAfter()).isNull();\n\n verify(replyService).removeAllByComment(eq(comment.getMetadata().getName()));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Comment.class);\n verify(client, times(1)).update(captor.capture());\n Comment value = captor.getValue();\n assertThat(value.getMetadata().getFinalizers()\n .contains(CommentReconciler.FINALIZER_NAME)).isFalse();\n }\n\n @Test\n void compatibleCreationTime() {\n Comment comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(\"fake-comment\");\n comment.setSpec(new Comment.CommentSpec());\n comment.getSpec().setApprovedTime(Instant.now());\n comment.getSpec().setCreationTime(null);\n\n commentReconciler.compatibleCreationTime(comment);\n\n assertThat(comment.getSpec().getCreationTime())\n .isEqualTo(comment.getSpec().getApprovedTime());\n }\n\n private static Ref getRef() {\n Ref ref = new Ref();\n ref.setGroup(\"content.halo.run\");\n ref.setVersion(\"v1alpha1\");\n ref.setKind(\"Post\");\n ref.setName(\"fake-post\");\n return ref;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/MenuItemReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Duration;\nimport java.util.Optional;\nimport java.util.function.Consumer;\nimport java.util.function.Supplier;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.core.extension.MenuItem.MenuItemSpec;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.reconciler.MenuItemReconciler;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.controller.Reconciler.Request;\n\n@ExtendWith(MockitoExtension.class)\nclass MenuItemReconcilerTest {\n\n @Mock\n ExtensionClient client;\n\n @InjectMocks\n MenuItemReconciler reconciler;\n\n @Nested\n class WhenCategoryRefSet {\n\n @Test\n void shouldNotUpdateMenuItemIfCategoryNotFound() {\n Supplier menuItemSupplier = () -> createMenuItem(\"fake-name\", spec -> {\n spec.setTargetRef(Ref.of(\"fake-category\", Category.GVK));\n });\n\n when(client.fetch(MenuItem.class, \"fake-name\"))\n .thenReturn(Optional.of(menuItemSupplier.get()));\n when(client.fetch(Category.class, \"fake-category\")).thenReturn(Optional.empty());\n\n var result = reconciler.reconcile(new Request(\"fake-name\"));\n\n assertTrue(result.reEnqueue());\n assertEquals(Duration.ofMinutes(1), result.retryAfter());\n verify(client).fetch(MenuItem.class, \"fake-name\");\n verify(client).fetch(Category.class, \"fake-category\");\n verify(client, never()).update(isA(MenuItem.class));\n }\n\n @Test\n void shouldUpdateMenuItemIfCategoryFound() {\n Supplier menuItemSupplier = () -> createMenuItem(\"fake-name\", spec -> {\n spec.setTargetRef(Ref.of(\"fake-category\", Category.GVK));\n });\n\n when(client.fetch(MenuItem.class, \"fake-name\"))\n .thenReturn(Optional.of(menuItemSupplier.get()))\n .thenReturn(Optional.of(menuItemSupplier.get()));\n when(client.fetch(Category.class, \"fake-category\"))\n .thenReturn(Optional.of(createCategory()));\n\n var result = reconciler.reconcile(new Request(\"fake-name\"));\n\n assertTrue(result.reEnqueue());\n assertEquals(Duration.ofMinutes(1), result.retryAfter());\n verify(client, times(2)).fetch(MenuItem.class, \"fake-name\");\n verify(client).fetch(Category.class, \"fake-category\");\n verify(client).update(argThat(menuItem -> {\n var status = menuItem.getStatus();\n return status.getHref().equals(\"fake://permalink\")\n && status.getDisplayName().equals(\"Fake Category\");\n }));\n }\n\n Category createCategory() {\n var metadata = new Metadata();\n metadata.setName(\"fake-category\");\n\n var spec = new Category.CategorySpec();\n spec.setDisplayName(\"Fake Category\");\n var status = new Category.CategoryStatus();\n status.setPermalink(\"fake://permalink\");\n\n var category = new Category();\n category.setMetadata(metadata);\n category.setSpec(spec);\n category.setStatus(status);\n return category;\n }\n }\n\n @Nested\n class WhenSinglePageRefSet {\n\n @Test\n void shouldUpdateMenuItemIfPageFound() {\n Supplier menuItemSupplier = () -> createMenuItem(\"fake-name\",\n spec -> spec.setTargetRef(Ref.of(\"fake-page\", SinglePage.GVK)));\n\n when(client.fetch(MenuItem.class, \"fake-name\"))\n .thenReturn(Optional.of(menuItemSupplier.get()))\n .thenReturn(Optional.of(menuItemSupplier.get()));\n\n when(client.fetch(SinglePage.class, \"fake-page\"))\n .thenReturn(Optional.of(createSinglePage()));\n\n var result = reconciler.reconcile(new Request(\"fake-name\"));\n assertTrue(result.reEnqueue());\n assertEquals(Duration.ofMinutes(1), result.retryAfter());\n verify(client, times(2)).fetch(MenuItem.class, \"fake-name\");\n verify(client).fetch(SinglePage.class, \"fake-page\");\n verify(client).update(argThat(menuItem -> {\n var status = menuItem.getStatus();\n return status.getHref().equals(\"fake://permalink\")\n && status.getDisplayName().equals(\"fake-title\");\n }));\n }\n\n SinglePage createSinglePage() {\n var metadata = new Metadata();\n metadata.setName(\"fake-page\");\n\n var spec = new SinglePage.SinglePageSpec();\n spec.setTitle(\"fake-title\");\n var status = new SinglePage.SinglePageStatus();\n status.setPermalink(\"fake://permalink\");\n\n var singlePage = new SinglePage();\n singlePage.setMetadata(metadata);\n singlePage.setSpec(spec);\n singlePage.setStatus(status);\n return singlePage;\n }\n }\n\n @Nested\n class WhenOtherRefsNotSet {\n\n @Test\n void shouldNotRequeueIfHrefNotSet() {\n var menuItem = createMenuItem(\"fake-name\", spec -> {\n spec.setHref(null);\n spec.setDisplayName(\"Fake display name\");\n });\n when(client.fetch(MenuItem.class, \"fake-name\")).thenReturn(Optional.of(menuItem));\n\n var result = reconciler.reconcile(new Request(\"fake-name\"));\n assertFalse(result.reEnqueue());\n\n verify(client).fetch(MenuItem.class, \"fake-name\");\n verify(client, never()).update(menuItem);\n }\n\n @Test\n void shouldNotRequeueIfDisplayNameNotSet() {\n var menuItem = createMenuItem(\"fake-name\", spec -> {\n spec.setHref(\"/fake\");\n spec.setDisplayName(null);\n });\n when(client.fetch(MenuItem.class, \"fake-name\")).thenReturn(Optional.of(menuItem));\n var result = reconciler.reconcile(new Request(\"fake-name\"));\n assertFalse(result.reEnqueue());\n\n verify(client).fetch(MenuItem.class, \"fake-name\");\n verify(client, never()).update(menuItem);\n }\n\n @Test\n void shouldReconcileIfHrefAndDisplayNameSet() {\n Supplier menuItemSupplier = () -> createMenuItem(\"fake-name\", spec -> {\n spec.setHref(\"/fake\");\n spec.setDisplayName(\"Fake display name\");\n });\n\n when(client.fetch(MenuItem.class, \"fake-name\"))\n .thenReturn(Optional.of(menuItemSupplier.get()))\n .thenReturn(Optional.of(menuItemSupplier.get()));\n\n var result = reconciler.reconcile(new Request(\"fake-name\"));\n assertFalse(result.reEnqueue());\n\n verify(client, times(2)).fetch(MenuItem.class, \"fake-name\");\n verify(client).update(argThat(ext -> {\n if (!(ext instanceof MenuItem menuItem)) {\n return false;\n }\n return menuItem.getStatus().getHref().equals(\"/fake\")\n && menuItem.getStatus().getDisplayName().equals(\"Fake display name\");\n }));\n }\n }\n\n MenuItem createMenuItem(String name, Consumer specCustomizer) {\n var metadata = new Metadata();\n metadata.setName(name);\n var menuItem = new MenuItem();\n menuItem.setMetadata(metadata);\n var spec = new MenuItemSpec();\n if (specCustomizer != null) {\n specCustomizer.accept(spec);\n }\n menuItem.setSpec(spec);\n return menuItem;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/PluginReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.plugin.PluginConst.PLUGIN_PATH;\nimport static run.halo.app.plugin.PluginConst.RELOAD_ANNO;\nimport static run.halo.app.plugin.PluginConst.RUNTIME_MODE_ANNO;\n\nimport java.io.IOException;\nimport java.net.URL;\nimport java.net.URLClassLoader;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.time.Clock;\nimport java.time.Instant;\nimport java.time.ZoneOffset;\nimport java.util.HashMap;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.Set;\nimport java.util.function.Consumer;\nimport org.jspecify.annotations.Nullable;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.DefaultPluginDescriptor;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginWrapper;\nimport org.pf4j.RuntimeMode;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport reactor.core.scheduler.Schedulers;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.Reconciler.Request;\nimport run.halo.app.extension.controller.RequeueException;\nimport run.halo.app.infra.Condition;\nimport run.halo.app.infra.ConditionStatus;\nimport run.halo.app.plugin.PluginProperties;\nimport run.halo.app.plugin.PluginService;\nimport run.halo.app.plugin.SpringPluginManager;\n\n/**\n * Tests for {@link PluginReconciler}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PluginReconcilerTest {\n\n @Mock\n SpringPluginManager pluginManager;\n\n @Mock\n ExtensionClient client;\n\n @Mock\n PluginProperties pluginProperties;\n\n @Mock\n PluginService pluginService;\n\n @InjectMocks\n PluginReconciler reconciler;\n\n Clock clock = Clock.fixed(Instant.parse(\"2024-01-09T12:00:00Z\"), ZoneOffset.UTC);\n\n String finalizer = \"plugin-protection\";\n String name = \"fake-plugin\";\n\n String reverseProxyName = \"fake-plugin-system-generated-reverse-proxy\";\n\n String settingName = \"fake-setting\";\n\n String configMapName = \"fake-configmap\";\n\n @BeforeEach\n void setUp() {\n reconciler.setClock(clock);\n reconciler.setScheduler(Schedulers.immediate());\n }\n\n @Test\n void shouldNotRequeueIfPluginNotFound() {\n when(client.fetch(Plugin.class, \"fake-plugin\")).thenReturn(Optional.empty());\n var result = reconciler.reconcile(new Request(\"fake-plugin\"));\n assertFalse(result.reEnqueue());\n verify(client).fetch(Plugin.class, \"fake-plugin\");\n }\n\n @Nested\n class WhenNotDeleting {\n\n @TempDir\n Path tempPath;\n\n @BeforeEach\n void setUp() throws IOException {\n lenient().when(pluginService.getRequiredDependencies(any(), any()))\n .thenReturn(List.of());\n Files.createFile(tempPath.resolve(\"fake-plugin-1.2.3.jar\"));\n }\n\n @Test\n void shouldNotStartPluginWithDevModeInNonDevEnv() {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(true);\n plugin.getMetadata()\n .setAnnotations(new HashMap<>(Map.of(RUNTIME_MODE_ANNO, \"dev\",\n PLUGIN_PATH, \"fake-path\")));\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n\n var result = reconciler.reconcile(new Request(name));\n assertFalse(result.reEnqueue());\n\n var status = fakePlugin.getStatus();\n assertEquals(Plugin.Phase.UNKNOWN, status.getPhase());\n var condition = status.getConditions().peekFirst();\n assertEquals(Condition.builder()\n .type(PluginReconciler.ConditionType.INITIALIZED)\n .status(ConditionStatus.FALSE)\n .reason(PluginReconciler.ConditionReason.INVALID_RUNTIME_MODE)\n .message(\"\"\"\n Cannot run the plugin with development mode in non-development environment.\\\n \"\"\")\n .build(), condition);\n\n verify(client).update(fakePlugin);\n verify(client).fetch(Plugin.class, name);\n verify(pluginProperties).getRuntimeMode();\n verify(pluginManager, never()).loadPlugin(any(Path.class));\n verify(pluginManager, never()).startPlugin(name);\n }\n\n @Test\n void shouldStartInDevMode() {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(true);\n plugin.getMetadata()\n .setAnnotations(new HashMap<>(Map.of(RUNTIME_MODE_ANNO, \"dev\",\n PLUGIN_PATH, \"fake-path\")));\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(pluginManager.getPlugin(name))\n .thenReturn(null)\n .thenReturn(mockPluginWrapper(PluginState.RESOLVED));\n\n when(pluginManager.startPlugin(name)).thenReturn(PluginState.STARTED);\n when(pluginProperties.getRuntimeMode()).thenReturn(RuntimeMode.DEVELOPMENT);\n\n var result = reconciler.reconcile(new Request(name));\n assertTrue(result.reEnqueue());\n assertEquals(Paths.get(\"fake-path\").toUri(), fakePlugin.getStatus().getLoadLocation());\n\n verify(pluginManager).startPlugin(name);\n }\n\n @Test\n void shouldThrowExceptionIfNoPluginPathProvidedInDevMode() {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(true);\n plugin.getMetadata()\n .setAnnotations(new HashMap<>(Map.of(RUNTIME_MODE_ANNO, \"dev\")));\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(pluginManager.getPlugin(name))\n // loading plugin\n .thenReturn(null);\n when(pluginProperties.getRuntimeMode()).thenReturn(RuntimeMode.DEVELOPMENT);\n\n var result = reconciler.reconcile(new Request(name));\n assertFalse(result.reEnqueue());\n }\n\n @Test\n void shouldReloadIfReloadAnnotationPresent() {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(true);\n plugin.getMetadata().setAnnotations(new HashMap<>(Map.of(RELOAD_ANNO, \"true\")));\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(pluginManager.getPluginsRoots()).thenReturn(List.of(tempPath));\n var pluginWrapper = mockPluginWrapper(PluginState.RESOLVED);\n when(pluginManager.getPlugin(name)).thenReturn(pluginWrapper);\n when(pluginManager.startPlugin(name)).thenReturn(PluginState.STARTED);\n when(pluginManager.getUnresolvedPlugins()).thenReturn(List.of(pluginWrapper));\n when(pluginManager.getResolvedPlugins()).thenReturn(List.of());\n\n var result = reconciler.reconcile(new Request(name));\n assertTrue(result.reEnqueue());\n\n verify(pluginManager).unloadPlugin(name);\n var loadLocation = Paths.get(fakePlugin.getStatus().getLoadLocation());\n verify(pluginManager).loadPlugin(loadLocation);\n }\n\n @Test\n void shouldReportIfFailedToStartPlugin() throws IOException {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(true);\n spec.setSettingName(settingName);\n spec.setConfigMapName(configMapName);\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(pluginManager.getPluginsRoots()).thenReturn(List.of(tempPath));\n when(pluginManager.getPlugin(name))\n // loading plugin\n .thenReturn(null)\n // get setting extension\n .thenReturn(mockPluginWrapperForSetting())\n .thenReturn(mockPluginWrapperForStaticResources())\n .thenReturn(\n mockPluginWrapper(PluginState.FAILED, new IllegalStateException(\"Fake error\"))\n );\n var result = reconciler.reconcile(new Request(name));\n assertFalse(result.reEnqueue());\n\n verify(client).update(fakePlugin);\n var status = fakePlugin.getStatus();\n assertEquals(Plugin.Phase.FAILED, status.getPhase());\n var condition = status.getConditions().peekFirst();\n assertEquals(PluginReconciler.ConditionType.READY, condition.getType());\n assertEquals(ConditionStatus.FALSE, condition.getStatus());\n assertEquals(PluginReconciler.ConditionReason.START_ERROR, condition.getReason());\n assertTrue(condition.getMessage().contains(\"Fake error\"));\n\n verify(pluginManager, never()).startPlugin(name);\n }\n\n @Test\n void shouldEnablePluginIfEnabled() throws IOException {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(true);\n spec.setSettingName(settingName);\n spec.setConfigMapName(configMapName);\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(pluginManager.getPluginsRoots()).thenReturn(List.of(tempPath));\n when(pluginManager.getPlugin(name))\n // loading plugin\n .thenReturn(null)\n // get setting extension\n .thenReturn(mockPluginWrapperForSetting())\n .thenReturn(mockPluginWrapperForStaticResources())\n // before starting\n .thenReturn(mockPluginWrapper(PluginState.STARTED))\n // sync plugin state\n .thenReturn(mockPluginWrapper(PluginState.STARTED));\n\n var result = reconciler.reconcile(new Request(name));\n\n assertFalse(result.reEnqueue());\n assertTrue(fakePlugin.getMetadata().getFinalizers().contains(finalizer));\n\n assertEquals(\"fake-plugin-1.2.3.jar\",\n fakePlugin.getMetadata().getAnnotations().get(PLUGIN_PATH));\n var loadLocation = Paths.get(fakePlugin.getStatus().getLoadLocation());\n assertEquals(tempPath.resolve(\"fake-plugin-1.2.3.jar\"), loadLocation);\n assertEquals(\"/plugins/fake-plugin/assets/fake-logo.svg?version=1.2.3\",\n fakePlugin.getStatus().getLogo());\n assertEquals(\"/plugins/fake-plugin/assets/console/main.js?version=1.2.3\",\n fakePlugin.getStatus().getEntry());\n assertEquals(\"/plugins/fake-plugin/assets/console/style.css?version=1.2.3\",\n fakePlugin.getStatus().getStylesheet());\n assertEquals(Plugin.Phase.STARTED, fakePlugin.getStatus().getPhase());\n assertEquals(PluginState.STARTED, fakePlugin.getStatus().getLastProbeState());\n assertNotNull(fakePlugin.getStatus().getLastStartTime());\n\n var condition = fakePlugin.getStatus().getConditions().peek();\n assertEquals(PluginReconciler.ConditionType.READY, condition.getType());\n assertEquals(ConditionStatus.TRUE, condition.getStatus());\n assertEquals(clock.instant(), condition.getLastTransitionTime());\n\n verify(pluginManager, never()).startPlugin(name);\n verify(pluginManager).loadPlugin(loadLocation);\n verify(pluginManager, times(5)).getPlugin(name);\n verify(client).update(fakePlugin);\n verify(client).fetch(Setting.class, settingName);\n verify(client).create(any(Setting.class));\n verify(client).fetch(ConfigMap.class, configMapName);\n verify(client).create(any(ConfigMap.class));\n verify(client).fetch(ReverseProxy.class, reverseProxyName);\n verify(client).create(any(ReverseProxy.class));\n }\n\n @Test\n void shouldDisablePluginIfDisabled() throws IOException {\n var fakePlugin = createPlugin(name, plugin -> {\n var spec = plugin.getSpec();\n spec.setVersion(\"1.2.3\");\n spec.setLogo(\"fake-logo.svg\");\n spec.setEnabled(false);\n spec.setSettingName(settingName);\n spec.setConfigMapName(configMapName);\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(pluginManager.getPluginsRoots()).thenReturn(List.of(tempPath));\n\n when(pluginManager.getPlugin(name))\n // loading plugin\n .thenReturn(null)\n // get setting files.\n .thenReturn(mockPluginWrapperForSetting())\n // resolving static resources\n .thenReturn(mockPluginWrapperForStaticResources())\n // before disabling plugin\n .thenReturn(mock(PluginWrapper.class))\n // sync plugin state\n .thenReturn(mockPluginWrapper(PluginState.DISABLED));\n\n var result = reconciler.reconcile(new Request(\"fake-plugin\"));\n\n assertFalse(result.reEnqueue());\n assertTrue(fakePlugin.getMetadata().getFinalizers().contains(finalizer));\n\n assertEquals(\"fake-plugin-1.2.3.jar\",\n fakePlugin.getMetadata().getAnnotations().get(PLUGIN_PATH));\n var loadLocation = Paths.get(fakePlugin.getStatus().getLoadLocation());\n assertEquals(tempPath.resolve(\"fake-plugin-1.2.3.jar\"), loadLocation);\n assertEquals(\"/plugins/fake-plugin/assets/fake-logo.svg?version=1.2.3\",\n fakePlugin.getStatus().getLogo());\n assertEquals(\"/plugins/fake-plugin/assets/console/main.js?version=1.2.3\",\n fakePlugin.getStatus().getEntry());\n assertEquals(\"/plugins/fake-plugin/assets/console/style.css?version=1.2.3\",\n fakePlugin.getStatus().getStylesheet());\n assertEquals(Plugin.Phase.DISABLED, fakePlugin.getStatus().getPhase());\n assertEquals(PluginState.DISABLED, fakePlugin.getStatus().getLastProbeState());\n\n verify(pluginManager).disablePlugin(name);\n verify(pluginManager).loadPlugin(loadLocation);\n verify(pluginManager, times(5)).getPlugin(name);\n verify(client).update(fakePlugin);\n verify(client).fetch(Setting.class, settingName);\n verify(client).create(any(Setting.class));\n verify(client).fetch(ConfigMap.class, configMapName);\n verify(client).create(any(ConfigMap.class));\n verify(client).fetch(ReverseProxy.class, reverseProxyName);\n verify(client).create(any(ReverseProxy.class));\n }\n\n PluginWrapper mockPluginWrapperForSetting() throws IOException {\n var pluginWrapper = mock(PluginWrapper.class);\n\n var pluginRootResource =\n new DefaultResourceLoader().getResource(\"classpath:plugin/plugin-0.0.1/\");\n var classLoader = new URLClassLoader(new URL[] {pluginRootResource.getURL()}, null);\n when(pluginWrapper.getPluginClassLoader()).thenReturn(classLoader);\n lenient().when(pluginWrapper.getDescriptor()).thenReturn(new DefaultPluginDescriptor());\n return pluginWrapper;\n }\n\n PluginWrapper mockPluginWrapperForStaticResources() {\n // check\n var pluginWrapper = mock(PluginWrapper.class);\n var pluginClassLoader = mock(ClassLoader.class);\n when(pluginClassLoader.getResource(\"console/main.js\")).thenReturn(\n mock(URL.class));\n when(pluginClassLoader.getResource(\"console/style.css\")).thenReturn(\n mock(URL.class));\n when(pluginWrapper.getPluginClassLoader()).thenReturn(pluginClassLoader);\n lenient().when(pluginWrapper.getDescriptor()).thenReturn(new DefaultPluginDescriptor());\n return pluginWrapper;\n }\n\n PluginWrapper mockPluginWrapper(PluginState state) {\n return mockPluginWrapper(state, null);\n }\n\n PluginWrapper mockPluginWrapper(PluginState state, @Nullable Throwable t) {\n var pluginWrapper = mock(PluginWrapper.class);\n lenient().when(pluginWrapper.getPluginState()).thenReturn(state);\n lenient().when(pluginWrapper.getDescriptor()).thenReturn(new DefaultPluginDescriptor());\n lenient().when(pluginWrapper.getFailedException()).thenReturn(t);\n return pluginWrapper;\n }\n\n }\n\n @Nested\n class WhenDeleting {\n\n @Test\n void shouldDoNothingWithoutFinalizer() {\n var fakePlugin = createPlugin(name, plugin -> {\n var metadata = plugin.getMetadata();\n metadata.setDeletionTimestamp(clock.instant());\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n\n var result = reconciler.reconcile(new Request(name));\n assertFalse(result.reEnqueue());\n verify(client).fetch(Plugin.class, name);\n verify(client, never()).update(fakePlugin);\n verify(pluginManager, never()).getPlugin(name);\n verify(pluginManager, never()).deletePlugin(name);\n }\n\n @Test\n void shouldCleanUpResourceFully() {\n var fakePlugin = createPlugin(name, plugin -> {\n var metadata = plugin.getMetadata();\n metadata.setDeletionTimestamp(clock.instant());\n metadata.setFinalizers(new HashSet<>(Set.of(finalizer)));\n plugin.getStatus().setLastProbeState(PluginState.STARTED);\n plugin.getSpec().setConfigMapName(\"fake-configmap\");\n plugin.getSpec().setSettingName(\"fake-setting\");\n });\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(client.fetch(Setting.class, \"fake-setting\"))\n .thenReturn(Optional.empty());\n when(client.fetch(ReverseProxy.class, reverseProxyName))\n .thenReturn(Optional.empty());\n\n when(pluginManager.getPlugin(name))\n .thenReturn(mock(PluginWrapper.class))\n .thenReturn(null);\n\n var result = reconciler.reconcile(new Request(name));\n\n assertFalse(result.reEnqueue());\n // make sure the finalizer is removed.\n assertFalse(fakePlugin.getMetadata().getFinalizers().contains(finalizer));\n assertNull(fakePlugin.getStatus().getLastProbeState());\n verify(pluginManager, times(2)).getPlugin(name);\n verify(pluginManager).deletePlugin(name);\n verify(client).fetch(Plugin.class, name);\n verify(client).fetch(Setting.class, \"fake-setting\");\n verify(client).fetch(ReverseProxy.class, reverseProxyName);\n verify(client).update(fakePlugin);\n }\n\n @Test\n void shouldDeleteSettingAndRequeueIfExists() {\n var fakePlugin = createPlugin(name, plugin -> {\n var metadata = plugin.getMetadata();\n metadata.setDeletionTimestamp(clock.instant());\n metadata.setFinalizers(new HashSet<>(Set.of(finalizer)));\n plugin.getStatus().setLastProbeState(PluginState.STARTED);\n plugin.getSpec().setSettingName(settingName);\n });\n\n var fakeSetting = createSetting(settingName);\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(client.fetch(Setting.class, settingName))\n .thenReturn(Optional.of(fakeSetting));\n when(client.fetch(ReverseProxy.class, reverseProxyName))\n .thenReturn(Optional.empty());\n\n var exception = assertThrows(\n RequeueException.class,\n () -> reconciler.reconcile(new Request(name))\n );\n assertEquals(Reconciler.Result.requeue(null), exception.getResult());\n assertEquals(\"Waiting for setting fake-setting to be deleted.\", exception.getMessage());\n\n // make sure the finalizer is removed.\n assertFalse(fakePlugin.getMetadata().getFinalizers().contains(finalizer));\n assertEquals(PluginState.STARTED, fakePlugin.getStatus().getLastProbeState());\n verify(pluginManager, never()).getPlugin(name);\n verify(pluginManager, never()).deletePlugin(name);\n verify(client).fetch(Plugin.class, name);\n verify(client).fetch(ReverseProxy.class, reverseProxyName);\n verify(client).fetch(Setting.class, settingName);\n verify(client).delete(fakeSetting);\n verify(client, never()).update(fakePlugin);\n }\n\n @Test\n void shouldDeleteReverseProxyAndRequeueIfExists() {\n var fakePlugin = createPlugin(name, plugin -> {\n var metadata = plugin.getMetadata();\n metadata.setDeletionTimestamp(clock.instant());\n metadata.setFinalizers(new HashSet<>(Set.of(finalizer)));\n plugin.getStatus().setLastProbeState(PluginState.STARTED);\n plugin.getSpec().setSettingName(settingName);\n });\n\n var reverseProxy = createReverseProxy(reverseProxyName);\n\n when(client.fetch(Plugin.class, name)).thenReturn(Optional.of(fakePlugin));\n when(client.fetch(ReverseProxy.class, reverseProxyName))\n .thenReturn(Optional.of(reverseProxy));\n\n var exception = assertThrows(RequeueException.class,\n () -> reconciler.reconcile(new Request(name)),\n \"Waiting for setting fake-setting to be deleted.\");\n assertEquals(Reconciler.Result.requeue(null), exception.getResult());\n assertEquals(\"Waiting for reverse proxy \" + reverseProxyName + \" to be deleted.\",\n exception.getMessage());\n\n // make sure the finalizer is removed.\n assertFalse(fakePlugin.getMetadata().getFinalizers().contains(finalizer));\n assertEquals(PluginState.STARTED, fakePlugin.getStatus().getLastProbeState());\n verify(pluginManager, never()).getPlugin(name);\n verify(pluginManager, never()).deletePlugin(name);\n verify(client).fetch(Plugin.class, name);\n verify(client).fetch(ReverseProxy.class, reverseProxyName);\n verify(client).delete(reverseProxy);\n verify(client, never()).fetch(Setting.class, settingName);\n verify(client, never()).update(fakePlugin);\n }\n\n }\n\n Setting createSetting(String name) {\n var setting = new Setting();\n var metadata = new Metadata();\n metadata.setName(name);\n setting.setMetadata(metadata);\n return setting;\n }\n\n ReverseProxy createReverseProxy(String name) {\n var reverseProxy = new ReverseProxy();\n var metadata = new Metadata();\n metadata.setName(name);\n reverseProxy.setMetadata(metadata);\n return reverseProxy;\n }\n\n Plugin createPlugin(String name, Consumer pluginConsumer) {\n var plugin = new Plugin();\n var metadata = new Metadata();\n plugin.setMetadata(metadata);\n metadata.setName(name);\n plugin.setSpec(new Plugin.PluginSpec());\n plugin.setStatus(new Plugin.PluginStatus());\n pluginConsumer.accept(plugin);\n return plugin;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/PostReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.ExcerptGenerator;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.content.PostService;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.content.permalinks.PostPermalinkPolicy;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.core.reconciler.PostReconciler;\nimport run.halo.app.event.post.PostPublishedEvent;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Tests for {@link PostReconciler}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostReconcilerTest {\n\n @Mock\n private ExtensionClient client;\n\n @Mock\n private PostPermalinkPolicy postPermalinkPolicy;\n\n @Mock\n private PostService postService;\n\n @Mock\n private ApplicationEventPublisher eventPublisher;\n\n @Mock\n private NotificationCenter notificationCenter;\n\n @Mock\n private ExtensionGetter extensionGetter;\n\n @InjectMocks\n private PostReconciler postReconciler;\n\n @BeforeEach\n void setUp() {\n lenient().when(notificationCenter.subscribe(any(), any())).thenReturn(Mono.empty());\n }\n\n @Test\n void reconcile() {\n String name = \"post-A\";\n Post post = TestPost.postV1();\n post.getSpec().setPublish(false);\n post.getSpec().setHeadSnapshot(\"post-A-head-snapshot\");\n when(client.fetch(eq(Post.class), eq(name)))\n .thenReturn(Optional.of(post));\n when(postService.getContent(eq(post.getSpec().getReleaseSnapshot()),\n eq(post.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.empty());\n\n Snapshot snapshotV1 = TestPost.snapshotV1();\n Snapshot snapshotV2 = TestPost.snapshotV2();\n snapshotV1.getSpec().setContributors(Set.of(\"guqing\"));\n snapshotV2.getSpec().setContributors(Set.of(\"guqing\", \"zhangsan\"));\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of(snapshotV1, snapshotV2));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Post.class);\n postReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(1)).update(captor.capture());\n\n verify(postPermalinkPolicy, times(1)).permalink(any());\n\n Post value = captor.getValue();\n assertThat(value.getStatus().getExcerpt()).isEmpty();\n assertThat(value.getStatus().getContributors()).isEqualTo(List.of(\"guqing\", \"zhangsan\"));\n }\n\n @Test\n void shouldGenerateBlankExcerptWhenContentIsNull() {\n var name = \"post-A\";\n Post post = TestPost.postV1();\n post.getSpec().setPublish(true);\n post.getSpec().setHeadSnapshot(\"post-A-head-snapshot\");\n post.getSpec().setReleaseSnapshot(\"post-fake-released-snapshot\");\n when(client.fetch(eq(Post.class), eq(name)))\n .thenReturn(Optional.of(post));\n when(postService.getContent(eq(post.getSpec().getReleaseSnapshot()),\n eq(post.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(post.getSpec().getHeadSnapshot())\n .raw(null)\n .content(null)\n .rawType(\"markdown\")\n .build()));\n\n Snapshot snapshotV2 = TestPost.snapshotV2();\n snapshotV2.getMetadata().setLabels(new HashMap<>());\n snapshotV2.getSpec().setContributors(Set.of(\"guqing\", \"zhangsan\"));\n\n Snapshot snapshotV1 = TestPost.snapshotV1();\n snapshotV1.getSpec().setContributors(Set.of(\"guqing\"));\n\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of(snapshotV1, snapshotV2));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Post.class);\n postReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(1)).update(captor.capture());\n Post value = captor.getValue();\n assertThat(value.getStatus().getExcerpt()).isEqualTo(\"\");\n }\n\n @Test\n void reconcileExcerpt() {\n // https://github.com/halo-dev/halo/issues/2452\n String name = \"post-A\";\n Post post = TestPost.postV1();\n post.getSpec().setPublish(true);\n post.getSpec().setHeadSnapshot(\"post-A-head-snapshot\");\n post.getSpec().setReleaseSnapshot(\"post-fake-released-snapshot\");\n when(client.fetch(eq(Post.class), eq(name)))\n .thenReturn(Optional.of(post));\n when(postService.getContent(eq(post.getSpec().getReleaseSnapshot()),\n eq(post.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(post.getSpec().getHeadSnapshot())\n .raw(\"hello world\")\n .content(\"

hello world

\")\n .rawType(\"markdown\")\n .build()));\n\n Snapshot snapshotV2 = TestPost.snapshotV2();\n snapshotV2.getMetadata().setLabels(new HashMap<>());\n snapshotV2.getSpec().setContributors(Set.of(\"guqing\", \"zhangsan\"));\n\n Snapshot snapshotV1 = TestPost.snapshotV1();\n snapshotV1.getSpec().setContributors(Set.of(\"guqing\"));\n\n when(extensionGetter.getEnabledExtension(eq(ExcerptGenerator.class)))\n .thenReturn(Mono.empty());\n\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of(snapshotV1, snapshotV2));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Post.class);\n postReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(1)).update(captor.capture());\n Post value = captor.getValue();\n assertThat(value.getStatus().getExcerpt()).isEqualTo(\"hello world\");\n }\n\n @Nested\n class LastModifyTimeTest {\n @Test\n void reconcileLastModifyTimeWhenPostIsPublished() {\n String name = \"post-A\";\n Post post = TestPost.postV1();\n post.getSpec().setPublish(true);\n post.getSpec().setHeadSnapshot(\"post-A-head-snapshot\");\n post.getSpec().setReleaseSnapshot(\"post-fake-released-snapshot\");\n when(client.fetch(eq(Post.class), eq(name)))\n .thenReturn(Optional.of(post));\n when(postService.getContent(eq(post.getSpec().getReleaseSnapshot()),\n eq(post.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(post.getSpec().getHeadSnapshot())\n .raw(\"hello world\")\n .content(\"

hello world

\")\n .rawType(\"markdown\")\n .build()));\n Instant lastModifyTime = Instant.now();\n Snapshot snapshotV2 = TestPost.snapshotV2();\n snapshotV2.getSpec().setLastModifyTime(lastModifyTime);\n when(client.fetch(eq(Snapshot.class), eq(post.getSpec().getReleaseSnapshot())))\n .thenReturn(Optional.of(snapshotV2));\n\n when(extensionGetter.getEnabledExtension(eq(ExcerptGenerator.class)))\n .thenReturn(Mono.empty());\n\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of());\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Post.class);\n postReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(1)).update(captor.capture());\n Post value = captor.getValue();\n assertThat(value.getStatus().getLastModifyTime()).isEqualTo(lastModifyTime);\n verify(eventPublisher).publishEvent(any(PostPublishedEvent.class));\n }\n\n @Test\n void reconcileLastModifyTimeWhenPostIsNotPublished() {\n String name = \"post-A\";\n Post post = TestPost.postV1();\n post.getSpec().setPublish(false);\n post.getSpec().setHeadSnapshot(\"post-A-head-snapshot\");\n when(client.fetch(eq(Post.class), eq(name)))\n .thenReturn(Optional.of(post));\n when(postService.getContent(eq(post.getSpec().getReleaseSnapshot()),\n eq(post.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(post.getSpec().getHeadSnapshot())\n .raw(\"hello world\")\n .content(\"

hello world

\")\n .rawType(\"markdown\")\n .build()));\n\n when(extensionGetter.getEnabledExtension(eq(ExcerptGenerator.class)))\n .thenReturn(Mono.empty());\n\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of());\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(Post.class);\n postReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(1)).update(captor.capture());\n Post value = captor.getValue();\n assertThat(value.getStatus().getLastModifyTime()).isNull();\n }\n }\n\n @Test\n void subscribeNewCommentNotificationTest() {\n Post post = TestPost.postV1();\n\n postReconciler.subscribeNewCommentNotification(post);\n\n verify(notificationCenter).subscribe(\n assertArg(subscriber -> assertThat(subscriber.getName())\n .isEqualTo(post.getSpec().getOwner())),\n assertArg(argReason -> {\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(NotificationReasonConst.NEW_COMMENT_ON_POST);\n interestReason.setExpression(\"props.postOwner == 'null'\");\n assertThat(argReason).isEqualTo(interestReason);\n }));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/ReverseProxyReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.core.reconciler.ReverseProxyReconciler;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.plugin.PluginConst;\nimport run.halo.app.plugin.resources.ReverseProxyRouterFunctionRegistry;\n\n/**\n * Tests for {@link ReverseProxyReconciler}.\n *\n * @author guqing\n * @since 2.0.1\n */\n@ExtendWith(MockitoExtension.class)\nclass ReverseProxyReconcilerTest {\n\n @Mock\n private ExtensionClient client;\n\n @Mock\n private ReverseProxyRouterFunctionRegistry routerFunctionRegistry;\n\n @InjectMocks\n private ReverseProxyReconciler reverseProxyReconciler;\n\n @Test\n void reconcileRemoval() {\n // fix gh-2937\n ReverseProxy reverseProxy = new ReverseProxy();\n reverseProxy.setMetadata(new Metadata());\n reverseProxy.getMetadata().setName(\"fake-reverse-proxy\");\n reverseProxy.getMetadata().setDeletionTimestamp(Instant.now());\n reverseProxy.getMetadata()\n .setLabels(Map.of(PluginConst.PLUGIN_NAME_LABEL_NAME, \"fake-plugin\"));\n reverseProxy.setRules(List.of());\n\n doNothing().when(routerFunctionRegistry).remove(anyString(), anyString());\n when(client.fetch(ReverseProxy.class, \"fake-reverse-proxy\"))\n .thenReturn(Optional.of(reverseProxy));\n\n reverseProxyReconciler.reconcile(new Reconciler.Request(\"fake-reverse-proxy\"));\n\n verify(routerFunctionRegistry, never()).register(anyString(), any(ReverseProxy.class));\n\n verify(routerFunctionRegistry, times(1))\n .remove(eq(\"fake-plugin\"), eq(\"fake-reverse-proxy\"));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/SinglePageReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.content.TestPost.snapshotV1;\n\nimport java.net.URI;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationContext;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.ExcerptGenerator;\nimport run.halo.app.content.NotificationReasonConst;\nimport run.halo.app.content.SinglePageService;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.core.extension.content.Snapshot;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.notification.NotificationCenter;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Tests for {@link SinglePageReconciler}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageReconcilerTest {\n @Mock\n private ExtensionClient client;\n\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private CounterService counterService;\n\n @Mock\n private SinglePageService singlePageService;\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n NotificationCenter notificationCenter;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @InjectMocks\n private SinglePageReconciler singlePageReconciler;\n\n @BeforeEach\n void setUp() {\n lenient().when(notificationCenter.subscribe(any(), any())).thenReturn(Mono.empty());\n }\n\n @Test\n void reconcile() {\n String name = \"page-A\";\n SinglePage page = pageV1();\n page.getSpec().setHeadSnapshot(\"page-A-head-snapshot\");\n page.getSpec().setReleaseSnapshot(page.getSpec().getHeadSnapshot());\n when(client.fetch(eq(SinglePage.class), eq(name)))\n .thenReturn(Optional.of(page));\n when(singlePageService.getContent(eq(page.getSpec().getReleaseSnapshot()),\n eq(page.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(page.getSpec().getHeadSnapshot())\n .raw(\"hello world\")\n .content(\"

hello world

\")\n .rawType(\"markdown\")\n .build())\n );\n\n Snapshot snapshotV1 = snapshotV1();\n Snapshot snapshotV2 = TestPost.snapshotV2();\n snapshotV1.getSpec().setContributors(Set.of(\"guqing\"));\n snapshotV2.getSpec().setContributors(Set.of(\"guqing\", \"zhangsan\"));\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of(snapshotV1, snapshotV2));\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n\n when(extensionGetter.getEnabledExtension(eq(ExcerptGenerator.class)))\n .thenReturn(Mono.empty());\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(SinglePage.class);\n singlePageReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(3)).update(captor.capture());\n\n SinglePage value = captor.getValue();\n assertThat(value.getStatus().getExcerpt()).isEqualTo(\"hello world\");\n assertThat(value.getStatus().getContributors()).isEqualTo(List.of(\"guqing\", \"zhangsan\"));\n }\n\n @Test\n void createPermalink() {\n SinglePage page = pageV1();\n page.getSpec().setSlug(\"page-slug\");\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n\n String permalink = singlePageReconciler.createPermalink(page);\n assertThat(permalink).isEqualTo(\"/page-slug\");\n\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"http://example.com\"));\n permalink = singlePageReconciler.createPermalink(page);\n assertThat(permalink).isEqualTo(\"http://example.com/page-slug\");\n\n page.getSpec().setSlug(\"中文 slug\");\n permalink = singlePageReconciler.createPermalink(page);\n assertThat(permalink).isEqualTo(\"http://example.com/%E4%B8%AD%E6%96%87%20slug\");\n }\n\n @Nested\n class LastModifyTimeTest {\n @Test\n void reconcileLastModifyTimeWhenPageIsPublished() {\n String name = \"page-A\";\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n\n SinglePage page = pageV1();\n page.getSpec().setPublish(true);\n page.getSpec().setHeadSnapshot(\"page-A-head-snapshot\");\n page.getSpec().setReleaseSnapshot(\"page-fake-released-snapshot\");\n when(client.fetch(eq(SinglePage.class), eq(name)))\n .thenReturn(Optional.of(page));\n when(singlePageService.getContent(eq(page.getSpec().getReleaseSnapshot()),\n eq(page.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(page.getSpec().getHeadSnapshot())\n .raw(\"hello world\")\n .content(\"

hello world

\")\n .rawType(\"markdown\")\n .build())\n );\n Instant lastModifyTime = Instant.now();\n Snapshot snapshotV2 = TestPost.snapshotV2();\n snapshotV2.getSpec().setLastModifyTime(lastModifyTime);\n when(client.fetch(eq(Snapshot.class), eq(page.getSpec().getReleaseSnapshot())))\n .thenReturn(Optional.of(snapshotV2));\n\n when(extensionGetter.getEnabledExtension(eq(ExcerptGenerator.class)))\n .thenReturn(Mono.empty());\n\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of());\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(SinglePage.class);\n singlePageReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(4)).update(captor.capture());\n SinglePage value = captor.getValue();\n assertThat(value.getStatus().getLastModifyTime()).isEqualTo(lastModifyTime);\n }\n\n @Test\n void reconcileLastModifyTimeWhenPageIsNotPublished() {\n String name = \"page-A\";\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n\n SinglePage page = pageV1();\n page.getSpec().setPublish(false);\n when(client.fetch(eq(SinglePage.class), eq(name)))\n .thenReturn(Optional.of(page));\n when(singlePageService.getContent(eq(page.getSpec().getReleaseSnapshot()),\n eq(page.getSpec().getBaseSnapshot())))\n .thenReturn(Mono.just(ContentWrapper.builder()\n .snapshotName(page.getSpec().getHeadSnapshot())\n .raw(\"hello world\")\n .content(\"

hello world

\")\n .rawType(\"markdown\")\n .build())\n );\n\n when(extensionGetter.getEnabledExtension(eq(ExcerptGenerator.class)))\n .thenReturn(Mono.empty());\n\n when(client.listAll(eq(Snapshot.class), any(), any()))\n .thenReturn(List.of());\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(SinglePage.class);\n singlePageReconciler.reconcile(new Reconciler.Request(name));\n\n verify(client, times(3)).update(captor.capture());\n SinglePage value = captor.getValue();\n assertThat(value.getStatus().getLastModifyTime()).isNull();\n }\n }\n\n public static SinglePage pageV1() {\n SinglePage page = new SinglePage();\n page.setKind(Post.KIND);\n\n page.setApiVersion(\"content.halo.run/v1alpha1\");\n Metadata metadata = new Metadata();\n metadata.setName(\"page-A\");\n page.setMetadata(metadata);\n\n SinglePage.SinglePageSpec spec = new SinglePage.SinglePageSpec();\n page.setSpec(spec);\n\n spec.setTitle(\"page-A\");\n spec.setSlug(\"page-slug\");\n spec.setBaseSnapshot(snapshotV1().getMetadata().getName());\n spec.setHeadSnapshot(\"base-snapshot\");\n spec.setReleaseSnapshot(null);\n\n return page;\n }\n\n\n @Test\n void subscribeNewCommentNotificationTest() {\n var page = pageV1();\n\n singlePageReconciler.subscribeNewCommentNotification(page);\n\n verify(notificationCenter).subscribe(\n assertArg(subscriber -> assertThat(subscriber.getName())\n .isEqualTo(page.getSpec().getOwner())),\n assertArg(argReason -> {\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(NotificationReasonConst.NEW_COMMENT_ON_PAGE);\n interestReason.setExpression(\"props.pageOwner == 'null'\");\n assertThat(argReason).isEqualTo(interestReason);\n }));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/SystemConfigReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport run.halo.app.core.extension.content.Constant;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.SystemConfigChangedEvent;\nimport run.halo.app.infra.SystemSetting;\n\n@ExtendWith(MockitoExtension.class)\nclass SystemConfigReconcilerTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n ApplicationEventPublisher eventPublisher;\n\n @InjectMocks\n SystemConfigReconciler reconciler;\n\n ConfigMap systemConfigMap;\n ConfigMap defaultConfigMap;\n\n @BeforeEach\n void setUp() {\n systemConfigMap = createConfigMap(SystemSetting.SYSTEM_CONFIG);\n defaultConfigMap = createConfigMap(SystemSetting.SYSTEM_CONFIG_DEFAULT);\n }\n\n @Test\n void reconcileShouldDoNothingWhenConfigMapNotFound() {\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.empty());\n\n reconciler.reconcile(request);\n\n verify(client, never()).update(any(ConfigMap.class));\n verify(eventPublisher, never()).publishEvent(any());\n }\n\n @Test\n void reconcileShouldDoNothingWhenConfigMapIsDeleted() {\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n systemConfigMap.getMetadata().setDeletionTimestamp(Instant.now());\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n\n reconciler.reconcile(request);\n\n verify(client, never()).update(any(ConfigMap.class));\n verify(eventPublisher, never()).publishEvent(any());\n }\n\n @Test\n void reconcileShouldThrowExceptionForNonSystemConfig() {\n var request = new Reconciler.Request(\"other-config\");\n\n assertThrows(IllegalStateException.class, () -> reconciler.reconcile(request));\n }\n\n @Test\n void reconcileShouldUpdateChecksumAndPublishEventWhenDataChanges() {\n var data = Map.of(\"key1\", \"value1\", \"key2\", \"value2\");\n systemConfigMap.setData(data);\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Optional.of(defaultConfigMap));\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n // Verify checksum annotation was added\n verify(client, times(1)).update(argThat(configMap -> {\n var annotations = configMap.getMetadata().getAnnotations();\n return annotations != null\n && annotations.containsKey(Constant.CHECKSUM_CONFIG_ANNO)\n && annotations.containsKey(\"halo.run/data-snapshot\");\n }));\n\n // Verify event was published\n ArgumentCaptor eventCaptor =\n ArgumentCaptor.forClass(SystemConfigChangedEvent.class);\n verify(eventPublisher, times(1)).publishEvent(eventCaptor.capture());\n\n var event = eventCaptor.getValue();\n assertThat(event.getNewData()).isEqualTo(data);\n }\n\n @Test\n void reconcileShouldNotUpdateWhenChecksumUnchanged() {\n var data = Map.of(\"key1\", \"value1\");\n systemConfigMap.setData(data);\n\n // Pre-set checksum to match current data - sha256 of data.toString()\n var existingChecksum = com.google.common.hash.Hashing.sha256()\n .hashString(systemConfigMap.getData().toString(),\n java.nio.charset.StandardCharsets.UTF_8)\n .toString();\n systemConfigMap.getMetadata().getAnnotations()\n .put(Constant.CHECKSUM_CONFIG_ANNO, existingChecksum);\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n verify(client, never()).update(any(ConfigMap.class));\n verify(eventPublisher, never()).publishEvent(any());\n }\n\n @Test\n void reconcileShouldHandleNullData() {\n systemConfigMap.setData(null);\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Optional.of(defaultConfigMap));\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n // Should still update with checksum\n verify(client, times(1)).update(any(ConfigMap.class));\n verify(eventPublisher, times(1)).publishEvent(any(SystemConfigChangedEvent.class));\n }\n\n @Test\n void reconcileShouldMergeWithDefaultConfig() {\n var userData = Map.of(\"user.key\", \"user-value\");\n var defaultData = Map.of(\"default.key\", \"default-value\");\n\n systemConfigMap.setData(userData);\n defaultConfigMap.setData(defaultData);\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Optional.of(defaultConfigMap));\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n ArgumentCaptor eventCaptor =\n ArgumentCaptor.forClass(SystemConfigChangedEvent.class);\n verify(eventPublisher, times(1)).publishEvent(eventCaptor.capture());\n\n var event = eventCaptor.getValue();\n // New data should contain user data\n assertThat(event.getNewData()).containsEntry(\"user.key\", \"user-value\");\n }\n\n @Test\n void reconcileShouldHandleEmptyData() {\n systemConfigMap.setData(Map.of());\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Optional.of(defaultConfigMap));\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n verify(client, times(1)).update(any(ConfigMap.class));\n verify(eventPublisher, times(1)).publishEvent(any(SystemConfigChangedEvent.class));\n }\n\n @Test\n void reconcileShouldPreserveDataSnapshotForComparison() {\n var oldData = Map.of(\"key1\", \"old-value\");\n var newData = Map.of(\"key1\", \"new-value\");\n\n // Set initial data and snapshot\n systemConfigMap.setData(oldData);\n systemConfigMap.getMetadata().getAnnotations()\n .put(\"halo.run/data-snapshot\", \"{\\\"key1\\\":\\\"old-value\\\"}\");\n\n // Update to new data\n systemConfigMap.setData(newData);\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Optional.of(defaultConfigMap));\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n ArgumentCaptor eventCaptor =\n ArgumentCaptor.forClass(SystemConfigChangedEvent.class);\n verify(eventPublisher, times(1)).publishEvent(eventCaptor.capture());\n\n var event = eventCaptor.getValue();\n assertThat(event.getOldData()).containsEntry(\"key1\", \"old-value\");\n assertThat(event.getNewData()).containsEntry(\"key1\", \"new-value\");\n }\n\n @Test\n void reconcileShouldHandleNoDefaultConfig() {\n var data = Map.of(\"key1\", \"value1\");\n systemConfigMap.setData(data);\n\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Optional.of(systemConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Optional.empty());\n\n var request = new Reconciler.Request(SystemSetting.SYSTEM_CONFIG);\n reconciler.reconcile(request);\n\n verify(client, times(1)).update(any(ConfigMap.class));\n\n ArgumentCaptor eventCaptor =\n ArgumentCaptor.forClass(SystemConfigChangedEvent.class);\n verify(eventPublisher, times(1)).publishEvent(eventCaptor.capture());\n\n var event = eventCaptor.getValue();\n assertThat(event.getNewData()).isEqualTo(data);\n }\n\n private ConfigMap createConfigMap(String name) {\n var configMap = new ConfigMap();\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setAnnotations(new HashMap<>());\n configMap.setMetadata(metadata);\n configMap.setData(new HashMap<>());\n return configMap;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/TagReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.content.permalinks.TagPermalinkPolicy;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.core.reconciler.TagReconciler;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\n\n/**\n * Tests for {@link TagReconciler}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass TagReconcilerTest {\n @Mock\n private ExtensionClient client;\n\n @Mock\n private TagPermalinkPolicy tagPermalinkPolicy;\n\n @InjectMocks\n private TagReconciler tagReconciler;\n\n @Test\n void reconcile() {\n Tag tag = tag();\n when(client.fetch(eq(Tag.class), eq(\"fake-tag\")))\n .thenReturn(Optional.of(tag));\n when(tagPermalinkPolicy.permalink(any()))\n .thenAnswer(arg -> \"/tags/\" + tag.getSpec().getSlug());\n ArgumentCaptor captor = ArgumentCaptor.forClass(Tag.class);\n\n tagReconciler.reconcile(new TagReconciler.Request(\"fake-tag\"));\n\n verify(client).update(captor.capture());\n Tag capture = captor.getValue();\n assertThat(capture.getStatus().getPermalink()).isEqualTo(\"/tags/fake-slug\");\n\n // change slug\n tag.getSpec().setSlug(\"new-slug\");\n tagReconciler.reconcile(new TagReconciler.Request(\"fake-tag\"));\n verify(client, times(2)).update(captor.capture());\n assertThat(capture.getStatus().getPermalink()).isEqualTo(\"/tags/new-slug\");\n }\n\n @Test\n void reconcileDelete() {\n Tag tag = tag();\n tag.getMetadata().setDeletionTimestamp(Instant.now());\n tag.getMetadata().setFinalizers(Set.of(TagReconciler.FINALIZER_NAME));\n when(client.fetch(eq(Tag.class), eq(\"fake-tag\")))\n .thenReturn(Optional.of(tag));\n ArgumentCaptor captor = ArgumentCaptor.forClass(Tag.class);\n\n tagReconciler.reconcile(new TagReconciler.Request(\"fake-tag\"));\n verify(client, times(1)).update(captor.capture());\n verify(tagPermalinkPolicy, times(0)).permalink(any());\n }\n\n Tag tag() {\n Tag tag = new Tag();\n tag.setMetadata(new Metadata());\n tag.getMetadata().setVersion(0L);\n tag.getMetadata().setName(\"fake-tag\");\n\n tag.setSpec(new Tag.TagSpec());\n tag.getSpec().setSlug(\"fake-slug\");\n\n tag.setStatus(new Tag.TagStatus());\n return tag;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/ThemeReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.AssertionsForClassTypes.assertThatThrownBy;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.io.File;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.mockito.stubbing.Answer;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.core.retry.RetryException;\nimport org.springframework.core.retry.RetryPolicy;\nimport org.springframework.core.retry.RetryTemplate;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.util.ResourceUtils;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.extension.controller.RequeueException;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.theme.TemplateEngineManager;\n\n/**\n * Tests for {@link ThemeReconciler}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ThemeReconcilerTest {\n\n @Mock\n private ExtensionClient extensionClient;\n\n @Mock\n private SystemVersionSupplier systemVersionSupplier;\n\n @Mock\n ThemeRootGetter themeRoot;\n\n @Mock\n private File defaultTheme;\n\n @Mock\n private TemplateEngineManager templateEngineManager;\n\n @Spy\n RetryTemplate retryTemplate = new RetryTemplate(RetryPolicy.builder()\n .maxRetries(1)\n .delay(Duration.ZERO)\n .predicate(IllegalStateException.class::isInstance)\n .build());\n\n @InjectMocks\n ThemeReconciler themeReconciler;\n\n @TempDir\n private Path tempDirectory;\n\n @BeforeEach\n void setUp() throws IOException {\n themeReconciler.setRetryTemplate(retryTemplate);\n defaultTheme = ResourceUtils.getFile(\"classpath:themes/default\");\n lenient().when(systemVersionSupplier.get()).thenReturn(Version.parse(\"0.0.0\"));\n lenient().when(templateEngineManager.clearCache(any())).thenReturn(Mono.empty());\n }\n\n @Test\n void reconcileDelete() throws IOException, RetryException {\n Path testWorkDir = tempDirectory.resolve(\"reconcile-delete\");\n Files.createDirectory(testWorkDir);\n when(themeRoot.get()).thenReturn(testWorkDir);\n\n Theme theme = new Theme();\n Metadata metadata = new Metadata();\n metadata.setName(\"theme-test\");\n metadata.setFinalizers(new HashSet<>());\n metadata.getFinalizers().add(\"theme-protection\");\n metadata.setDeletionTimestamp(Instant.now());\n theme.setMetadata(metadata);\n theme.setKind(Theme.KIND);\n theme.setApiVersion(\"theme.halo.run/v1alpha1\");\n Theme.ThemeSpec themeSpec = new Theme.ThemeSpec();\n themeSpec.setSettingName(\"theme-test-setting\");\n theme.setSpec(themeSpec);\n\n Path defaultThemePath = testWorkDir.resolve(\"theme-test\");\n\n // copy to temp directory\n FileSystemUtils.copyRecursively(defaultTheme.toPath(), defaultThemePath);\n\n assertThat(testWorkDir).isNotEmptyDirectory();\n assertThat(defaultThemePath).exists();\n\n when(extensionClient.fetch(eq(Theme.class), eq(metadata.getName())))\n .thenReturn(Optional.of(theme));\n when(extensionClient.fetch(Setting.class, themeSpec.getSettingName()))\n .thenReturn(Optional.empty());\n\n themeReconciler.reconcile(new Reconciler.Request(metadata.getName()));\n\n verify(extensionClient, times(1)).fetch(eq(Theme.class), eq(metadata.getName()));\n verify(extensionClient, times(2)).fetch(eq(Setting.class), eq(themeSpec.getSettingName()));\n\n verify(extensionClient, times(2)).list(eq(AnnotationSetting.class), any(), any());\n\n assertThat(Files.exists(testWorkDir)).isTrue();\n assertThat(Files.exists(defaultThemePath)).isFalse();\n }\n\n @Test\n void reconcileDeleteRetry() {\n var theme = fakeTheme();\n var metadata = theme.getMetadata();\n metadata.setDeletionTimestamp(Instant.now());\n metadata.setFinalizers(new HashSet<>());\n metadata.getFinalizers().add(\"theme-protection\");\n\n when(extensionClient.fetch(Theme.class, \"theme-test\")).thenReturn(Optional.of(theme));\n\n Path testWorkDir = tempDirectory.resolve(\"reconcile-delete\");\n when(themeRoot.get()).thenReturn(testWorkDir);\n\n final ThemeReconciler themeReconciler =\n new ThemeReconciler(extensionClient, themeRoot, systemVersionSupplier,\n templateEngineManager);\n\n final int[] retryFlags = {0, 0};\n when(extensionClient.fetch(eq(Setting.class), eq(\"theme-test-setting\")))\n .thenAnswer((Answer>) invocation -> {\n retryFlags[0]++;\n // retry 2 times\n if (retryFlags[0] < 3) {\n return Optional.of(new Setting());\n }\n return Optional.empty();\n });\n\n when(extensionClient.list(eq(AnnotationSetting.class), any(), eq(null)))\n .thenAnswer((Answer>) invocation -> {\n retryFlags[1]++;\n // retry 2 times\n if (retryFlags[1] < 3) {\n return List.of(new AnnotationSetting());\n }\n return List.of();\n });\n\n themeReconciler.reconcile(new Reconciler.Request(metadata.getName()));\n\n String settingName = theme.getSpec().getSettingName();\n verify(extensionClient, times(1)).fetch(eq(Theme.class), eq(metadata.getName()));\n verify(extensionClient, times(3)).fetch(eq(Setting.class), eq(settingName));\n verify(extensionClient, times(3)).list(eq(AnnotationSetting.class), any(), eq(null));\n verify(templateEngineManager).clearCache(eq(metadata.getName()));\n }\n\n @Test\n void reconcileDeleteRetryWhenThrowException() {\n var theme = fakeTheme();\n theme.getMetadata().setDeletionTimestamp(Instant.now());\n theme.getMetadata().setFinalizers(new HashSet<>());\n theme.getMetadata().getFinalizers().add(\"theme-protection\");\n\n when(extensionClient.fetch(Theme.class, \"theme-test\")).thenReturn(Optional.of(theme));\n\n when(extensionClient.fetch(Setting.class, \"theme-test-setting\"))\n .thenReturn(Optional.of(new Setting()));\n\n String settingName = theme.getSpec().getSettingName();\n assertThatThrownBy(\n () -> themeReconciler.reconcile(new Reconciler.Request(theme.getMetadata().getName())))\n .satisfies(t -> {\n var e = Exceptions.unwrap(t);\n assertThat(e).isInstanceOf(RetryException.class);\n });\n verify(extensionClient, times(3)).fetch(eq(Setting.class), eq(settingName));\n }\n\n @Test\n void shouldBeFailedIfVersionNotSatisfied() {\n when(systemVersionSupplier.get()).thenReturn(Version.parse(\"2.3.0\"));\n var testWorkDir = tempDirectory.resolve(\"reconcile-delete\");\n when(themeRoot.get()).thenReturn(testWorkDir);\n var theme = fakeTheme();\n theme.setStatus(null);\n theme.getSpec().setRequires(\">2.3.0\");\n theme.getSpec().setSettingName(null);\n when(extensionClient.fetch(Theme.class, \"theme-test\"))\n .thenReturn(Optional.of(theme));\n var themeReconciler = new ThemeReconciler(\n extensionClient, themeRoot, systemVersionSupplier, templateEngineManager\n );\n\n themeReconciler.reconcile(new Reconciler.Request(theme.getMetadata().getName()));\n\n var themeUpdateCaptor = ArgumentCaptor.forClass(Theme.class);\n verify(extensionClient).update(themeUpdateCaptor.capture());\n Theme value = themeUpdateCaptor.getValue();\n assertThat(value.getStatus()).isNotNull();\n assertThat(value.getStatus().getConditions().peekFirst().getType())\n .isEqualTo(Theme.ThemePhase.FAILED.name());\n assertThat(value.getStatus().getPhase())\n .isEqualTo(Theme.ThemePhase.FAILED);\n }\n\n @Test\n void shouldBeReadyIfVersionSatisfied() {\n when(systemVersionSupplier.get()).thenReturn(Version.parse(\"2.3.0\"));\n var testWorkDir = tempDirectory.resolve(\"reconcile-delete\");\n when(themeRoot.get()).thenReturn(testWorkDir);\n var theme = fakeTheme();\n theme.setStatus(null);\n theme.getSpec().setRequires(\">=2.3.0\");\n theme.getSpec().setSettingName(null);\n when(extensionClient.fetch(Theme.class, \"theme-test\"))\n .thenReturn(Optional.of(theme));\n var themeReconciler = new ThemeReconciler(\n extensionClient, themeRoot, systemVersionSupplier, templateEngineManager\n );\n var themeUpdateCaptor = ArgumentCaptor.forClass(Theme.class);\n themeReconciler.reconcile(new Reconciler.Request(theme.getMetadata().getName()));\n verify(extensionClient).update(themeUpdateCaptor.capture());\n assertThat(themeUpdateCaptor.getValue().getStatus().getPhase())\n .isEqualTo(Theme.ThemePhase.READY);\n }\n\n private Theme fakeTheme() {\n Theme theme = new Theme();\n Metadata metadata = new Metadata();\n metadata.setName(\"theme-test\");\n theme.setMetadata(metadata);\n theme.setKind(Theme.KIND);\n theme.setApiVersion(\"theme.halo.run/v1alpha1\");\n Theme.ThemeSpec themeSpec = new Theme.ThemeSpec();\n themeSpec.setSettingName(\"theme-test-setting\");\n theme.setSpec(themeSpec);\n return theme;\n }\n\n @Test\n void themeSettingDefaultValue() throws IOException, JSONException {\n Path testWorkDir = tempDirectory.resolve(\"reconcile-setting-value\");\n Files.createDirectory(testWorkDir);\n when(themeRoot.get()).thenReturn(testWorkDir);\n\n Theme theme = new Theme();\n Metadata metadata = new Metadata();\n metadata.setName(\"theme-test\");\n theme.setMetadata(metadata);\n theme.setKind(Theme.KIND);\n theme.setApiVersion(\"theme.halo.run/v1alpha1\");\n Theme.ThemeSpec themeSpec = new Theme.ThemeSpec();\n themeSpec.setSettingName(null);\n theme.setSpec(themeSpec);\n\n when(extensionClient.fetch(eq(Theme.class), eq(metadata.getName())))\n .thenReturn(Optional.of(theme));\n var reconcile = themeReconciler.reconcile(new Reconciler.Request(metadata.getName()));\n assertThat(reconcile.reEnqueue()).isFalse();\n verify(extensionClient, times(1)).fetch(eq(Theme.class), eq(metadata.getName()));\n\n // setting exists\n themeSpec.setSettingName(\"theme-test-setting\");\n assertThat(theme.getSpec().getConfigMapName()).isNull();\n ArgumentCaptor captor = ArgumentCaptor.forClass(Theme.class);\n Assertions.assertThrows(RequeueException.class,\n () -> themeReconciler.reconcile(new Reconciler.Request(metadata.getName()))\n );\n verify(extensionClient, times(2)).fetch(eq(Theme.class), eq(metadata.getName()));\n verify(extensionClient).update(captor.capture());\n Theme value = captor.getValue();\n assertThat(value.getSpec().getConfigMapName()).isNotNull();\n\n // populate setting name and configMap name and configMap not exists\n themeSpec.setSettingName(\"theme-test-setting\");\n themeSpec.setConfigMapName(\"theme-test-configmap\");\n when(extensionClient.fetch(eq(ConfigMap.class), any()))\n .thenReturn(Optional.empty());\n when(extensionClient.fetch(eq(Setting.class), eq(themeSpec.getSettingName())))\n .thenReturn(Optional.of(getFakeSetting()));\n themeReconciler.reconcile(new Reconciler.Request(metadata.getName()));\n verify(extensionClient, times(2))\n .fetch(eq(Setting.class), eq(themeSpec.getSettingName()));\n ArgumentCaptor configMapCaptor = ArgumentCaptor.forClass(ConfigMap.class);\n verify(extensionClient, times(1)).create(any(ConfigMap.class));\n verify(extensionClient, times(1)).create(configMapCaptor.capture());\n ConfigMap defaultValueConfigMap = configMapCaptor.getValue();\n Map data = defaultValueConfigMap.getData();\n JSONAssert.assertEquals(\"\"\"\n {\n \"sns\": \"{\\\\\"email\\\\\":\\\\\"example@exmple.com\\\\\"}\"\n }\n \"\"\",\n JsonUtils.objectToJson(data),\n true);\n }\n\n private static Setting getFakeSetting() {\n String settingJson = \"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Setting\",\n \"metadata\": {\n \"name\": \"theme-default-setting\"\n },\n \"spec\": {\n \"forms\": [{\n \"formSchema\": [\n {\n \"$el\": \"h1\",\n \"children\": \"Register\"\n },\n {\n \"$formkit\": \"text\",\n \"label\": \"Email\",\n \"name\": \"email\",\n \"value\": \"example@exmple.com\"\n },\n {\n \"$formkit\": \"password\",\n \"label\": \"Password\",\n \"name\": \"password\",\n \"validation\": \"required|length:5,16\",\n \"value\": null\n }\n ],\n \"group\": \"sns\",\n \"label\": \"社交资料\"\n }]\n }\n }\n \"\"\";\n return JsonUtils.jsonToObject(settingJson, Setting.class);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/reconciler/UserReconcilerTest.java", "content": "package run.halo.app.core.reconciler;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.reconciler.UserReconciler;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.notification.NotificationCenter;\n\n/**\n * Tests for {@link UserReconciler}.\n *\n * @author guqing\n * @since 2.0.1\n */\n@ExtendWith(MockitoExtension.class)\nclass UserReconcilerTest {\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n private ExtensionClient client;\n\n @Mock\n private NotificationCenter notificationCenter;\n\n @Mock\n private RoleService roleService;\n\n @InjectMocks\n private UserReconciler userReconciler;\n\n @BeforeEach\n void setUp() {\n lenient().when(notificationCenter.unsubscribe(any(), any())).thenReturn(Mono.empty());\n }\n\n @Test\n void permalinkForFakeUser() throws URISyntaxException {\n when(externalUrlSupplier.get()).thenReturn(new URI(\"http://localhost:8090\"));\n\n when(roleService.getRolesByUsername(\"fake-user\"))\n .thenReturn(Flux.empty());\n\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Optional.of(user(\"fake-user\")));\n userReconciler.reconcile(new Reconciler.Request(\"fake-user\"));\n\n verify(client).update(assertArg(user ->\n assertEquals(\n \"http://localhost:8090/authors/fake-user\",\n user.getStatus().getPermalink()\n )\n ));\n }\n\n @Test\n void permalinkForAnonymousUser() {\n when(client.fetch(eq(User.class), eq(AnonymousUserConst.PRINCIPAL)))\n .thenReturn(Optional.of(user(AnonymousUserConst.PRINCIPAL)));\n when(roleService.getRolesByUsername(AnonymousUserConst.PRINCIPAL)).thenReturn(Flux.empty());\n userReconciler.reconcile(new Reconciler.Request(AnonymousUserConst.PRINCIPAL));\n verify(client).update(any(User.class));\n }\n\n @Test\n void ensureRoleNamesAnno() {\n when(roleService.getRolesByUsername(\"fake-user\")).thenReturn(Flux.just(\"fake-role\"));\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Optional.of(user(\"fake-user\")));\n when(externalUrlSupplier.get()).thenReturn(URI.create(\"/\"));\n\n userReconciler.reconcile(new Reconciler.Request(\"fake-user\"));\n\n verify(client).update(assertArg(user -> {\n assertEquals(\"\"\"\n [\"fake-role\"]\\\n \"\"\",\n user.getMetadata().getAnnotations().get(User.ROLE_NAMES_ANNO));\n }));\n }\n\n User user(String name) {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(name);\n user.getMetadata().setFinalizers(Set.of(\"user-protection\"));\n user.setSpec(new User.UserSpec());\n return user;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/user/service/DefaultRoleServiceTest.java", "content": "package run.halo.app.core.user.service;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.eq;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Collection;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.function.Predicate;\nimport java.util.stream.Stream;\nimport org.assertj.core.api.AssertionsForInterfaceTypes;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.user.service.DefaultRoleService;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link DefaultRoleService}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultRoleServiceTest {\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private DefaultRoleService roleService;\n\n @ParameterizedTest\n @MethodSource(\"usernamesProvider\")\n void shouldReturnEmptyMapIfNoUsernamesProvided(Collection usernames) {\n roleService.getRolesByUsernames(usernames)\n .as(StepVerifier::create)\n .expectNext(Map.of())\n .verifyComplete();\n }\n\n static Stream> usernamesProvider() {\n return Stream.of(null, List.of(), Set.of());\n }\n\n @Nested\n class ListDependenciesTest {\n @Test\n void listDependencies() {\n // prepare test data\n var role1 = createRole(\"role1\", \"role2\");\n var role2 = createRole(\"role2\", \"role3\");\n var role3 = createRole(\"role3\");\n\n var roleNames = Set.of(\"role1\");\n\n\n when(client.listAll(same(Role.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(role1))\n .thenReturn(Flux.just(role2))\n .thenReturn(Flux.just(role3))\n .thenReturn(Flux.empty());\n\n // call the method under test\n var result = roleService.listDependenciesFlux(roleNames);\n\n // verify the result\n StepVerifier.create(result)\n .expectNext(role1)\n .expectNext(role2)\n .expectNext(role3)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, times(4)).listAll(\n same(Role.class),\n any(ListOptions.class),\n any(Sort.class)\n );\n }\n\n @Test\n void listDependenciesWithCycle() {\n // prepare test data\n var role1 = createRole(\"role1\", \"role2\");\n var role2 = createRole(\"role2\", \"role3\");\n var role3 = createRole(\"role3\", \"role1\");\n\n var roleNames = Set.of(\"role1\");\n\n // setup mocks\n when(client.listAll(same(Role.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(role1))\n .thenReturn(Flux.just(role2))\n .thenReturn(Flux.just(role3))\n .thenReturn(Flux.empty());\n\n // call the method under test\n var result = roleService.listDependenciesFlux(roleNames);\n\n // verify the result\n StepVerifier.create(result)\n .expectNext(role1)\n .expectNext(role2)\n .expectNext(role3)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, times(4)).listAll(\n same(Role.class),\n any(ListOptions.class),\n any(Sort.class)\n );\n }\n\n @Test\n void listDependenciesWithMiddleCycle() {\n // prepare test data\n // role1 -> role2 -> role3 -> role4\n // \\<-----|\n var role1 = createRole(\"role1\", \"role2\");\n var role2 = createRole(\"role2\", \"role3\");\n var role3 = createRole(\"role3\", \"role2\", \"role4\");\n var role4 = createRole(\"role4\");\n\n var roleNames = Set.of(\"role1\");\n\n when(client.listAll(same(Role.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(role1))\n .thenReturn(Flux.just(role2))\n .thenReturn(Flux.just(role3))\n .thenReturn(Flux.just(role4))\n .thenReturn(Flux.empty());\n\n // call the method under test\n var result = roleService.listDependenciesFlux(roleNames);\n\n // verify the result\n StepVerifier.create(result)\n .expectNext(role1)\n .expectNext(role2)\n .expectNext(role3)\n .expectNext(role4)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, times(5)).listAll(\n same(Role.class),\n any(ListOptions.class),\n any(Sort.class)\n );\n }\n\n @Test\n void listDependenciesWithCycleAndSequence() {\n // prepare test data\n // role1 -> role2 -> role3\n // \\->role4 \\<-----|\n Role role1 = createRole(\"role1\", \"role4\", \"role2\");\n Role role2 = createRole(\"role2\", \"role3\");\n Role role3 = createRole(\"role3\", \"role2\");\n Role role4 = createRole(\"role4\");\n\n Set roleNames = Set.of(\"role1\");\n\n when(client.listAll(same(Role.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(role1))\n .thenReturn(Flux.just(role4, role2))\n .thenReturn(Flux.just(role3))\n .thenReturn(Flux.empty());\n\n // call the method under test\n var result = roleService.listDependenciesFlux(roleNames);\n\n // verify the result\n StepVerifier.create(result)\n .expectNext(role1)\n .expectNext(role4)\n .expectNext(role2)\n .expectNext(role3)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, times(4)).listAll(same(Role.class), any(), any());\n }\n\n @Test\n void listDependenciesAfterCycle() {\n // prepare test data\n // role1 -> role2 -> role3\n // \\->role4 \\<-----|\n Role role1 = createRole(\"role1\", \"role4\", \"role2\");\n Role role2 = createRole(\"role2\", \"role3\");\n Role role3 = createRole(\"role3\", \"role2\");\n Role role4 = createRole(\"role4\");\n\n Set roleNames = Set.of(\"role2\");\n\n when(client.listAll(same(Role.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(role2))\n .thenReturn(Flux.just(role3))\n .thenReturn(Flux.empty());\n\n // call the method under test\n var result = roleService.listDependenciesFlux(roleNames);\n\n // verify the result\n StepVerifier.create(result)\n .expectNext(role2)\n .expectNext(role3)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, times(3)).listAll(\n same(Role.class),\n any(ListOptions.class),\n any(Sort.class)\n );\n }\n\n @Test\n void listDependenciesWithNullParam() {\n var result = roleService.listDependenciesFlux(null);\n\n // verify the result\n StepVerifier.create(result)\n .verifyComplete();\n\n result = roleService.listDependenciesFlux(Set.of());\n StepVerifier.create(result)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, never()).listAll(\n eq(Role.class),\n any(ListOptions.class),\n any(Sort.class)\n );\n }\n\n @Test\n void listDependenciesAndSomeOneNotFound() {\n var role1 = createRole(\"role1\", \"role2\");\n var role2 = createRole(\"role2\", \"role3\", \"role4\");\n var role4 = createRole(\"role4\");\n\n var roleNames = Set.of(\"role1\");\n\n when(client.listAll(same(Role.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(role1))\n .thenReturn(Flux.just(role2))\n .thenReturn(Flux.just(role4))\n .thenReturn(Flux.empty())\n ;\n\n var result = roleService.listDependenciesFlux(roleNames);\n // verify the result\n StepVerifier.create(result)\n .expectNext(role1)\n .expectNext(role2)\n .expectNext(role4)\n .verifyComplete();\n\n // verify the mock invocations\n verify(client, times(4)).listAll(\n same(Role.class),\n any(ListOptions.class),\n any(Sort.class)\n );\n }\n\n @Test\n void testSubjectMatch() {\n RoleBinding fakeAuthenticatedBinding =\n createRoleBinding(\"authenticated-fake-binding\", \"fake\", \"authenticated\");\n RoleBinding fakeEditorBinding =\n createRoleBinding(\"editor-fake-binding\", \"fake\", \"editor\");\n RoleBinding fakeAnonymousBinding =\n createRoleBinding(\"test-anonymous-binding\", \"test\", \"anonymous\");\n\n RoleBinding.Subject subject = new RoleBinding.Subject();\n subject.setName(\"authenticated\");\n subject.setKind(Role.KIND);\n subject.setApiGroup(Role.GROUP);\n\n Predicate predicate = roleService.getRoleBindingPredicate(subject);\n List result =\n Stream.of(fakeAuthenticatedBinding, fakeEditorBinding, fakeAnonymousBinding)\n .filter(predicate)\n .toList();\n AssertionsForInterfaceTypes.assertThat(result)\n .containsExactly(fakeAuthenticatedBinding);\n\n subject.setName(\"editor\");\n predicate = roleService.getRoleBindingPredicate(subject);\n result =\n Stream.of(fakeAuthenticatedBinding, fakeEditorBinding, fakeAnonymousBinding)\n .filter(predicate)\n .toList();\n AssertionsForInterfaceTypes.assertThat(result).containsExactly(fakeEditorBinding);\n }\n\n RoleBinding createRoleBinding(String name, String refName, String subjectName) {\n RoleBinding roleBinding = new RoleBinding();\n roleBinding.setMetadata(new Metadata());\n roleBinding.getMetadata().setName(name);\n roleBinding.setRoleRef(new RoleBinding.RoleRef());\n roleBinding.getRoleRef().setKind(Role.KIND);\n roleBinding.getRoleRef().setApiGroup(Role.GROUP);\n roleBinding.getRoleRef().setName(refName);\n roleBinding.setSubjects(List.of(new RoleBinding.Subject()));\n roleBinding.getSubjects().get(0).setKind(Role.KIND);\n roleBinding.getSubjects().get(0).setName(subjectName);\n roleBinding.getSubjects().get(0).setApiGroup(Role.GROUP);\n return roleBinding;\n }\n\n private Role createRole(String name, String... dependencies) {\n Role role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(name);\n\n Map annotations = new HashMap<>();\n annotations.put(Role.ROLE_DEPENDENCIES_ANNO, JsonUtils.objectToJson(dependencies));\n role.getMetadata().setAnnotations(annotations);\n return role;\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/core/user/service/impl/EmailPasswordRecoveryServiceImplTest.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.junit.jupiter.MockitoExtension;\n\n/**\n * Tests for {@link EmailPasswordRecoveryServiceImpl}.\n *\n * @author guqing\n * @since 2.11.0\n */\n@ExtendWith(MockitoExtension.class)\nclass EmailPasswordRecoveryServiceImplTest {\n\n}" }, { "path": "application/src/test/java/run/halo/app/core/user/service/impl/EmailVerificationServiceImplTest.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static run.halo.app.core.user.service.impl.EmailVerificationServiceImpl.MAX_ATTEMPTS;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.core.user.service.impl.EmailVerificationServiceImpl.EmailVerificationManager.UsernameEmail;\nimport run.halo.app.infra.exception.EmailVerificationFailed;\n\n/**\n * Tests for {@link EmailVerificationServiceImpl}.\n *\n * @author guqing\n * @since 2.11.0\n */\n@ExtendWith(MockitoExtension.class)\nclass EmailVerificationServiceImplTest {\n\n @Nested\n class EmailVerificationManagerTest {\n\n @Test\n public void generateCodeTest() {\n var emailVerificationManager =\n new EmailVerificationServiceImpl.EmailVerificationManager();\n emailVerificationManager.generateCode(\"fake-user\", \"fake-email\");\n var result = emailVerificationManager.contains(\"fake-user\", \"fake-email\");\n assertThat(result).isTrue();\n\n emailVerificationManager.generateCode(\"guqing\", \"hi@halo.run\");\n result = emailVerificationManager.contains(\"guqing\", \"hi@halo.run\");\n assertThat(result).isTrue();\n\n result = emailVerificationManager.contains(\"123\", \"123\");\n assertThat(result).isFalse();\n }\n\n @Test\n public void removeTest() {\n var emailVerificationManager =\n new EmailVerificationServiceImpl.EmailVerificationManager();\n emailVerificationManager.generateCode(\"fake-user\", \"fake-email\");\n var result = emailVerificationManager.contains(\"fake-user\", \"fake-email\");\n emailVerificationManager.removeCode(\"fake-user\", \"fake-email\");\n result = emailVerificationManager.contains(\"fake-user\", \"fake-email\");\n assertThat(result).isFalse();\n }\n\n @Test\n void verifyCodeTestNormal() {\n String username = \"guqing\";\n String email = \"hi@halo.run\";\n var emailVerificationManager =\n new EmailVerificationServiceImpl.EmailVerificationManager();\n var result = emailVerificationManager.verifyCode(username, email, \"fake-code\");\n assertThat(result).isFalse();\n\n var code = emailVerificationManager.generateCode(username, email);\n result = emailVerificationManager.verifyCode(username, email, \"fake-code\");\n assertThat(result).isFalse();\n\n result = emailVerificationManager.verifyCode(username, email, code);\n assertThat(result).isTrue();\n }\n\n @Test\n void verifyCodeFailedAfterMaxAttempts() {\n String username = \"guqing\";\n String email = \"example@example.com\";\n var emailVerificationManager =\n new EmailVerificationServiceImpl.EmailVerificationManager();\n var code = emailVerificationManager.generateCode(username, email);\n for (int i = 0; i <= MAX_ATTEMPTS; i++) {\n var result = emailVerificationManager.verifyCode(username, email, \"fake-code\");\n assertThat(result).isFalse();\n }\n\n assertThatThrownBy(() -> emailVerificationManager.verifyCode(username, email, code))\n .isInstanceOf(EmailVerificationFailed.class)\n .hasMessage(\"400 BAD_REQUEST \\\"Too many attempts. Please try again later.\\\"\");\n }\n }\n\n @Test\n void shouldBeEqualUsernameEmailWithDifferentCase() {\n var expected = new UsernameEmail(\"faker\", \"a@b.com\");\n var got = new UsernameEmail(\"faker\", \"A@B.com\");\n assertEquals(expected, got);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/core/user/service/impl/UserServiceImplTest.java", "content": "package run.halo.app.core.user.service.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anySet;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.extension.GroupVersionKind.fromExtension;\n\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.DisplayName;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.security.core.session.ReactiveSessionInformation;\nimport org.springframework.security.core.session.ReactiveSessionRegistry;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport org.springframework.transaction.ReactiveTransaction;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.RoleBinding;\nimport run.halo.app.core.extension.RoleBinding.Subject;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.user.service.EmailVerificationService;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.SignUpData;\nimport run.halo.app.core.user.service.UserPostCreatingHandler;\nimport run.halo.app.core.user.service.UserPreCreatingHandler;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.event.user.PasswordChangedEvent;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.exception.DuplicateNameException;\nimport run.halo.app.infra.exception.EmailAlreadyTakenException;\nimport run.halo.app.infra.exception.UnsatisfiedAttributeValueException;\nimport run.halo.app.infra.exception.UserNotFoundException;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@ExtendWith(MockitoExtension.class)\nclass UserServiceImplTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n SystemConfigFetcher environmentFetcher;\n\n @Mock\n PasswordEncoder passwordEncoder;\n\n @Mock\n ApplicationEventPublisher eventPublisher;\n\n @Mock\n RoleService roleService;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @Mock\n EmailVerificationService emailVerificationService;\n\n @Mock\n ReactiveTransactionManager txManager;\n\n @Mock\n ReactiveSessionRegistry sessionRegistry;\n\n @InjectMocks\n UserServiceImpl userService;\n\n @Test\n void shouldThrowExceptionIfUserNotFoundInExtension() {\n when(client.get(eq(User.class), eq(\"faker\"))).thenReturn(\n Mono.error(new ExtensionNotFoundException(fromExtension(User.class), \"faker\")));\n StepVerifier.create(userService.getUser(\"faker\"))\n .verifyError(UserNotFoundException.class);\n\n verify(client, times(1)).get(eq(User.class), eq(\"faker\"));\n }\n\n @Test\n void shouldGetUserIfUserFoundInExtension() {\n User fakeUser = new User();\n when(client.get(User.class, \"faker\")).thenReturn(Mono.just(fakeUser));\n\n StepVerifier.create(userService.getUser(\"faker\"))\n .assertNext(user -> assertEquals(fakeUser, user))\n .verifyComplete();\n\n verify(client, times(1)).get(eq(User.class), eq(\"faker\"));\n }\n\n @Test\n void shouldFindUserByVerifiedEmail() {\n var fakeUser = createUser(\"fake-user\", \"fake-password\");\n when(client.listAll(eq(User.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(fakeUser));\n userService.findUserByVerifiedEmail(\"faker@halo.run\")\n .as(StepVerifier::create)\n .expectNext(fakeUser)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnEmptyIfNoUserWithVerifiedEmail() {\n when(client.listAll(eq(User.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.empty());\n userService.findUserByVerifiedEmail(\"faker@halo.run\")\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void shouldGetGhostsIfUsersContainDeleted() {\n var fakeUser1 = createUser(\"fake-user1\", \"fake-password\");\n var fakeUser2 = createUser(\"fake-user2\", \"fake-password\");\n var ghost = createUser(UserService.GHOST_USER_NAME, \"fake-password\");\n when(client.listAll(eq(User.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(fakeUser1, fakeUser2, ghost));\n userService.getUsersOrGhosts(List.of(\"fake-user1\", \"deleted-user\", \"fake-user2\"))\n .as(StepVerifier::create)\n .expectNext(fakeUser1, ghost, fakeUser2)\n .verifyComplete();\n }\n\n @Test\n void shouldUpdatePasswordIfUserFoundInExtension() {\n var fakeUser = new User();\n fakeUser.setSpec(new User.UserSpec());\n\n when(client.get(User.class, \"faker\")).thenReturn(Mono.just(fakeUser));\n when(client.update(eq(fakeUser))).thenReturn(Mono.just(fakeUser));\n\n StepVerifier.create(userService.updatePassword(\"faker\", \"new-fake-password\"))\n .expectNext(fakeUser)\n .verifyComplete();\n\n verify(client, times(1)).get(eq(User.class), eq(\"faker\"));\n verify(client, times(1)).update(argThat(extension -> {\n var user = (User) extension;\n return \"new-fake-password\".equals(user.getSpec().getPassword());\n }));\n\n verify(eventPublisher).publishEvent(any(PasswordChangedEvent.class));\n }\n\n @Nested\n @DisplayName(\"UpdateWithRawPassword\")\n class UpdateWithRawPasswordTest {\n\n @Test\n void shouldUpdatePasswordWithDifferentPassword() {\n var oldUser = createUser(\"fake@password\");\n var newUser = createUser(\"new@password\");\n\n when(client.get(User.class, \"fake-user\")).thenReturn(\n Mono.just(oldUser));\n when(client.update(eq(oldUser))).thenReturn(Mono.just(newUser));\n when(passwordEncoder.matches(\"new@password\", \"fake@password\")).thenReturn(false);\n when(passwordEncoder.encode(\"new@password\")).thenReturn(\"encoded@new@password\");\n\n StepVerifier.create(userService.updateWithRawPassword(\"fake-user\", \"new@password\"))\n .expectNext(newUser)\n .verifyComplete();\n\n verify(passwordEncoder).matches(\"new@password\", \"fake@password\");\n verify(passwordEncoder).encode(\"new@password\");\n verify(client).get(User.class, \"fake-user\");\n verify(client).update(argThat(extension -> {\n var user = (User) extension;\n return \"encoded@new@password\".equals(user.getSpec().getPassword());\n }));\n verify(eventPublisher).publishEvent(any(PasswordChangedEvent.class));\n }\n\n @Test\n void shouldUpdatePasswordIfNoPasswordBefore() {\n var oldUser = createUser(null);\n var newUser = createUser(\"new@password\");\n\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(oldUser));\n when(client.update(oldUser)).thenReturn(Mono.just(newUser));\n when(passwordEncoder.encode(\"new@password\")).thenReturn(\"encoded@new@password\");\n\n StepVerifier.create(userService.updateWithRawPassword(\"fake-user\", \"new@password\"))\n .expectNext(newUser)\n .verifyComplete();\n\n verify(passwordEncoder, never()).matches(\"new@password\", null);\n verify(passwordEncoder).encode(\"new@password\");\n verify(client).update(argThat(extension -> {\n var user = (User) extension;\n return \"encoded@new@password\".equals(user.getSpec().getPassword());\n }));\n verify(client).get(User.class, \"fake-user\");\n verify(eventPublisher).publishEvent(any(PasswordChangedEvent.class));\n }\n\n @Test\n void shouldDoNothingIfPasswordNotChanged() {\n userService = spy(userService);\n\n var oldUser = createUser(\"fake@password\");\n var newUser = createUser(\"new@password\");\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(oldUser));\n when(passwordEncoder.matches(\"fake@password\", \"fake@password\")).thenReturn(true);\n\n StepVerifier.create(userService.updateWithRawPassword(\"fake-user\", \"fake@password\"))\n .expectNextCount(0)\n .verifyComplete();\n\n verify(passwordEncoder, times(1)).matches(\"fake@password\", \"fake@password\");\n verify(passwordEncoder, never()).encode(any());\n verify(client, never()).update(any());\n verify(client).get(User.class, \"fake-user\");\n verify(eventPublisher, times(0)).publishEvent(any(PasswordChangedEvent.class));\n }\n\n @Test\n void shouldThrowExceptionIfUserNotFound() {\n when(client.get(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Mono.error(\n new ExtensionNotFoundException(fromExtension(User.class), \"fake-user\")));\n\n StepVerifier.create(userService.updateWithRawPassword(\"fake-user\", \"new@password\"))\n .verifyError(UserNotFoundException.class);\n\n verify(passwordEncoder, never()).matches(anyString(), anyString());\n verify(passwordEncoder, never()).encode(anyString());\n verify(client, never()).update(any());\n verify(client).get(User.class, \"fake-user\");\n }\n\n @Test\n void shouldThrowWhenPwdContainsInvalidChars() {\n StepVerifier.create(userService.updateWithRawPassword(\"fake-user\", \"new-password\"))\n .expectError(UnsatisfiedAttributeValueException.class)\n .verify();\n\n verify(passwordEncoder, never()).encode(anyString());\n verify(client, never()).update(any());\n }\n\n }\n\n User createUser(String username, String password) {\n var user = new User();\n Metadata metadata = new Metadata();\n metadata.setName(username);\n user.setMetadata(metadata);\n user.setSpec(new User.UserSpec());\n user.getSpec().setPassword(password);\n return user;\n }\n\n User createUser(String password) {\n return createUser(\"fake-user\", password);\n }\n\n @Nested\n class GrantRolesTest {\n\n @BeforeEach\n void setUp() {\n var tx = mock(ReactiveTransaction.class);\n\n when(txManager.getReactiveTransaction(any()))\n .thenReturn(Mono.just(tx));\n when(txManager.commit(tx)).thenReturn(Mono.empty());\n }\n\n @Test\n void shouldGetNotFoundIfUserNotFound() {\n when(client.get(User.class, \"invalid-user\"))\n .thenReturn(Mono.error(\n new ExtensionNotFoundException(fromExtension(User.class), \"invalid-user\"))\n );\n\n when(roleService.listRoleBindings(any())).thenReturn(Flux.empty());\n when(client.create(isA(RoleBinding.class)))\n .thenReturn(Mono.just(mock(RoleBinding.class)));\n when(sessionRegistry.getAllSessions(\"invalid-user\")).thenReturn(Flux.empty());\n\n var grantRolesMono = userService.grantRoles(\"invalid-user\", Set.of(\"fake-role\"));\n StepVerifier.create(grantRolesMono)\n .expectError(ExtensionNotFoundException.class)\n .verify();\n\n verify(client).get(User.class, \"invalid-user\");\n }\n\n @Test\n void shouldCreateRoleBindingIfNotExist() {\n var user = createUser(\"fake-password\");\n when(client.get(User.class, \"fake-user\"))\n .thenReturn(Mono.just(user));\n when(roleService.listRoleBindings(any(Subject.class))).thenReturn(Flux.empty());\n when(client.create(isA(RoleBinding.class))).thenReturn(\n Mono.just(mock(RoleBinding.class)));\n when(client.update(user)).thenReturn(Mono.just(user));\n var session = mock(ReactiveSessionInformation.class);\n when(session.invalidate()).thenReturn(Mono.empty());\n when(sessionRegistry.getAllSessions(\"fake-user\")).thenReturn(Flux.just(session));\n\n var grantRolesMono = userService.grantRoles(\"fake-user\", Set.of(\"fake-role\"));\n StepVerifier.create(grantRolesMono)\n .expectNextCount(1)\n .verifyComplete();\n\n verify(client).create(isA(RoleBinding.class));\n }\n\n @Test\n void shouldDeleteRoleBindingIfNotProvided() {\n var notProvidedRoleBinding = RoleBinding.create(\"fake-user\", \"non-provided-fake-role\");\n var existingRoleBinding = RoleBinding.create(\"fake-user\", \"fake-role\");\n when(roleService.listRoleBindings(any(Subject.class)))\n .thenReturn(Flux.just(notProvidedRoleBinding, existingRoleBinding));\n when(client.delete(isA(RoleBinding.class)))\n .thenReturn(Mono.just(mock(RoleBinding.class)));\n when(sessionRegistry.getAllSessions(\"fake-user\")).thenReturn(Flux.empty());\n var user = createUser(\"fake-password\");\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(user));\n when(client.update(user)).thenReturn(Mono.just(user));\n\n StepVerifier.create(userService.grantRoles(\"fake-user\", Set.of(\"fake-role\")))\n .expectNext(user)\n .verifyComplete();\n }\n\n @Test\n void shouldUpdateRoleBindingIfExists() {\n // add another subject\n var anotherSubject = new Subject();\n anotherSubject.setName(\"another-fake-user\");\n anotherSubject.setKind(User.KIND);\n anotherSubject.setApiGroup(User.GROUP);\n var notProvidedRoleBinding = RoleBinding.create(\"fake-user\", \"non-provided-fake-role\");\n notProvidedRoleBinding.getSubjects().add(anotherSubject);\n\n var existingRoleBinding = RoleBinding.create(\"fake-user\", \"fake-role\");\n\n when(roleService.listRoleBindings(any(Subject.class)))\n .thenReturn(Flux.just(notProvidedRoleBinding, existingRoleBinding));\n when(client.update(isA(RoleBinding.class)))\n .thenReturn(Mono.just(mock(RoleBinding.class)));\n\n when(sessionRegistry.getAllSessions(\"fake-user\")).thenReturn(Flux.empty());\n\n var user = createUser(\"fake-password\");\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(user));\n when(client.update(user)).thenReturn(Mono.just(user));\n\n StepVerifier.create(userService.grantRoles(\"fake-user\", Set.of(\"fake-role\")))\n // Because the roles are the same, so no need to update the existingRoleBinding\n .expectNext(user)\n .verifyComplete();\n\n verify(client).update(notProvidedRoleBinding);\n }\n }\n\n\n @Nested\n class SignUpTest {\n\n @Test\n void signUpWhenRegistrationNotAllowed() {\n SystemSetting.User userSetting = new SystemSetting.User();\n userSetting.setAllowRegistration(false);\n when(environmentFetcher.fetch(eq(SystemSetting.User.GROUP),\n eq(SystemSetting.User.class)))\n .thenReturn(Mono.just(userSetting));\n\n var signUpData = createSignUpData(\"fake-user\", \"fake-password\");\n\n userService.signUp(signUpData)\n .as(StepVerifier::create)\n .consumeErrorWith(e -> {\n assertInstanceOf(ServerWebInputException.class, e);\n assertTrue(e.getMessage().contains(\"registration is not allowed\"));\n })\n .verify();\n }\n\n @Test\n void signUpWhenRegistrationDefaultRoleNotConfigured() {\n SystemSetting.User userSetting = new SystemSetting.User();\n userSetting.setAllowRegistration(true);\n when(environmentFetcher.fetch(eq(SystemSetting.User.GROUP),\n eq(SystemSetting.User.class)))\n .thenReturn(Mono.just(userSetting));\n\n var signUpData = createSignUpData(\"fake-user\", \"fake-password\");\n\n userService.signUp(signUpData)\n .as(StepVerifier::create)\n .consumeErrorWith(e -> {\n assertInstanceOf(ServerWebInputException.class, e);\n assertTrue(e.getMessage().contains(\"default role is not configured\"));\n })\n .verify();\n }\n\n @Test\n void signUpWhenRegistrationUsernameExists() {\n SystemSetting.User userSetting = new SystemSetting.User();\n userSetting.setAllowRegistration(true);\n userSetting.setDefaultRole(\"fake-role\");\n when(environmentFetcher.fetch(eq(SystemSetting.User.GROUP),\n eq(SystemSetting.User.class)))\n .thenReturn(Mono.just(userSetting));\n when(passwordEncoder.encode(eq(\"fake-password\"))).thenReturn(\"fake-password\");\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Mono.just(createFakeUser(\"test\", \"test\")));\n when(extensionGetter.getExtensions(UserPreCreatingHandler.class))\n .thenReturn(Flux.empty());\n\n var signUpData = createSignUpData(\"fake-user\", \"fake-password\");\n userService.signUp(signUpData)\n .as(StepVerifier::create)\n .expectError(DuplicateNameException.class)\n .verify();\n }\n\n @Test\n void signUpWhenEmailAlreadyTaken() {\n SystemSetting.User userSetting = new SystemSetting.User();\n userSetting.setAllowRegistration(true);\n userSetting.setMustVerifyEmailOnRegistration(true);\n userSetting.setDefaultRole(\"fake-role\");\n when(environmentFetcher.fetch(eq(SystemSetting.User.GROUP),\n eq(SystemSetting.User.class)))\n .thenReturn(Mono.just(userSetting));\n when(passwordEncoder.encode(eq(\"fake-password\"))).thenReturn(\"fake-password\");\n when(emailVerificationService.verifyRegisterVerificationCode(\"fake@example.com\",\n \"fakeCode\"))\n .thenReturn(Mono.just(true));\n when(client.listAll(same(User.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.from(Mono.fromSupplier(() -> {\n var user = new User();\n user.setSpec(new User.UserSpec());\n user.getSpec().setEmailVerified(true);\n return user;\n })));\n\n var signUpData = createSignUpData(\"fake-user\", \"fake-password\");\n signUpData.setEmail(\"fake@example.com\");\n signUpData.setEmailCode(\"fakeCode\");\n userService.signUp(signUpData)\n .as(StepVerifier::create)\n .expectError(EmailAlreadyTakenException.class)\n .verify();\n }\n\n @Test\n void signUpWhenRegistrationSuccessfully() {\n SystemSetting.User userSetting = new SystemSetting.User();\n userSetting.setAllowRegistration(true);\n userSetting.setDefaultRole(\"fake-role\");\n when(environmentFetcher.fetch(eq(SystemSetting.User.GROUP),\n eq(SystemSetting.User.class)))\n .thenReturn(Mono.just(userSetting));\n when(passwordEncoder.encode(eq(\"fake-password\"))).thenReturn(\"fake-password\");\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Mono.empty());\n\n User fakeUser = createFakeUser(\"fake-user\", \"fake-password\");\n var signUpData = createSignUpData(\"fake-user\", \"fake-password\");\n\n when(client.fetch(eq(Role.class), anyString())).thenReturn(Mono.just(new Role()));\n when(client.create(any(User.class))).thenReturn(Mono.just(fakeUser));\n UserServiceImpl spyUserService = spy(userService);\n doReturn(Mono.just(fakeUser)).when(spyUserService).grantRoles(eq(\"fake-user\"),\n anySet());\n when(extensionGetter.getExtensions(UserPreCreatingHandler.class))\n .thenReturn(Flux.just(user -> {\n if (user.getMetadata().getAnnotations() == null) {\n user.getMetadata().setAnnotations(new HashMap<>());\n }\n user.getMetadata().getAnnotations()\n .put(\"pre.creating.handler.handled\", \"true\");\n return Mono.empty();\n }));\n when(extensionGetter.getExtensions(UserPostCreatingHandler.class))\n .thenReturn(Flux.just(user -> {\n assertEquals(fakeUser, user);\n return Mono.empty();\n }));\n\n spyUserService.signUp(signUpData)\n .as(StepVerifier::create)\n .consumeNextWith(user -> {\n assertThat(user.getMetadata().getName()).isEqualTo(\"fake-user\");\n assertThat(user.getSpec().getPassword()).isEqualTo(\"fake-password\");\n })\n .verifyComplete();\n\n verify(client).create(assertArg(u -> {\n var handled = u.getMetadata().getAnnotations().get(\"pre.creating.handler.handled\");\n assertEquals(\"true\", handled);\n }));\n verify(spyUserService).grantRoles(eq(\"fake-user\"), anySet());\n }\n\n User createFakeUser(String name, String password) {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(name);\n user.setSpec(new User.UserSpec());\n user.getSpec().setPassword(password);\n return user;\n }\n\n SignUpData createSignUpData(String name, String password) {\n SignUpData signUpData = new SignUpData();\n signUpData.setUsername(name);\n signUpData.setPassword(password);\n signUpData.setDisplayName(name);\n return signUpData;\n }\n }\n\n @Test\n void confirmPasswordWhenPasswordNotSet() {\n var user = new User();\n user.setSpec(new User.UserSpec());\n when(client.get(User.class, \"fake-user\")).thenReturn(Mono.just(user));\n userService.confirmPassword(\"fake-user\", \"fake-password\")\n .as(StepVerifier::create)\n .expectNext(true)\n .verifyComplete();\n\n user.getSpec().setPassword(\"\");\n userService.confirmPassword(\"fake-user\", \"fake-password\")\n .as(StepVerifier::create)\n .expectNext(true)\n .verifyComplete();\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/AbstractExtensionTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport org.junit.jupiter.api.Test;\n\nclass AbstractExtensionTest {\n\n @Test\n void groupVersionKind() {\n var extension = new AbstractExtension() {\n };\n extension.setApiVersion(\"fake.halo.run/v1alpha1\");\n extension.setKind(\"Fake\");\n var gvk = extension.groupVersionKind();\n\n assertEquals(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"), gvk);\n }\n\n @Test\n void testGroupVersionKind() {\n var extension = new AbstractExtension() {\n };\n extension.groupVersionKind(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"));\n\n assertEquals(\"fake.halo.run/v1alpha1\", extension.getApiVersion());\n assertEquals(\"Fake\", extension.getKind());\n }\n\n @Test\n void metadata() {\n var extension = new AbstractExtension() {\n };\n Metadata metadata = new Metadata();\n metadata.setName(\"fake\");\n extension.setMetadata(metadata);\n\n assertEquals(metadata, extension.getMetadata());\n }\n\n @Test\n void testMetadata() {\n var extension = new AbstractExtension() {\n };\n\n Metadata metadata = new Metadata();\n metadata.setName(\"fake\");\n extension.setMetadata(metadata);\n\n assertEquals(metadata, extension.getMetadata());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/ComparatorsTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.time.Instant;\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\nclass ComparatorsTest {\n\n @Nested\n class CompareCreationTimestamp {\n\n FakeExtension createFake(String name, Instant creationTimestamp) {\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setCreationTimestamp(creationTimestamp);\n var fake = new FakeExtension();\n fake.setMetadata(metadata);\n return fake;\n }\n\n @Test\n void desc() {\n var comparator = Comparators.compareCreationTimestamp(false);\n var now = Instant.now();\n var before = now.minusMillis(1);\n var after = now.plusMillis(1);\n\n var fakeNow = createFake(\"now\", now);\n var fakeBefore = createFake(\"before\", before);\n var fakeAfter = createFake(\"after\", after);\n\n var sortedFakes = new ArrayList<>(List.of(fakeNow, fakeAfter, fakeBefore));\n sortedFakes.sort(comparator);\n\n assertEquals(List.of(fakeAfter, fakeNow, fakeBefore), sortedFakes);\n }\n\n @Test\n void asc() {\n var comparator = Comparators.compareCreationTimestamp(true);\n var now = Instant.now();\n var before = now.minusMillis(1);\n var after = now.plusMillis(1);\n\n var fakeNow = createFake(\"now\", now);\n var fakeBefore = createFake(\"before\", before);\n var fakeAfter = createFake(\"after\", after);\n\n var sortedFakes = new ArrayList<>(List.of(fakeNow, fakeAfter, fakeBefore));\n sortedFakes.sort(comparator);\n\n assertEquals(List.of(fakeBefore, fakeNow, fakeAfter), sortedFakes);\n }\n }\n\n @Nested\n class CompareName {\n\n FakeExtension createFake(String name) {\n var metadata = new Metadata();\n metadata.setName(name);\n var fake = new FakeExtension();\n fake.setMetadata(metadata);\n return fake;\n }\n\n @Test\n void desc() {\n var comparator = Comparators.compareName(false);\n var fake01 = createFake(\"fake01\");\n var fake02 = createFake(\"fake02\");\n var fake03 = createFake(\"fake03\");\n\n var sortedFakes = new ArrayList<>(List.of(fake02, fake01, fake03));\n sortedFakes.sort(comparator);\n\n assertEquals(List.of(fake03, fake02, fake01), sortedFakes);\n }\n\n @Test\n void asc() {\n var comparator = Comparators.compareName(true);\n var fake01 = createFake(\"fake01\");\n var fake02 = createFake(\"fake02\");\n var fake03 = createFake(\"fake03\");\n\n var sortedFakes = new ArrayList<>(List.of(fake02, fake03, fake01));\n sortedFakes.sort(comparator);\n\n assertEquals(List.of(fake01, fake02, fake03), sortedFakes);\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/ConfigMapTest.java", "content": "package run.halo.app.extension;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.doNothing;\n\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.security.util.InMemoryResource;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\n/**\n * Tests for {@link ConfigMap}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ConfigMapTest {\n\n @Mock\n ExtensionClient extensionClient;\n\n @Test\n void configMapTest() {\n ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(ConfigMap.class);\n doNothing().when(extensionClient).create(argumentCaptor.capture());\n\n ConfigMap configMap = new ConfigMap();\n Metadata metadata = new Metadata();\n metadata.setName(\"test-configmap\");\n configMap.setMetadata(metadata);\n Map data = Map.of(\"k1\", \"v1\", \"k2\", \"v2\", \"k3\", \"v3\");\n configMap.setData(data);\n extensionClient.create(configMap);\n\n ConfigMap value = argumentCaptor.getValue();\n assertThat(value).isNotNull();\n assertThat(value.getData()).isEqualTo(data);\n }\n\n @Test\n void putDataItem() {\n ConfigMap configMap = new ConfigMap();\n configMap.putDataItem(\"k1\", \"v1\")\n .putDataItem(\"k2\", \"v2\")\n .putDataItem(\"k3\", \"v3\");\n\n assertThat(configMap.getData()).isNotNull();\n assertThat(configMap.getData()).hasSize(3);\n assertThat(configMap.getData()).isEqualTo(\n Map.of(\"k1\", \"v1\", \"k2\", \"v2\", \"k3\", \"v3\"));\n }\n\n @Test\n void equalsTest() {\n ConfigMap configMapA = new ConfigMap();\n Metadata metadataA = new Metadata();\n metadataA.setName(\"test-configmap\");\n configMapA.setMetadata(metadataA);\n configMapA.putDataItem(\"k1\", \"v1\");\n\n ConfigMap configMapB = new ConfigMap();\n Metadata metadataB = new Metadata();\n metadataB.setName(\"test-configmap\");\n configMapB.setMetadata(metadataB);\n configMapB.putDataItem(\"k1\", \"v1\");\n\n assertThat(configMapA).isEqualTo(configMapB);\n\n configMapB.getMetadata().setName(\"test-configmap-2\");\n assertThat(configMapA).isNotEqualTo(configMapB);\n }\n\n @Test\n void yamlTest() {\n String configMapYaml = \"\"\"\n apiVersion: v1alpha1\n kind: ConfigMap\n metadata:\n name: test-configmap\n data:\n k1: v1\n k2: v2\n k3: v3\n \"\"\";\n List unstructureds =\n new YamlUnstructuredLoader(new InMemoryResource(configMapYaml)).load();\n assertThat(unstructureds).hasSize(1);\n Unstructured unstructured = unstructureds.get(0);\n ConfigMap configMap =\n Unstructured.OBJECT_MAPPER.convertValue(unstructured, ConfigMap.class);\n\n assertThat(configMap.getData()).isEqualTo(Map.of(\"k1\", \"v1\", \"k2\", \"v2\", \"k3\", \"v3\"));\n assertThat(configMap.getMetadata().getName()).isEqualTo(\"test-configmap\");\n assertThat(configMap.getApiVersion()).isEqualTo(\"v1alpha1\");\n assertThat(configMap.getKind()).isEqualTo(\"ConfigMap\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/DefaultSchemeManagerTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.verify;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.event.SchemeRemovedEvent;\nimport run.halo.app.extension.exception.SchemeNotFoundException;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.index.IndicesManager;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultSchemeManagerTest {\n\n @Mock\n IndicesManager indicesManager;\n\n @Mock\n IndexEngine indexEngine;\n\n @Mock\n ApplicationEventPublisher eventPublisher;\n\n @InjectMocks\n DefaultSchemeManager schemeManager;\n\n @BeforeEach\n void setUp() {\n lenient().when(indexEngine.getIndicesManager()).thenReturn(indicesManager);\n }\n\n @Test\n void shouldThrowExceptionWhenNoGvkAnnotation() {\n class WithoutGvkExtension extends AbstractExtension {\n }\n\n assertThrows(IllegalArgumentException.class,\n () -> schemeManager.register(WithoutGvkExtension.class));\n }\n\n @Test\n void shouldGetNothingWhenUnregistered() {\n final var gvk = new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\");\n var scheme = schemeManager.fetch(gvk);\n assertFalse(scheme.isPresent());\n\n assertThrows(SchemeNotFoundException.class, () -> schemeManager.get(gvk));\n assertThrows(SchemeNotFoundException.class, () -> schemeManager.get(FakeExtension.class));\n assertThrows(SchemeNotFoundException.class, () -> schemeManager.get(new FakeExtension()));\n }\n\n @Test\n void shouldGetSchemeWhenRegistered() {\n schemeManager.register(FakeExtension.class);\n final var gvk = new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\");\n var scheme = schemeManager.fetch(gvk);\n assertTrue(scheme.isPresent());\n\n assertEquals(gvk, schemeManager.get(gvk).groupVersionKind());\n assertEquals(gvk, schemeManager.get(FakeExtension.class).groupVersionKind());\n assertEquals(gvk, schemeManager.get(new FakeExtension()).groupVersionKind());\n }\n\n @Test\n void shouldUnregisterSuccessfully() {\n schemeManager.register(FakeExtension.class);\n Scheme scheme = schemeManager.get(FakeExtension.class);\n assertNotNull(scheme);\n\n schemeManager.unregister(scheme);\n assertThrows(SchemeNotFoundException.class, () -> schemeManager.get(FakeExtension.class));\n }\n\n @Test\n void shouldTriggerOnChangeOnlyOnceWhenRegisterTwice() {\n schemeManager.register(FakeExtension.class);\n schemeManager.register(FakeExtension.class);\n\n verify(eventPublisher).publishEvent(isA(SchemeAddedEvent.class));\n verify(indicesManager).add(same(FakeExtension.class), any());\n }\n\n @Test\n void shouldTriggerOnChangeOnlyOnceWhenUnregisterTwice() {\n schemeManager.register(FakeExtension.class);\n var scheme = schemeManager.get(FakeExtension.class);\n schemeManager.unregister(scheme);\n schemeManager.unregister(scheme);\n\n verify(eventPublisher).publishEvent(isA(SchemeAddedEvent.class));\n verify(eventPublisher).publishEvent(isA(SchemeRemovedEvent.class));\n verify(indicesManager).add(same(FakeExtension.class), any());\n }\n\n @Test\n void getSizeOfSchemes() {\n assertEquals(0, schemeManager.size());\n schemeManager.register(FakeExtension.class);\n assertEquals(1, schemeManager.size());\n schemeManager.unregister(schemeManager.get(FakeExtension.class));\n assertEquals(0, schemeManager.size());\n }\n\n @Test\n void shouldReturnCopyOnWriteList() {\n schemeManager.register(FakeExtension.class);\n var schemes = schemeManager.schemes();\n schemes.forEach(scheme -> {\n // make sure concurrent modification won't happen\n schemeManager.register(FooExtension.class);\n });\n }\n\n @GVK(group = \"fake.halo.run\", version = \"v1alpha1\", kind = \"Foo\",\n plural = \"foos\", singular = \"foo\")\n static class FooExtension extends AbstractExtension {\n }\n}\n\n" }, { "path": "application/src/test/java/run/halo/app/extension/ExtensionOperatorTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport org.junit.jupiter.api.Test;\n\nclass ExtensionOperatorTest {\n\n @Test\n void testIsNotDeleted() {\n var ext = mock(ExtensionOperator.class);\n var metadata = mock(Metadata.class);\n when(metadata.getDeletionTimestamp()).thenReturn(null);\n when(ext.getMetadata()).thenReturn(metadata);\n\n assertTrue(ExtensionOperator.isNotDeleted().test(ext));\n\n when(metadata.getDeletionTimestamp()).thenReturn(Instant.now());\n assertFalse(ExtensionOperator.isNotDeleted().test(ext));\n }\n\n @Test\n void testIsDeleted() {\n var ext = mock(ExtensionOperator.class);\n\n when(ext.getMetadata()).thenReturn(null);\n assertFalse(ExtensionOperator.isDeleted(ext));\n\n var metadata = mock(Metadata.class);\n when(ext.getMetadata()).thenReturn(metadata);\n when(metadata.getDeletionTimestamp()).thenReturn(null);\n assertFalse(ExtensionOperator.isDeleted(ext));\n\n when(metadata.getDeletionTimestamp()).thenReturn(Instant.now());\n assertTrue(ExtensionOperator.isDeleted(ext));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/ExtensionStoreUtilTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\n\nclass ExtensionStoreUtilTest {\n\n Scheme scheme;\n\n Scheme grouplessScheme;\n\n @BeforeEach\n void setUp() {\n scheme = new Scheme(FakeExtension.class,\n new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"),\n \"fakes\",\n \"fake\",\n new ObjectNode(null));\n grouplessScheme = new Scheme(FakeExtension.class,\n new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"),\n \"fakes\",\n \"fake\",\n new ObjectNode(null));\n }\n\n @Test\n void buildStoreNamePrefix() {\n var prefix = ExtensionStoreUtil.buildStoreNamePrefix(scheme);\n assertEquals(\"/registry/fake.halo.run/fakes\", prefix);\n\n prefix = ExtensionStoreUtil.buildStoreNamePrefix(grouplessScheme);\n assertEquals(\"/registry/fakes\", prefix);\n }\n\n @Test\n void buildStoreName() {\n var storeName = ExtensionStoreUtil.buildStoreName(scheme, \"fake-name\");\n assertEquals(\"/registry/fake.halo.run/fakes/fake-name\", storeName);\n\n storeName = ExtensionStoreUtil.buildStoreName(grouplessScheme, \"fake-name\");\n assertEquals(\"/registry/fakes/fake-name\", storeName);\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/FakeExtension.java", "content": "package run.halo.app.extension;\n\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\n\n@GVK(group = \"fake.halo.run\",\n version = \"v1alpha1\",\n kind = \"Fake\",\n plural = \"fakes\",\n singular = \"fake\")\n@Data\n@ToString(callSuper = true)\n@EqualsAndHashCode(callSuper = true)\npublic class FakeExtension extends AbstractExtension {\n\n private FakeStatus status = new FakeStatus();\n\n public static FakeExtension createFake(String name) {\n var metadata = new Metadata();\n metadata.setName(name);\n var fake = new FakeExtension();\n fake.setMetadata(metadata);\n return fake;\n }\n\n @Data\n public static class FakeStatus {\n private String state;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/GroupVersionKindTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static run.halo.app.extension.GroupVersionKind.fromAPIVersionAndKind;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\n\nclass GroupVersionKindTest {\n\n @Test\n void testFromApiVersionAndKind() {\n record TestCase(String apiVersion, String kind, GroupVersionKind expected,\n Class exception) {\n }\n\n List.of(\n new TestCase(\"v1alpha1\", \"Fake\", new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"), null),\n new TestCase(\"fake.halo.run/v1alpha1\", \"Fake\",\n new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"), null),\n new TestCase(\"\", \"\", null, IllegalArgumentException.class),\n new TestCase(\"\", \"Fake\", null, IllegalArgumentException.class),\n new TestCase(\"v1alpha1\", \"\", null, IllegalArgumentException.class),\n new TestCase(\"fake.halo.run/v1alpha1/v1alpha2\", \"Fake\", null,\n IllegalArgumentException.class)\n ).forEach(testCase -> {\n if (testCase.exception != null) {\n assertThrows(testCase.exception, () -> {\n fromAPIVersionAndKind(testCase.apiVersion, testCase.kind);\n });\n } else {\n var got = fromAPIVersionAndKind(testCase.apiVersion, testCase.kind);\n assertEquals(testCase.expected, got);\n }\n });\n }\n\n @Test\n void testHasGroup() {\n record TestCase(GroupVersionKind gvk, boolean hasGroup) {\n }\n\n List.of(\n new TestCase(new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"), false),\n new TestCase(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"), true)\n ).forEach(testCase -> assertEquals(testCase.hasGroup, testCase.gvk.hasGroup()));\n }\n\n @Test\n void testGroupKind() {\n record TestCase(GroupVersionKind gvk, GroupKind gk) {\n }\n\n List.of(\n new TestCase(new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"), new GroupKind(\"\", \"Fake\")),\n new TestCase(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"),\n new GroupKind(\"fake.halo.run\", \"Fake\"))\n ).forEach(testCase -> {\n assertEquals(testCase.gk, testCase.gvk.groupKind());\n });\n }\n\n @Test\n void testGroupVersion() {\n record TestCase(GroupVersionKind gvk, GroupVersion gv) {\n }\n\n List.of(\n new TestCase(new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"),\n new GroupVersion(\"\", \"v1alpha1\")),\n new TestCase(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"),\n new GroupVersion(\"fake.halo.run\", \"v1alpha1\"))\n ).forEach(testCase -> {\n assertEquals(testCase.gv, testCase.gvk.groupVersion());\n });\n }\n\n @Test\n void fromExtension() {\n GroupVersionKind groupVersionKind = GroupVersionKind.fromExtension(FakeExtension.class);\n assertEquals(\"fake.halo.run\", groupVersionKind.group());\n assertEquals(\"v1alpha1\", groupVersionKind.version());\n assertEquals(\"Fake\", groupVersionKind.kind());\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/GroupVersionTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\n\nimport org.junit.jupiter.api.Test;\n\nclass GroupVersionTest {\n\n @Test\n void shouldThrowIllegalArgumentExceptionWhenAPIVersionIsIllegal() {\n assertThrows(IllegalArgumentException.class, () -> GroupVersion.parseAPIVersion(null),\n \"apiVersion is null\");\n assertThrows(IllegalArgumentException.class, () -> GroupVersion.parseAPIVersion(\"\"),\n \"apiVersion is empty\");\n assertThrows(IllegalArgumentException.class, () -> GroupVersion.parseAPIVersion(\" \"),\n \"apiVersion is blank\");\n assertThrows(IllegalArgumentException.class, () -> GroupVersion.parseAPIVersion(\"a/b/c\"),\n \"apiVersion contains more than 1 '/'\");\n }\n\n @Test\n void shouldReturnGroupVersionCorrectly() {\n assertEquals(new GroupVersion(\"\", \"v1\"), GroupVersion.parseAPIVersion(\"v1\"),\n \"only contains version\");\n assertEquals(new GroupVersion(\"core.halo.run\", \"v1\"),\n GroupVersion.parseAPIVersion(\"core.halo.run/v1\"), \"only contains version\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/JsonExtensionConverterTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.Mockito.lenient;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport java.io.IOException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.exception.ExtensionConvertException;\nimport run.halo.app.extension.exception.SchemaViolationException;\nimport run.halo.app.extension.store.ExtensionStore;\n\n@ExtendWith(MockitoExtension.class)\nclass JsonExtensionConverterTest {\n\n @InjectMocks\n JSONExtensionConverter converter;\n\n @Mock\n SchemeManager schemeManager;\n\n ObjectMapper objectMapper = Unstructured.OBJECT_MAPPER;\n\n @BeforeEach\n void setUp() {\n converter.setObjectMapper(objectMapper);\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n lenient().when(schemeManager.get(scheme.groupVersionKind())).thenReturn(scheme);\n }\n\n @Test\n void convertTo() throws IOException {\n var fake = createFakeExtension(\"fake\", 10L);\n\n var extensionStore = converter.convertTo(fake);\n\n assertEquals(\"/registry/fake.halo.run/fakes/fake\", extensionStore.getName());\n assertEquals(10L, extensionStore.getVersion());\n assertEquals(fake, objectMapper.readValue(extensionStore.getData(), FakeExtension.class));\n }\n\n @Test\n void convertFrom() throws JsonProcessingException {\n var fake = createFakeExtension(\"fake\", 20L);\n\n var store = new ExtensionStore();\n store.setName(\"/registry/fake.halo.run/fakes/fake\");\n store.setVersion(20L);\n store.setData(objectMapper.writeValueAsBytes(fake));\n\n FakeExtension gotFake = converter.convertFrom(FakeExtension.class, store);\n assertEquals(fake, gotFake);\n }\n\n @Test\n void shouldThrowConvertExceptionWhenDataIsInvalid() {\n var store = new ExtensionStore();\n store.setName(\"/registry/fake.halo.run/fakes/fake\");\n store.setVersion(20L);\n store.setData(\"{\".getBytes());\n\n assertThrows(ExtensionConvertException.class,\n () -> converter.convertFrom(FakeExtension.class, store));\n }\n\n @Test\n void shouldThrowSchemaViolationExceptionWhenNameNotSet() {\n var fake = new FakeExtension();\n Metadata metadata = new Metadata();\n fake.setMetadata(metadata);\n fake.setApiVersion(\"fake.halo.run/v1alpha1\");\n fake.setKind(\"Fake\");\n var error = assertThrows(SchemaViolationException.class, () -> converter.convertTo(fake));\n assertEquals(1, error.getErrors().size());\n var result = error.getErrors().items().get(0);\n assertEquals(1026, result.code());\n assertEquals(\"Field 'name' is required.\", result.message());\n }\n\n FakeExtension createFakeExtension(String name, Long version) {\n var fake = new FakeExtension();\n fake.groupVersionKind(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"));\n Metadata metadata = new Metadata();\n metadata.setName(name);\n metadata.setVersion(version);\n fake.setMetadata(metadata);\n\n return fake;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/JsonExtensionTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertNull;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.json.JsonMapper;\nimport com.fasterxml.jackson.databind.node.TextNode;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\n\nclass JsonExtensionTest {\n\n ObjectMapper objectMapper;\n\n @BeforeEach\n void setUp() {\n objectMapper = JsonMapper.builder().build();\n }\n\n @Test\n void serializeEmptyExt() throws JsonProcessingException, JSONException {\n var ext = new JsonExtension(objectMapper);\n var json = objectMapper.writeValueAsString(ext);\n JSONAssert.assertEquals(\"{}\", json, true);\n }\n\n @Test\n void serializeExt() throws JsonProcessingException, JSONException {\n var ext = new JsonExtension(objectMapper);\n ext.setApiVersion(\"fake.halo.run/v1alpha\");\n ext.setKind(\"Fake\");\n var metadata = ext.getMetadataOrCreate();\n metadata.setName(\"fake-name\");\n\n ext.getInternal().set(\"data\", TextNode.valueOf(\"halo\"));\n\n JSONAssert.assertEquals(\"\"\"\n {\n \"apiVersion\": \"fake.halo.run/v1alpha\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"name\": \"fake-name\"\n },\n \"data\": \"halo\"\n }\"\"\", objectMapper.writeValueAsString(ext), true);\n }\n\n @Test\n void deserialize() throws JsonProcessingException {\n var json = \"\"\"\n {\n \"apiVersion\": \"fake.halo.run/v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"name\": \"faker\"\n },\n \"otherProperty\": \"otherPropertyValue\"\n }\"\"\";\n\n var ext = objectMapper.readValue(json, JsonExtension.class);\n\n assertEquals(\"fake.halo.run/v1alpha1\", ext.getApiVersion());\n assertEquals(\"Fake\", ext.getKind());\n assertNotNull(ext.getMetadata());\n assertEquals(\"faker\", ext.getMetadata().getName());\n assertNull(ext.getMetadata().getVersion());\n assertNull(ext.getMetadata().getFinalizers());\n assertNull(ext.getMetadata().getAnnotations());\n assertNull(ext.getMetadata().getLabels());\n assertNull(ext.getMetadata().getGenerateName());\n assertNull(ext.getMetadata().getCreationTimestamp());\n assertNull(ext.getMetadata().getDeletionTimestamp());\n assertEquals(\"otherPropertyValue\", ext.getInternal().get(\"otherProperty\").asText());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/ListResultTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertSame;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport com.fasterxml.jackson.databind.DeserializationFeature;\nimport com.fasterxml.jackson.databind.json.JsonMapper;\nimport java.lang.reflect.ParameterizedType;\nimport java.util.List;\nimport java.util.Optional;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\n\nclass ListResultTest {\n\n @Test\n void generateGenericClass() {\n var fakeListClass =\n ListResult.generateGenericClass(Scheme.buildFromType(FakeExtension.class));\n assertTrue(ListResult.class.isAssignableFrom(fakeListClass));\n assertSame(FakeExtension.class, ((ParameterizedType) fakeListClass.getGenericSuperclass())\n .getActualTypeArguments()[0]);\n assertEquals(\"FakeList\", fakeListClass.getSimpleName());\n }\n\n @Test\n void generateGenericClassForClassParam() {\n var fakeListClass = ListResult.generateGenericClass(FakeExtension.class);\n assertTrue(ListResult.class.isAssignableFrom(fakeListClass));\n assertSame(FakeExtension.class, ((ParameterizedType) fakeListClass.getGenericSuperclass())\n .getActualTypeArguments()[0]);\n assertEquals(\"FakeExtensionList\", fakeListClass.getSimpleName());\n }\n\n @Test\n void totalPages() {\n var listResult = new ListResult<>(1, 10, 100, List.of());\n assertEquals(10, listResult.getTotalPages());\n\n listResult = new ListResult<>(1, 10, 1, List.of());\n assertEquals(1, listResult.getTotalPages());\n\n listResult = new ListResult<>(1, 10, 9, List.of());\n assertEquals(1, listResult.getTotalPages());\n\n listResult = new ListResult<>(1, 0, 100, List.of());\n assertEquals(1, listResult.getTotalPages());\n }\n\n @Test\n void subListWhenSizeIsZero() {\n var list = List.of(1, 2, 3, 4, 5);\n assertSubList(list);\n\n list = List.of(1);\n assertSubList(list);\n }\n\n @Test\n void firstTest() {\n var listResult = new ListResult<>(List.of());\n assertEquals(Optional.empty(), ListResult.first(listResult));\n\n listResult = new ListResult<>(1, 10, 1, List.of(\"A\"));\n assertEquals(Optional.of(\"A\"), ListResult.first(listResult));\n }\n\n @Test\n void serializationTest() throws JsonProcessingException {\n var result = new ListResult<>(1, 10, 100, List.of(\"a\", \"b\", \"c\"));\n var json = JsonMapper.builder()\n .build()\n .writeValueAsString(result);\n JSONAssert.assertEquals(\"\"\"\n {\n \"page\": 1,\n \"size\": 10,\n \"total\": 100,\n \"items\": [\n \"a\",\n \"b\",\n \"c\"\n ],\n \"first\": true,\n \"last\": false,\n \"hasNext\": true,\n \"hasPrevious\": false,\n \"totalPages\": 10\n }\n \"\"\", json, true);\n }\n\n @Test\n void deserializationTest() throws JsonProcessingException {\n var json = \"\"\"\n {\n \"page\": 2,\n \"size\": 10,\n \"total\": 100,\n \"items\": [\n \"a\",\n \"b\",\n \"c\"\n ],\n \"first\": false,\n \"last\": false,\n \"hasNext\": true,\n \"hasPrevious\": true,\n \"totalPages\": 10\n }\n \"\"\";\n var result = JsonMapper.builder()\n .disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)\n .build()\n .readValue(json, new TypeReference>() {\n });\n assertEquals(2, result.getPage());\n assertEquals(100, result.getTotal());\n assertEquals(10, result.getTotalPages());\n assertEquals(10, result.getSize());\n assertFalse(result.isFirst());\n assertFalse(result.isLast());\n assertTrue(result.hasNext());\n assertTrue(result.hasPrevious());\n assertEquals(List.of(\"a\", \"b\", \"c\"), result.getItems());\n }\n\n private void assertSubList(List list) {\n var result = ListResult.subList(list, 0, 0);\n assertEquals(list, result);\n\n result = ListResult.subList(list, 0, 1);\n assertEquals(list.subList(0, 1), result);\n\n result = ListResult.subList(list, 1, 0);\n assertEquals(list, result);\n\n assertEquals(list.subList(0, 1), ListResult.subList(list, -1, 1));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/MetadataOperatorTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\n\nclass MetadataOperatorTest {\n\n Instant now = Instant.now();\n\n @Test\n void testEqualsWithSameType() {\n assertTrue(MetadataOperator.equals(null, null));\n\n var left = createFullMetadata();\n var right = createFullMetadata();\n assertFalse(MetadataOperator.equals(left, null));\n assertFalse(MetadataOperator.equals(null, right));\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setDeletionTimestamp(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setDeletionTimestamp(null);\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setCreationTimestamp(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setCreationTimestamp(null);\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setVersion(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setVersion(null);\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setAnnotations(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setAnnotations(null);\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setLabels(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setLabels(null);\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setName(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setName(null);\n assertTrue(MetadataOperator.equals(left, right));\n\n left.setFinalizers(null);\n assertFalse(MetadataOperator.equals(left, right));\n right.setFinalizers(null);\n assertTrue(MetadataOperator.equals(left, right));\n }\n\n @Test\n void testEqualsWithDifferentType() {\n var mockMetadata = mock(MetadataOperator.class);\n when(mockMetadata.getName()).thenReturn(\"fake-name\");\n when(mockMetadata.getLabels()).thenReturn(Map.of(\"fake-label-key\", \"fake-label-value\"));\n when(mockMetadata.getAnnotations()).thenReturn(Map.of(\"fake-anno-key\", \"fake-anno-value\"));\n when(mockMetadata.getVersion()).thenReturn(123L);\n when(mockMetadata.getCreationTimestamp()).thenReturn(now);\n when(mockMetadata.getDeletionTimestamp()).thenReturn(now);\n when(mockMetadata.getFinalizers())\n .thenReturn(Set.of(\"fake-finalizer-1\", \"fake-finalizer-2\"));\n\n var metadata = createFullMetadata();\n assertTrue(MetadataOperator.equals(metadata, mockMetadata));\n }\n\n Metadata createFullMetadata() {\n var metadata = new Metadata();\n metadata.setName(\"fake-name\");\n metadata.setLabels(Map.of(\"fake-label-key\", \"fake-label-value\"));\n metadata.setAnnotations(Map.of(\"fake-anno-key\", \"fake-anno-value\"));\n metadata.setVersion(123L);\n metadata.setCreationTimestamp(now);\n metadata.setDeletionTimestamp(now);\n metadata.setFinalizers(Set.of(\"fake-finalizer-2\", \"fake-finalizer-1\"));\n return metadata;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/ReactiveExtensionClientTest.java", "content": "package run.halo.app.extension;\n\nimport static java.util.Collections.emptyList;\nimport static java.util.Collections.reverseOrder;\nimport static java.util.Comparator.comparing;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.extension.GroupVersionKind.fromAPIVersionAndKind;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.json.JsonMapper;\nimport com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.DisplayName;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.dao.DataIntegrityViolationException;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport org.springframework.transaction.reactive.TransactionalOperator;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.exception.SchemeNotFoundException;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.store.ExtensionStore;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\n\n@ExtendWith(MockitoExtension.class)\nclass ReactiveExtensionClientTest {\n\n static final Scheme fakeScheme = Scheme.buildFromType(FakeExtension.class);\n\n @Mock\n ReactiveExtensionStoreClient storeClient;\n\n @Mock\n ExtensionConverter converter;\n\n @Mock\n SchemeManager schemeManager;\n\n @Mock\n ReactiveTransactionManager reactiveTransactionManager;\n\n @Spy\n ObjectMapper objectMapper = JsonMapper.builder()\n .addModule(new JavaTimeModule())\n .build();\n\n @Mock\n IndexEngine indexEngine;\n\n @InjectMocks\n ReactiveExtensionClientImpl client;\n\n @BeforeEach\n void setUp() {\n lenient().when(schemeManager.get(eq(FakeExtension.class)))\n .thenReturn(fakeScheme);\n lenient().when(schemeManager.get(eq(fakeScheme.groupVersionKind()))).thenReturn(fakeScheme);\n var transactionalOperator = mock(TransactionalOperator.class);\n client.setTransactionalOperator(transactionalOperator);\n lenient().when(transactionalOperator.transactional(any(Mono.class)))\n .thenAnswer(invocation -> invocation.getArgument(0));\n }\n\n FakeExtension createFakeExtension(String name, Long version) {\n var fake = new FakeExtension();\n var metadata = new Metadata();\n metadata.setName(name);\n metadata.setVersion(version);\n\n fake.setMetadata(metadata);\n fake.setApiVersion(\"fake.halo.run/v1alpha1\");\n fake.setKind(\"Fake\");\n\n return fake;\n }\n\n ExtensionStore createExtensionStore(String name) {\n return createExtensionStore(name, null);\n }\n\n ExtensionStore createExtensionStore(String name, Long version) {\n var extensionStore = new ExtensionStore();\n extensionStore.setName(name);\n extensionStore.setVersion(version);\n extensionStore.setData(\"fake data\".getBytes());\n return extensionStore;\n }\n\n Unstructured createUnstructured() throws JsonProcessingException {\n String extensionJson = \"\"\"\n {\n \"apiVersion\": \"fake.halo.run/v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"labels\": {\n \"category\": \"fake\",\n \"default\": \"true\"\n },\n \"name\": \"fake\",\n \"creationTimestamp\": \"2011-12-03T10:15:30Z\",\n \"version\": 12345\n }\n }\n \"\"\";\n return Unstructured.OBJECT_MAPPER.readValue(extensionJson, Unstructured.class);\n }\n\n @Test\n void shouldThrowSchemeNotFoundExceptionWhenSchemeNotRegistered() {\n class UnRegisteredExtension extends AbstractExtension {\n }\n\n when(schemeManager.get(eq(UnRegisteredExtension.class)))\n .thenThrow(SchemeNotFoundException.class);\n when(schemeManager.get(isA(GroupVersionKind.class)))\n .thenThrow(SchemeNotFoundException.class);\n\n assertThrows(SchemeNotFoundException.class,\n () -> client.list(UnRegisteredExtension.class, null,\n null));\n assertThrows(SchemeNotFoundException.class,\n () -> client.list(UnRegisteredExtension.class, null, null, 0, 10));\n assertThrows(SchemeNotFoundException.class,\n () -> client.fetch(UnRegisteredExtension.class, \"fake\"));\n assertThrows(SchemeNotFoundException.class, () ->\n client.fetch(fromAPIVersionAndKind(\"fake.halo.run/v1alpha1\", \"UnRegistered\"), \"fake\"));\n\n when(converter.convertTo(any())).thenThrow(SchemeNotFoundException.class);\n StepVerifier.create(client.create(createFakeExtension(\"fake\", null)))\n .verifyError(SchemeNotFoundException.class);\n\n assertThrows(SchemeNotFoundException.class, () -> {\n when(converter.convertTo(any())).thenThrow(SchemeNotFoundException.class);\n client.update(createFakeExtension(\"fake\", 1L));\n });\n assertThrows(SchemeNotFoundException.class, () -> {\n when(converter.convertTo(any())).thenThrow(SchemeNotFoundException.class);\n client.delete(createFakeExtension(\"fake\", 1L));\n });\n }\n\n @Test\n void shouldReturnEmptyExtensions() {\n when(storeClient.listByNamePrefix(anyString())).thenReturn(Flux.empty());\n var fakes = client.list(FakeExtension.class, null, null);\n StepVerifier.create(fakes)\n .verifyComplete();\n }\n\n @Test\n void shouldReturnExtensionsWithFilterAndSorter() {\n var fake1 = createFakeExtension(\"fake-01\", 1L);\n var fake2 = createFakeExtension(\"fake-02\", 1L);\n\n when(\n converter.convertFrom(FakeExtension.class, createExtensionStore(\"fake-01\"))).thenReturn(\n fake1);\n when(\n converter.convertFrom(FakeExtension.class, createExtensionStore(\"fake-02\"))).thenReturn(\n fake2);\n when(storeClient.listByNamePrefix(anyString())).thenReturn(\n Flux.fromIterable(\n List.of(createExtensionStore(\"fake-01\"), createExtensionStore(\"fake-02\"))));\n\n // without filter and sorter\n Flux fakes =\n client.list(FakeExtension.class, null, null);\n StepVerifier.create(fakes)\n .expectNext(fake1)\n .expectNext(fake2)\n .verifyComplete();\n\n // with filter\n fakes = client.list(FakeExtension.class, fake -> {\n String name = fake.getMetadata().getName();\n return \"fake-01\".equals(name);\n }, null);\n StepVerifier.create(fakes)\n .expectNext(fake1)\n .verifyComplete();\n\n // with sorter\n fakes = client.list(FakeExtension.class, null,\n reverseOrder(comparing(fake -> fake.getMetadata().getName())));\n StepVerifier.create(fakes)\n .expectNext(fake2)\n .expectNext(fake1)\n .verifyComplete();\n }\n\n @Test\n void shouldQueryPageableAndCorrectly() {\n var fake1 = createFakeExtension(\"fake-01\", 1L);\n var fake2 = createFakeExtension(\"fake-02\", 1L);\n var fake3 = createFakeExtension(\"fake-03\", 1L);\n\n when(\n converter.convertFrom(FakeExtension.class, createExtensionStore(\"fake-01\"))).thenReturn(\n fake1);\n when(\n converter.convertFrom(FakeExtension.class, createExtensionStore(\"fake-02\"))).thenReturn(\n fake2);\n when(\n converter.convertFrom(FakeExtension.class, createExtensionStore(\"fake-03\"))).thenReturn(\n fake3);\n\n when(storeClient.listByNamePrefix(anyString())).thenReturn(Flux.fromIterable(\n List.of(createExtensionStore(\"fake-01\"), createExtensionStore(\"fake-02\"),\n createExtensionStore(\"fake-03\"))));\n\n // without filter and sorter.\n var fakes = client.list(FakeExtension.class, null, null, 1, 10);\n StepVerifier.create(fakes)\n .expectNext(new ListResult<>(1, 10, 3, List.of(fake1, fake2, fake3)))\n .verifyComplete();\n\n // out of page range\n fakes = client.list(FakeExtension.class, null, null, 100, 10);\n StepVerifier.create(fakes)\n .expectNext(new ListResult<>(100, 10, 3, emptyList()))\n .verifyComplete();\n\n // with filter only\n fakes =\n client.list(FakeExtension.class, fake -> \"fake-03\".equals(fake.getMetadata().getName()),\n null, 1, 10);\n StepVerifier.create(fakes)\n .expectNext(new ListResult<>(1, 10, 1, List.of(fake3)))\n .verifyComplete();\n\n // with sorter only\n fakes = client.list(FakeExtension.class, null,\n reverseOrder(comparing(fake -> fake.getMetadata().getName())), 1, 10);\n StepVerifier.create(fakes)\n .expectNext(new ListResult<>(1, 10, 3, List.of(fake3, fake2, fake1)))\n .verifyComplete();\n\n // without page\n fakes = client.list(FakeExtension.class, null, null, 0, 0);\n StepVerifier.create(fakes)\n .expectNext(new ListResult<>(0, 0, 3, List.of(fake1, fake2, fake3)))\n .verifyComplete();\n }\n\n @Test\n void shouldFetchNothing() {\n when(storeClient.fetchByName(any())).thenReturn(Mono.empty());\n\n var fake = client.fetch(FakeExtension.class, \"fake\");\n\n StepVerifier.create(fake)\n .verifyComplete();\n\n verify(converter, times(0)).convertFrom(any(), any());\n verify(storeClient, times(1)).fetchByName(any());\n }\n\n @Test\n void shouldNotFetchUnstructured() {\n when(schemeManager.get(isA(GroupVersionKind.class)))\n .thenReturn(fakeScheme);\n when(storeClient.fetchByName(any())).thenReturn(Mono.empty());\n var unstructuredFake = client.fetch(fakeScheme.groupVersionKind(), \"fake\");\n StepVerifier.create(unstructuredFake)\n .verifyComplete();\n\n verify(converter, times(0)).convertFrom(any(), any());\n verify(schemeManager, times(1)).get(isA(GroupVersionKind.class));\n verify(storeClient, times(1)).fetchByName(any());\n }\n\n @Test\n void shouldFetchAnExtension() {\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(createExtensionStore(storeName)));\n\n when(\n converter.convertFrom(FakeExtension.class, createExtensionStore(storeName))).thenReturn(\n createFakeExtension(\"fake\", 1L));\n\n var fake = client.fetch(FakeExtension.class, \"fake\");\n StepVerifier.create(fake)\n .expectNext(createFakeExtension(\"fake\", 1L))\n .verifyComplete();\n\n verify(storeClient, times(1)).fetchByName(eq(storeName));\n verify(converter, times(1)).convertFrom(eq(FakeExtension.class),\n eq(createExtensionStore(storeName)));\n }\n\n @Test\n void shouldFetchUnstructuredExtension() throws JsonProcessingException {\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(createExtensionStore(storeName)));\n when(schemeManager.get(isA(GroupVersionKind.class)))\n .thenReturn(fakeScheme);\n when(converter.convertFrom(Unstructured.class, createExtensionStore(storeName)))\n .thenReturn(createUnstructured());\n\n var fake = client.fetch(fakeScheme.groupVersionKind(), \"fake\");\n StepVerifier.create(fake)\n .expectNext(createUnstructured())\n .verifyComplete();\n\n verify(storeClient, times(1)).fetchByName(eq(storeName));\n verify(schemeManager, times(1)).get(isA(GroupVersionKind.class));\n verify(converter, times(1)).convertFrom(eq(Unstructured.class),\n eq(createExtensionStore(storeName)));\n }\n\n @Test\n void shouldCreateSuccessfully() {\n var fake = createFakeExtension(\"fake\", null);\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(\"/registry/fake.halo.run/fakes/fake\"));\n when(storeClient.create(any(), any())).thenReturn(\n Mono.just(createExtensionStore(\"/registry/fake.halo.run/fakes/fake\")));\n when(converter.convertFrom(same(FakeExtension.class), any())).thenReturn(fake);\n doNothing().when(indexEngine).insert(any());\n\n StepVerifier.create(client.create(fake))\n .expectNext(fake)\n .verifyComplete();\n\n verify(converter, times(1)).convertTo(eq(fake));\n verify(storeClient, times(1)).create(eq(\"/registry/fake.halo.run/fakes/fake\"), any());\n assertNotNull(fake.getMetadata().getCreationTimestamp());\n }\n\n @Test\n void shouldCreateWithGenerateNameSuccessfully() {\n var fake = createFakeExtension(\"fake\", null);\n fake.getMetadata().setName(\"\");\n fake.getMetadata().setGenerateName(\"fake-\");\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(\"/registry/fake.halo.run/fakes/fake\"));\n when(storeClient.create(any(), any())).thenReturn(\n Mono.just(createExtensionStore(\"/registry/fake.halo.run/fakes/fake\")));\n when(converter.convertFrom(same(FakeExtension.class), any())).thenReturn(fake);\n doNothing().when(indexEngine).insert(any());\n\n StepVerifier.create(client.create(fake))\n .expectNext(fake)\n .verifyComplete();\n\n verify(converter, times(1)).convertTo(argThat(ext -> {\n var name = ext.getMetadata().getName();\n return name.startsWith(ext.getMetadata().getGenerateName());\n }));\n verify(storeClient, times(1)).create(eq(\"/registry/fake.halo.run/fakes/fake\"), any());\n assertNotNull(fake.getMetadata().getCreationTimestamp());\n }\n\n @Test\n void shouldThrowExceptionIfCreatingWithoutGenerateName() {\n var fake = createFakeExtension(\"fake\", null);\n fake.getMetadata().setName(\"\");\n fake.getMetadata().setGenerateName(\"\");\n\n StepVerifier.create(client.create(fake))\n .verifyError(IllegalArgumentException.class);\n }\n\n @Test\n void shouldThrowExceptionIfPrimaryKeyDuplicated() {\n var fake = createFakeExtension(\"fake\", null);\n fake.getMetadata().setName(\"\");\n fake.getMetadata().setGenerateName(\"fake-\");\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(\"/registry/fake.halo.run/fakes/fake\"));\n when(storeClient.create(any(), any())).thenThrow(DataIntegrityViolationException.class);\n\n StepVerifier.create(client.create(fake))\n .expectErrorMatches(Exceptions::isRetryExhausted)\n .verify();\n }\n\n @Test\n void shouldCreateUsingUnstructuredSuccessfully() throws JsonProcessingException {\n var fake = createUnstructured();\n\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(\"/registry/fake.halo.run/fakes/fake\"));\n when(storeClient.create(any(), any())).thenReturn(\n Mono.just(createExtensionStore(\"/registry/fake.halo.run/fakes/fake\")));\n when(converter.convertFrom(same(Unstructured.class), any())).thenReturn(fake);\n doNothing().when(indexEngine).insert(any());\n\n StepVerifier.create(client.create(fake))\n .expectNext(fake)\n .verifyComplete();\n\n verify(converter, times(1)).convertTo(eq(fake));\n verify(storeClient, times(1)).create(eq(\"/registry/fake.halo.run/fakes/fake\"), any());\n assertNotNull(fake.getMetadata().getCreationTimestamp());\n }\n\n @Test\n void shouldUpdateSuccessfully() {\n var fake = createFakeExtension(\"fake\", 2L);\n fake.getMetadata().setLabels(Map.of(\"new\", \"true\"));\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(storeName, 2L));\n when(storeClient.update(any(), any(), any())).thenReturn(\n Mono.just(createExtensionStore(storeName, 2L)));\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(createExtensionStore(storeName, 1L)));\n doNothing().when(indexEngine).update(any());\n\n var oldFake = createFakeExtension(\"fake\", 2L);\n oldFake.getMetadata().setLabels(Map.of(\"old\", \"true\"));\n\n var updatedFake = createFakeExtension(\"fake\", 3L);\n updatedFake.getMetadata().setLabels(Map.of(\"updated\", \"true\"));\n when(converter.convertFrom(same(FakeExtension.class), any()))\n .thenReturn(oldFake)\n .thenReturn(updatedFake);\n\n StepVerifier.create(client.update(fake))\n .expectNext(updatedFake)\n .verifyComplete();\n\n verify(storeClient).fetchByName(storeName);\n verify(converter).convertTo(isA(JsonExtension.class));\n verify(converter, times(2)).convertFrom(same(FakeExtension.class), any());\n verify(storeClient)\n .update(eq(\"/registry/fake.halo.run/fakes/fake\"), eq(2L), any());\n }\n\n @Test\n void shouldNotUpdateIfExtensionNotChange() {\n var fake = createFakeExtension(\"fake\", 2L);\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(createExtensionStore(storeName, 1L)));\n\n var oldFake = createFakeExtension(\"fake\", 2L);\n\n when(converter.convertFrom(same(FakeExtension.class), any())).thenReturn(oldFake);\n\n StepVerifier.create(client.update(fake))\n .expectNext(fake)\n .verifyComplete();\n\n verify(storeClient).fetchByName(storeName);\n verify(converter).convertFrom(same(FakeExtension.class), any());\n verify(converter, never()).convertTo(any());\n verify(storeClient, never()).update(any(), any(), any());\n }\n\n @Test\n void shouldNotUpdateIfUnstructuredNotChange() throws JsonProcessingException {\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n var extensionStore = createExtensionStore(storeName, 2L);\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(extensionStore));\n\n var fakeJson = objectMapper.writeValueAsString(createFakeExtension(\"fake\", 2L));\n var oldFakeJson = objectMapper.writeValueAsString(createFakeExtension(\"fake\", 2L));\n\n var fake = objectMapper.readValue(fakeJson, Unstructured.class);\n var oldFake = objectMapper.readValue(oldFakeJson, Unstructured.class);\n oldFake.getMetadata().setVersion(2L);\n\n when(converter.convertFrom(Unstructured.class, extensionStore)).thenReturn(oldFake);\n\n StepVerifier.create(client.update(fake))\n .expectNext(fake)\n .verifyComplete();\n\n verify(storeClient).fetchByName(storeName);\n verify(converter).convertFrom(Unstructured.class, extensionStore);\n verify(converter, never()).convertTo(any());\n verify(storeClient, never()).update(any(), any(), any());\n }\n\n @Test\n void shouldUpdateIfExtensionStatusChangedOnly() {\n var fake = createFakeExtension(\"fake\", 2L);\n fake.getStatus().setState(\"new-state\");\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(storeName, 2L));\n when(storeClient.update(any(), any(), any())).thenReturn(\n Mono.just(createExtensionStore(storeName, 2L)));\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(createExtensionStore(storeName, 1L)));\n doNothing().when(indexEngine).update(any());\n\n var oldFake = createFakeExtension(\"fake\", 2L);\n oldFake.getStatus().setState(\"old-state\");\n\n var updatedFake = createFakeExtension(\"fake\", 3L);\n when(converter.convertFrom(same(FakeExtension.class), any()))\n .thenReturn(oldFake)\n .thenReturn(updatedFake);\n\n StepVerifier.create(client.update(fake))\n .expectNext(updatedFake)\n .verifyComplete();\n\n verify(storeClient).fetchByName(storeName);\n verify(converter).convertTo(isA(JsonExtension.class));\n verify(converter, times(2)).convertFrom(same(FakeExtension.class), any());\n verify(storeClient)\n .update(eq(\"/registry/fake.halo.run/fakes/fake\"), eq(2L), any());\n }\n\n @Test\n void shouldUpdateUnstructuredSuccessfully() throws JsonProcessingException {\n var fake = createUnstructured();\n var name = \"/registry/fake.halo.run/fakes/fake\";\n when(converter.convertTo(any()))\n .thenReturn(createExtensionStore(name, 12345L));\n when(storeClient.update(any(), any(), any()))\n .thenReturn(Mono.just(createExtensionStore(name, 12345L)));\n when(storeClient.fetchByName(name))\n .thenReturn(Mono.just(createExtensionStore(name, 12346L)));\n doNothing().when(indexEngine).update(any());\n\n var oldFake = createUnstructured();\n oldFake.getMetadata().setLabels(Map.of(\"old\", \"true\"));\n\n var updatedFake = createUnstructured();\n updatedFake.getMetadata().setLabels(Map.of(\"updated\", \"true\"));\n when(converter.convertFrom(same(Unstructured.class), any()))\n .thenReturn(oldFake)\n .thenReturn(updatedFake);\n\n StepVerifier.create(client.update(fake))\n .expectNext(updatedFake)\n .verifyComplete();\n\n verify(storeClient).fetchByName(name);\n verify(converter).convertTo(isA(JsonExtension.class));\n verify(converter, times(2)).convertFrom(same(Unstructured.class), any());\n verify(storeClient)\n .update(eq(\"/registry/fake.halo.run/fakes/fake\"), eq(12345L), any());\n }\n\n @Test\n void shouldDeleteSuccessfully() {\n var fake = createFakeExtension(\"fake\", 2L);\n when(converter.convertTo(any())).thenReturn(\n createExtensionStore(\"/registry/fake.halo.run/fakes/fake\"));\n when(storeClient.update(any(), any(), any())).thenReturn(\n Mono.just(createExtensionStore(\"/registry/fake.halo.run/fakes/fake\")));\n when(converter.convertFrom(same(FakeExtension.class), any())).thenReturn(fake);\n doNothing().when(indexEngine).update(any());\n\n StepVerifier.create(client.delete(fake))\n .expectNext(fake)\n .verifyComplete();\n\n verify(converter, times(1)).convertTo(any());\n verify(storeClient, times(1)).update(any(), any(), any());\n verify(storeClient, never()).delete(any(), any());\n }\n\n @Test\n void shouldGetJsonExtension() {\n var storeName = \"/registry/fake.halo.run/fakes/fake\";\n when(storeClient.fetchByName(storeName)).thenReturn(\n Mono.just(createExtensionStore(storeName)));\n\n var fake = createFakeExtension(\"fake\", 1L);\n var expectedJsonExt = objectMapper.convertValue(fake, JsonExtension.class);\n\n when(converter.convertFrom(JsonExtension.class, createExtensionStore(storeName)))\n .thenReturn(expectedJsonExt);\n\n var gvk = Scheme.buildFromType(FakeExtension.class).groupVersionKind();\n StepVerifier.create(client.getJsonExtension(gvk, \"fake\"))\n .expectNext(expectedJsonExt)\n .verifyComplete();\n\n verify(storeClient, times(1)).fetchByName(eq(storeName));\n verify(converter, times(1)).convertFrom(eq(JsonExtension.class),\n eq(createExtensionStore(storeName)));\n }\n\n\n @Nested\n @DisplayName(\"Extension watcher test\")\n class WatcherTest {\n\n @Mock\n Watcher watcher;\n\n @BeforeEach\n void setUp() {\n client.watch(watcher);\n }\n\n @Test\n void shouldWatchOnAddSuccessfully() {\n doNothing().when(watcher).onAdd(isA(Extension.class));\n shouldCreateSuccessfully();\n\n verify(watcher, times(1)).onAdd(isA(Extension.class));\n }\n\n @Test\n void shouldWatchOnUpdateSuccessfully() {\n doNothing().when(watcher).onUpdate(any(), any());\n shouldUpdateSuccessfully();\n\n verify(watcher, times(1)).onUpdate(any(), any());\n }\n\n @Test\n void shouldNotWatchOnUpdateIfExtensionNotChange() {\n shouldNotUpdateIfExtensionNotChange();\n\n verify(watcher, never()).onUpdate(any(), any());\n }\n\n @Test\n void shouldNotWatchOnUpdateIfExtensionStatusChangeOnly() {\n shouldUpdateIfExtensionStatusChangedOnly();\n\n verify(watcher, never()).onUpdate(any(), any());\n }\n\n @Test\n void shouldWatchOnDeleteSuccessfully() {\n doNothing().when(watcher).onDelete(any());\n shouldDeleteSuccessfully();\n\n verify(watcher, times(1)).onDelete(any());\n }\n\n @Test\n void shouldWatchRealTypeOnAdd() {\n var name = \"/registry/fake.halo.run/fakes/fake\";\n var extensionStore = createExtensionStore(name);\n var fake = createFakeExtension(\"fake\", 1L);\n var unstructured = Unstructured.OBJECT_MAPPER.convertValue(fake, Unstructured.class);\n\n when(converter.convertTo(unstructured)).thenReturn(extensionStore);\n when(converter.convertFrom(Unstructured.class, extensionStore))\n .thenReturn(unstructured);\n when(storeClient.create(eq(name), any(byte[].class)))\n .thenReturn(Mono.just(extensionStore));\n doNothing().when(watcher).onAdd(isA(FakeExtension.class));\n\n client.create(unstructured)\n .as(StepVerifier::create)\n .expectNext(unstructured)\n .verifyComplete();\n }\n\n @Test\n void shouldWatchRealTypeOnUpdate() {\n var name = \"/registry/fake.halo.run/fakes/fake\";\n\n var oldExtensionStore = createExtensionStore(name, 1L);\n var extensionStore = createExtensionStore(name, 2L);\n var oldFake = createFakeExtension(\"fake\", 1L);\n var fake = createFakeExtension(\"fake\", 2L);\n var oldUnstructured =\n Unstructured.OBJECT_MAPPER.convertValue(oldFake, Unstructured.class);\n var unstructured = Unstructured.OBJECT_MAPPER.convertValue(fake, Unstructured.class);\n\n when(storeClient.fetchByName(name))\n .thenReturn(Mono.just(oldExtensionStore));\n when(converter.convertFrom(Unstructured.class, oldExtensionStore))\n .thenReturn(oldUnstructured);\n when(converter.convertFrom(Unstructured.class, extensionStore))\n .thenReturn(unstructured);\n when(converter.convertTo(isA(JsonExtension.class))).thenReturn(extensionStore);\n when(storeClient.update(eq(name), eq(2L), any(byte[].class)))\n .thenReturn(Mono.just(extensionStore));\n doNothing().when(watcher).onUpdate(isA(FakeExtension.class), isA(FakeExtension.class));\n\n client.update(unstructured)\n .as(StepVerifier::create)\n .expectNext(unstructured)\n .verifyComplete();\n }\n\n @Test\n void shouldWatchRealTypeOnDelete() {\n var name = \"/registry/fake.halo.run/fakes/fake\";\n\n var extensionStore = createExtensionStore(name, 1L);\n var fake = createFakeExtension(\"fake\", 1L);\n var unstructured = Unstructured.OBJECT_MAPPER.convertValue(fake, Unstructured.class);\n\n when(converter.convertFrom(Unstructured.class, extensionStore))\n .thenReturn(unstructured);\n when(converter.convertTo(unstructured)).thenReturn(extensionStore);\n when(storeClient.update(eq(name), eq(1L), any(byte[].class)))\n .thenReturn(Mono.just(extensionStore));\n doNothing().when(watcher).onDelete(isA(FakeExtension.class));\n\n client.delete(unstructured)\n .as(StepVerifier::create)\n .expectNext(unstructured)\n .verifyComplete();\n }\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/RefTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static run.halo.app.extension.GroupVersionKind.fromAPIVersionAndKind;\nimport static run.halo.app.extension.GroupVersionKind.fromExtension;\n\nimport org.junit.jupiter.api.Test;\n\nclass RefTest {\n\n @Test\n void shouldHasSameGroupAndKind() {\n FakeExtension fake = new FakeExtension();\n Metadata metadata = new Metadata();\n metadata.setName(\"fake\");\n fake.setMetadata(metadata);\n assertTrue(Ref.groupKindEquals(Ref.of(fake), fromExtension(fake.getClass())));\n // has different version\n assertTrue(Ref.groupKindEquals(Ref.of(fake),\n fromAPIVersionAndKind(\"fake.halo.run/v11111111111\", \"Fake\")));\n assertFalse(Ref.groupKindEquals(Ref.of(fake),\n fromAPIVersionAndKind(\"fake.halo.run/v1alpha1\", \"NotFake\")));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/SchemeTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\n\nimport com.fasterxml.jackson.databind.node.JsonNodeFactory;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport org.junit.jupiter.api.Test;\n\nclass SchemeTest {\n\n @Test\n void requiredFieldTest() {\n assertThrows(IllegalArgumentException.class,\n () -> new Scheme(null, new GroupVersionKind(\"\", \"v1alpha1\", \"\"), \"\", \"\", null));\n assertThrows(IllegalArgumentException.class,\n () -> new Scheme(FakeExtension.class, new GroupVersionKind(\"\", \"\", \"\"), \"\", \"\",\n null));\n assertThrows(IllegalArgumentException.class,\n () -> new Scheme(FakeExtension.class, new GroupVersionKind(\"\", \"v1alpha1\", \"\"), \"\",\n \"\", null));\n assertThrows(IllegalArgumentException.class,\n () -> new Scheme(FakeExtension.class, new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"), \"\",\n \"\", null));\n assertThrows(IllegalArgumentException.class,\n () -> new Scheme(FakeExtension.class, new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"),\n \"fakes\", \"\", null));\n assertThrows(IllegalArgumentException.class, () -> {\n new Scheme(FakeExtension.class, new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"), \"fakes\",\n \"fake\", null);\n });\n new Scheme(FakeExtension.class, new GroupVersionKind(\"\", \"v1alpha1\", \"Fake\"), \"fakes\",\n \"fake\", new ObjectNode(null));\n }\n\n\n @Test\n void shouldThrowExceptionWhenTypeHasNoGvkAnno() {\n class NoGvkExtension extends AbstractExtension {\n }\n\n assertThrows(IllegalArgumentException.class,\n () -> Scheme.getGvkFromType(NoGvkExtension.class));\n assertThrows(IllegalArgumentException.class,\n () -> Scheme.buildFromType(NoGvkExtension.class));\n }\n\n @Test\n void shouldGetGvkFromTypeWithGvkAnno() {\n var gvk = Scheme.getGvkFromType(FakeExtension.class);\n assertEquals(\"fake.halo.run\", gvk.group());\n assertEquals(\"v1alpha1\", gvk.version());\n assertEquals(\"Fake\", gvk.kind());\n assertEquals(\"fake\", gvk.singular());\n assertEquals(\"fakes\", gvk.plural());\n }\n\n @Test\n void shouldCreateSchemeSuccessfully() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n assertEquals(new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Fake\"),\n scheme.groupVersionKind());\n assertEquals(\"fake\", scheme.singular());\n assertEquals(\"fakes\", scheme.plural());\n assertNotNull(scheme.openApiSchema());\n assertEquals(FakeExtension.class, scheme.type());\n }\n\n @Test\n void equalsAndHashCodeTest() {\n var scheme1 = Scheme.buildFromType(FakeExtension.class);\n var scheme2 = Scheme.buildFromType(FakeExtension.class);\n assertEquals(scheme1, scheme2);\n assertEquals(scheme1.hashCode(), scheme2.hashCode());\n\n // openApiSchema is not included in equals and hashCode.\n var scheme3 = new Scheme(FakeExtension.class, scheme1.groupVersionKind(),\n scheme1.plural(), scheme1.singular(), JsonNodeFactory.instance.objectNode());\n assertEquals(scheme1, scheme3);\n\n // singular and plural are not included in equals and hashCode.\n var scheme4 = new Scheme(FakeExtension.class, scheme1.groupVersionKind(),\n scheme1.plural(), \"other\", scheme1.openApiSchema());\n assertEquals(scheme1, scheme4);\n\n // plural is not included in equals and hashCode.\n var scheme5 = new Scheme(FakeExtension.class, scheme1.groupVersionKind(),\n \"other\", scheme1.singular(), scheme1.openApiSchema());\n assertEquals(scheme1, scheme5);\n\n // type is not included in equals and hashCode.\n var scheme6 = new Scheme(FakeExtension.class, scheme1.groupVersionKind(),\n scheme1.plural(), scheme1.singular(), scheme1.openApiSchema());\n assertEquals(scheme1, scheme6);\n\n // groupVersionKind is included in equals and hashCode.\n var scheme7 = new Scheme(FakeExtension.class,\n new GroupVersionKind(\"other.halo.run\", \"v1alpha1\", \"Fake\"),\n scheme1.plural(), scheme1.singular(), scheme1.openApiSchema());\n assertNotEquals(scheme1, scheme7);\n\n scheme7 = new Scheme(FakeExtension.class,\n new GroupVersionKind(\"fake.halo.run\", \"v1alpha2\", \"Fake\"),\n scheme1.plural(), scheme1.singular(), scheme1.openApiSchema());\n assertNotEquals(scheme1, scheme7);\n\n scheme7 = new Scheme(FakeExtension.class,\n new GroupVersionKind(\"fake.halo.run\", \"v1alpha1\", \"Other\"),\n scheme1.plural(), scheme1.singular(), scheme1.openApiSchema());\n assertNotEquals(scheme1, scheme7);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/UnstructuredTest.java", "content": "package run.halo.app.extension;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Set;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.test.json.JsonAssert;\nimport org.springframework.test.json.JsonCompareMode;\nimport tools.jackson.databind.json.JsonMapper;\n\nclass UnstructuredTest {\n\n ObjectMapper objectMapper = Unstructured.OBJECT_MAPPER;\n\n String extensionJson = \"\"\"\n {\n \"apiVersion\": \"fake.halo.run/v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"labels\": {\n \"category\": \"fake\",\n \"default\": \"true\"\n },\n \"name\": \"fake-extension\",\n \"creationTimestamp\": \"2011-12-03T10:15:30Z\",\n \"version\": 12345,\n \"finalizers\": [\"finalizer.1\", \"finalizer.2\"]\n }\n }\n \"\"\";\n\n @Test\n void shouldSerializeCorrectly() throws JsonProcessingException {\n Map extensionMap = objectMapper.readValue(extensionJson, Map.class);\n var extension = new Unstructured(extensionMap);\n\n var gotNode = objectMapper.valueToTree(extension);\n assertEquals(objectMapper.readTree(extensionJson), gotNode);\n }\n\n @Test\n void shouldSetCreationTimestamp() throws JsonProcessingException, JSONException {\n Map extensionMap = objectMapper.readValue(extensionJson, Map.class);\n var extension = new Unstructured(extensionMap);\n\n var beforeChange = objectMapper.writeValueAsString(extension);\n\n var metadata = extension.getMetadata();\n metadata.setCreationTimestamp(metadata.getCreationTimestamp());\n\n var afterChange = objectMapper.writeValueAsString(extension);\n\n JSONAssert.assertEquals(beforeChange, afterChange, true);\n }\n\n @Test\n void shouldDeserializeCorrectly() throws JsonProcessingException, JSONException {\n var extension = objectMapper.readValue(extensionJson, Unstructured.class);\n var gotJson = objectMapper.writeValueAsString(extension);\n JSONAssert.assertEquals(extensionJson, gotJson, true);\n }\n\n @Test\n void shouldGetExtensionCorrectly() throws JsonProcessingException {\n var extension = objectMapper.readValue(extensionJson, Unstructured.class);\n\n assertEquals(\"fake.halo.run/v1alpha1\", extension.getApiVersion());\n assertEquals(\"Fake\", extension.getKind());\n MetadataOperator.equals(createMetadata(), extension.getMetadata());\n }\n\n @Test\n void shouldSetExtensionCorrectly() {\n var extension = createUnstructured();\n\n assertEquals(\"fake.halo.run/v1alpha1\", extension.getApiVersion());\n assertEquals(\"Fake\", extension.getKind());\n assertTrue(MetadataOperator.equals(createMetadata(), extension.getMetadata()));\n }\n\n @Test\n void shouldBeEqual() {\n assertEquals(new Unstructured(), new Unstructured());\n assertEquals(createUnstructured(), createUnstructured());\n }\n\n @Test\n void shouldNotBeEqual() {\n var another = createUnstructured();\n another.getMetadata().setName(\"fake-extension-2\");\n assertNotEquals(createUnstructured(), another);\n }\n\n @Test\n void shouldGetFinalizersCorrectly() throws JsonProcessingException {\n var extension = objectMapper.readValue(extensionJson, Unstructured.class);\n\n assertEquals(Set.of(\"finalizer.1\", \"finalizer.2\"), extension.getMetadata().getFinalizers());\n\n extension.getMetadata().setFinalizers(Set.of(\"finalizer.3\", \"finalizer.4\"));\n assertEquals(Set.of(\"finalizer.3\", \"finalizer.4\"), extension.getMetadata().getFinalizers());\n }\n\n @Test\n void shouldSetLabelsCorrectly() throws JsonProcessingException {\n var extension = objectMapper.readValue(extensionJson, Unstructured.class);\n\n assertEquals(Map.of(\"category\", \"fake\", \"default\", \"true\"),\n extension.getMetadata().getLabels());\n\n extension.getMetadata().setLabels(Map.of(\"category\", \"fake\", \"default\", \"false\"));\n assertEquals(Map.of(\"category\", \"fake\", \"default\", \"false\"),\n extension.getMetadata().getLabels());\n }\n\n @Test\n void shouldSetAnnotationsCorrectly() throws JsonProcessingException {\n var extension = objectMapper.readValue(extensionJson, Unstructured.class);\n\n assertNull(extension.getMetadata().getAnnotations());\n\n extension.getMetadata()\n .setAnnotations(Map.of(\"annotation1\", \"value1\", \"annotation2\", \"value2\"));\n assertEquals(Map.of(\"annotation1\", \"value1\", \"annotation2\", \"value2\"),\n extension.getMetadata().getAnnotations());\n }\n\n @Nested\n class JacksonJson3Test {\n\n JsonMapper jsonMapper = JsonMapper.shared();\n\n @Test\n void shouldSerializeCorrectly() {\n var json = \"\"\"\n {\n \"apiVersion\": \"fake.halo.run/v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"labels\": {\n \"category\": \"fake\",\n \"default\": \"true\"\n },\n \"name\": \"fake-extension\",\n \"creationTimestamp\": \"2011-12-03T10:15:30Z\",\n \"version\": 12345\n },\n \"spec\": {\n \"field1\": \"value1\",\n \"field2\": 2\n }\n }\n \"\"\";\n var unstructured = jsonMapper.readValue(json, Unstructured.class);\n assertEquals(\"fake-extension\", unstructured.getMetadata().getName());\n assertEquals(\"fake.halo.run/v1alpha1\", unstructured.getApiVersion());\n assertEquals(\"Fake\", unstructured.getKind());\n assertEquals(\"fake\", unstructured.getMetadata().getLabels().get(\"category\"));\n assertEquals(\"true\", unstructured.getMetadata().getLabels().get(\"default\"));\n assertEquals(Instant.parse(\"2011-12-03T10:15:30Z\"),\n unstructured.getMetadata().getCreationTimestamp());\n assertEquals(12345L, unstructured.getMetadata().getVersion());\n\n var field1 =\n Unstructured.getNestedValue(unstructured.getData(), \"spec\", \"field1\").orElse(null);\n var field2 =\n Unstructured.getNestedValue(unstructured.getData(), \"spec\", \"field2\").orElse(null);\n assertEquals(\"value1\", field1);\n assertEquals(2, field2);\n }\n\n @Test\n void shouldDeserializeCorrectly() {\n var u = new Unstructured();\n u.setApiVersion(\"fake.halo.run/v1alpha1\");\n u.setKind(\"Fake\");\n var metadata = new Metadata();\n metadata.setName(\"fake-extension\");\n u.setMetadata(metadata);\n Unstructured.setNestedValue(u.getData(), new HashMap<>(), \"spec\");\n Unstructured.setNestedValue(u.getData(), \"value1\", \"spec\", \"field1\");\n\n var json = jsonMapper.writeValueAsString(u);\n JsonAssert.comparator(JsonCompareMode.STRICT).assertIsMatch(\"\"\"\n {\n \"apiVersion\": \"fake.halo.run/v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"name\": \"fake-extension\"\n },\n \"spec\": {\n \"field1\": \"value1\"\n }\n }\n \"\"\", json);\n }\n }\n\n Unstructured createUnstructured() {\n var unstructured = new Unstructured();\n unstructured.setApiVersion(\"fake.halo.run/v1alpha1\");\n unstructured.setKind(\"Fake\");\n unstructured.setMetadata(createMetadata());\n return unstructured;\n }\n\n private Metadata createMetadata() {\n var metadata = new Metadata();\n metadata.setName(\"fake-extension\");\n metadata.setLabels(Map.of(\"category\", \"fake\", \"default\", \"true\"));\n metadata.setCreationTimestamp(Instant.parse(\"2011-12-03T10:15:30Z\"));\n metadata.setVersion(12345L);\n return metadata;\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/gc/GcReconcilerTest.java", "content": "package run.halo.app.extension.gc;\n\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.transaction.ReactiveTransaction;\nimport org.springframework.transaction.ReactiveTransactionManager;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.ExtensionConverter;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.index.IndexEngine;\nimport run.halo.app.extension.store.ExtensionStore;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\n\n@ExtendWith(MockitoExtension.class)\nclass GcReconcilerTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n ReactiveExtensionStoreClient storeClient;\n\n @Mock\n ExtensionConverter converter;\n\n @Mock\n SchemeManager schemeManager;\n\n @Mock\n IndexEngine indexEngine;\n\n @Mock\n ReactiveTransactionManager txManager;\n\n @InjectMocks\n GcReconciler reconciler;\n\n @BeforeEach\n void setUp() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n when(schemeManager.get(scheme.groupVersionKind())).thenReturn(scheme);\n }\n\n @Test\n void shouldDoNothingIfExtensionNotFound() {\n var fake = createExtension();\n when(client.fetch(FakeExtension.class, fake.getMetadata().getName()))\n .thenReturn(Optional.empty());\n\n var result = reconciler.reconcile(createGcRequest());\n assertNull(result);\n verify(converter, never()).convertTo(any());\n verify(storeClient, never()).delete(any(), any());\n }\n\n @Test\n void shouldDoNothingIfFinalizersPresent() {\n var fake = createExtension();\n fake.getMetadata().setFinalizers(Set.of(\"fake-finalizer\"));\n fake.getMetadata().setDeletionTimestamp(null);\n when(client.fetch(FakeExtension.class, fake.getMetadata().getName()))\n .thenReturn(Optional.of(fake));\n\n var result = reconciler.reconcile(createGcRequest());\n assertNull(result);\n verify(converter, never()).convertTo(any());\n verify(storeClient, never()).delete(any(), any());\n }\n\n @Test\n void shouldDoNothingIfDeletionTimestampIsNull() {\n var fake = createExtension();\n fake.getMetadata().setDeletionTimestamp(null);\n fake.getMetadata().setFinalizers(null);\n when(client.fetch(FakeExtension.class, fake.getMetadata().getName()))\n .thenReturn(Optional.of(fake));\n\n var result = reconciler.reconcile(createGcRequest());\n assertNull(result);\n verify(converter, never()).convertTo(any());\n verify(storeClient, never()).delete(any(), any());\n }\n\n @Test\n void shouldDeleteCorrectly() {\n var fake = createExtension();\n fake.getMetadata().setDeletionTimestamp(Instant.now());\n fake.getMetadata().setFinalizers(null);\n when(client.fetch(FakeExtension.class, fake.getMetadata().getName()))\n .thenReturn(Optional.of(fake));\n\n ExtensionStore store = new ExtensionStore();\n store.setName(\"fake-store-name\");\n store.setVersion(1L);\n\n when(converter.convertTo(any())).thenReturn(store);\n doNothing().when(indexEngine).delete(any());\n var tx = mock(ReactiveTransaction.class);\n when(txManager.getReactiveTransaction(any())).thenReturn(Mono.just(tx));\n when(txManager.commit(tx)).thenReturn(Mono.empty());\n when(storeClient.delete(\"fake-store-name\", 1L)).thenReturn(Mono.just(store));\n\n var result = reconciler.reconcile(createGcRequest());\n assertNull(result);\n verify(converter).convertTo(any());\n verify(storeClient).delete(\"fake-store-name\", 1L);\n }\n\n GcRequest createGcRequest() {\n var fake = createExtension();\n return new GcRequest(fake.groupVersionKind(), fake.getMetadata().getName());\n }\n\n FakeExtension createExtension() {\n var fake = new FakeExtension();\n var metadata = new Metadata();\n metadata.setName(\"fake\");\n fake.setMetadata(metadata);\n return fake;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/gc/GcSynchronizerTest.java", "content": "package run.halo.app.extension.gc;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.verify;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.SchemeManager;\n\n@ExtendWith(MockitoExtension.class)\nclass GcSynchronizerTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n SchemeManager schemeManager;\n\n @InjectMocks\n GcSynchronizer synchronizer;\n\n @Test\n void shouldStartNormally() {\n synchronizer.start();\n\n assertFalse(synchronizer.isDisposed());\n verify(client).watch(isA(GcWatcher.class));\n verify(schemeManager).schemes();\n }\n\n @Test\n void shouldDisposeSuccessfully() {\n assertFalse(synchronizer.isDisposed());\n\n synchronizer.dispose();\n\n assertTrue(synchronizer.isDisposed());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/gc/GcWatcherTest.java", "content": "package run.halo.app.extension.gc;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\n\nimport java.time.Instant;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.RequestQueue;\n\n@ExtendWith(MockitoExtension.class)\nclass GcWatcherTest {\n\n @Mock\n RequestQueue queue;\n\n @InjectMocks\n GcWatcher watcher;\n\n @Test\n void shouldAddIntoQueueWhenDeletionTimestampSet() {\n var fake = createExtension();\n fake.getMetadata().setDeletionTimestamp(Instant.now());\n\n watcher.onAdd(fake);\n verify(queue).addImmediately(any(GcRequest.class));\n\n watcher.onUpdate(fake, fake);\n verify(queue, times(2)).addImmediately(any(GcRequest.class));\n\n watcher.onDelete(fake);\n verify(queue, times(3)).addImmediately(any(GcRequest.class));\n }\n\n @Test\n void shouldNotAddIntoQueueWhenDeletionTimestampNotSet() {\n var fake = createExtension();\n watcher.onAdd(fake);\n verify(queue, never()).addImmediately(any(GcRequest.class));\n\n watcher.onUpdate(fake, fake);\n verify(queue, never()).addImmediately(any(GcRequest.class));\n\n watcher.onDelete(fake);\n verify(queue, never()).addImmediately(any(GcRequest.class));\n }\n\n @Test\n void shouldNotAddIntoQueueWhenDisposed() {\n var fake = createExtension();\n fake.getMetadata().setDeletionTimestamp(Instant.now());\n watcher.dispose();\n\n watcher.onAdd(fake);\n verify(queue, never()).addImmediately(any(GcRequest.class));\n\n watcher.onUpdate(fake, fake);\n verify(queue, never()).addImmediately(any(GcRequest.class));\n\n watcher.onDelete(fake);\n verify(queue, never()).addImmediately(any(GcRequest.class));\n }\n\n @Test\n void shouldDisposeHookCorrectly() {\n var run = mock(Runnable.class);\n watcher.registerDisposeHook(run);\n assertFalse(watcher.isDisposed());\n watcher.dispose();\n assertTrue(watcher.isDisposed());\n verify(run).run();\n }\n\n\n FakeExtension createExtension() {\n var fake = new FakeExtension();\n Metadata metadata = new Metadata();\n metadata.setName(\"fake\");\n fake.setMetadata(metadata);\n return fake;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/index/DefaultIndexEngineTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.data.domain.Sort.Direction.ASC;\nimport static org.springframework.data.domain.Sort.Direction.DESC;\n\nimport java.util.List;\nimport java.util.Set;\nimport java.util.stream.Collectors;\nimport java.util.stream.IntStream;\nimport java.util.stream.StreamSupport;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.convert.ConversionService;\nimport org.springframework.data.domain.Sort;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequestImpl;\nimport run.halo.app.extension.index.query.Queries;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultIndexEngineTest {\n\n @Mock\n ConversionService conversionService;\n\n @Mock\n IndicesManager indicesManager;\n\n @Mock\n Indices indices;\n\n @Mock\n SingleValueIndex singleValueIndex;\n\n @InjectMocks\n DefaultIndexEngine engine;\n\n @BeforeEach\n void setUp() {\n lenient().when(indicesManager.get(Fake.class)).thenReturn(indices);\n engine.setIndicesManager(indicesManager);\n assertEquals(indicesManager, engine.getIndicesManager());\n }\n\n @Test\n void shouldDestroyIndicesOnClose() throws Exception {\n engine.destroy();\n verify(indicesManager).close();\n }\n\n @Test\n void shouldInsertExtensions() {\n var fake = createFake(\"fake\");\n\n engine.insert(List.of(fake));\n\n verify(indices).insert(fake);\n }\n\n @Test\n void shouldUpdateExtensions() {\n var fake = createFake(\"fake\");\n\n engine.update(List.of(fake));\n\n verify(indices).update(fake);\n }\n\n @Test\n void shouldDeleteExtensions() {\n var fake = createFake(\"fake\");\n\n engine.delete(List.of(fake));\n\n verify(indices).delete(fake);\n }\n\n @Test\n void shouldRetrieveWithConditionsAndPage() {\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n var page = PageRequestImpl.of(2, 2);\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\", \"4\", \"5\", \"6\"));\n var result = engine.retrieve(Fake.class, options, page);\n assertEquals(6, result.getTotal());\n assertEquals(List.of(\"3\", \"4\"), result.getItems());\n }\n\n @Test\n void shouldRetrieveWithConditionsAndFirstPage() {\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\", \"4\", \"5\", \"6\"));\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n var page = PageRequestImpl.of(1, 4);\n var result = engine.retrieve(Fake.class, options, page);\n assertEquals(6, result.getTotal());\n assertEquals(List.of(\"1\", \"2\", \"3\", \"4\"), result.getItems());\n }\n\n @Test\n void shouldRetrieveWithConditionsAndLastPage() {\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\", \"4\", \"5\", \"6\"));\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n var page = PageRequestImpl.of(2, 4);\n var result = engine.retrieve(Fake.class, options, page);\n assertEquals(6, result.getTotal());\n assertEquals(List.of(\"5\", \"6\"), result.getItems());\n }\n\n @Test\n void shouldRetrieveWithConditionsAndExceededPage() {\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\", \"4\", \"5\", \"6\"));\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n var page = PageRequestImpl.of(4, 2);\n var result = engine.retrieve(Fake.class, options, page);\n assertEquals(6, result.getTotal());\n assertEquals(List.of(), result.getItems());\n }\n\n @Test\n void shouldRetrieveAllWithConditionsAndNonPositiveSize() {\n var allResult = IntStream.rangeClosed(1, 1001)\n .boxed()\n .map(o -> String.format(\"%04d\", o))\n .collect(Collectors.toSet());\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(allResult);\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n var page = PageRequestImpl.of(1, 0);\n var result = engine.retrieve(Fake.class, options, page);\n assertEquals(1001, result.getTotal());\n assertEquals(1000, result.getItems().size());\n assertEquals(\"0001\", result.getItems().getFirst());\n assertEquals(\"1000\", result.getItems().getLast());\n }\n\n @Test\n void shouldRetrieveAllWithConditions() {\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\"));\n when(singleValueIndex.getKey(\"1\")).thenReturn(\"1\");\n when(singleValueIndex.getKey(\"2\")).thenReturn(\"2\");\n when(singleValueIndex.getKey(\"3\")).thenReturn(\"3\");\n var result = engine.retrieveAll(Fake.class, options, Sort.by(DESC, \"metadata.name\"));\n assertEquals(List.of(\"3\", \"2\", \"1\"),\n StreamSupport.stream(result.spliterator(), false).toList()\n );\n }\n\n @Test\n void shouldRetrieveTopNWithConditions() {\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\", \"4\", \"5\"));\n when(singleValueIndex.getKey(\"1\")).thenReturn(\"1\");\n when(singleValueIndex.getKey(\"2\")).thenReturn(\"2\");\n when(singleValueIndex.getKey(\"3\")).thenReturn(\"3\");\n when(singleValueIndex.getKey(\"4\")).thenReturn(\"4\");\n when(singleValueIndex.getKey(\"5\")).thenReturn(\"5\");\n var result = engine.retrieveTopN(Fake.class, options, Sort.by(DESC, \"metadata.name\"), 3);\n assertEquals(List.of(\"5\", \"4\", \"3\"),\n StreamSupport.stream(result.spliterator(), false).toList()\n );\n\n result = engine.retrieveTopN(Fake.class, options, Sort.by(ASC, \"metadata.name\"), 2);\n assertEquals(List.of(\"1\", \"2\"), StreamSupport.stream(result.spliterator(), false).toList());\n }\n\n @Test\n void shouldCountWithConditions() {\n var options = ListOptions.builder()\n .andQuery(Queries.all(\"metadata.name\"))\n .build();\n when(indices.getIndex(\"metadata.name\")).thenReturn(singleValueIndex);\n when(singleValueIndex.all()).thenReturn(Set.of(\"1\", \"2\", \"3\", \"4\"));\n var count = engine.count(Fake.class, options);\n assertEquals(4L, count);\n }\n\n Fake createFake(String name) {\n var fake = new Fake();\n fake.setMetadata(new Metadata());\n fake.getMetadata().setName(name);\n return fake;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/index/DefaultIndicesManagerTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertSame;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultIndicesManagerTest {\n\n @Mock\n SingleValueIndexSpec singleValueIndexSpec;\n\n @Mock\n MultiValueIndexSpec multiValueIndexSpec;\n\n @Mock\n SingleValueIndexSpec duplicateNameIndexSpec;\n\n @InjectMocks\n DefaultIndicesManager indicesManager;\n\n @BeforeEach\n void setUp() {\n lenient().when(singleValueIndexSpec.getName()).thenReturn(\"singleValueIndex\");\n lenient().when(multiValueIndexSpec.getName()).thenReturn(\"multiValueIndex\");\n }\n\n @Test\n void shouldAddDefaultIndexSpecs() {\n indicesManager.add(Fake.class, List.of(singleValueIndexSpec, multiValueIndexSpec));\n var indices = indicesManager.get(Fake.class);\n assertNotNull(indices.getIndex(\"metadata.name\"));\n assertNotNull(indices.getIndex(\"metadata.creationTimestamp\"));\n assertNotNull(indices.getIndex(\"metadata.deletionTimestamp\"));\n assertNotNull(indices.getIndex(\"singleValueIndex\"));\n assertNotNull(indices.getIndex(\"multiValueIndex\"));\n }\n\n @Test\n void shouldThrowExceptionForUnknownType() {\n assertThrows(IllegalArgumentException.class, () -> indicesManager.get(Fake.class));\n }\n\n @Test\n void shouldCloseIndicesManager() throws Exception {\n indicesManager.add(Fake.class, List.of(singleValueIndexSpec, multiValueIndexSpec));\n indicesManager.close();\n assertThrows(IllegalArgumentException.class, () -> indicesManager.get(Fake.class));\n }\n\n @Test\n void shouldNotOverwriteDefaultIndices() {\n when(duplicateNameIndexSpec.getName()).thenReturn(\"metadata.name\");\n indicesManager.add(Fake.class, List.of(duplicateNameIndexSpec));\n var indices = indicesManager.get(Fake.class);\n var nameIndex = indices.getIndex(\"metadata.name\");\n assertSame(String.class, nameIndex.getKeyType());\n }\n\n @Test\n void shouldRemoveIndices() {\n indicesManager.add(Fake.class, List.of(singleValueIndexSpec, multiValueIndexSpec));\n indicesManager.remove(Fake.class);\n assertThrows(IllegalArgumentException.class, () -> indicesManager.get(Fake.class));\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/index/DefaultIndicesTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.doThrow;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.Metadata;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultIndicesTest {\n\n @Mock\n Index index1;\n\n @Mock\n Index index2;\n\n @Mock\n Index index3;\n\n @Mock\n Index longIndex;\n\n DefaultIndices indices;\n\n @BeforeEach\n void setUp() {\n when(index1.getName()).thenReturn(\"index1\");\n when(index2.getName()).thenReturn(\"index2\");\n when(index3.getName()).thenReturn(\"index3\");\n indices = new DefaultIndices<>(List.of(index1, index2, index3));\n }\n\n @Test\n void shouldNotReplaceWhenDuplicateIndexNames() {\n when(longIndex.getName()).thenReturn(\"index1\");\n indices = new DefaultIndices<>(List.of(index1, longIndex));\n // The first index should be retained\n assertEquals(index1, indices.getIndex(\"index1\"));\n }\n\n @Test\n void shouldInsertCorrectly() {\n var fake = createFake(\"fake\");\n\n var to = mock(TransactionalOperation.class);\n doNothing().when(to).prepare();\n doNothing().when(to).commit();\n\n when(index1.prepareInsert(fake)).thenReturn(to);\n when(index2.prepareInsert(fake)).thenReturn(to);\n when(index3.prepareInsert(fake)).thenReturn(to);\n\n indices.insert(fake);\n\n verify(index1).prepareInsert(fake);\n verify(index2).prepareInsert(fake);\n verify(index3).prepareInsert(fake);\n\n verify(to, times(3)).prepare();\n verify(to, times(3)).commit();\n verify(to, never()).rollback();\n }\n\n @Test\n void shouldUpdateCorrectly() {\n var fake = createFake(\"fake\");\n\n var to = mock(TransactionalOperation.class);\n doNothing().when(to).prepare();\n doNothing().when(to).commit();\n\n when(index1.prepareUpdate(fake)).thenReturn(to);\n when(index2.prepareUpdate(fake)).thenReturn(to);\n when(index3.prepareUpdate(fake)).thenReturn(to);\n\n indices.update(fake);\n\n verify(index1).prepareUpdate(fake);\n verify(index2).prepareUpdate(fake);\n verify(index3).prepareUpdate(fake);\n\n verify(to, times(3)).prepare();\n verify(to, times(3)).commit();\n verify(to, never()).rollback();\n }\n\n @Test\n void shouldDeleteCorrectly() {\n var to = mock(TransactionalOperation.class);\n doNothing().when(to).prepare();\n doNothing().when(to).commit();\n\n var name = \"fake\";\n when(index1.prepareDelete(name)).thenReturn(to);\n when(index2.prepareDelete(name)).thenReturn(to);\n when(index3.prepareDelete(name)).thenReturn(to);\n\n var fake = createFake(name);\n indices.delete(fake);\n\n verify(index1).prepareDelete(name);\n verify(index2).prepareDelete(name);\n verify(index3).prepareDelete(name);\n\n verify(to, times(3)).prepare();\n verify(to, times(3)).commit();\n verify(to, never()).rollback();\n }\n\n @Test\n void shouldRollbackOnInsertFailure() {\n var fake = createFake(\"fake\");\n\n var to1 = mock(TransactionalOperation.class);\n var to2 = mock(TransactionalOperation.class);\n var to3 = mock(TransactionalOperation.class);\n\n doNothing().when(to1).prepare();\n doNothing().when(to1).commit();\n\n doNothing().when(to2).prepare();\n // Simulate failure on second index\n doThrow(new RuntimeException(\"Insert failed\")).when(to2).commit();\n\n doNothing().when(to3).prepare();\n\n when(index1.prepareInsert(fake)).thenReturn(to1);\n when(index2.prepareInsert(fake)).thenReturn(to2);\n when(index3.prepareInsert(fake)).thenReturn(to3);\n\n assertThrows(RuntimeException.class, () -> indices.insert(fake));\n\n verify(to1).prepare();\n verify(to1).commit();\n verify(to1).rollback();\n\n verify(to2).prepare();\n verify(to2).commit();\n verify(to2).rollback();\n\n verify(to3).prepare();\n // to3 not committed, so no rollback\n verify(to3, never()).commit();\n verify(to3).rollback();\n }\n\n @Test\n void shouldRollbackOnUpdateFailure() {\n var fake = createFake(\"fake\");\n\n var to1 = mock(TransactionalOperation.class);\n var to2 = mock(TransactionalOperation.class);\n var to3 = mock(TransactionalOperation.class);\n\n doNothing().when(to1).prepare();\n doNothing().when(to1).commit();\n\n doNothing().when(to2).prepare();\n // Simulate failure on second index\n doThrow(new RuntimeException(\"Update failed\")).when(to2).commit();\n\n doNothing().when(to3).prepare();\n\n when(index1.prepareUpdate(fake)).thenReturn(to1);\n when(index2.prepareUpdate(fake)).thenReturn(to2);\n when(index3.prepareUpdate(fake)).thenReturn(to3);\n\n assertThrows(RuntimeException.class, () -> indices.update(fake));\n\n verify(to1).prepare();\n verify(to1).commit();\n verify(to1).rollback();\n\n verify(to2).prepare();\n verify(to2).commit();\n verify(to2).rollback();\n\n verify(to3).prepare();\n // to3 not committed, so no rollback\n verify(to3, never()).commit();\n verify(to3).rollback();\n }\n\n @Test\n void shouldRollbackOnDeleteFailure() {\n var to1 = mock(TransactionalOperation.class);\n var to2 = mock(TransactionalOperation.class);\n var to3 = mock(TransactionalOperation.class);\n\n doNothing().when(to1).prepare();\n doNothing().when(to1).commit();\n\n doNothing().when(to2).prepare();\n // Simulate failure on second index\n doThrow(new RuntimeException(\"Delete failed\")).when(to2).commit();\n\n doNothing().when(to3).prepare();\n\n var name = \"fake\";\n when(index1.prepareDelete(name)).thenReturn(to1);\n when(index2.prepareDelete(name)).thenReturn(to2);\n when(index3.prepareDelete(name)).thenReturn(to3);\n\n var fake = createFake(name);\n assertThrows(RuntimeException.class, () -> indices.delete(fake));\n\n verify(to1).prepare();\n verify(to1).commit();\n verify(to1).rollback();\n\n verify(to2).prepare();\n verify(to2).commit();\n verify(to2).rollback();\n\n verify(to3).prepare();\n // to3 not committed, so no rollback\n verify(to3, never()).commit();\n verify(to3).rollback();\n }\n\n @Test\n void shouldGetIndexCorrectly() {\n assertEquals(index1, indices.getIndex(\"index1\"));\n assertEquals(index2, indices.getIndex(\"index2\"));\n assertEquals(index3, indices.getIndex(\"index3\"));\n\n assertThrows(IllegalArgumentException.class, () -> indices.getIndex(\"non-existent\"));\n }\n\n @Test\n void shouldCloseIndicesCorrectly() throws Exception {\n doNothing().when(index1).close();\n doNothing().when(index2).close();\n doNothing().when(index3).close();\n\n indices.close();\n\n verify(index1).close();\n verify(index2).close();\n verify(index3).close();\n\n var fake = createFake(\"fake\");\n assertThrows(IllegalStateException.class, () -> indices.insert(fake));\n assertThrows(IllegalStateException.class, () -> indices.update(fake));\n assertThrows(IllegalStateException.class, () -> indices.delete(fake));\n assertThrows(IllegalStateException.class, () -> indices.getIndex(\"index1\"));\n }\n\n Fake createFake(String name) {\n var fake = new Fake();\n fake.setMetadata(new Metadata());\n fake.getMetadata().setName(name);\n return fake;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/index/Fake.java", "content": "package run.halo.app.extension.index;\n\nimport java.util.HashSet;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\n\n@GVK(\n group = \"fake.halo.app\",\n version = \"v1\",\n kind = \"Fake\",\n singular = \"fake\",\n plural = \"fakes\"\n)\n@Data\n@EqualsAndHashCode(callSuper = true)\nclass Fake extends AbstractExtension {\n\n private Set stringValues = new HashSet<>();\n\n private String stringValue;\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/index/LabelIndexTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.io.IOException;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Metadata;\n\n@ExtendWith(MockitoExtension.class)\nclass LabelIndexTest {\n\n @InjectMocks\n LabelIndex index;\n\n @Nested\n class IndexOperationTests {\n\n @Test\n void shouldInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.getMetadata().setLabels(Map.of(\"k1\", \"v1\", \"k2\", \"v2\"));\n\n var op = index.prepareInsert(fake);\n op.prepare();\n op.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"k1\", \"v1\"));\n assertEquals(Set.of(\"fake\"), index.exists(\"k1\"));\n assertTrue(index.equal(\"k1\", \"non-existent\").isEmpty());\n }\n\n @Test\n void shouldUpdateAndRollbackCorrectly() throws Exception {\n var fake = createFake(\"fake\");\n fake.getMetadata().setLabels(Map.of(\"k1\", \"v1\"));\n // insert\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n // update to v2\n fake.getMetadata().setLabels(Map.of(\"k1\", \"v2\"));\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertTrue(index.equal(\"k1\", \"v1\").isEmpty());\n assertEquals(Set.of(\"fake\"), index.equal(\"k1\", \"v2\"));\n\n // rollback should restore previous state (v1)\n update.rollback();\n assertEquals(Set.of(\"fake\"), index.equal(\"k1\", \"v1\"));\n assertTrue(index.equal(\"k1\", \"v2\").isEmpty());\n }\n\n @Test\n void shouldDeleteAndRollbackCorrectly() throws Exception {\n var fake = createFake(\"fake\");\n fake.getMetadata().setLabels(Map.of(\"k1\", \"v1\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n\n assertTrue(index.equal(\"k1\", \"v1\").isEmpty());\n // rollback restores it\n delete.rollback();\n assertEquals(Set.of(\"fake\"), index.equal(\"k1\", \"v1\"));\n }\n\n @Test\n void shouldTreatEmptyLabelsAsEmptySet() throws Exception {\n var fake = createFake(\"empty\");\n fake.getMetadata().setLabels(Map.of());\n var op = index.prepareInsert(fake);\n op.prepare();\n op.commit();\n\n // no entries for any label key\n assertTrue(index.exists(\"any\").isEmpty());\n assertTrue(index.equal(\"any\", \"any\").isEmpty());\n }\n\n @Test\n void shouldCloseIndexCorrectly() throws IOException {\n var fake = createFake(\"f\");\n fake.getMetadata().setLabels(Map.of(\"k\", \"v\"));\n insert(fake);\n\n index.close();\n\n assertTrue(index.exists(\"k\").isEmpty());\n assertTrue(index.equal(\"k\", \"v\").isEmpty());\n }\n }\n\n @Nested\n class QueryTests {\n\n @BeforeEach\n void setUp() {\n index = new LabelIndex<>(); // fresh\n var f1 = createFake(\"f1\");\n f1.getMetadata().setLabels(Map.of(\"k1\", \"v1\"));\n\n var f2 = createFake(\"f2\");\n f2.getMetadata().setLabels(Map.of(\"k1\", \"v2\"));\n\n var f3 = createFake(\"f3\");\n f3.getMetadata().setLabels(Map.of(\"k1\", \"v3\"));\n\n insert(f1);\n insert(f2);\n insert(f3);\n }\n\n @Test\n void existsQuery() {\n assertEquals(Set.of(\"f1\", \"f2\", \"f3\"), index.exists(\"k1\"));\n assertTrue(index.exists(\"non-existent\").isEmpty());\n }\n\n @Test\n void equalAndNotEqualQuery() {\n assertEquals(Set.of(\"f1\"), index.equal(\"k1\", \"v1\"));\n assertEquals(Set.of(\"f2\", \"f3\"), index.notEqual(\"k1\", \"v1\"));\n }\n\n @Test\n void inAndNotInQuery() {\n var inResult = index.in(\"k1\", List.of(\"v1\", \"v3\", \"non-existent\"));\n assertEquals(Set.of(\"f1\", \"f3\"), inResult);\n\n var notInResult = index.notIn(\"k1\", List.of(\"v1\", \"non-existent\"));\n assertEquals(Set.of(\"f2\", \"f3\"), notInResult);\n }\n }\n\n void insert(Fake fake) {\n var op = index.prepareInsert(fake);\n op.prepare();\n op.commit();\n }\n\n Fake createFake(String name) {\n var fake = new Fake();\n fake.setMetadata(new Metadata());\n fake.getMetadata().setName(name);\n return fake;\n }\n\n @GVK(\n group = \"fake.halo.app\",\n version = \"v1\",\n kind = \"Fake\",\n singular = \"fake\",\n plural = \"fakes\"\n )\n @Data\n @EqualsAndHashCode(callSuper = true)\n static class Fake extends AbstractExtension {\n // ...existing code...\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/index/MultiValueIndexTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.lenient;\n\nimport java.io.IOException;\nimport java.util.Collections;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.dao.DuplicateKeyException;\nimport run.halo.app.extension.Metadata;\n\n@ExtendWith(MockitoExtension.class)\nclass MultiValueIndexTest {\n\n @Mock\n MultiValueIndexSpec spec;\n\n @InjectMocks\n MultiValueIndex index;\n\n @Nested\n class UniqueMultiValueTests {\n\n @BeforeEach\n void setUp() {\n lenient().when(spec.getName()).thenReturn(\"metadata.name\");\n lenient().when(spec.getKeyType()).thenReturn(String.class);\n lenient().when(spec.isUnique()).thenReturn(true);\n lenient().when(spec.getValues(any(Fake.class))).thenAnswer(invocation -> {\n Fake fake = invocation.getArgument(0);\n return fake.getStringValues();\n });\n }\n\n @Test\n void shouldCloseIndexCorrectly() throws IOException {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"a\", \"b\"));\n insert(fake);\n\n index.close();\n\n assertTrue(index.all().isEmpty());\n }\n\n @Nested\n class IndexOperationTest {\n\n @Test\n void shouldGetKeyType() {\n assertEquals(String.class, index.getKeyType());\n }\n\n @Test\n void shouldInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n assertEquals(Set.of(\"fake\"), index.equal(\"s2\"));\n assertEquals(Set.of(\"s1\", \"s2\"), index.getKeys(\"fake\"));\n assertTrue(index.isNull().isEmpty());\n }\n\n @Test\n void shouldRollbackInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n insert.rollback();\n\n assertTrue(index.all().isEmpty());\n }\n\n @Test\n void shouldUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValues(Set.of(\"s2\", \"s3\"));\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertTrue(index.equal(\"s1\").isEmpty());\n assertEquals(Set.of(\"fake\"), index.equal(\"s2\"));\n assertEquals(Set.of(\"fake\"), index.equal(\"s3\"));\n assertEquals(Set.of(\"s2\", \"s3\"), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldRollbackUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValues(Set.of(\"s2\"));\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n update.rollback();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n assertTrue(index.equal(\"s2\").isEmpty());\n assertEquals(Set.of(\"s1\"), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n\n assertTrue(index.all().isEmpty());\n }\n\n @Test\n void shouldHandleDeleteIfPrimaryKeyNotExist() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"non-existent-fake\");\n delete.prepare();\n delete.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n }\n\n @Test\n void shouldRollbackDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n delete.rollback();\n\n // rollback restores previous keys\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n assertEquals(Set.of(\"fake\"), index.equal(\"s2\"));\n assertEquals(Set.of(\"s1\", \"s2\"), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldHandleDuplicateKeysOnInsert() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValues(Set.of(\"common\"));\n\n // first insert\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n // second insert with the same key -> duplicate occurs on commit\n var fake2 = createFake(\"fake2\");\n fake2.setStringValues(Set.of(\"common\"));\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n assertThrows(DuplicateKeyException.class, insert2::commit);\n }\n\n @Test\n void shouldHandleDuplicateKeysOnUpdate() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValues(Set.of(\"s1\"));\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValues(Set.of(\"s2\"));\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n insert2.commit();\n\n // Attempt to update fake2's values to contain \"s1\", which should cause a duplicate\n fake2.setStringValues(Set.of(\"s1\"));\n var update = index.prepareUpdate(fake2);\n update.prepare();\n assertThrows(DuplicateKeyException.class, update::commit);\n }\n\n @Test\n void shouldHandleEmptyValuesAsNullOnInsert() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Collections.emptySet());\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n assertEquals(Set.of(\"fake\"), index.isNull());\n assertTrue(index.isNotNull().isEmpty());\n assertEquals(Collections.emptySet(), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldHandleEmptyValuesAsNullOnUpdate() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n insert(fake);\n\n // update to empty values\n fake.setStringValues(Collections.emptySet());\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertEquals(Set.of(\"fake\"), index.isNull());\n assertTrue(index.equal(\"s1\").isEmpty());\n assertEquals(Collections.emptySet(), index.getKeys(\"fake\"));\n }\n }\n\n @Nested\n class IndexQueryTest {\n\n @BeforeEach\n void setUp() {\n // insert some data for query tests (single-value sets)\n var fake1 = createFake(\"fake1\");\n fake1.setStringValues(Set.of(\"string1\"));\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValues(Set.of(\"string2\"));\n\n var fake3 = createFake(\"fake3\");\n fake3.setStringValues(Set.of(\"string3\"));\n\n var fakenull = createFake(\"fakenull\");\n fakenull.setStringValues(Set.of());\n\n insert(fake1);\n insert(fake2);\n insert(fake3);\n insert(fakenull);\n }\n\n @Test\n void equalQuery() {\n var result1 = index.equal(\"string1\");\n assertEquals(Set.of(\"fake1\"), result1);\n\n var result2 = index.equal(\"string2\");\n assertEquals(Set.of(\"fake2\"), result2);\n\n var result3 = index.equal(\"non-existent-string\");\n assertTrue(result3.isEmpty());\n }\n\n @Test\n void notEqualQuery() {\n var result1 = index.notEqual(\"string1\");\n assertEquals(Set.of(\"fake2\", \"fake3\"), result1);\n\n var result2 = index.notEqual(\"string2\");\n assertEquals(Set.of(\"fake1\", \"fake3\"), result2);\n\n var result3 = index.notEqual(\"non-existent-string\");\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result3);\n }\n\n @Test\n void allQuery() {\n var result = index.all();\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\", \"fakenull\"), result);\n }\n\n @Test\n void inQuery() {\n var result = index.in(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), result);\n }\n\n @Test\n void notInQuery() {\n var result = index.notIn(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake2\"), result);\n }\n\n @Test\n void isNullQuery() {\n assertEquals(Set.of(\"fakenull\"), index.isNull());\n }\n\n @Test\n void isNotNullQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.isNotNull());\n }\n\n @Test\n void betweenQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.between(\"string1\", true, \"string3\", false)\n );\n }\n\n @Test\n void notBetweenQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.notBetween(\"string1\", true, \"string2\", false)\n );\n }\n\n @Test\n void lessThanQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.lessThan(\"string3\", false)\n );\n }\n\n @Test\n void greaterThanQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.greaterThan(\"string1\", false)\n );\n }\n\n @Test\n void stringContainsQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringContains(\"ing\")\n );\n }\n\n @Test\n void stringNotContainsQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringNotContains(\"ing\")\n );\n }\n\n @Test\n void stringStartsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringStartsWith(\"string\")\n );\n }\n\n @Test\n void stringNotStartsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringNotStartsWith(\"string\")\n );\n }\n\n @Test\n void stringEndsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringEndsWith(\"ing\")\n );\n }\n\n @Test\n void stringNotEndsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringNotEndsWith(\"ing\")\n );\n }\n\n }\n }\n\n @Nested\n class NonUniqueMultiValueTests {\n\n @BeforeEach\n void setUp() {\n lenient().when(spec.getName()).thenReturn(\"metadata.name\");\n lenient().when(spec.getKeyType()).thenReturn(String.class);\n lenient().when(spec.isUnique()).thenReturn(false);\n lenient().when(spec.getValues(any(Fake.class))).thenAnswer(invocation -> {\n Fake fake = invocation.getArgument(0);\n return fake.getStringValues();\n });\n }\n\n @Test\n void shouldInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n assertEquals(Set.of(\"fake\"), index.equal(\"s2\"));\n assertEquals(Set.of(\"s1\", \"s2\"), index.getKeys(\"fake\"));\n assertTrue(index.isNull().isEmpty());\n }\n\n @Test\n void shouldRollbackInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n insert.rollback();\n\n assertTrue(index.all().isEmpty());\n }\n\n @Test\n void shouldUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValues(Set.of(\"s2\", \"s3\"));\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertTrue(index.equal(\"s1\").isEmpty());\n assertEquals(Set.of(\"fake\"), index.equal(\"s2\"));\n assertEquals(Set.of(\"fake\"), index.equal(\"s3\"));\n assertEquals(Set.of(\"s2\", \"s3\"), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldRollbackUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValues(Set.of(\"s2\"));\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n update.rollback();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n assertTrue(index.equal(\"s2\").isEmpty());\n assertEquals(Set.of(\"s1\"), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n\n assertTrue(index.all().isEmpty());\n }\n\n @Test\n void shouldHandleDeleteIfPrimaryKeyNotExist() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"non-existent-fake\");\n delete.prepare();\n delete.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n }\n\n @Test\n void shouldRollbackDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\", \"s2\"));\n insert(fake);\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n delete.rollback();\n\n // rollback restores previous keys\n assertEquals(Set.of(\"fake\"), index.equal(\"s1\"));\n assertEquals(Set.of(\"fake\"), index.equal(\"s2\"));\n assertEquals(Set.of(\"s1\", \"s2\"), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldAllowDuplicateKeysOnInsert() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValues(Set.of(\"common\"));\n\n // first insert\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n // second insert with the same key -> should succeed for non-unique index\n var fake2 = createFake(\"fake2\");\n fake2.setStringValues(Set.of(\"common\"));\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n insert2.commit();\n\n assertEquals(Set.of(\"fake1\", \"fake2\"), index.equal(\"common\"));\n }\n\n @Test\n void shouldAllowDuplicateKeysOnUpdate() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValues(Set.of(\"s1\"));\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValues(Set.of(\"s2\"));\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n insert2.commit();\n\n // Update fake2's values to contain \"s1\" — should be allowed for non-unique index\n fake2.setStringValues(Set.of(\"s1\"));\n var update = index.prepareUpdate(fake2);\n update.prepare();\n update.commit();\n\n assertEquals(Set.of(\"fake1\", \"fake2\"), index.equal(\"s1\"));\n }\n\n @Test\n void shouldHandleEmptyValuesAsNullOnInsert() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Collections.emptySet());\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n assertEquals(Set.of(\"fake\"), index.isNull());\n assertTrue(index.isNotNull().isEmpty());\n assertEquals(Collections.emptySet(), index.getKeys(\"fake\"));\n }\n\n @Test\n void shouldHandleEmptyValuesAsNullOnUpdate() {\n var fake = createFake(\"fake\");\n fake.setStringValues(Set.of(\"s1\"));\n insert(fake);\n\n // update to empty values\n fake.setStringValues(Collections.emptySet());\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertEquals(Set.of(\"fake\"), index.isNull());\n assertTrue(index.equal(\"s1\").isEmpty());\n assertEquals(Collections.emptySet(), index.getKeys(\"fake\"));\n }\n\n @Nested\n class IndexQueryTest {\n\n @BeforeEach\n void setUp() {\n // insert some data for query tests (single-value sets)\n var fake1 = createFake(\"fake1\");\n fake1.setStringValues(Set.of(\"string1\", \"string2\"));\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValues(Set.of(\"string2\"));\n\n var fake3 = createFake(\"fake3\");\n fake3.setStringValues(Set.of(\"string3\"));\n\n var fakenull = createFake(\"fakenull\");\n fakenull.setStringValues(Set.of());\n\n insert(fake1);\n insert(fake2);\n insert(fake3);\n insert(fakenull);\n }\n\n @Test\n void equalQuery() {\n var result1 = index.equal(\"string1\");\n assertEquals(Set.of(\"fake1\"), result1);\n\n var result2 = index.equal(\"string2\");\n assertEquals(Set.of(\"fake1\", \"fake2\"), result2);\n\n var result3 = index.equal(\"non-existent-string\");\n assertTrue(result3.isEmpty());\n }\n\n @Test\n void notEqualQuery() {\n var result1 = index.notEqual(\"string1\");\n assertEquals(Set.of(\"fake2\", \"fake3\"), result1);\n\n var result2 = index.notEqual(\"string2\");\n assertEquals(Set.of(\"fake3\"), result2);\n\n var result3 = index.notEqual(\"non-existent-string\");\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result3);\n }\n\n @Test\n void inQuery() {\n var result = index.in(Set.of(\"string1\", \"string2\"));\n assertEquals(Set.of(\"fake1\", \"fake2\"), result);\n }\n\n @Test\n void notInQuery() {\n var result = index.notIn(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake2\"), result);\n\n result = index.notIn(Set.of(\"string2\"));\n assertEquals(Set.of(\"fake3\"), result);\n\n result = index.notIn(Set.of(\"non-existent-string\"));\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result);\n }\n\n @Test\n void allQuery() {\n var result = index.all();\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\", \"fakenull\"), result);\n }\n\n @Test\n void isNullQuery() {\n assertEquals(Set.of(\"fakenull\"), index.isNull());\n }\n\n @Test\n void isNotNullQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.isNotNull());\n }\n\n @Test\n void betweenQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.between(\"string1\", true, \"string3\", false)\n );\n }\n\n @Test\n void notBetweenQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.notBetween(\"string1\", true, \"string2\", false)\n );\n }\n\n @Test\n void lessThanQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.lessThan(\"string3\", false)\n );\n }\n\n @Test\n void greaterThanQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.greaterThan(\"string1\", false)\n );\n }\n\n @Test\n void stringContainsQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringContains(\"ing\")\n );\n }\n\n @Test\n void stringNotContainsQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringNotContains(\"ing\")\n );\n }\n\n @Test\n void stringStartsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringStartsWith(\"string\")\n );\n }\n\n @Test\n void stringNotStartsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringNotStartsWith(\"string\")\n );\n }\n\n @Test\n void stringEndsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringEndsWith(\"ing\")\n );\n }\n\n @Test\n void stringNotEndsWithQuery() {\n assertThrows(UnsupportedOperationException.class,\n () -> index.stringNotEndsWith(\"ing\")\n );\n }\n\n }\n\n }\n\n void insert(Fake fake) {\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n }\n\n Fake createFake(String name) {\n var fake = new Fake();\n fake.setMetadata(new Metadata());\n fake.getMetadata().setName(name);\n return fake;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/index/SingleValueIndexTest.java", "content": "package run.halo.app.extension.index;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.lenient;\n\nimport java.io.IOException;\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.dao.DuplicateKeyException;\nimport run.halo.app.extension.Metadata;\n\n@ExtendWith(MockitoExtension.class)\nclass SingleValueIndexTest {\n\n @Mock\n SingleValueIndexSpec spec;\n\n @InjectMocks\n SingleValueIndex index;\n\n\n @Nested\n class NonNullAndUniqueTest {\n\n @BeforeEach\n void setUp() {\n lenient().when(spec.getName()).thenReturn(\"metadata.name\");\n lenient().when(spec.getKeyType()).thenReturn(String.class);\n lenient().when(spec.isNullable()).thenReturn(false);\n lenient().when(spec.isUnique()).thenReturn(true);\n lenient().when(spec.getValue(any(Fake.class))).thenAnswer(invocation -> {\n Fake fake = invocation.getArgument(0);\n return fake.getStringValue();\n });\n }\n\n @Test\n void shouldCloseIndexCorrectly() throws IOException {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n insert(fake);\n\n index.close();\n\n assertEquals(Set.of(), index.equal(\"string\"));\n }\n\n @Nested\n class IndexOperationTest {\n\n @Test\n void shouldGetKeyType() {\n assertEquals(String.class, index.getKeyType());\n }\n\n @Test\n void shouldInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldRollbackInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n insert.rollback();\n\n assertEquals(Set.of(), index.equal(\"string\"));\n }\n\n @Test\n void shouldUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValue(\"new-string\");\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"new-string\"));\n }\n\n\n @Test\n void shouldRollbackUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValue(\"new-string\");\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n update.rollback();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n\n assertEquals(Set.of(), index.equal(\"string\"));\n }\n\n @Test\n void shouldHandleDeleteIfPrimaryKeyNotExist() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n var delete = index.prepareDelete(\"non-existent-fake\");\n delete.prepare();\n delete.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldRollbackDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n delete.rollback();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldHandleDuplicateKeysOnInsert() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValue(\"string\");\n\n // first insert\n var insert = index.prepareInsert(fake1);\n insert.prepare();\n insert.commit();\n\n // second insert with the same string value\n var fake2 = createFake(\"fake2\");\n fake2.setStringValue(\"string\");\n insert = index.prepareInsert(fake2);\n assertThrows(DuplicateKeyException.class, insert::prepare);\n }\n\n @Test\n void shouldHandleDuplicateKeysOnUpdate() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValue(\"string1\");\n\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValue(\"string2\");\n\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n insert2.commit();\n\n // Attempt to update fake2's stringValue to \"string1\", which should cause a\n // duplicate\n // key\n fake2.setStringValue(\"string1\");\n var update = index.prepareUpdate(fake2);\n assertThrows(DuplicateKeyException.class, update::prepare);\n }\n\n @Test\n void shouldHandleNullValueOnInsert() {\n var fake = createFake(\"fake\");\n fake.setStringValue(null);\n\n var insert = index.prepareInsert(fake);\n assertThrows(IllegalArgumentException.class, insert::prepare);\n }\n\n @Test\n void shouldHandleNullValueOnUpdate() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n // Now update to null value\n fake.setStringValue(null);\n var update = index.prepareUpdate(fake);\n assertThrows(IllegalArgumentException.class, update::prepare);\n }\n }\n\n @Nested\n class IndexQueryTest {\n\n @BeforeEach\n void setUp() {\n // insert some data for query tests\n var fake1 = createFake(\"fake1\");\n fake1.setStringValue(\"string1\");\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValue(\"string2\");\n\n var fake3 = createFake(\"fake3\");\n fake3.setStringValue(\"string3\");\n\n insert(fake1);\n insert(fake2);\n insert(fake3);\n }\n\n @Test\n void equalQuery() {\n var result1 = index.equal(\"string1\");\n assertEquals(Set.of(\"fake1\"), result1);\n\n var result2 = index.equal(\"string2\");\n assertEquals(Set.of(\"fake2\"), result2);\n\n var result3 = index.equal(\"non-existent-string\");\n assertTrue(result3.isEmpty());\n }\n\n @Test\n void notEqualQuery() {\n var result1 = index.notEqual(\"string1\");\n assertEquals(Set.of(\"fake2\", \"fake3\"), result1);\n\n var result2 = index.notEqual(\"string2\");\n assertEquals(Set.of(\"fake1\", \"fake3\"), result2);\n\n var result3 = index.notEqual(\"non-existent-string\");\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result3);\n }\n\n @Test\n void allQuery() {\n var result = index.all();\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result);\n }\n\n @Test\n void betweenQuery() {\n var result = index.between(\"string1\", true, \"string3\", false);\n assertEquals(Set.of(\"fake1\", \"fake2\"), result);\n }\n\n @Test\n void notBetweenQuery() {\n var result = index.notBetween(\"string1\", true, \"string2\", false);\n assertEquals(Set.of(\"fake2\", \"fake3\"), result);\n }\n\n @Test\n void inQuery() {\n var result = index.in(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), result);\n }\n\n @Test\n void notInQueryForSet() {\n var result = index.notIn(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake2\"), result);\n }\n\n @Test\n void notInQueryForList() {\n var result = index.notIn(List.of(\"string2\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), result);\n }\n\n @Test\n void lessThanQuery() {\n var result = index.lessThan(\"string3\", false);\n assertEquals(Set.of(\"fake1\", \"fake2\"), result);\n }\n\n @Test\n void greaterThanQuery() {\n var result = index.greaterThan(\"string1\", false);\n assertEquals(Set.of(\"fake2\", \"fake3\"), result);\n }\n\n @Test\n void isNullQuery() {\n assertThrows(IllegalArgumentException.class, () -> index.isNull());\n }\n\n @Test\n void isNotNullQuery() {\n assertThrows(IllegalArgumentException.class, () -> index.isNotNull());\n }\n\n @Test\n void stringContainsQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.stringContains(\"ing\"));\n assertEquals(Set.of(\"fake2\"), index.stringContains(\"ing2\"));\n }\n\n @Test\n void stringNotContainsQuery() {\n assertEquals(Set.of(), index.stringNotContains(\"ing\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), index.stringNotContains(\"ing2\"));\n }\n\n @Test\n void stringStartsWithQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.stringStartsWith(\"string\"));\n assertEquals(Set.of(\"fake2\"), index.stringStartsWith(\"string2\"));\n }\n\n @Test\n void stringNotStartsWithQuery() {\n assertEquals(Set.of(), index.stringNotStartsWith(\"string\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), index.stringNotStartsWith(\"string2\"));\n }\n\n @Test\n void stringEndsWithQuery() {\n assertEquals(Set.of(\"fake1\"), index.stringEndsWith(\"ing1\"));\n assertEquals(Set.of(\"fake3\"), index.stringEndsWith(\"ing3\"));\n }\n\n @Test\n void stringNotEndsWithQuery() {\n assertEquals(Set.of(\"fake2\", \"fake3\"), index.stringNotEndsWith(\"ing1\"));\n assertEquals(Set.of(\"fake1\", \"fake2\"), index.stringNotEndsWith(\"ing3\"));\n }\n\n }\n\n }\n\n @Nested\n class NullableAndNonUniqueTest {\n\n @BeforeEach\n void setUp() {\n lenient().when(spec.getName()).thenReturn(\"metadata.name\");\n lenient().when(spec.getKeyType()).thenReturn(String.class);\n lenient().when(spec.isNullable()).thenReturn(true);\n lenient().when(spec.isUnique()).thenReturn(false);\n lenient().when(spec.getValue(any(Fake.class))).thenAnswer(invocation -> {\n Fake fake = invocation.getArgument(0);\n return fake.getStringValue();\n });\n }\n\n @Test\n void shouldGetKeyType() {\n assertEquals(String.class, index.getKeyType());\n }\n\n @Test\n void shouldInsertAllowDuplicate() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValue(\"string\");\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValue(\"string\");\n\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n insert2.commit();\n\n assertEquals(Set.of(\"fake1\", \"fake2\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldUpdateAllowDuplicate() {\n var fake1 = createFake(\"fake1\");\n fake1.setStringValue(\"string1\");\n\n var insert1 = index.prepareInsert(fake1);\n insert1.prepare();\n insert1.commit();\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValue(\"string2\");\n\n var insert2 = index.prepareInsert(fake2);\n insert2.prepare();\n insert2.commit();\n\n // update fake2 to string1 should be allowed when not unique\n fake2.setStringValue(\"string1\");\n var update = index.prepareUpdate(fake2);\n update.prepare();\n update.commit();\n\n assertEquals(Set.of(\"fake1\", \"fake2\"), index.equal(\"string1\"));\n }\n\n @Test\n void shouldHandleNullValueOnInsert() {\n var fake = createFake(\"fake\");\n fake.setStringValue(null);\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n assertEquals(Set.of(\"fake\"), index.isNull());\n // no non-null entries exist\n assertTrue(index.isNotNull().isEmpty());\n }\n\n @Test\n void shouldHandleNullValueOnUpdate() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n // update to null should be allowed\n fake.setStringValue(null);\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n\n assertEquals(Set.of(\"fake\"), index.isNull());\n assertTrue(index.equal(\"string\").isEmpty());\n }\n\n @Test\n void shouldRollbackInsertCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n insert.rollback();\n\n assertEquals(Set.of(), index.equal(\"string\"));\n }\n\n @Test\n void shouldRollbackUpdateCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n fake.setStringValue(\"new-string\");\n var update = index.prepareUpdate(fake);\n update.prepare();\n update.commit();\n update.rollback();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n\n assertEquals(Set.of(), index.equal(\"string\"));\n }\n\n @Test\n void shouldHandleDeleteIfPrimaryKeyNotExist() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n var delete = index.prepareDelete(\"non-existent-fake\");\n delete.prepare();\n delete.commit();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Test\n void shouldRollbackDeleteCorrectly() {\n var fake = createFake(\"fake\");\n fake.setStringValue(\"string\");\n\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n\n var delete = index.prepareDelete(\"fake\");\n delete.prepare();\n delete.commit();\n delete.rollback();\n\n assertEquals(Set.of(\"fake\"), index.equal(\"string\"));\n }\n\n @Nested\n class IndexQueryTest {\n\n @BeforeEach\n void setUp() {\n // insert some data for query tests\n var fake1 = createFake(\"fake1\");\n fake1.setStringValue(\"string1\");\n\n var fake2 = createFake(\"fake2\");\n fake2.setStringValue(\"string2\");\n\n var fake3 = createFake(\"fake3\");\n fake3.setStringValue(\"string3\");\n\n var fakenull = createFake(\"fakenull\");\n fakenull.setStringValue(null);\n\n insert(fake1);\n insert(fake2);\n insert(fake3);\n insert(fakenull);\n }\n\n @Test\n void equalQuery() {\n var result1 = index.equal(\"string1\");\n assertEquals(Set.of(\"fake1\"), result1);\n\n var result2 = index.equal(\"string2\");\n assertEquals(Set.of(\"fake2\"), result2);\n\n var result3 = index.equal(\"non-existent-string\");\n assertTrue(result3.isEmpty());\n }\n\n @Test\n void notEqualQuery() {\n var result1 = index.notEqual(\"string1\");\n assertEquals(Set.of(\"fake2\", \"fake3\"), result1);\n\n var result2 = index.notEqual(\"string2\");\n assertEquals(Set.of(\"fake1\", \"fake3\"), result2);\n\n var result3 = index.notEqual(\"non-existent-string\");\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result3);\n }\n\n @Test\n void allQuery() {\n var result = index.all();\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), result);\n }\n\n @Test\n void betweenQuery() {\n var result = index.between(\"string1\", true, \"string3\", false);\n assertEquals(Set.of(\"fake1\", \"fake2\"), result);\n }\n\n @Test\n void notBetweenQuery() {\n var result = index.notBetween(\"string1\", true, \"string2\", false);\n assertEquals(Set.of(\"fake2\", \"fake3\"), result);\n }\n\n @Test\n void inQuery() {\n var result = index.in(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), result);\n }\n\n @Test\n void notInQueryForSet() {\n var result = index.notIn(Set.of(\"string1\", \"string3\"));\n assertEquals(Set.of(\"fake2\"), result);\n }\n\n @Test\n void notInQueryForList() {\n var result = index.notIn(List.of(\"string2\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), result);\n }\n\n @Test\n void lessThanQuery() {\n var result = index.lessThan(\"string3\", false);\n assertEquals(Set.of(\"fake1\", \"fake2\"), result);\n }\n\n @Test\n void greaterThanQuery() {\n var result = index.greaterThan(\"string1\", false);\n assertEquals(Set.of(\"fake2\", \"fake3\"), result);\n }\n\n @Test\n void isNullQuery() {\n assertEquals(Set.of(\"fakenull\"), index.isNull());\n }\n\n @Test\n void isNotNullQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.isNotNull());\n }\n\n @Test\n void stringContainsQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.stringContains(\"ing\"));\n assertEquals(Set.of(\"fake2\"), index.stringContains(\"ing2\"));\n }\n\n @Test\n void stringNotContainsQuery() {\n assertEquals(Set.of(), index.stringNotContains(\"ing\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), index.stringNotContains(\"ing2\"));\n }\n\n @Test\n void stringStartsWithQuery() {\n assertEquals(Set.of(\"fake1\", \"fake2\", \"fake3\"), index.stringStartsWith(\"string\"));\n assertEquals(Set.of(\"fake2\"), index.stringStartsWith(\"string2\"));\n }\n\n @Test\n void stringNotStartsWithQuery() {\n assertEquals(Set.of(), index.stringNotStartsWith(\"string\"));\n assertEquals(Set.of(\"fake1\", \"fake3\"), index.stringNotStartsWith(\"string2\"));\n }\n\n @Test\n void stringEndsWithQuery() {\n assertEquals(Set.of(\"fake1\"), index.stringEndsWith(\"ing1\"));\n assertEquals(Set.of(\"fake3\"), index.stringEndsWith(\"ing3\"));\n }\n\n @Test\n void stringNotEndsWithQuery() {\n assertEquals(Set.of(\"fake2\", \"fake3\"), index.stringNotEndsWith(\"ing1\"));\n assertEquals(Set.of(\"fake1\", \"fake2\"), index.stringNotEndsWith(\"ing3\"));\n }\n\n }\n }\n\n void insert(Fake fake) {\n var insert = index.prepareInsert(fake);\n insert.prepare();\n insert.commit();\n }\n\n Fake createFake(String name) {\n var fake = new Fake();\n fake.setMetadata(new Metadata());\n fake.getMetadata().setName(name);\n return fake;\n }\n\n}\n\n" }, { "path": "application/src/test/java/run/halo/app/extension/index/query/QueryVisitorTest.java", "content": "package run.halo.app.extension.index.query;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.mockito.Mockito.withSettings;\n\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.boot.convert.ApplicationConversionService;\nimport org.springframework.core.convert.ConversionFailedException;\nimport org.springframework.core.convert.ConversionService;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.index.Index;\nimport run.halo.app.extension.index.Indices;\nimport run.halo.app.extension.index.LabelIndexQuery;\nimport run.halo.app.extension.index.ValueIndexQuery;\n\n@SuppressWarnings({\"unchecked\", \"rawtypes\"})\n@ExtendWith(MockitoExtension.class)\nclass QueryVisitorTest {\n\n @Mock\n Indices indices;\n\n @Spy\n ConversionService conversionService = ApplicationConversionService.getSharedInstance();\n\n @InjectMocks\n QueryVisitor visitor;\n\n @Test\n void shouldVisitAllCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.all()).thenReturn(Set.of(\"all\", \"data\"));\n var condition = Queries.all(\"metadata.name\");\n condition.visit(visitor);\n assertEquals(Set.of(\"all\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisitNoneCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n var condition = Queries.all(\"metadata.name\").not();\n condition.visit(visitor);\n assertEquals(Set.of(), visitor.getResult());\n }\n\n @Test\n void shouldVisitEmptyCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.all()).thenReturn(Set.of(\"all\", \"data\"));\n var condition = Condition.empty();\n condition.visit(visitor);\n assertEquals(Set.of(\"all\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisitEqualsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.equal(\"test-name\")).thenReturn(Set.of(\"equal\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.equal(\"metadata.name\", \"test-name\");\n condition.visit(visitor);\n assertEquals(Set.of(\"equal\", \"data\"), visitor.getResult());\n\n verify(conversionService).canConvert(String.class, String.class);\n verify(conversionService).convert(\"test-name\", String.class);\n }\n\n @Test\n void shouldVisitNotEqualsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.notEqual(\"test-name\")).thenReturn(Set.of(\"not-equal\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.notEqual(\"metadata.name\", \"test-name\");\n condition.visit(visitor);\n assertEquals(Set.of(\"not-equal\", \"data\"), visitor.getResult());\n\n verify(conversionService).canConvert(String.class, String.class);\n verify(conversionService).convert(\"test-name\", String.class);\n }\n\n @Test\n void shouldVisitInCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.in(argThat(c -> c.containsAll(List.of(\"name1\", \"name1\")))))\n .thenReturn(Set.of(\"in\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.in(\"metadata.name\", Set.of(\"name1\", \"name2\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"in\", \"data\"), visitor.getResult());\n verify(conversionService, times(2)).canConvert(String.class, String.class);\n verify(conversionService).convert(\"name1\", String.class);\n verify(conversionService).convert(\"name2\", String.class);\n }\n\n @Test\n void shouldVisitNotInCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.notIn(argThat(c -> c.containsAll(List.of(\"name1\", \"name2\")))))\n .thenReturn(Set.of(\"not-in\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.in(\"metadata.name\", Set.of(\"name1\", \"name2\")).not();\n condition.visit(visitor);\n assertEquals(Set.of(\"not-in\", \"data\"), visitor.getResult());\n verify(conversionService, times(2)).canConvert(String.class, String.class);\n verify(conversionService).convert(\"name1\", String.class);\n verify(conversionService).convert(\"name2\", String.class);\n }\n\n @Test\n void shouldVisitGreaterThanCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.age\")).thenReturn(index);\n when(query.greaterThan(18, false)).thenReturn(Set.of(\"gt\", \"data\"));\n when(index.getKeyType()).thenReturn(Integer.class);\n var condition = Queries.greaterThan(\"metadata.age\", 18);\n condition.visit(visitor);\n assertEquals(Set.of(\"gt\", \"data\"), visitor.getResult());\n\n verify(conversionService).canConvert(Integer.class, Integer.class);\n verify(conversionService).convert(18, Integer.class);\n }\n\n @Test\n void shouldVisitLessThanCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.age\")).thenReturn(index);\n when(query.lessThan(65, false)).thenReturn(Set.of(\"lt\", \"data\"));\n when(index.getKeyType()).thenReturn(Integer.class);\n var condition = Queries.lessThan(\"metadata.age\", 65);\n condition.visit(visitor);\n assertEquals(Set.of(\"lt\", \"data\"), visitor.getResult());\n\n verify(conversionService).canConvert(Integer.class, Integer.class);\n verify(conversionService).convert(65, Integer.class);\n }\n\n @Test\n void shouldVisitBetweenCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.age\")).thenReturn(index);\n when(query.between(18, true, 65, false)).thenReturn(Set.of(\"between\", \"data\"));\n when(index.getKeyType()).thenReturn(Integer.class);\n var condition = Queries.between(\"metadata.age\", 18, true, 65, false);\n condition.visit(visitor);\n assertEquals(Set.of(\"between\", \"data\"), visitor.getResult());\n\n verify(conversionService, times(2)).canConvert(Integer.class, Integer.class);\n verify(conversionService).convert(18, Integer.class);\n verify(conversionService).convert(65, Integer.class);\n }\n\n @Test\n void shouldVisitNotBetweenCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.age\")).thenReturn(index);\n when(query.notBetween(18, false, 65, true)).thenReturn(Set.of(\"not-between\", \"data\"));\n when(index.getKeyType()).thenReturn(Integer.class);\n var condition = Queries.between(\"metadata.age\", 18, true, 65, false).not();\n condition.visit(visitor);\n assertEquals(Set.of(\"not-between\", \"data\"), visitor.getResult());\n\n verify(conversionService, times(2)).canConvert(Integer.class, Integer.class);\n verify(conversionService).convert(18, Integer.class);\n verify(conversionService).convert(65, Integer.class);\n }\n\n @Test\n void shouldVisitStringContainsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.description\")).thenReturn(index);\n when(query.stringContains(\"keyword\")).thenReturn(Set.of(\"contains\", \"data\"));\n var condition = Queries.contains(\"metadata.description\", \"keyword\");\n condition.visit(visitor);\n assertEquals(Set.of(\"contains\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"keyword\", String.class);\n }\n\n @Test\n void shouldVisitStringNotContainsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.description\")).thenReturn(index);\n when(query.stringNotContains(\"keyword\")).thenReturn(Set.of(\"not-contains\", \"data\"));\n var condition = Queries.contains(\"metadata.description\", \"keyword\").not();\n condition.visit(visitor);\n assertEquals(Set.of(\"not-contains\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"keyword\", String.class);\n }\n\n @Test\n void shouldVisitStringStartsWithCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.title\")).thenReturn(index);\n when(query.stringStartsWith(\"prefix\")).thenReturn(Set.of(\"starts-with\", \"data\"));\n var condition = Queries.startsWith(\"metadata.title\", \"prefix\");\n condition.visit(visitor);\n assertEquals(Set.of(\"starts-with\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"prefix\", String.class);\n }\n\n @Test\n void shouldVisitStringNotStartsWithCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.title\")).thenReturn(index);\n when(query.stringNotStartsWith(\"prefix\")).thenReturn(Set.of(\"not-starts-with\", \"data\"));\n var condition = Queries.startsWith(\"metadata.title\", \"prefix\").not();\n condition.visit(visitor);\n assertEquals(Set.of(\"not-starts-with\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"prefix\", String.class);\n }\n\n @Test\n void shouldVisitStringEndsWithCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.title\")).thenReturn(index);\n when(query.stringEndsWith(\"suffix\")).thenReturn(Set.of(\"ends-with\", \"data\"));\n var condition = Queries.endsWith(\"metadata.title\", \"suffix\");\n condition.visit(visitor);\n assertEquals(Set.of(\"ends-with\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"suffix\", String.class);\n }\n\n @Test\n void shouldVisitStringNotEndsWithCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.title\")).thenReturn(index);\n when(query.stringNotEndsWith(\"suffix\")).thenReturn(Set.of(\"not-ends-with\", \"data\"));\n var condition = Queries.endsWith(\"metadata.title\", \"suffix\").not();\n condition.visit(visitor);\n assertEquals(Set.of(\"not-ends-with\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"suffix\", String.class);\n }\n\n @Test\n void shouldVisitIsNullCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.optionalField\")).thenReturn(index);\n when(query.isNull()).thenReturn(Set.of(\"is-null\", \"data\"));\n var condition = Queries.isNull(\"metadata.optionalField\");\n condition.visit(visitor);\n assertEquals(Set.of(\"is-null\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisitIsNotNullCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.optionalField\")).thenReturn(index);\n when(query.isNotNull()).thenReturn(Set.of(\"is-not-null\", \"data\"));\n var condition = Queries.isNull(\"metadata.optionalField\").not();\n condition.visit(visitor);\n assertEquals(Set.of(\"is-not-null\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisitLabelEqualsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n var query = (LabelIndexQuery) index;\n when(indices.getIndex(\"metadata.labels\")).thenReturn(index);\n when(query.equal(\"env\", \"production\")).thenReturn(Set.of(\"label-equal\", \"data\"));\n var condition = Queries.labelEqual(\"env\", \"production\");\n condition.visit(visitor);\n assertEquals(Set.of(\"label-equal\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"production\", String.class);\n }\n\n @Test\n void shouldVisitLabelNotEqualsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n var primaryIndex = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (LabelIndexQuery) index;\n var primaryQuery = (ValueIndexQuery) primaryIndex;\n when(indices.getIndex(\"metadata.labels\")).thenReturn(index);\n when(indices.getIndex(\"metadata.name\")).thenReturn(primaryIndex);\n when(query.equal(\"env\", \"production\")).thenReturn(Set.of(\"equal\", \"data\"));\n when(primaryQuery.all()).thenReturn(Set.of(\"all\", \"data\"));\n var condition = Queries.labelEqual(\"env\", \"production\").not();\n condition.visit(visitor);\n assertEquals(Set.of(\"all\"), visitor.getResult());\n }\n\n @Test\n void shouldVisitLabelInCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n var query = (LabelIndexQuery) index;\n when(indices.getIndex(\"metadata.labels\")).thenReturn(index);\n when(query.in(eq(\"env\"), eq(Set.of(\"production\", \"staging\"))))\n .thenReturn(Set.of(\"label-in\", \"data\"));\n var condition = Queries.labelIn(\"env\", Set.of(\"production\", \"staging\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"label-in\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"production\", String.class);\n verify(conversionService, never()).convert(\"staging\", String.class);\n }\n\n @Test\n void shouldVisitLabelNotInCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n var query = (LabelIndexQuery) index;\n when(indices.getIndex(\"metadata.labels\")).thenReturn(index);\n when(query.notIn(eq(\"env\"), eq(Set.of(\"production\", \"staging\"))))\n .thenReturn(Set.of(\"label-not-in\", \"data\"));\n var condition = Queries.labelIn(\"env\", Set.of(\"production\", \"staging\")).not();\n condition.visit(visitor);\n assertEquals(Set.of(\"label-not-in\", \"data\"), visitor.getResult());\n\n verify(conversionService, never()).canConvert(String.class, String.class);\n verify(conversionService, never()).convert(\"production\", String.class);\n verify(conversionService, never()).convert(\"staging\", String.class);\n }\n\n @Test\n void shouldVisitLabelExistsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n var query = (LabelIndexQuery) index;\n when(indices.getIndex(\"metadata.labels\")).thenReturn(index);\n when(query.exists(\"env\")).thenReturn(Set.of(\"label-exists\", \"data\"));\n var condition = Queries.labelExists(\"env\");\n condition.visit(visitor);\n assertEquals(Set.of(\"label-exists\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisitLabelNotExistsCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n var primaryIndex = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (LabelIndexQuery) index;\n var primaryQuery = (ValueIndexQuery) primaryIndex;\n when(indices.getIndex(\"metadata.name\")).thenReturn(primaryIndex);\n when(indices.getIndex(\"metadata.labels\")).thenReturn(index);\n when(query.exists(\"env\")).thenReturn(Set.of(\"label-exists\", \"data\"));\n when(primaryQuery.all()).thenReturn(Set.of(\"all\", \"data\"));\n var condition = Queries.labelExists(\"env\").not();\n condition.visit(visitor);\n assertEquals(Set.of(\"all\"), visitor.getResult());\n }\n\n @Test\n void shouldVisiteAndCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.equal(\"name1\")).thenReturn(Set.of(\"name1\", \"data\"));\n when(query.equal(\"name2\")).thenReturn(Set.of(\"name2\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.equal(\"metadata.name\", \"name1\")\n .and(Queries.equal(\"metadata.name\", \"name2\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisiteOrCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.equal(\"name1\")).thenReturn(Set.of(\"name1\", \"data\"));\n when(query.equal(\"name2\")).thenReturn(Set.of(\"name2\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.equal(\"metadata.name\", \"name1\")\n .or(Queries.equal(\"metadata.name\", \"name2\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"name1\", \"name2\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldVisiteNotCondition() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.notEqual(\"name1\")).thenReturn(Set.of(\"not-equal\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = new NotCondition(Queries.equal(\"metadata.name\", \"name1\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"not-equal\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldRefineAndConditionWithLeftEmpty() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.equal(\"name1\")).thenReturn(Set.of(\"name1\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Condition.empty()\n .and(Queries.equal(\"metadata.name\", \"name1\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"name1\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldRefineAndConditionWithRightEmpty() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.equal(\"name1\")).thenReturn(Set.of(\"name1\", \"data\"));\n when(index.getKeyType()).thenReturn(String.class);\n var condition = Queries.equal(\"metadata.name\", \"name1\")\n .and(Condition.empty());\n condition.visit(visitor);\n assertEquals(Set.of(\"name1\", \"data\"), visitor.getResult());\n }\n\n @Test\n void shouldRefineOrConditionWithLeftEmpty() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.all()).thenReturn(Set.of(\"all\"));\n var condition = Condition.empty()\n .or(Queries.equal(\"metadata.name\", \"name1\"));\n condition.visit(visitor);\n assertEquals(Set.of(\"all\"), visitor.getResult());\n\n verify(query, never()).equal(\"name1\");\n }\n\n @Test\n void shouldRefineOrConditionWithRightEmpty() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.all()).thenReturn(Set.of(\"all\"));\n var condition = Queries.equal(\"metadata.name\", \"name1\")\n .or(Condition.empty());\n condition.visit(visitor);\n assertEquals(Set.of(\"all\"), visitor.getResult());\n\n verify(query, never()).equal(\"name1\");\n }\n\n @Test\n void shouldRefineAndConditionWithBothEmpty() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.all()).thenReturn(Set.of(\"all\"));\n var condition = Condition.empty().and(Condition.empty());\n condition.visit(visitor);\n assertEquals(Set.of(\"all\"), visitor.getResult());\n\n verify(query).all();\n }\n\n @Test\n void shouldRefineOrConditionWithBothEmpty() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n var query = (ValueIndexQuery) index;\n when(indices.getIndex(\"metadata.name\")).thenReturn(index);\n when(query.all()).thenReturn(Set.of(\"all\"));\n var condition = Condition.empty().or(Condition.empty());\n condition.visit(visitor);\n assertEquals(Set.of(\"all\"), visitor.getResult());\n\n verify(query).all();\n }\n\n @Test\n void throwErrorIfIndexNotFound() {\n var condition = Queries.equal(\"metadata.unknownField\", \"value\");\n when(indices.getIndex(\"metadata.unknownField\")).thenThrow(IllegalArgumentException.class);\n assertThrows(IllegalArgumentException.class, (() -> {\n condition.visit(visitor);\n }));\n }\n\n @Test\n void throwErrorIfIndexTypeMismatchForValueIndexQuery() {\n var labelIndex = mock(Index.class, withSettings().extraInterfaces(LabelIndexQuery.class));\n when(indices.getIndex(\"metadata.name\")).thenReturn(labelIndex);\n var condition = Queries.equal(\"metadata.name\", \"name1\");\n assertThrows(IllegalArgumentException.class, (() -> {\n condition.visit(visitor);\n }));\n }\n\n @Test\n void throwErrorIfIndexTypeMismatchForLabelIndexQuery() {\n var valueIndex = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n when(indices.getIndex(\"metadata.labels\")).thenReturn(valueIndex);\n var condition = Queries.labelEqual(\"env\", \"production\");\n assertThrows(IllegalArgumentException.class, (() -> {\n condition.visit(visitor);\n }));\n }\n\n @Test\n void throwErrorIfValueConversionNotSupported() {\n var index = mock(Index.class, withSettings().extraInterfaces(ValueIndexQuery.class));\n when(indices.getIndex(\"metadata.age\")).thenReturn(index);\n when(index.getKeyType()).thenReturn(Integer.class);\n var condition = Queries.equal(\"metadata.age\", \"not-an-integer\");\n assertThrows(ConversionFailedException.class, (() -> {\n condition.visit(visitor);\n }));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionCompositeRouterFunctionTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertNull;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.web.reactive.function.server.HandlerStrategies;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.event.SchemeAddedEvent;\nimport run.halo.app.extension.event.SchemeRemovedEvent;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionCompositeRouterFunctionTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @InjectMocks\n ExtensionCompositeRouterFunction extensionRouterFunc;\n\n @Test\n void shouldRouteWhenSchemeRegistered() {\n var exchange = MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/apis/fake.halo.run/v1alpha1/fakes\").build());\n\n var messageReaders = HandlerStrategies.withDefaults().messageReaders();\n ServerRequest request = ServerRequest.create(exchange, messageReaders);\n\n var handlerFunc = extensionRouterFunc.route(request).block();\n assertNull(handlerFunc);\n\n // trigger registering scheme\n extensionRouterFunc.onSchemeAddedEvent(\n new SchemeAddedEvent(this, Scheme.buildFromType(FakeExtension.class))\n );\n\n handlerFunc = extensionRouterFunc.route(request).block();\n assertNotNull(handlerFunc);\n }\n\n @Test\n void shouldNotRouteWhenSchemeUnregistered() {\n var exchange = MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/apis/fake.halo.run/v1alpha1/fakes\").build());\n\n var messageReaders = HandlerStrategies.withDefaults().messageReaders();\n\n // trigger registering scheme\n extensionRouterFunc.onSchemeAddedEvent(\n new SchemeAddedEvent(this, Scheme.buildFromType(FakeExtension.class))\n );\n\n ServerRequest request = ServerRequest.create(exchange, messageReaders);\n var handlerFunc = extensionRouterFunc.route(request).block();\n assertNotNull(handlerFunc);\n\n // trigger registering scheme\n extensionRouterFunc.onSchemeRemovedEvent(\n new SchemeRemovedEvent(this, Scheme.buildFromType(FakeExtension.class))\n );\n handlerFunc = extensionRouterFunc.route(request).block();\n assertNull(handlerFunc);\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionCreateHandlerTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.doThrow;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Objects;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.web.reactive.function.server.EntityResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.exception.ExtensionConvertException;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionCreateHandlerTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Test\n void shouldBuildPathPatternCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var createHandler = new ExtensionCreateHandler(scheme, client);\n var pathPattern = createHandler.pathPattern();\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes\", pathPattern);\n }\n\n @Test\n void shouldHandleCorrectly() {\n final var fake = new FakeExtension();\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n fake.setMetadata(metadata);\n\n var unstructured = new Unstructured();\n unstructured.setMetadata(metadata);\n unstructured.setApiVersion(\"fake.halo.run/v1alpha1\");\n unstructured.setKind(\"Fake\");\n\n var serverRequest = MockServerRequest.builder()\n .body(Mono.just(unstructured));\n when(client.create(any(Unstructured.class))).thenReturn(Mono.just(unstructured));\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var getHandler = new ExtensionCreateHandler(scheme, client);\n var responseMono = getHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .consumeNextWith(response -> {\n assertEquals(HttpStatus.CREATED, response.statusCode());\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\",\n Objects.requireNonNull(response.headers().getLocation()).toString());\n assertEquals(MediaType.APPLICATION_JSON, response.headers().getContentType());\n assertTrue(response instanceof EntityResponse);\n assertEquals(unstructured, ((EntityResponse) response).entity());\n })\n .verifyComplete();\n verify(client, times(1)).create(eq(unstructured));\n }\n\n @Test\n void shouldReturnErrorWhenNoBodyProvided() {\n var serverRequest = MockServerRequest.builder()\n .body(Mono.empty());\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var getHandler = new ExtensionCreateHandler(scheme, client);\n var responseMono = getHandler.handle(serverRequest);\n StepVerifier.create(responseMono)\n .verifyError(ExtensionConvertException.class);\n }\n\n @Test\n void shouldReturnErrorWhenExtensionNotFound() {\n final var unstructured = new Unstructured();\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n unstructured.setMetadata(metadata);\n unstructured.setApiVersion(\"fake.halo.run/v1alpha1\");\n unstructured.setKind(\"Fake\");\n\n var serverRequest = MockServerRequest.builder()\n .body(Mono.just(unstructured));\n doThrow(ExtensionNotFoundException.class).when(client).create(any());\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var createHandler = new ExtensionCreateHandler(scheme, client);\n var responseMono = createHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .verifyError(ExtensionNotFoundException.class);\n verify(client, times(1)).create(\n argThat(extension -> Objects.equals(\"my-fake\", extension.getMetadata().getName())));\n verify(client, times(0)).fetch(same(FakeExtension.class), anyString());\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionDeleteHandlerTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.extension.GroupVersionKind.fromExtension;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.web.reactive.function.server.EntityResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionDeleteHandlerTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Test\n void shouldBuildPathPatternCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var deleteHandler = new ExtensionDeleteHandler(scheme, client);\n var pathPattern = deleteHandler.pathPattern();\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\", pathPattern);\n }\n\n @Test\n void shouldHandleCorrectly() {\n final var fake = new FakeExtension();\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n fake.setMetadata(metadata);\n\n var unstructured = new Unstructured();\n unstructured.setMetadata(metadata);\n unstructured.setApiVersion(\"fake.halo.run/v1alpha1\");\n unstructured.setKind(\"Fake\");\n\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .body(Mono.just(unstructured));\n when(client.get(eq(FakeExtension.class), eq(\"my-fake\"))).thenReturn(Mono.just(fake));\n when(client.delete(eq(fake))).thenReturn(Mono.just(fake));\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var deleteHandler = new ExtensionDeleteHandler(scheme, client);\n var responseMono = deleteHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .assertNext(response -> {\n assertEquals(HttpStatus.OK, response.statusCode());\n assertEquals(MediaType.APPLICATION_JSON, response.headers().getContentType());\n assertTrue(response instanceof EntityResponse);\n assertEquals(fake, ((EntityResponse) response).entity());\n })\n .verifyComplete();\n verify(client, times(1)).get(eq(FakeExtension.class), eq(\"my-fake\"));\n verify(client, times(1)).delete(any());\n verify(client, times(0)).update(any());\n }\n\n @Test\n void shouldReturnErrorWhenNoNameProvided() {\n var serverRequest = MockServerRequest.builder()\n .body(Mono.empty());\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var deleteHandler = new ExtensionDeleteHandler(scheme, client);\n assertThrows(IllegalArgumentException.class, () -> deleteHandler.handle(serverRequest));\n }\n\n @Test\n void shouldReturnErrorWhenExtensionNotFound() {\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .build();\n when(client.get(FakeExtension.class, \"my-fake\")).thenReturn(\n Mono.error(\n new ExtensionNotFoundException(fromExtension(FakeExtension.class), \"my-fake\")));\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var deleteHandler = new ExtensionDeleteHandler(scheme, client);\n var responseMono = deleteHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .verifyError(ExtensionNotFoundException.class);\n\n verify(client, times(1)).get(same(FakeExtension.class), anyString());\n verify(client, times(0)).update(any());\n verify(client, times(0)).delete(any());\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionGetHandlerTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.extension.GroupVersionKind.fromExtension;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.web.reactive.function.server.EntityResponse;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionGetHandlerTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Test\n void shouldBuildPathPatternCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var getHandler = new ExtensionGetHandler(scheme, client);\n var pathPattern = getHandler.pathPattern();\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\", pathPattern);\n }\n\n @Test\n void shouldHandleCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var getHandler = new ExtensionGetHandler(scheme, client);\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .build();\n final var fake = new FakeExtension();\n when(client.get(eq(FakeExtension.class), eq(\"my-fake\"))).thenReturn(Mono.just(fake));\n\n var responseMono = getHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .consumeNextWith(response -> {\n assertEquals(HttpStatus.OK, response.statusCode());\n assertEquals(MediaType.APPLICATION_JSON, response.headers().getContentType());\n assertTrue(response instanceof EntityResponse);\n assertEquals(fake, ((EntityResponse) response).entity());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldThrowExceptionWhenExtensionNotFound() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var getHandler = new ExtensionGetHandler(scheme, client);\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .build();\n when(client.get(eq(FakeExtension.class), eq(\"my-fake\"))).thenReturn(Mono.error(\n new ExtensionNotFoundException(fromExtension(FakeExtension.class), \"my-fake\")));\n\n Mono responseMono = getHandler.handle(serverRequest);\n StepVerifier.create(responseMono)\n .expectError(ExtensionNotFoundException.class)\n .verify();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionListHandlerTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.web.reactive.function.server.EntityResponse;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionListHandlerTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Test\n void shouldBuildPathPatternCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var listHandler = new ExtensionListHandler(scheme, client);\n var pathPattern = listHandler.pathPattern();\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes\", pathPattern);\n }\n\n @Test\n void shouldHandleCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var listHandler = new ExtensionListHandler(scheme, client);\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/fake\")\n .queryParam(\"sort\", \"metadata.name,desc\"));\n var serverRequest = MockServerRequest.builder().exchange(exchange).build();\n final var fake01 = FakeExtension.createFake(\"fake01\");\n final var fake02 = FakeExtension.createFake(\"fake02\");\n var fakeListResult = new ListResult<>(0, 0, 2, List.of(fake01, fake02));\n when(client.listBy(same(FakeExtension.class), any(ListOptions.class), any()))\n .thenReturn(Mono.just(fakeListResult));\n\n var responseMono = listHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .consumeNextWith(response -> {\n assertEquals(HttpStatus.OK, response.statusCode());\n assertEquals(MediaType.APPLICATION_JSON, response.headers().getContentType());\n assertTrue(response instanceof EntityResponse);\n assertEquals(fakeListResult, ((EntityResponse) response).entity());\n })\n .verifyComplete();\n verify(client).listBy(same(FakeExtension.class), any(ListOptions.class), any());\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionRouterFunctionFactoryTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport com.fasterxml.jackson.databind.node.JsonNodeFactory;\nimport com.github.fge.jackson.jsonpointer.JsonPointer;\nimport com.github.fge.jsonpatch.AddOperation;\nimport com.github.fge.jsonpatch.JsonPatch;\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.codec.HttpMessageReader;\nimport org.springframework.http.codec.json.JacksonJsonDecoder;\nimport org.springframework.http.codec.json.JacksonJsonEncoder;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.HandlerStrategies;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.JsonExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.CreateHandler;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.GetHandler;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.ListHandler;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.UpdateHandler;\nimport run.halo.app.infra.config.JacksonAdapterModule;\nimport tools.jackson.databind.json.JsonMapper;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionRouterFunctionFactoryTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Spy\n Scheme scheme = Scheme.buildFromType(FakeExtension.class);\n\n @InjectMocks\n ExtensionRouterFunctionFactory factory;\n\n WebTestClient webClient;\n\n @BeforeEach\n void setUp() {\n var mapper = JsonMapper.builder()\n .addModule(new JacksonAdapterModule(\n () -> com.fasterxml.jackson.databind.json.JsonMapper.builder().build())\n )\n .build();\n webClient = WebTestClient.bindToRouterFunction(factory.create())\n .handlerStrategies(HandlerStrategies.builder()\n .codecs(c -> {\n c.defaultCodecs().jacksonJsonEncoder(new JacksonJsonEncoder(mapper));\n c.defaultCodecs().jacksonJsonDecoder(new JacksonJsonDecoder(mapper));\n })\n .build()\n )\n .configureClient()\n .codecs(c -> {\n c.defaultCodecs().jacksonJsonEncoder(new JacksonJsonEncoder(mapper));\n c.defaultCodecs().jacksonJsonDecoder(new JacksonJsonDecoder(mapper));\n })\n .build();\n }\n\n @Nested\n class PatchTest {\n\n @Test\n void shouldResponse404IfMethodNotPatch() {\n webClient.method(HttpMethod.POST)\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .exchange()\n .expectStatus().isNotFound();\n }\n\n @Test\n void shouldResponse415IfMediaTypeIsInsufficient() {\n webClient.method(HttpMethod.PATCH)\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .exchange()\n .expectStatus().isEqualTo(HttpStatus.UNSUPPORTED_MEDIA_TYPE);\n\n webClient.method(HttpMethod.PATCH)\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON.toString())\n .exchange()\n .expectStatus().isEqualTo(HttpStatus.UNSUPPORTED_MEDIA_TYPE);\n }\n\n @Test\n void shouldResponseBadRequestIfNoPatchBody() {\n webClient.method(HttpMethod.PATCH)\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .header(HttpHeaders.CONTENT_TYPE, \"application/json-patch+json\")\n .exchange()\n .expectStatus().isBadRequest();\n }\n\n @Test\n void shouldPatchCorrectly() {\n var fake = new FakeExtension();\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n fake.setMetadata(metadata);\n var mapper = com.fasterxml.jackson.databind.json.JsonMapper.builder().build();\n var jsonExt = mapper.convertValue(fake, JsonExtension.class);\n\n when(client.getJsonExtension(scheme.groupVersionKind(), \"my-fake\"))\n .thenReturn(Mono.just(jsonExt));\n\n var status = new FakeExtension.FakeStatus();\n status.setState(\"running\");\n fake.setStatus(status);\n var updatedExt = mapper.convertValue(fake, JsonExtension.class);\n when(client.update(any(JsonExtension.class))).thenReturn(Mono.just(updatedExt));\n\n var stateNode = JsonNodeFactory.instance.textNode(\"running\");\n var jsonPatch = new JsonPatch(List.of(\n new AddOperation(JsonPointer.of(\"status\", \"state\"), stateNode)\n ));\n webClient.method(HttpMethod.PATCH)\n .uri(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\")\n .header(HttpHeaders.CONTENT_TYPE, \"application/json-patch+json\")\n .bodyValue(jsonPatch)\n .exchange()\n .expectStatus().isOk()\n .expectBody(JsonExtension.class).isEqualTo(updatedExt);\n\n verify(client).update(assertArg(ext -> {\n var state = ext.getInternal().get(\"status\").get(\"state\")\n .asText();\n assertEquals(\"running\", state);\n }));\n }\n }\n\n @Test\n void shouldCreateSuccessfully() {\n var routerFunction = factory.create();\n\n testCases().forEach(testCase -> {\n List> messageReaders =\n HandlerStrategies.withDefaults().messageReaders();\n var request = ServerRequest.create(testCase.webExchange, messageReaders);\n var handlerFunc = routerFunction.route(request).block();\n assertInstanceOf(testCase.expectHandlerType, handlerFunc);\n });\n }\n\n List testCases() {\n var listWebExchange = MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/apis/fake.halo.run/v1alpha1/fakes\").build());\n\n var getWebExchange = MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\").build()\n );\n\n var createWebExchange = MockServerWebExchange.from(\n MockServerHttpRequest.post(\"/apis/fake.halo.run/v1alpha1/fakes\").body(\"{}\")\n );\n\n var updateWebExchange = MockServerWebExchange.from(\n MockServerHttpRequest.put(\"/apis/fake.halo.run/v1alpha1/fakes/my-fake\").body(\"{}\")\n );\n\n return List.of(\n new TestCase(listWebExchange, ListHandler.class),\n new TestCase(getWebExchange, GetHandler.class),\n new TestCase(createWebExchange, CreateHandler.class),\n new TestCase(updateWebExchange, UpdateHandler.class)\n );\n }\n\n record TestCase(ServerWebExchange webExchange,\n Class> expectHandlerType) {\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/extension/router/ExtensionUpdateHandlerTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.argThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.doThrow;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Objects;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.web.reactive.function.server.EntityResponse;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.exception.ExtensionNotFoundException;\n\n@ExtendWith(MockitoExtension.class)\nclass ExtensionUpdateHandlerTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Test\n void shouldBuildPathPatternCorrectly() {\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var updateHandler = new ExtensionUpdateHandler(scheme, client);\n var pathPattern = updateHandler.pathPattern();\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes/{name}\", pathPattern);\n }\n\n @Test\n void shouldHandleCorrectly() {\n final var fake = new FakeExtension();\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n fake.setMetadata(metadata);\n\n var unstructured = new Unstructured();\n unstructured.setMetadata(metadata);\n unstructured.setApiVersion(\"fake.halo.run/v1alpha1\");\n unstructured.setKind(\"Fake\");\n\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .body(Mono.just(unstructured));\n // when(client.fetch(eq(FakeExtension.class), eq(\"my-fake\"))).thenReturn(Mono.just(fake));\n when(client.update(eq(unstructured))).thenReturn(Mono.just(unstructured));\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var updateHandler = new ExtensionUpdateHandler(scheme, client);\n var responseMono = updateHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .assertNext(response -> {\n assertEquals(HttpStatus.OK, response.statusCode());\n assertEquals(MediaType.APPLICATION_JSON, response.headers().getContentType());\n assertTrue(response instanceof EntityResponse);\n assertEquals(unstructured, ((EntityResponse) response).entity());\n })\n .verifyComplete();\n // verify(client, times(1)).fetch(eq(FakeExtension.class), eq(\"my-fake\"));\n verify(client, times(1)).update(eq(unstructured));\n }\n\n @Test\n void shouldReturnErrorWhenNoBodyProvided() {\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .body(Mono.empty());\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var updateHandler = new ExtensionUpdateHandler(scheme, client);\n var responseMono = updateHandler.handle(serverRequest);\n StepVerifier.create(responseMono)\n .verifyError(ServerWebInputException.class);\n }\n\n @Test\n void shouldReturnErrorWhenNoNameProvided() {\n var serverRequest = MockServerRequest.builder()\n .body(Mono.empty());\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var updateHandler = new ExtensionUpdateHandler(scheme, client);\n assertThrows(IllegalArgumentException.class, () -> updateHandler.handle(serverRequest));\n }\n\n @Test\n void shouldReturnErrorWhenExtensionNotFound() {\n final var unstructured = new Unstructured();\n var metadata = new Metadata();\n metadata.setName(\"my-fake\");\n unstructured.setMetadata(metadata);\n unstructured.setApiVersion(\"fake.halo.run/v1alpha1\");\n unstructured.setKind(\"Fake\");\n\n var serverRequest = MockServerRequest.builder()\n .pathVariable(\"name\", \"my-fake\")\n .body(Mono.just(unstructured));\n doThrow(ExtensionNotFoundException.class).when(client).update(any());\n\n var scheme = Scheme.buildFromType(FakeExtension.class);\n var updateHandler = new ExtensionUpdateHandler(scheme, client);\n var responseMono = updateHandler.handle(serverRequest);\n\n StepVerifier.create(responseMono)\n .verifyError(ExtensionNotFoundException.class);\n\n verify(client, times(1)).update(\n argThat(extension -> Objects.equals(\"my-fake\", extension.getMetadata().getName())));\n verify(client, times(0)).fetch(same(FakeExtension.class), anyString());\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/extension/router/PathPatternGeneratorTest.java", "content": "package run.halo.app.extension.router;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.AbstractExtension;\nimport run.halo.app.extension.GVK;\nimport run.halo.app.extension.Scheme;\nimport run.halo.app.extension.router.ExtensionRouterFunctionFactory.PathPatternGenerator;\n\nclass PathPatternGeneratorTest {\n\n @GVK(group = \"fake.halo.run\", version = \"v1alpha1\", kind = \"Fake\",\n singular = \"fake\", plural = \"fakes\")\n private static class GroupExtension extends AbstractExtension {\n }\n\n @GVK(group = \"\", version = \"v1alpha1\", kind = \"Fake\",\n singular = \"fake\", plural = \"fakes\")\n private static class GrouplessExtension extends AbstractExtension {\n }\n\n @Test\n void buildGroupedExtensionPathPattern() {\n var scheme = Scheme.buildFromType(GroupExtension.class);\n var pathPattern = PathPatternGenerator.buildExtensionPathPattern(scheme);\n assertEquals(\"/apis/fake.halo.run/v1alpha1/fakes\", pathPattern);\n }\n\n @Test\n void buildGrouplessExtensionPathPattern() {\n var scheme = Scheme.buildFromType(GrouplessExtension.class);\n var pathPattern = PathPatternGenerator.buildExtensionPathPattern(scheme);\n assertEquals(\"/api/v1alpha1/fakes\", pathPattern);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/extension/store/ReactiveExtensionStoreClientImplTest.java", "content": "package run.halo.app.extension.store;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.r2dbc.core.R2dbcEntityOperations;\nimport org.springframework.data.r2dbc.core.ReactiveSelectOperation;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\n\n@ExtendWith(MockitoExtension.class)\nclass ReactiveExtensionStoreClientImplTest {\n\n @Mock\n ExtensionStoreRepository repository;\n\n @Mock\n R2dbcEntityOperations entityOperations;\n\n @InjectMocks\n ReactiveExtensionStoreClientImpl client;\n\n @Test\n void listByNamePrefix() {\n var expectedExtensions = List.of(\n new ExtensionStore(\"/registry/posts/hello-world\", \"this is post\".getBytes(), 1L),\n new ExtensionStore(\"/registry/posts/hello-halo\", \"this is post\".getBytes(), 1L)\n );\n\n var select = mock(ReactiveSelectOperation.ReactiveSelect.class);\n var selectWithQuery = mock(ReactiveSelectOperation.SelectWithQuery.class);\n var terminatingSelect = mock(ReactiveSelectOperation.TerminatingSelect.class);\n when(terminatingSelect.all()).thenReturn(Flux.fromIterable(expectedExtensions));\n when(selectWithQuery.matching(any())).thenReturn(terminatingSelect);\n when(select.withFetchSize(100)).thenReturn(selectWithQuery);\n when(entityOperations.select(ExtensionStore.class)).thenReturn(select);\n\n client.listByNamePrefix(\"/registry/posts\").collectList()\n .as(StepVerifier::create)\n .expectNext(expectedExtensions)\n .verifyComplete();\n }\n\n @Test\n void fetchByName() {\n var expectedExtension =\n new ExtensionStore(\"/registry/posts/hello-world\", \"this is post\".getBytes(), 1L);\n\n when(repository.findById(\"/registry/posts/hello-halo\"))\n .thenReturn(Mono.just(expectedExtension));\n\n var gotExtension = client.fetchByName(\"/registry/posts/hello-halo\").blockOptional();\n assertTrue(gotExtension.isPresent());\n assertEquals(expectedExtension, gotExtension.get());\n }\n\n @Test\n void create() {\n var expectedExtension =\n new ExtensionStore(\"/registry/posts/hello-halo\", \"hello halo\".getBytes(), 2L);\n\n when(repository.save(any()))\n .thenReturn(Mono.just(expectedExtension));\n\n var createdExtension =\n client.create(\"/registry/posts/hello-halo\", \"hello halo\".getBytes())\n .block();\n\n assertEquals(expectedExtension, createdExtension);\n }\n\n @Test\n void update() {\n var expectedExtension =\n new ExtensionStore(\"/registry/posts/hello-halo\", \"hello halo\".getBytes(), 2L);\n\n when(repository.save(any())).thenReturn(Mono.just(expectedExtension));\n\n var updatedExtension =\n client.update(\"/registry/posts/hello-halo\", 1L, \"hello halo\".getBytes())\n .block();\n\n assertEquals(expectedExtension, updatedExtension);\n }\n\n @Test\n void shouldDoNotThrowExceptionWhenDeletingNonExistExt() {\n when(repository.findById(anyString())).thenReturn(Mono.empty());\n\n client.delete(\"/registry/posts/hello-halo\", 1L).block();\n }\n\n @Test\n void shouldDeleteSuccessfully() {\n var expectedExtension =\n new ExtensionStore(\"/registry/posts/hello-halo\", \"hello halo\".getBytes(), 2L);\n\n when(repository.findById(anyString())).thenReturn(Mono.just(expectedExtension));\n when(repository.delete(any())).thenReturn(Mono.empty());\n\n var deletedExtension = client.delete(\"/registry/posts/hello-halo\", 2L).block();\n\n assertEquals(expectedExtension, deletedExtension);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/ConditionListTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Iterator;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link ConditionList}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass ConditionListTest {\n\n @Test\n void add() {\n ConditionList conditionList = new ConditionList();\n conditionList.add(condition(\"type\", \"message\", \"reason\", ConditionStatus.FALSE));\n conditionList.add(condition(\"type\", \"message\", \"reason\", ConditionStatus.FALSE));\n\n assertThat(conditionList.size()).isEqualTo(1);\n conditionList.add(condition(\"type\", \"message\", \"reason\", ConditionStatus.TRUE));\n assertThat(conditionList.size()).isEqualTo(2);\n }\n\n @Test\n void addAndEvictFIFO() throws JSONException {\n ConditionList conditionList = new ConditionList();\n conditionList.addFirst(condition(\"type\", \"message\", \"reason\", ConditionStatus.FALSE));\n conditionList.addFirst(condition(\"type2\", \"message2\", \"reason2\", ConditionStatus.FALSE));\n conditionList.addFirst(condition(\"type3\", \"message3\", \"reason3\", ConditionStatus.FALSE));\n\n JSONAssert.assertEquals(\"\"\"\n [\n {\n \"type\": \"type3\",\n \"status\": \"FALSE\",\n \"message\": \"message3\",\n \"reason\": \"reason3\"\n },\n {\n \"type\": \"type2\",\n \"status\": \"FALSE\",\n \"message\": \"message2\",\n \"reason\": \"reason2\"\n },\n {\n \"type\": \"type\",\n \"status\": \"FALSE\",\n \"message\": \"message\",\n \"reason\": \"reason\"\n }\n ]\n \"\"\",\n JsonUtils.objectToJson(conditionList),\n true);\n assertThat(conditionList.size()).isEqualTo(3);\n\n conditionList.addAndEvictFIFO(\n condition(\"type4\", \"message4\", \"reason4\", ConditionStatus.FALSE), 1);\n\n assertThat(conditionList.size()).isEqualTo(1);\n\n // json serialize test.\n JSONAssert.assertEquals(\"\"\"\n [\n {\n \"type\": \"type4\",\n \"status\": \"FALSE\",\n \"message\": \"message4\",\n \"reason\": \"reason4\"\n }\n ]\n \"\"\",\n JsonUtils.objectToJson(conditionList), true);\n }\n\n @Test\n void peek() {\n ConditionList conditionList = new ConditionList();\n conditionList.addFirst(condition(\"type\", \"message\", \"reason\", ConditionStatus.FALSE));\n Condition condition = condition(\"type2\", \"message2\", \"reason2\", ConditionStatus.FALSE);\n conditionList.addFirst(condition);\n\n Condition peek = conditionList.peek();\n assertThat(peek).isEqualTo(condition);\n }\n\n @Test\n void removeLast() {\n ConditionList conditionList = new ConditionList();\n Condition condition = condition(\"type\", \"message\", \"reason\", ConditionStatus.FALSE);\n conditionList.addFirst(condition);\n\n conditionList.addFirst(condition(\"type2\", \"message2\", \"reason2\", ConditionStatus.FALSE));\n\n assertThat(conditionList.size()).isEqualTo(2);\n assertThat(conditionList.removeLast()).isEqualTo(condition);\n assertThat(conditionList.size()).isEqualTo(1);\n }\n\n @Test\n void test() {\n ConditionList conditionList = new ConditionList();\n conditionList.addAndEvictFIFO(\n condition(\"type\", \"message\", \"reason\", ConditionStatus.FALSE));\n conditionList.addAndEvictFIFO(\n condition(\"type2\", \"message2\", \"reason2\", ConditionStatus.FALSE));\n\n Iterator iterator = conditionList.iterator();\n assertThat(iterator.next().getType()).isEqualTo(\"type2\");\n assertThat(iterator.next().getType()).isEqualTo(\"type\");\n }\n\n @Test\n void deserialization() {\n String s = \"\"\"\n [{\n \"type\": \"type3\",\n \"status\": \"FALSE\",\n \"message\": \"message3\",\n \"reason\": \"reason3\"\n },\n {\n \"type\": \"type2\",\n \"status\": \"FALSE\",\n \"message\": \"message2\",\n \"reason\": \"reason2\"\n },\n {\n \"type\": \"type\",\n \"status\": \"FALSE\",\n \"message\": \"message\",\n \"reason\": \"reason\"\n }]\n \"\"\";\n ConditionList conditions = JsonUtils.jsonToObject(s, ConditionList.class);\n assertThat(conditions.peek().getType()).isEqualTo(\"type3\");\n }\n\n @Test\n void shouldNotAddIfTypeIsSame() {\n var conditions = new ConditionList();\n var condition = Condition.builder()\n .type(\"type\")\n .status(ConditionStatus.TRUE)\n .reason(\"reason\")\n .message(\"message\")\n .build();\n\n var anotherCondition = Condition.builder()\n .type(\"type\")\n .status(ConditionStatus.FALSE)\n .reason(\"another reason\")\n .message(\"another message\")\n .build();\n\n conditions.addAndEvictFIFO(condition);\n conditions.addAndEvictFIFO(anotherCondition);\n\n assertEquals(1, conditions.size());\n }\n\n @Test\n void shouldNotUpdateLastTransitionTimeIfStatusNotChanged() {\n var now = Instant.now();\n var conditions = new ConditionList();\n conditions.addAndEvictFIFO(\n Condition.builder()\n .type(\"type\")\n .status(ConditionStatus.TRUE)\n .reason(\"reason\")\n .message(\"message\")\n .lastTransitionTime(now)\n .build()\n );\n\n conditions.addAndEvictFIFO(\n Condition.builder()\n .type(\"type\")\n .status(ConditionStatus.TRUE)\n .reason(\"reason\")\n .message(\"message\")\n .lastTransitionTime(now.plus(Duration.ofSeconds(1)))\n .build()\n );\n\n assertEquals(1, conditions.size());\n // make sure the last transition time was not modified.\n assertEquals(now, conditions.peek().getLastTransitionTime());\n }\n\n @Test\n void shouldUpdateLastTransitionTimeIfStatusChanged() {\n var now = Instant.now();\n var conditions = new ConditionList();\n conditions.addAndEvictFIFO(\n Condition.builder()\n .type(\"type\")\n .status(ConditionStatus.TRUE)\n .reason(\"reason\")\n .message(\"message\")\n .lastTransitionTime(now)\n .build()\n );\n\n conditions.addAndEvictFIFO(\n Condition.builder()\n .type(\"type\")\n .status(ConditionStatus.FALSE)\n .reason(\"reason\")\n .message(\"message\")\n .lastTransitionTime(now.plus(Duration.ofSeconds(1)))\n .build()\n );\n\n assertEquals(1, conditions.size());\n assertEquals(now.plus(Duration.ofSeconds(1)), conditions.peek().getLastTransitionTime());\n }\n\n private Condition condition(String type, String message, String reason,\n ConditionStatus status) {\n Condition condition = new Condition();\n condition.setType(type);\n condition.setMessage(message);\n condition.setReason(reason);\n condition.setStatus(status);\n return condition;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/DefaultBackupRootGetterTest.java", "content": "package run.halo.app.infra;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultBackupRootGetterTest {\n\n @Mock\n HaloProperties haloProperties;\n\n @InjectMocks\n DefaultBackupRootGetter backupRootGetter;\n\n @Test\n void shouldGetBackupRootFromWorkDir() {\n when(haloProperties.getWorkDir()).thenReturn(Path.of(\"workdir\"));\n var backupRoot = this.backupRootGetter.get();\n assertEquals(Path.of(\"workdir\", \"backups\"), backupRoot);\n verify(haloProperties).getWorkDir();\n }\n\n\n}" }, { "path": "application/src/test/java/run/halo/app/infra/DefaultExternalLinkProcessorTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.web.filter.reactive.ServerWebExchangeContextFilter.EXCHANGE_CONTEXT_ATTRIBUTE;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.net.URL;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.test.StepVerifier;\n\n/**\n * Tests for {@link DefaultExternalLinkProcessor}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultExternalLinkProcessorTest {\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @InjectMocks\n DefaultExternalLinkProcessor externalLinkProcessor;\n\n\n @Test\n void processWhenLinkIsEmpty() {\n assertThat(externalLinkProcessor.processLink((String) null)).isNull();\n assertThat(externalLinkProcessor.processLink(\"\")).isEmpty();\n }\n\n @Test\n void process() throws MalformedURLException {\n when(externalUrlSupplier.getRaw()).thenReturn(null);\n assertThat(externalLinkProcessor.processLink(\"/test\")).isEqualTo(\"/test\");\n\n when(externalUrlSupplier.getRaw()).thenReturn(URI.create(\"https://halo.run\").toURL());\n assertThat(externalLinkProcessor.processLink(\"/test\")).isEqualTo(\"https://halo.run/test\");\n\n assertThat(externalLinkProcessor.processLink(\"https://guqing.xyz/test\"))\n .isEqualTo(\"https://guqing.xyz/test\");\n\n when(externalUrlSupplier.getRaw()).thenReturn(URI.create(\"https://halo.run/\").toURL());\n assertThat(externalLinkProcessor.processLink(\"/test\")).isEqualTo(\"https://halo.run/test\");\n assertThat(externalLinkProcessor.processLink(\"https://halo.run/test\"))\n .isEqualTo(\"https://halo.run/test\");\n }\n\n @ParameterizedTest\n @MethodSource(\"processUriTestWithoutServerWebExchangeArguments\")\n void processUriWithoutServerWebExchange(String link, String expectedLink)\n throws MalformedURLException {\n lenient().when(externalUrlSupplier.getRaw())\n .thenReturn(new URL(\"https://www.halo.run/context-path\"));\n externalLinkProcessor.processLink(URI.create(link))\n .as(StepVerifier::create)\n .expectNext(URI.create(expectedLink))\n .verifyComplete();\n }\n\n static Stream processUriTestWithoutServerWebExchangeArguments() {\n return Stream.of(\n Arguments.of(\"http://localhost:8090/halo\", \"http://localhost:8090/halo\"),\n Arguments.of(\"/halo\", \"https://www.halo.run/context-path/halo\"),\n Arguments.of(\"halo\", \"https://www.halo.run/context-path/halo\"),\n Arguments.of(\"/halo?query\", \"https://www.halo.run/context-path/halo?query\"),\n Arguments.of(\n \"/halo?query#fragment\", \"https://www.halo.run/context-path/halo?query#fragment\"\n ),\n Arguments.of(\"/halo/subpath\", \"https://www.halo.run/context-path/halo/subpath\"),\n Arguments.of(\"/halo/中文\", \"https://www.halo.run/context-path/halo/%E4%B8%AD%E6%96%87\"),\n Arguments.of(\"/halo/ooo%2Fooo\", \"https://www.halo.run/context-path/halo/ooo%2Fooo\")\n );\n }\n\n @ParameterizedTest\n @MethodSource(\"processUriTestWithServerWebExchangeArguments\")\n void processUriWithServerWebExchange(String link, String expectLink)\n throws MalformedURLException {\n lenient().when(externalUrlSupplier.getRaw())\n .thenReturn(URI.create(\"https://www.halo.run\").toURL());\n var request = mock(ServerHttpRequest.class);\n var exchange = mock(ServerWebExchange.class);\n lenient().when(exchange.getRequest()).thenReturn(request);\n lenient().when(externalUrlSupplier.getURL(request)).thenReturn(\n new URL(\"https://antoher.halo.run/context-path\"));\n externalLinkProcessor.processLink(URI.create(link))\n .contextWrite(context -> context.put(EXCHANGE_CONTEXT_ATTRIBUTE, exchange))\n .as(StepVerifier::create)\n .expectNext(URI.create(expectLink))\n .verifyComplete();\n }\n\n static Stream processUriTestWithServerWebExchangeArguments() {\n return Stream.of(\n Arguments.of(\"http://localhost:8090/halo?query#fragment\",\n \"http://localhost:8090/halo?query#fragment\"),\n Arguments.of(\"/halo\", \"https://antoher.halo.run/context-path/halo\"),\n Arguments.of(\"halo\", \"https://antoher.halo.run/context-path/halo\"),\n Arguments.of(\"/halo?query\", \"https://antoher.halo.run/context-path/halo?query\"),\n Arguments.of(\"/halo?query#fragment\",\n \"https://antoher.halo.run/context-path/halo?query#fragment\"),\n Arguments.of(\"/halo/subpath\", \"https://antoher.halo.run/context-path/halo/subpath\"),\n Arguments.of(\"/halo/中文\",\n \"https://antoher.halo.run/context-path/halo/%E4%B8%AD%E6%96%87\"),\n Arguments.of(\"/halo/ooo%2Fooo\", \"https://antoher.halo.run/context-path/halo/ooo%2Fooo\")\n );\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/DefaultSystemConfigFetcherTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.convert.ConversionService;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport tools.jackson.databind.json.JsonMapper;\n\n/**\n * Tests for {@link DefaultSystemConfigFetcher}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultSystemConfigFetcherTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n ConversionService conversionService;\n\n @Spy\n JsonMapper mapper = JsonMapper.shared();\n\n @InjectMocks\n DefaultSystemConfigFetcher systemConfigFetcher;\n\n private ConfigMap mockConfigMap;\n\n @BeforeEach\n void setUp() {\n mockConfigMap = new ConfigMap();\n mockConfigMap.setData(Map.of(\n \"basic\", \"\"\"\n {\n \"title\": \"Test Blog\",\n \"subtitle\": \"Test\"\n }\"\"\",\n \"post\", \"\"\"\n {\n \"postPageSize\": 10\n }\"\"\"\n ));\n }\n\n @Test\n void testFetchWithConvertibleType() {\n // Arrange\n when(conversionService.canConvert(String.class, String.class))\n .thenReturn(true);\n when(conversionService.convert(\"testValue\", String.class))\n .thenReturn(\"testValue\");\n\n var configMapWithString = new ConfigMap();\n var data = new HashMap();\n data.put(\"testKey\", \"testValue\");\n configMapWithString.setData(data);\n\n systemConfigFetcher.getConfigMapCache().set(configMapWithString.getData());\n\n // Act & Assert\n systemConfigFetcher.fetch(\"testKey\", String.class)\n .as(StepVerifier::create)\n .expectNext(\"testValue\")\n .verifyComplete();\n }\n\n @Test\n void testFetchWithJsonConversion() {\n // Arrange\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\n \"basic\", \"\"\"\n {\n \"title\": \"Test Blog\",\n \"subtitle\": \"Test Subtitle\"\n }\"\"\"\n ));\n systemConfigFetcher.getConfigMapCache().set(configMap.getData());\n\n when(conversionService.canConvert(String.class, SystemSetting.Basic.class))\n .thenReturn(false);\n\n // Act & Assert\n systemConfigFetcher.fetch(\"basic\", SystemSetting.Basic.class)\n .as(StepVerifier::create)\n .assertNext(basic -> {\n assertThat(basic.getTitle()).isEqualTo(\"Test Blog\");\n assertThat(basic.getSubtitle()).isEqualTo(\"Test Subtitle\");\n })\n .verifyComplete();\n }\n\n @Test\n void testFetchWhenKeyDoesNotExist() {\n // Arrange\n systemConfigFetcher.getConfigMapCache().set(mockConfigMap.getData());\n\n // Act & Assert\n systemConfigFetcher.fetch(\"nonExistentKey\", String.class)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void testGetBasicWithValidData() {\n // Arrange\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\n \"basic\", \"\"\"\n {\n \"title\": \"My Blog\",\n \"subtitle\": \"My Subtitle\",\n \"logo\": \"logo.png\"\n }\"\"\"\n ));\n systemConfigFetcher.getConfigMapCache().set(configMap.getData());\n\n when(conversionService.canConvert(String.class, SystemSetting.Basic.class))\n .thenReturn(false);\n\n // Act & Assert\n systemConfigFetcher.getBasic()\n .as(StepVerifier::create)\n .assertNext(basic -> {\n assertThat(basic.getTitle()).isEqualTo(\"My Blog\");\n assertThat(basic.getSubtitle()).isEqualTo(\"My Subtitle\");\n assertThat(basic.getLogo()).isEqualTo(\"logo.png\");\n })\n .verifyComplete();\n }\n\n @Test\n void testGetBasicWhenKeyDoesNotExist() {\n // Arrange\n systemConfigFetcher.getConfigMapCache().set(Map.of());\n\n // Act & Assert - should return a new instance\n systemConfigFetcher.getBasic()\n .as(StepVerifier::create)\n .assertNext(basic -> assertThat(basic).isNotNull())\n .verifyComplete();\n }\n\n @Test\n void testFetchComment() {\n // Arrange\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\n \"comment\", \"\"\"\n {\n \"enable\": true\n }\"\"\"\n ));\n systemConfigFetcher.getConfigMapCache().set(configMap.getData());\n\n when(conversionService.canConvert(String.class, SystemSetting.Comment.class))\n .thenReturn(false);\n\n // Act & Assert\n systemConfigFetcher.fetchComment()\n .as(StepVerifier::create)\n .expectNextMatches(java.util.Objects::nonNull)\n .verifyComplete();\n }\n\n @Test\n void testFetchPost() {\n // Arrange\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\n \"post\", \"\"\"\n {\n \"postPageSize\": 10,\n \"archivePageSize\": 20\n }\"\"\"\n ));\n systemConfigFetcher.getConfigMapCache().set(configMap.getData());\n\n when(conversionService.canConvert(String.class, SystemSetting.Post.class))\n .thenReturn(false);\n\n // Act & Assert\n systemConfigFetcher.fetchPost()\n .as(StepVerifier::create)\n .assertNext(post -> {\n assertThat(post.getPostPageSize()).isEqualTo(10);\n assertThat(post.getArchivePageSize()).isEqualTo(20);\n })\n .verifyComplete();\n }\n\n @Test\n void testFetchRouteRules() {\n // Arrange\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\n \"routeRules\", \"\"\"\n {\n \"post\": \"/articles/{slug}\",\n \"tags\": \"/labels\"\n }\"\"\"\n ));\n systemConfigFetcher.getConfigMapCache().set(configMap.getData());\n\n when(conversionService.canConvert(String.class, SystemSetting.ThemeRouteRules.class))\n .thenReturn(false);\n\n // Act & Assert\n systemConfigFetcher.fetchRouteRules()\n .as(StepVerifier::create)\n .assertNext(rules -> {\n assertThat(rules.getPost()).isEqualTo(\"/articles/{slug}\");\n assertThat(rules.getTags()).isEqualTo(\"/labels\");\n })\n .verifyComplete();\n }\n\n @Test\n void testGetConfig() {\n // Arrange\n var configData = mockConfigMap.getData();\n systemConfigFetcher.getConfigMapCache().set(configData);\n\n // Act & Assert\n systemConfigFetcher.getConfig()\n .as(StepVerifier::create)\n .expectNext(java.util.Objects.requireNonNull(configData))\n .verifyComplete();\n }\n\n @Test\n void testGetConfigMap() {\n // Arrange\n when(client.fetch(ConfigMap.class, \"system\"))\n .thenReturn(Mono.just(mockConfigMap));\n\n // Act & Assert\n systemConfigFetcher.getConfigMap()\n .as(StepVerifier::create)\n .expectNext(mockConfigMap)\n .verifyComplete();\n }\n\n @Test\n void testGetConfigMapBlocking() {\n // Arrange\n when(client.fetch(ConfigMap.class, \"system\"))\n .thenReturn(Mono.just(mockConfigMap));\n\n // Act\n Optional result = systemConfigFetcher.getConfigMapBlocking();\n\n // Assert\n assertThat(result).isPresent();\n assertThat(result.get()).isEqualTo(mockConfigMap);\n }\n\n @Test\n void testGetConfigMapBlockingWhenNotFound() {\n // Arrange\n when(client.fetch(ConfigMap.class, \"system\"))\n .thenReturn(Mono.empty());\n\n // Act\n Optional result = systemConfigFetcher.getConfigMapBlocking();\n\n // Assert\n assertThat(result).isEmpty();\n }\n\n @Test\n void testOnApplicationEvent() {\n // Arrange\n var oldData = new HashMap();\n var newDataMap = new HashMap();\n newDataMap.put(\"key1\", \"value1\");\n newDataMap.put(\"key2\", \"value2\");\n var event = new SystemConfigChangedEvent(this, oldData, newDataMap);\n\n // Act\n systemConfigFetcher.onApplicationEvent(event);\n\n // Assert\n assertThat(systemConfigFetcher.getConfigMapCache().get()).isEqualTo(newDataMap);\n }\n\n @Test\n void testCacheInvalidation() {\n // Arrange\n var initialDataMap = new HashMap();\n initialDataMap.put(\"key1\", \"value1\");\n systemConfigFetcher.getConfigMapCache().set(initialDataMap);\n\n // Act & Assert - Verify cache is updated when new data differs\n var newDataMap = new HashMap();\n newDataMap.put(\"key1\", \"newValue\");\n var event = new SystemConfigChangedEvent(this, initialDataMap, newDataMap);\n systemConfigFetcher.onApplicationEvent(event);\n\n assertThat(systemConfigFetcher.getConfigMapCache().get()).isEqualTo(newDataMap);\n }\n\n @Test\n void shouldGetConfigMapFromDatabaseIfNoCache() {\n // Arrange\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG))\n .thenReturn(Mono.just(mockConfigMap));\n when(client.fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG_DEFAULT))\n .thenReturn(Mono.empty());\n\n assertNotNull(mockConfigMap.getData());\n systemConfigFetcher.getConfigMapMono()\n .as(StepVerifier::create)\n .expectNext(mockConfigMap.getData())\n .verifyComplete();\n }\n\n @Test\n void shouldGetConfigMapFromCacheIfPresent() {\n // Arrange\n var cachedData = Map.of(\n \"cachedKey\", \"\"\"\n {\n \"key1\": \"value1\"\n }\"\"\"\n );\n systemConfigFetcher.getConfigMapCache().set(cachedData);\n\n // Act & Assert\n systemConfigFetcher.getConfigMapMono()\n .as(StepVerifier::create)\n .expectNext(cachedData)\n .verifyComplete();\n\n verify(client, never()).fetch(ConfigMap.class, SystemSetting.SYSTEM_CONFIG);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/DefaultSystemVersionSupplierTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.util.Properties;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.boot.info.BuildProperties;\n\n/**\n * Tests for {@link DefaultSystemVersionSupplier}.\n *\n * @author guqing\n * @since 2.0.0\n */\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultSystemVersionSupplierTest {\n\n @InjectMocks\n private DefaultSystemVersionSupplier systemVersionSupplier;\n\n @Mock\n ObjectProvider buildPropertiesProvider;\n\n @Test\n void getWhenBuildPropertiesNotSet() {\n Version version = systemVersionSupplier.get();\n assertThat(version.toString()).isEqualTo(\"0.0.0\");\n }\n\n @Test\n void getWhenBuildPropertiesButVersionIsNull() {\n Properties properties = new Properties();\n BuildProperties buildProperties = new BuildProperties(properties);\n when(buildPropertiesProvider.getIfUnique()).thenReturn(buildProperties);\n\n Version version = systemVersionSupplier.get();\n assertThat(version.toString()).isEqualTo(\"0.0.0\");\n }\n\n @Test\n void getWhenBuildPropertiesAndVersionNotEmpty() {\n Properties properties = new Properties();\n properties.put(\"version\", \"2.0.0\");\n BuildProperties buildProperties = new BuildProperties(properties);\n when(buildPropertiesProvider.getIfUnique()).thenReturn(buildProperties);\n\n Version version = systemVersionSupplier.get();\n assertThat(version.toString()).isEqualTo(\"2.0.0\");\n\n properties.put(\"version\", \"2.0.0-SNAPSHOT\");\n buildProperties = new BuildProperties(properties);\n when(buildPropertiesProvider.getIfUnique()).thenReturn(buildProperties);\n version = systemVersionSupplier.get();\n assertThat(version.toString()).isEqualTo(\"2.0.0-SNAPSHOT\");\n assertThat(version.preReleaseVersion().orElseThrow()).isEqualTo(\"SNAPSHOT\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/ExtensionResourceInitializerTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.io.IOException;\nimport java.nio.charset.StandardCharsets;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.boot.context.event.ApplicationStartedEvent;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.util.FileSystemUtils;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link ExtensionResourceInitializer}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ExtensionResourceInitializerTest {\n\n @Mock\n ReactiveExtensionClient extensionClient;\n @Mock\n HaloProperties haloProperties;\n @Mock\n ApplicationStartedEvent applicationStartedEvent;\n\n @Mock\n ApplicationEventPublisher eventPublisher;\n\n @InjectMocks\n ExtensionResourceInitializer extensionResourceInitializer;\n\n List dirsToClean;\n\n @BeforeEach\n void setUp() throws IOException {\n dirsToClean = new ArrayList<>(2);\n\n Path tempDirectory = Files.createTempDirectory(\"extension-resource-initializer-test\");\n dirsToClean.add(tempDirectory);\n Path multiDirectory =\n Files.createDirectories(tempDirectory.resolve(\"a\").resolve(\"b\").resolve(\"c\"));\n Files.writeString(tempDirectory.resolve(\"hello.yml\"), \"\"\"\n kind: FakeExtension\n apiVersion: v1\n metadata:\n name: fake-extension\n spec:\n hello: world\n \"\"\",\n StandardCharsets.UTF_8);\n\n Files.writeString(multiDirectory.getParent().resolve(\"fake-1.txt\"), \"\"\"\n kind: FakeExtension\n name: fake-extension\n \"\"\",\n StandardCharsets.UTF_8);\n Files.writeString(multiDirectory.resolve(\"fake.yaml\"), \"\"\"\n kind: FakeExtension\n apiVersion: v1\n metadata:\n name: fake-extension\n spec:\n hello: world\n \"\"\",\n StandardCharsets.UTF_8);\n\n // test file in directory\n Path secondTempDir = Files.createTempDirectory(\"extension-resource-file-test\");\n dirsToClean.add(secondTempDir);\n Path filePath = secondTempDir.resolve(\"good.yml\");\n Files.writeString(filePath, \"\"\"\n kind: FakeExtension\n apiVersion: v1\n metadata:\n name: config-file-is-ok\n spec:\n key: value\n \"\"\",\n StandardCharsets.UTF_8);\n\n when(haloProperties.getInitialExtensionLocations())\n .thenReturn(Set.of(\"file:\" + tempDirectory + \"/**/*.yaml\",\n \"file:\" + tempDirectory + \"/**/*.yml\",\n \"file:\" + filePath));\n }\n\n @AfterEach\n void cleanUp() throws IOException {\n if (dirsToClean != null) {\n for (var dir : dirsToClean) {\n FileSystemUtils.deleteRecursively(dir);\n }\n }\n }\n\n @Test\n void shouldStartCorrectly() throws Exception {\n when(haloProperties.isRequiredExtensionDisabled()).thenReturn(true);\n var argumentCaptor = ArgumentCaptor.forClass(Unstructured.class);\n\n when(extensionClient.fetch(any(GroupVersionKind.class), any()))\n .thenReturn(Mono.empty());\n when(extensionClient.create(any())).thenReturn(Mono.empty());\n\n extensionResourceInitializer.start();\n\n verify(extensionClient, times(3)).create(argumentCaptor.capture());\n\n List values = argumentCaptor.getAllValues();\n assertThat(values).isNotNull();\n assertThat(values).hasSize(3);\n JSONAssert.assertEquals(\"\"\"\n [\n {\n \"kind\": \"FakeExtension\",\n \"apiVersion\": \"v1\",\n \"metadata\": {\n \"name\": \"config-file-is-ok\"\n },\n \"spec\": {\n \"key\": \"value\"\n }\n },\n {\n \"kind\": \"FakeExtension\",\n \"apiVersion\": \"v1\",\n \"metadata\": {\n \"name\": \"fake-extension\"\n },\n \"spec\": {\n \"hello\": \"world\"\n }\n },\n {\n \"kind\": \"FakeExtension\",\n \"apiVersion\": \"v1\",\n \"metadata\": {\n \"name\": \"fake-extension\"\n },\n \"spec\": {\n \"hello\": \"world\"\n }\n }\n ]\n \"\"\", JsonUtils.objectToJson(values), false);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/InitializationStateGetterTest.java", "content": "package run.halo.app.infra;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tests for {@link InitializationStateGetter}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass InitializationStateGetterTest {\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private DefaultInitializationStateGetter initializationStateGetter;\n\n @Test\n void userInitialized() {\n when(client.listBy(eq(User.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.empty());\n initializationStateGetter.userInitialized()\n .as(StepVerifier::create)\n .expectNext(false)\n .verifyComplete();\n\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-hidden-user\");\n user.getMetadata().setLabels(Map.of(\"halo.run/hidden-user\", \"true\"));\n user.setSpec(new User.UserSpec());\n user.getSpec().setDisplayName(\"fake-hidden-user\");\n ListResult listResult = new ListResult<>(List.of(user));\n\n when(client.listBy(eq(User.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(listResult));\n initializationStateGetter.userInitialized()\n .as(StepVerifier::create)\n .expectNext(true)\n .verifyComplete();\n }\n\n @Test\n void dataInitialized() {\n ConfigMap configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(SystemState.SYSTEM_STATES_CONFIGMAP);\n configMap.setData(Map.of(\"states\", \"{\\\"isSetup\\\":true}\"));\n when(client.fetch(eq(ConfigMap.class), eq(SystemState.SYSTEM_STATES_CONFIGMAP)))\n .thenReturn(Mono.just(configMap));\n initializationStateGetter.dataInitialized()\n .as(StepVerifier::create)\n .expectNext(true)\n .verifyComplete();\n\n // call again\n initializationStateGetter.dataInitialized()\n .as(StepVerifier::create)\n .expectNext(true)\n .verifyComplete();\n // execute only once\n verify(client).fetch(eq(ConfigMap.class), eq(SystemState.SYSTEM_STATES_CONFIGMAP));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/ReactiveExtensionPaginatedOperatorImplTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.FakeExtension;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n@ExtendWith(MockitoExtension.class)\nclass ReactiveExtensionPaginatedOperatorImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private ReactiveExtensionPaginatedOperatorImpl service;\n\n @Nested\n class ListTest {\n\n @BeforeEach\n void setUp() {\n Instant now = Instant.now();\n var items = new ArrayList<>();\n // Generate 900 items\n for (int j = 0; j < 9; j++) {\n items.addAll(generateItems(100, now));\n }\n // mock new items during the process\n Instant otherNow = now.plusSeconds(1000);\n items.addAll(generateItems(90, otherNow));\n\n when(client.listBy(any(), any(), any())).thenAnswer(invocation -> {\n PageRequest pageRequest = invocation.getArgument(2);\n int pageNumber = pageRequest.getPageNumber();\n var list = ListResult.subList(items, pageNumber, pageRequest.getPageSize());\n var result = new ListResult<>(pageNumber, pageRequest.getPageSize(),\n items.size(), list);\n return Mono.just(result);\n });\n }\n\n @Test\n public void listTest() {\n StepVerifier.create(service.list(FakeExtension.class, new ListOptions()))\n .expectNextCount(900)\n .verifyComplete();\n }\n }\n\n @Test\n void nextPageTest() {\n var result = new ListResult(1, 10, 30, List.of());\n var sort = Sort.by(\"metadata.creationTimestamp\");\n var nextPage = ReactiveExtensionPaginatedOperatorImpl.nextPage(result, sort);\n assertThat(nextPage.getPageNumber()).isEqualTo(2);\n assertThat(nextPage.getPageSize()).isEqualTo(10);\n assertThat(nextPage.getSort()).isEqualTo(sort);\n }\n\n @Test\n void shouldTakeNextTest() {\n var now = Instant.now();\n var item = new FakeExtension();\n item.setMetadata(new Metadata());\n item.getMetadata().setCreationTimestamp(now);\n var result = ReactiveExtensionPaginatedOperatorImpl.shouldTakeNext(item, now);\n assertThat(result).isTrue();\n\n item.getMetadata().setCreationTimestamp(now.minusSeconds(1));\n result = ReactiveExtensionPaginatedOperatorImpl.shouldTakeNext(item, now);\n assertThat(result).isTrue();\n\n item.getMetadata().setCreationTimestamp(now.plusSeconds(1));\n result = ReactiveExtensionPaginatedOperatorImpl.shouldTakeNext(item, now);\n assertThat(result).isFalse();\n }\n\n private List generateItems(int count, Instant creationTimestamp) {\n List items = new ArrayList<>();\n for (int i = 0; i < count; i++) {\n var item = new FakeExtension();\n item.setMetadata(new Metadata());\n item.getMetadata().setCreationTimestamp(creationTimestamp);\n items.add(item);\n }\n return items;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/SystemConfigFirstExternalUrlSupplierTest.java", "content": "package run.halo.app.infra;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.net.URL;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.boot.webflux.autoconfigure.WebFluxProperties;\nimport org.springframework.http.HttpRequest;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@ExtendWith(MockitoExtension.class)\nclass SystemConfigFirstExternalUrlSupplierTest {\n\n @Mock\n HaloProperties haloProperties;\n\n @Mock\n WebFluxProperties webFluxProperties;\n\n @Mock\n SystemConfigFetcher systemConfigFetcher;\n\n @InjectMocks\n SystemConfigFirstExternalUrlSupplier externalUrl;\n\n @Nested\n class HaloPropertiesSupplier {\n\n @BeforeEach\n void setUp() {\n when(systemConfigFetcher.getBasic()).thenReturn(Mono.empty());\n externalUrl.onExtensionInitialized(null);\n }\n\n @Test\n void getURIWhenUsingAbsolutePermalink() throws MalformedURLException {\n var fakeUri = URI.create(\"https://halo.run/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(fakeUri.toURL());\n when(haloProperties.isUseAbsolutePermalink()).thenReturn(true);\n\n assertEquals(fakeUri, externalUrl.get());\n }\n\n @Test\n void getURIWhenBasePathSetAndNotUsingAbsolutePermalink() {\n when(webFluxProperties.getBasePath()).thenReturn(\"/blog\");\n when(haloProperties.isUseAbsolutePermalink()).thenReturn(false);\n\n assertEquals(URI.create(\"/blog\"), externalUrl.get());\n }\n\n @Test\n void getURIWhenBasePathSetAndUsingAbsolutePermalink() throws MalformedURLException {\n var fakeUri = URI.create(\"https://halo.run/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(fakeUri.toURL());\n lenient().when(webFluxProperties.getBasePath()).thenReturn(\"/blog\");\n when(haloProperties.isUseAbsolutePermalink()).thenReturn(true);\n\n assertEquals(URI.create(\"https://halo.run/fake\"), externalUrl.get());\n }\n\n\n @Test\n void getURIWhenUsingRelativePermalink() throws MalformedURLException {\n when(haloProperties.isUseAbsolutePermalink()).thenReturn(false);\n\n assertEquals(URI.create(\"/\"), externalUrl.get());\n }\n\n @Test\n void getURLWhenExternalURLProvided() throws MalformedURLException {\n var fakeUri = URI.create(\"https://halo.run/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(fakeUri.toURL());\n var mockRequest = mock(HttpRequest.class);\n var url = externalUrl.getURL(mockRequest);\n assertEquals(fakeUri.toURL(), url);\n }\n\n @Test\n void getURLWhenExternalURLAbsent() throws MalformedURLException {\n var fakeUri = URI.create(\"https://localhost/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(null);\n var mockRequest = mock(HttpRequest.class);\n when(mockRequest.getURI()).thenReturn(fakeUri);\n var url = externalUrl.getURL(mockRequest);\n assertEquals(new URL(\"https://localhost/\"), url);\n }\n\n @Test\n void getURLWhenBasePathSetAndExternalURLProvided() throws MalformedURLException {\n var fakeUri = URI.create(\"https://localhost/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(fakeUri.toURL());\n lenient().when(webFluxProperties.getBasePath()).thenReturn(\"/blog\");\n var mockRequest = mock(HttpRequest.class);\n lenient().when(mockRequest.getURI()).thenReturn(fakeUri);\n var url = externalUrl.getURL(mockRequest);\n assertEquals(new URL(\"https://localhost/fake\"), url);\n }\n\n @Test\n void getURLWhenBasePathSetAndExternalURLAbsent() throws MalformedURLException {\n var fakeUri = URI.create(\"https://localhost/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(null);\n when(webFluxProperties.getBasePath()).thenReturn(\"/blog\");\n var mockRequest = mock(HttpRequest.class);\n when(mockRequest.getURI()).thenReturn(fakeUri);\n var url = externalUrl.getURL(mockRequest);\n assertEquals(new URL(\"https://localhost/blog\"), url);\n }\n\n @Test\n void getRaw() throws MalformedURLException {\n var fakeUri = URI.create(\"http://localhost/fake\");\n when(haloProperties.getExternalUrl()).thenReturn(fakeUri.toURL());\n assertEquals(fakeUri.toURL(), externalUrl.getRaw());\n\n when(haloProperties.getExternalUrl()).thenReturn(null);\n assertNull(externalUrl.getRaw());\n }\n\n }\n\n @Nested\n class SystemConfigSupplier {\n\n @Test\n void shouldGetUrlWhenUseAbsolutePermalink() throws Exception {\n var basic = new SystemSetting.Basic();\n basic.setExternalUrl(\"https://www.halo.run\");\n when(systemConfigFetcher.getBasic()).thenReturn(Mono.just(basic));\n when(haloProperties.isUseAbsolutePermalink()).thenReturn(true);\n externalUrl.onExtensionInitialized(null);\n assertEquals(URI.create(\"https://www.halo.run\").toURL(), externalUrl.getRaw());\n assertEquals(URI.create(\"https://www.halo.run\"), externalUrl.get());\n\n var mockRequest = mock(HttpRequest.class);\n assertEquals(URI.create(\"https://www.halo.run\").toURL(),\n externalUrl.getURL(mockRequest));\n }\n\n @Test\n void shouldGetUrlWhenNotUsingAbsolutePermalink() throws MalformedURLException {\n var basic = new SystemSetting.Basic();\n basic.setExternalUrl(\"https://www.halo.run\");\n when(systemConfigFetcher.getBasic()).thenReturn(Mono.just(basic));\n when(haloProperties.isUseAbsolutePermalink()).thenReturn(false);\n when(webFluxProperties.getBasePath()).thenReturn(\"/fake\");\n externalUrl.onExtensionInitialized(null);\n\n assertEquals(URI.create(\"https://www.halo.run\").toURL(), externalUrl.getRaw());\n assertEquals(URI.create(\"/fake\"), externalUrl.get());\n var mockRequest = mock(HttpRequest.class);\n assertEquals(URI.create(\"https://www.halo.run\").toURL(),\n externalUrl.getURL(mockRequest));\n }\n\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/infra/SystemSettingTest.java", "content": "package run.halo.app.infra;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.HashMap;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.infra.SystemSetting.Comment;\nimport run.halo.app.infra.SystemSetting.ExtensionPointEnabled;\nimport run.halo.app.infra.utils.JsonUtils;\n\nclass SystemSettingTest {\n\n @Nested\n class ExtensionPointEnabledTest {\n\n @Test\n void deserializeTest() {\n var json = \"\"\"\n {\n \"run.halo.app.search.post.PostSearchService\": [\n \"run.halo.app.search.post.LucenePostSearchService\"\n ]\n }\n \"\"\";\n\n var enabled = JsonUtils.jsonToObject(json, ExtensionPointEnabled.class);\n assertTrue(enabled.containsKey(\"run.halo.app.search.post.PostSearchService\"));\n }\n }\n\n @Test\n void shouldGetConfigFromJson() {\n var configMap = new ConfigMap();\n configMap.putDataItem(\"comment\", \"\"\"\n {\"enable\": true}\n \"\"\");\n var comment = SystemSetting.get(configMap.getData(), Comment.GROUP, Comment.class);\n assertTrue(comment.getEnable());\n }\n\n @Test\n void shouldGetNullIfKeyNotExist() {\n var configMap = new ConfigMap();\n configMap.setData(new HashMap<>());\n String fake = SystemSetting.get(configMap.getData(), \"fake-key\", String.class);\n assertNull(fake);\n }\n\n @Test\n void shouldGetConfigViaConversionService() {\n var configMap = new ConfigMap();\n configMap.putDataItem(\"int\", \"100\");\n var integer = SystemSetting.get(configMap.getData(), \"int\", Integer.class);\n assertEquals(100, integer);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/SystemStateTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.ConfigMap;\n\n/**\n * Tests for {@link SystemState}.\n *\n * @author guqing\n * @since 2.8.0\n */\nclass SystemStateTest {\n\n @Test\n void deserialize() {\n ConfigMap configMap = new ConfigMap();\n SystemState systemState = SystemState.deserialize(configMap);\n assertThat(systemState).isNotNull();\n\n configMap.setData(Map.of(SystemState.GROUP, \"{\\\"isSetup\\\":true}\"));\n systemState = SystemState.deserialize(configMap);\n assertThat(systemState.getIsSetup()).isTrue();\n }\n\n @Test\n void update() {\n SystemState newSystemState = new SystemState();\n newSystemState.setIsSetup(true);\n\n ConfigMap configMap = new ConfigMap();\n SystemState.update(newSystemState, configMap);\n assertThat(configMap.getData().get(SystemState.GROUP)).isEqualTo(\"{\\\"isSetup\\\":true}\");\n\n var data = new LinkedHashMap();\n configMap.setData(data);\n data.put(SystemState.GROUP, \"{\\\"isSetup\\\":false}\");\n SystemState.update(newSystemState, configMap);\n assertThat(configMap.getData().get(SystemState.GROUP)).isEqualTo(\"{\\\"isSetup\\\":true}\");\n\n data.clear();\n data.put(SystemState.GROUP, \"{\\\"isSetup\\\":true, \\\"foo\\\":\\\"bar\\\"}\");\n newSystemState.setIsSetup(false);\n SystemState.update(newSystemState, configMap);\n assertThat(configMap.getData().get(SystemState.GROUP))\n .isEqualTo(\"{\\\"isSetup\\\":false,\\\"foo\\\":\\\"bar\\\"}\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/ValidationUtilsTest.java", "content": "package run.halo.app.infra;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.apache.commons.lang3.StringUtils;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link ValidationUtils}.\n *\n * @author guqing\n * @since 2.5.0\n */\nclass ValidationUtilsTest {\n\n @Nested\n class NameValidationTest {\n @Test\n void nullName() {\n assertThat(validateName(null)).isFalse();\n }\n\n @Test\n void emptyUsername() {\n assertThat(validateName(\"\")).isFalse();\n }\n\n @Test\n void startWithIllegalCharacter() {\n assertThat(validateName(\"-abc\")).isFalse();\n }\n\n @Test\n void endWithIllegalCharacter() {\n assertThat(validateName(\"abc-\")).isFalse();\n assertThat(validateName(\"abcD\")).isFalse();\n }\n\n @Test\n void middleWithIllegalCharacter() {\n assertThat(validateName(\"ab?c\")).isFalse();\n }\n\n @Test\n void moreThan63Characters() {\n assertThat(validateName(StringUtils.repeat('a', 64))).isFalse();\n }\n\n @Test\n void correctUsername() {\n assertThat(validateName(\"abc\")).isTrue();\n assertThat(validateName(\"ab-c\")).isTrue();\n assertThat(validateName(\"1st\")).isTrue();\n assertThat(validateName(\"ast1\")).isTrue();\n assertThat(validateName(\"ast-1\")).isTrue();\n }\n\n static boolean validateName(String name) {\n if (StringUtils.isBlank(name)) {\n return false;\n }\n boolean matches = ValidationUtils.NAME_PATTERN.matcher(name).matches();\n return matches && name.length() <= 63;\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/config/SessionConfigurationTest.java", "content": "package run.halo.app.infra.config;\n\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.UnsatisfiedDependencyException;\nimport org.springframework.boot.session.autoconfigure.SessionProperties;\nimport org.springframework.boot.test.context.runner.ReactiveWebApplicationContextRunner;\nimport org.springframework.boot.web.server.autoconfigure.ServerProperties;\nimport org.springframework.session.ReactiveFindByIndexNameSessionRepository;\nimport run.halo.app.security.session.ReactiveIndexedSessionRepository;\n\nclass SessionConfigurationTest {\n\n @Test\n void shouldLoadContextIfNoStoreTypeProvided() {\n var contextRunner = new ReactiveWebApplicationContextRunner()\n .withUserConfiguration(SessionConfiguration.class)\n .withBean(SessionProperties.class)\n .withBean(ServerProperties.class);\n contextRunner.run(context -> {\n assertNull(context.getStartupFailure());\n assertTrue(context.isActive());\n assertInstanceOf(\n ReactiveIndexedSessionRepository.class,\n context.getBean(ReactiveIndexedSessionRepository.class)\n );\n assertInstanceOf(\n ReactiveIndexedSessionRepository.class,\n context.getBean(ReactiveFindByIndexNameSessionRepository.class)\n );\n });\n }\n\n @Test\n void shouldLoadContextIfStoreTypeIsInMemory() {\n var contextRunner = new ReactiveWebApplicationContextRunner()\n .withUserConfiguration(SessionConfiguration.class)\n .withBean(SessionProperties.class)\n .withBean(ServerProperties.class)\n .withPropertyValues(\"halo.session.store-type=in-memory\");\n contextRunner.run(context -> {\n assertNull(context.getStartupFailure());\n assertTrue(context.isActive());\n assertInstanceOf(\n ReactiveIndexedSessionRepository.class,\n context.getBean(ReactiveIndexedSessionRepository.class)\n );\n assertInstanceOf(\n ReactiveIndexedSessionRepository.class,\n context.getBean(ReactiveFindByIndexNameSessionRepository.class)\n );\n });\n }\n\n @Test\n void shouldFailToLoadContextIfStoreTypeIsInvalid() {\n var contextRunner = new ReactiveWebApplicationContextRunner()\n .withUserConfiguration(SessionConfiguration.class)\n .withBean(SessionProperties.class)\n .withBean(ServerProperties.class)\n .withPropertyValues(\"halo.session.store-type=invalid-type\");\n contextRunner.run(context ->\n assertInstanceOf(UnsatisfiedDependencyException.class, context.getStartupFailure())\n );\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/exception/handlers/I18nExceptionTest.java", "content": "package run.halo.app.infra.exception.handlers;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\n\nimport java.util.Locale;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.dao.ConcurrencyFailureException;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.ProblemDetail;\nimport org.springframework.http.ResponseEntity;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.bind.annotation.GetMapping;\nimport org.springframework.web.bind.annotation.PutMapping;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.ResponseStatus;\nimport org.springframework.web.bind.annotation.RestController;\nimport org.springframework.web.server.ResponseStatusException;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass I18nExceptionTest {\n\n @Autowired\n WebTestClient webClient;\n\n Locale currentLocale;\n\n @BeforeEach\n void setUp() {\n currentLocale = Locale.getDefault();\n Locale.setDefault(Locale.ENGLISH);\n }\n\n @AfterEach\n void tearDown() {\n Locale.setDefault(currentLocale);\n }\n\n @Test\n void shouldBeOkForGreetingEndpoint() {\n webClient.get().uri(\"/response-entity/greet\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(String.class).isEqualTo(\"Hello Halo\");\n }\n\n @Test\n void shouldGetErrorIfErrorResponseThrow() {\n webClient.get().uri(\"/response-entity/error-response\")\n .exchange()\n .expectStatus().isBadRequest()\n .expectBody(ProblemDetail.class)\n .value(problemDetail -> {\n assertEquals(\"Error Response\", problemDetail.getTitle());\n assertEquals(\"Message argument is {0}.\", problemDetail.getDetail());\n });\n }\n\n\n @Test\n void shouldGetErrorIfErrorResponseThrowWithMessageCode() {\n webClient.get().uri(\"/response-entity/error-response/with-message-code\")\n .exchange()\n .expectStatus().isBadRequest()\n .expectBody(ProblemDetail.class)\n .value(problemDetail -> {\n assertEquals(\"Error Response\", problemDetail.getTitle());\n assertEquals(\"Something went wrong, argument is fake-arg.\",\n problemDetail.getDetail());\n });\n }\n\n @Test\n void shouldGetErrorIfErrorResponseThrowWithMessageCodeAndLocaleIsChinese() {\n webClient.get().uri(\"/response-entity/error-response/with-message-code\")\n .header(HttpHeaders.ACCEPT_LANGUAGE, \"zh-CN,zh\")\n .exchange()\n .expectStatus().isBadRequest()\n .expectBody(ProblemDetail.class)\n .value(problemDetail -> {\n assertEquals(\"发生错误\", problemDetail.getTitle());\n assertEquals(\"发生了一些错误，参数：fake-arg。\",\n problemDetail.getDetail());\n });\n\n }\n\n @Test\n void shouldGetErrorIfThrowingResponseStatusException() {\n webClient.get().uri(\"/response-entity/with-response-status-error\")\n .exchange()\n .expectStatus().isEqualTo(HttpStatus.GONE)\n .expectBody(ProblemDetail.class)\n .value(problemDetail -> {\n assertEquals(\"Gone\", problemDetail.getTitle());\n assertEquals(\"Something went wrong\",\n problemDetail.getDetail());\n });\n }\n\n @Test\n void shouldGetErrorIfThrowingGeneralException() {\n // problem reason will be a fixed prompt when internal server error occurred.\n webClient.get().uri(\"/response-entity/general-error\")\n .exchange()\n .expectStatus().isEqualTo(HttpStatus.INTERNAL_SERVER_ERROR)\n .expectBody(ProblemDetail.class)\n .value(problemDetail -> {\n assertEquals(\"Internal Server Error\", problemDetail.getTitle());\n assertEquals(\"Something went wrong, please try again later.\",\n problemDetail.getDetail());\n });\n }\n\n @Test\n void shouldGetConflictError() {\n webClient.mutate().apply(csrf()).build()\n .put().uri(\"/response-entity/conflict-error\")\n .exchange()\n .expectStatus().isEqualTo(HttpStatus.CONFLICT)\n .expectBody(ProblemDetail.class)\n .value(problemDetail -> {\n assertEquals(\"Conflict\", problemDetail.getTitle());\n assertEquals(\"Conflict detected.\",\n problemDetail.getDetail());\n });\n }\n\n @TestConfiguration\n static class TestConfig {\n\n @RestController\n @RequestMapping(\"/response-entity\")\n static class ResponseEntityController {\n\n @GetMapping(\"/greet\")\n ResponseEntity greet() {\n return ResponseEntity.ok(\"Hello Halo\");\n }\n\n @GetMapping(\"/error-response\")\n ResponseEntity throwErrorResponseException() {\n throw new ErrorResponseException();\n }\n\n @GetMapping(\"/error-response/with-message-args\")\n ResponseEntity throwErrorResponseExceptionWithMessageArgs() {\n throw new ErrorResponseException(\"Something went wrong.\",\n null, new Object[] {\"fake-arg\"});\n }\n\n @GetMapping(\"/error-response/with-message-code\")\n ResponseEntity throwErrorResponseExceptionWithMessageCode() {\n throw new ErrorResponseException(\"Something went wrong.\",\n \"error.somethingWentWrong\", new Object[] {\"fake-arg\"});\n }\n\n @GetMapping(\"/with-response-status-error\")\n ResponseEntity throwWithResponseStatusException() {\n throw new WithResponseStatusException();\n }\n\n @GetMapping(\"/general-error\")\n ResponseEntity throwGeneralException() {\n throw new GeneralException(\"Something went wrong\");\n }\n\n @PutMapping(\"/conflict-error\")\n ResponseEntity throwConflictException() {\n throw new ConcurrencyFailureException(\"Conflict detected\");\n }\n }\n }\n\n static class ErrorResponseException extends ResponseStatusException {\n\n public ErrorResponseException() {\n this(\"Something went wrong.\");\n }\n\n public ErrorResponseException(String reason) {\n this(reason, null, null);\n }\n\n public ErrorResponseException(String reason, String detailCode, Object[] detailArgs) {\n super(HttpStatus.BAD_REQUEST, reason, null, detailCode, detailArgs);\n }\n }\n\n @ResponseStatus(value = HttpStatus.GONE, reason = \"Something went wrong\")\n static class WithResponseStatusException extends RuntimeException {\n\n }\n\n static class GeneralException extends RuntimeException {\n\n public GeneralException(String message) {\n super(message);\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/properties/HaloPropertiesTest.java", "content": "package run.halo.app.infra.properties;\n\nimport java.net.MalformedURLException;\nimport java.net.URL;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.springframework.validation.SimpleErrors;\n\nclass HaloPropertiesTest {\n\n static Stream validateTest() throws MalformedURLException {\n return Stream.of(\n Arguments.of(true, new URL(\"http://localhost:8080\"), true),\n Arguments.of(false, new URL(\"http://localhost:8080\"), true),\n Arguments.of(true, new URL(\"https://localhost:8080\"), true),\n Arguments.of(false, new URL(\"https://localhost:8080\"), true),\n Arguments.of(true, new URL(\"ftp://localhost:8080\"), false),\n Arguments.of(false, new URL(\"ftp://localhost:8080\"), false),\n Arguments.of(true, new URL(\"http:www/halo/run\"), false),\n Arguments.of(false, new URL(\"http:www/halo.run\"), false),\n Arguments.of(true, new URL(\"https:www/halo/run\"), false),\n Arguments.of(false, new URL(\"https:www/halo/run\"), false),\n Arguments.of(true, new URL(\"https:///path\"), false),\n Arguments.of(false, new URL(\"https:///path\"), false),\n Arguments.of(true, new URL(\"http:///path\"), false),\n Arguments.of(false, new URL(\"http:///path\"), false),\n Arguments.of(true, null, false),\n Arguments.of(false, null, true)\n );\n }\n\n @ParameterizedTest\n @MethodSource\n void validateTest(boolean useAbsolutePermalink, URL externalUrl, boolean valid) {\n var properties = new HaloProperties();\n properties.setUseAbsolutePermalink(useAbsolutePermalink);\n properties.setExternalUrl(externalUrl);\n var errors = new SimpleErrors(properties);\n properties.validate(properties, errors);\n Assertions.assertEquals(valid, !errors.hasErrors());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/Base62UtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport io.seruco.encoding.base62.Base62;\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link Base62}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass Base62UtilsTest {\n\n @Test\n void encode() {\n getNaiveTestSet().forEach(\n (str, encoded) -> assertThat(Base62Utils.encode(str)).isEqualTo(encoded));\n }\n\n @Test\n void decodeToString() {\n getNaiveTestSet().forEach(\n (str, encoded) -> assertThat(Base62Utils.decodeToString(encoded)).isEqualTo(str));\n }\n\n public static Map getNaiveTestSet() {\n Map testSet = new HashMap<>();\n\n testSet.put(\"\", \"\");\n testSet.put(\"a\", \"1Z\");\n testSet.put(\"Hello\", \"5TP3P3v\");\n testSet.put(\"Hello world!\", \"T8dgcjRGuYUueWht\");\n testSet.put(\"Just a test\", \"7G0iTmJjQFG2t6K\");\n testSet.put(\"!!!!!!!!!!!!!!!!!\", \"4A7f43EVXQoS6Am897ZKbAn\");\n testSet.put(\"0123456789\", \"18XU2xYejWO9d3\");\n testSet.put(\"The quick brown fox jumps over the lazy dog\",\n \"83UM8dOjD4xrzASgmqLOXTgTagvV1jPegUJ39mcYnwHwTlzpdfKXvpp4RL\");\n testSet.put(\"Sphinx of black quartz, judge my vow\",\n \"1Ul5yQGNM8YFBp3sz19dYj1kTp95OW7jI8pTcTP5JhYjIaFmx\");\n\n return testSet;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/utils/FileNameUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static run.halo.app.infra.utils.FileNameUtils.randomFileName;\nimport static run.halo.app.infra.utils.FileNameUtils.removeFileExtension;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\nclass FileNameUtilsTest {\n\n @Nested\n class RemoveFileExtensionTest {\n\n @Test\n public void shouldNotRemoveExtIfNoExt() {\n assertEquals(\"halo\", removeFileExtension(\"halo\", true));\n assertEquals(\"halo\", removeFileExtension(\"halo\", false));\n }\n\n @Test\n public void shouldRemoveExtIfHasOnlyOneExt() {\n assertEquals(\"halo\", removeFileExtension(\"halo.run\", true));\n assertEquals(\"halo\", removeFileExtension(\"halo.run\", false));\n }\n\n @Test\n public void shouldNotRemoveExtIfDotfile() {\n assertEquals(\".halo\", removeFileExtension(\".halo\", true));\n assertEquals(\".halo\", removeFileExtension(\".halo\", false));\n }\n\n @Test\n public void shouldRemoveExtIfDotfileHasOneExt() {\n assertEquals(\".halo\", removeFileExtension(\".halo.run\", true));\n assertEquals(\".halo\", removeFileExtension(\".halo.run\", false));\n }\n\n @Test\n public void shouldRemoveExtIfHasTwoExt() {\n assertEquals(\"halo\", removeFileExtension(\"halo.tar.gz\", true));\n assertEquals(\"halo.tar\", removeFileExtension(\"halo.tar.gz\", false));\n }\n\n @Test\n public void shouldRemoveExtIfDotfileHasTwoExt() {\n assertEquals(\".halo\", removeFileExtension(\".halo.tar.gz\", true));\n assertEquals(\".halo.tar\", removeFileExtension(\".halo.tar.gz\", false));\n }\n\n @Test\n void shouldReturnNullIfFilenameIsNull() {\n assertNull(removeFileExtension(null, true));\n assertNull(removeFileExtension(null, false));\n }\n }\n\n @Nested\n class AppendRandomFileNameTest {\n @Test\n void normalFileName() {\n String randomFileName = randomFileName(\"halo.run\", 3);\n assertEquals(12, randomFileName.length());\n assertTrue(randomFileName.startsWith(\"halo-\"));\n assertTrue(randomFileName.endsWith(\".run\"));\n\n randomFileName = randomFileName(\".run\", 3);\n assertEquals(7, randomFileName.length());\n assertTrue(randomFileName.endsWith(\".run\"));\n\n randomFileName = randomFileName(\"halo\", 3);\n assertEquals(8, randomFileName.length());\n assertTrue(randomFileName.startsWith(\"halo-\"));\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/utils/FileTypeDetectUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.nio.file.Files;\nimport org.apache.tika.mime.MimeTypeException;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.util.ResourceUtils;\n\n/**\n * Test for {@link FileTypeDetectUtils}.\n *\n * @author guqing\n * @since 2.18.0\n */\nclass FileTypeDetectUtilsTest {\n\n @Test\n void detectMimeTypeTest() throws IOException {\n var file = ResourceUtils.getFile(\"classpath:app.key\");\n String mimeType = FileTypeDetectUtils.detectMimeType(Files.newInputStream(file.toPath()));\n assertThat(mimeType).isEqualTo(\"application/x-x509-key; format=pem\");\n\n file = ResourceUtils.getFile(\"classpath:console/index.html\");\n mimeType = FileTypeDetectUtils.detectMimeType(Files.newInputStream(file.toPath()));\n assertThat(mimeType).isEqualTo(\"text/plain\");\n\n file = ResourceUtils.getFile(\"classpath:themes/test-theme.zip\");\n mimeType = FileTypeDetectUtils.detectMimeType(Files.newInputStream(file.toPath()));\n assertThat(mimeType).isEqualTo(\"application/zip\");\n }\n\n @Test\n void detectMimeTypeWithNameTest() throws IOException {\n var stream = getFileInputStream(\"classpath:file-type-detect/index.js\");\n String mimeType = FileTypeDetectUtils.detectMimeType(stream, \"index.js\");\n assertThat(mimeType).isEqualTo(\"text/javascript\");\n\n stream = getFileInputStream(\"classpath:file-type-detect/index.html\");\n mimeType =\n FileTypeDetectUtils.detectMimeType(stream, \"index.html\");\n assertThat(mimeType).isEqualTo(\"text/html\");\n\n stream = getFileInputStream(\"classpath:file-type-detect/test.json\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream, \"test.json\");\n assertThat(mimeType).isEqualTo(\"application/json\");\n\n stream = getFileInputStream(\"classpath:file-type-detect/other.xlsx\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream, \"other.xlsx\");\n assertThat(mimeType).isEqualTo(\n \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\");\n\n // other.xlsx detect without name\n stream = getFileInputStream(\"classpath:file-type-detect/other.xlsx\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream);\n assertThat(mimeType).isEqualTo(\"application/zip\");\n\n // other.xlsx detect with wrong name\n stream = getFileInputStream(\"classpath:file-type-detect/other.xlsx\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream, \"other.txt\");\n assertThat(mimeType).isEqualTo(\"application/zip\");\n\n stream = getFileInputStream(\"classpath:file-type-detect/test.docx\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream, \"test.docx\");\n assertThat(mimeType).isEqualTo(\n \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\");\n\n // docx detect without file name\n stream = getFileInputStream(\"classpath:file-type-detect/test.docx\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream);\n assertThat(mimeType).isEqualTo(\"application/zip\");\n\n stream = getFileInputStream(\"classpath:file-type-detect/test.svg\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream, \"test.svg\");\n assertThat(mimeType).isEqualTo(\"image/svg+xml\");\n\n stream = getFileInputStream(\"classpath:file-type-detect/test.png\");\n mimeType = FileTypeDetectUtils.detectMimeType(stream, \"test.png\");\n assertThat(mimeType).isEqualTo(\"image/png\");\n }\n\n private static InputStream getFileInputStream(String location) throws IOException {\n var file = ResourceUtils.getFile(location);\n return Files.newInputStream(file.toPath());\n }\n\n @Test\n void detectFileExtensionTest() throws MimeTypeException {\n var ext = FileTypeDetectUtils.detectFileExtension(\"application/x-x509-key; format=pem\");\n assertThat(ext).isEqualTo(\"\");\n\n ext = FileTypeDetectUtils.detectFileExtension(\"text/plain\");\n assertThat(ext).isEqualTo(\".txt\");\n\n ext = FileTypeDetectUtils.detectFileExtension(\"application/zip\");\n assertThat(ext).isEqualTo(\".zip\");\n\n ext = FileTypeDetectUtils.detectFileExtension(\"image/bmp\");\n assertThat(ext).isEqualTo(\".bmp\");\n }\n\n @Test\n void detectFileExtensionsTest() throws MimeTypeException {\n var extensions = FileTypeDetectUtils.detectFileExtensions(\n \"application/x-x509-key; format=pem\"\n );\n assertThat(extensions).isEmpty();\n\n extensions = FileTypeDetectUtils.detectFileExtensions(\"text/plain\");\n assertThat(extensions).contains(\".text\");\n\n extensions = FileTypeDetectUtils.detectFileExtensions(\"application/zip\");\n assertThat(extensions).contains(\".zipx\");\n\n extensions = FileTypeDetectUtils.detectFileExtensions(\"image/bmp\");\n assertThat(extensions).contains(\".dib\");\n\n extensions = FileTypeDetectUtils.detectFileExtensions(\"image/jpeg\");\n assertThat(extensions).contains(\".jpeg\");\n }\n\n @Test\n void getFileExtensionTest() {\n var ext = FileTypeDetectUtils.getFileExtension(\"BMP+HTML+JAR.html\");\n assertThat(ext).isEqualTo(\".html\");\n\n ext = FileTypeDetectUtils.getFileExtension(\"test.jpg\");\n assertThat(ext).isEqualTo(\".jpg\");\n\n ext = FileTypeDetectUtils.getFileExtension(\"hello\");\n assertThat(ext).isEqualTo(\"\");\n }\n\n @Test\n void isValidExtensionForMimeTest() {\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/bmp\", \"hello.html\"))\n .isFalse();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/bmp\", \"hello.bmp\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/jpeg\", \"hello.html\"))\n .isFalse();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/jpeg\", \"hello.jpeg\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/jpeg\", \"hello.JPEG\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/jpeg\", \"hello.jpg\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"image/jpeg\", \"hello.jpe\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"audio/mpeg\", \"hello.html\"))\n .isFalse();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"audio/mpeg\", \"hello.mp3\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"audio/mpeg\", \"hello.MPGA\"))\n .isTrue();\n\n assertThat(FileTypeDetectUtils.isValidExtensionForMime(\"audio/mpeg\", \"hello.m3a\"))\n .isTrue();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/utils/FileUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static java.util.Objects.requireNonNull;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static run.halo.app.infra.utils.FileUtils.checkDirectoryTraversal;\nimport static run.halo.app.infra.utils.FileUtils.deleteFileSilently;\nimport static run.halo.app.infra.utils.FileUtils.jar;\nimport static run.halo.app.infra.utils.FileUtils.unzip;\nimport static run.halo.app.infra.utils.FileUtils.zip;\n\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Files;\nimport java.nio.file.NoSuchFileException;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.util.zip.ZipInputStream;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.io.TempDir;\nimport reactor.test.StepVerifier;\nimport run.halo.app.infra.exception.AccessDeniedException;\n\nclass FileUtilsTest {\n\n @TempDir\n Path tempDirectory;\n\n @Nested\n class DirectoryTraversalTest {\n\n @Test\n void traversalTestWhenSuccess() {\n checkDirectoryTraversal(\"/etc/\", \"/etc/halo/halo/../test\");\n checkDirectoryTraversal(\"/etc/\", \"/etc/halo/../test\");\n checkDirectoryTraversal(\"/etc/\", \"/etc/test\");\n }\n\n @Test\n void traversalTestWhenFailure() {\n assertThrows(AccessDeniedException.class,\n () -> checkDirectoryTraversal(\"/etc/\", \"/etc/../tmp\"));\n assertThrows(AccessDeniedException.class,\n () -> checkDirectoryTraversal(\"/etc/\", \"/../tmp\"));\n assertThrows(AccessDeniedException.class,\n () -> checkDirectoryTraversal(\"/etc/\", \"/tmp\"));\n }\n\n }\n\n @Nested\n class ZipTest {\n\n @Test\n void zipFolderAndUnzip() throws IOException, URISyntaxException {\n var uri = requireNonNull(getClass().getClassLoader().getResource(\"folder-to-zip\"))\n .toURI();\n var zipPath = tempDirectory.resolve(\"example.zip\");\n zip(Paths.get(uri), zipPath);\n\n var unzipTarget = tempDirectory.resolve(\"example-folder\");\n try (var zis = new ZipInputStream(Files.newInputStream(zipPath))) {\n unzip(zis, unzipTarget);\n }\n\n var lines = Files.readAllLines(unzipTarget.resolve(\"examplefile\"));\n assertEquals(1, lines.size());\n assertEquals(\"Here is an example file.\", lines.get(0));\n }\n\n @Test\n void jarFolderAndUnzip() throws IOException, URISyntaxException {\n var uri = requireNonNull(getClass().getClassLoader().getResource(\"folder-to-zip\"))\n .toURI();\n var zipPath = tempDirectory.resolve(\"example.zip\");\n jar(Paths.get(uri), zipPath);\n\n var unzipTarget = tempDirectory.resolve(\"example-folder\");\n try (var zis = new ZipInputStream(Files.newInputStream(zipPath))) {\n unzip(zis, unzipTarget);\n }\n var lines = Files.readAllLines(unzipTarget.resolve(\"examplefile\"));\n assertEquals(1, lines.size());\n assertEquals(\"Here is an example file.\", lines.get(0));\n }\n\n @Test\n void zipFolderIfNoSuchFolder() {\n assertThrows(NoSuchFileException.class, () ->\n zip(Paths.get(\"no-such-folder\"), tempDirectory.resolve(\"example.zip\")));\n }\n\n @Test\n void jarFolderIfNoSuchFolder() {\n assertThrows(NoSuchFileException.class, () ->\n jar(Paths.get(\"no-such-folder\"), tempDirectory.resolve(\"example.zip\")));\n }\n\n }\n\n @Test\n void deleteFileSilentlyTest() throws IOException {\n StepVerifier.create(deleteFileSilently(null))\n .expectNext(false)\n .verifyComplete();\n\n StepVerifier.create(deleteFileSilently(tempDirectory))\n .expectNext(false)\n .verifyComplete();\n\n StepVerifier.create(\n deleteFileSilently(Files.createFile(tempDirectory.resolve(\"for-deleting\"))))\n .expectNext(true)\n .verifyComplete();\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/HaloUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.CsvSource;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport run.halo.app.theme.router.ModelConst;\n\nclass HaloUtilsTest {\n\n @Test\n void checkNoCache() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\").build());\n var request = MockServerRequest.builder()\n .exchange(exchange)\n .build();\n var applied = HaloUtils.noCache().apply(request);\n assertEquals(applied, request);\n assertTrue(() -> exchange.getRequiredAttribute(ModelConst.NO_CACHE));\n }\n\n @ParameterizedTest\n @CsvSource({\n \"http://example.com/path with spaces, http://example.com/path%20with%20spaces\",\n \"https://example.com/üñîçødé, https://example.com/%C3%BC%C3%B1%C3%AE%C3%A7%C3%B8d%C3%A9\",\n \"ftp://example.com/special?param=äöü, ftp://example.com/special?param=%C3%A4%C3%B6%C3%BC\",\n \"http://example.com/normal-path, http://example.com/normal-path\",\n \"http://example.com/路径, http://example.com/%E8%B7%AF%E5%BE%84\",\n \"http://example.com/space%20space, http://example.com/space%20space\",\n \"http://example.com/100%100, http://example.com/100%100\",\n \"http://example.com/mixed chars%20and 中文, http://example.com/mixed%20chars%20and%20%E4%B8%AD%E6%96%87\",\n \"http://中文.com/path/to/中文, http://xn--fiq228c.com/path/to/%E4%B8%AD%E6%96%87\"\n })\n void shouldConvertUriSafely(String uri, String expected) {\n assertEquals(expected, HaloUtils.safeToUri(uri).toString());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/IpAddressUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.net.InetSocketAddress;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\n\nclass IpAddressUtilsTest {\n\n @Test\n void testGetIPAddressFromCloudflareProxy() {\n var request = MockServerHttpRequest.get(\"/\")\n .header(\"CF-Connecting-IP\", \"127.0.0.1\")\n .build();\n var expected = \"127.0.0.1\";\n var actual = IpAddressUtils.getClientIp(request);\n assertEquals(expected, actual);\n }\n\n @Test\n void testGetIPAddressFromXRealIpHeader() {\n var request = MockServerHttpRequest.get(\"/\")\n .header(\"X-Real-IP\", \"127.0.0.1\")\n .build();\n var expected = \"127.0.0.1\";\n var actual = IpAddressUtils.getClientIp(request);\n assertEquals(expected, actual);\n }\n\n @Test\n void testGetUnknownIPAddressWhenRemoteAddressIsNull() {\n var request = MockServerHttpRequest.get(\"/\").build();\n var actual = IpAddressUtils.getClientIp(request);\n assertEquals(IpAddressUtils.UNKNOWN, actual);\n }\n\n @Test\n void testGetUnknownIPAddressWhenRemoteAddressIsUnresolved() {\n var request = MockServerHttpRequest.get(\"/\")\n .remoteAddress(InetSocketAddress.createUnresolved(\"localhost\", 8090))\n .build();\n var actual = IpAddressUtils.getClientIp(request);\n assertEquals(IpAddressUtils.UNKNOWN, actual);\n }\n\n @Test\n void testGetIPAddressWithMultipleHeaders() {\n var headers = new HttpHeaders();\n headers.add(\"X-Forwarded-For\", \"127.0.0.1, 127.0.1.1\");\n headers.add(\"Proxy-Client-IP\", \"127.0.0.2\");\n headers.add(\"CF-Connecting-IP\", \"127.0.0.2\");\n headers.add(\"WL-Proxy-Client-IP\", \"127.0.0.3\");\n headers.add(\"HTTP_CLIENT_IP\", \"127.0.0.4\");\n headers.add(\"HTTP_X_FORWARDED_FOR\", \"127.0.0.5\");\n var request = MockServerHttpRequest.get(\"/\")\n .headers(headers)\n .build();\n var expected = \"127.0.0.1\";\n var actual = IpAddressUtils.getClientIp(request);\n assertEquals(expected, actual);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/SettingUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport java.util.Map;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.core.extension.Setting;\n\n/**\n * Tests for {@link SettingUtils}.\n *\n * @author guqing\n * @since 2.0.1\n */\nclass SettingUtilsTest {\n\n @Test\n void settingDefinedDefaultValueMap() throws JSONException {\n Setting setting = getFakeSetting();\n var map = SettingUtils.settingDefinedDefaultValueMap(setting);\n JSONAssert.assertEquals(\"\"\"\n {\n \"sns\": \"{\\\\\"email\\\\\":\\\\\"example@exmple.com\\\\\"}\"\n }\n \"\"\",\n JsonUtils.objectToJson(map),\n true);\n }\n\n @Test\n void mergePatch() throws JSONException {\n Map defaultValue =\n Map.of(\"comment\", \"{\\\"enable\\\":true,\\\"requireReviewForNew\\\":true}\",\n \"basic\", \"{\\\"title\\\":\\\"guqing's blog\\\"}\",\n \"authProvider\", \"{\\\"github\\\":{\\\"clientId\\\":\\\"fake-client-id\\\"}}\");\n Map modified = Map.of(\"comment\",\n \"{\\\"enable\\\":true,\\\"requireReviewForNew\\\":true,\\\"systemUserOnly\\\":false}\",\n \"basic\", \"{\\\"title\\\":\\\"guqing's blog\\\", \\\"subtitle\\\": \\\"fake-sub-title\\\"}\");\n\n Map result = SettingUtils.mergePatch(modified, defaultValue);\n Map excepted = Map.of(\"comment\",\n \"{\\\"enable\\\":true,\\\"requireReviewForNew\\\":true,\\\"systemUserOnly\\\":false}\",\n \"basic\", \"{\\\"title\\\":\\\"guqing's blog\\\",\\\"subtitle\\\":\\\"fake-sub-title\\\"}\",\n \"authProvider\", \"{\\\"github\\\":{\\\"clientId\\\":\\\"fake-client-id\\\"}}\");\n JSONAssert.assertEquals(JsonUtils.objectToJson(excepted), JsonUtils.objectToJson(result),\n true);\n }\n\n @Test\n void mergePatchWithMoreType() throws JSONException {\n Map defaultValue = Map.of(\n \"array\", \"[1,2,3]\",\n \"number\", \"1\",\n \"boolean\", \"false\",\n \"string\", \"new-default-string-value\",\n \"object\", \"{\\\"name\\\":\\\"guqing\\\"}\"\n );\n Map modified = Map.of(\n \"stringArray\", \"[\\\"hello\\\", \\\"world\\\"]\",\n \"boolean\", \"true\",\n \"string\", \"hello\",\n \"object\", \"{\\\"name\\\":\\\"guqing\\\", \\\"age\\\": 18}\"\n );\n Map result = SettingUtils.mergePatch(modified, defaultValue);\n Map excepted = Map.of(\n \"array\", \"[1,2,3]\",\n \"number\", \"1\",\n \"boolean\", \"true\",\n \"string\", \"hello\",\n \"object\", \"{\\\"name\\\":\\\"guqing\\\",\\\"age\\\":18}\",\n \"stringArray\", \"[\\\"hello\\\",\\\"world\\\"]\"\n );\n JSONAssert.assertEquals(JsonUtils.objectToJson(excepted), JsonUtils.objectToJson(result),\n true);\n }\n\n private static Setting getFakeSetting() {\n String settingJson = \"\"\"\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Setting\",\n \"metadata\": {\n \"name\": \"theme-default-setting\"\n },\n \"spec\": {\n \"forms\": [{\n \"formSchema\": [\n {\n \"$el\": \"h1\",\n \"children\": \"Register\"\n },\n {\n \"$formkit\": \"text\",\n \"label\": \"Email\",\n \"name\": \"email\",\n \"value\": \"example@exmple.com\"\n },\n {\n \"$formkit\": \"password\",\n \"label\": \"Password\",\n \"name\": \"password\",\n \"validation\": \"required|length:5,16\",\n \"value\": null\n }\n ],\n \"group\": \"sns\",\n \"label\": \"社交资料\"\n }]\n }\n }\n \"\"\";\n return JsonUtils.jsonToObject(settingJson, Setting.class);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/SortUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link SortUtils}.\n *\n * @author guqing\n * @since 2.19.0\n */\nclass SortUtilsTest {\n\n @Test\n void resolve() {\n // null case\n assertThat(SortUtils.resolve(null).isUnsorted()).isTrue();\n\n // multiple sort and directions\n var str = List.of(\"name,asc\", \"age,desc\");\n var sort = SortUtils.resolve(str);\n assertThat(sort.toString()).isEqualTo(\"name: ASC,age: DESC\");\n\n // missing direction\n str = List.of(\"name\");\n sort = SortUtils.resolve(str);\n assertThat(sort.toString()).isEqualTo(\"name: ASC\");\n\n // whitespace in direction\n assertThatThrownBy(() -> SortUtils.resolve(List.of(\"name, desc\")))\n .isInstanceOf(IllegalArgumentException.class)\n .hasMessage(\"Direction must not contain whitespace\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/SystemConfigUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\n\nclass SystemConfigUtilsTest {\n\n private final ObjectMapper mapper = JsonUtils.mapper();\n\n @Test\n void mergeMapShouldMergeEmptyMaps() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n Map overrideMap = new HashMap<>();\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n assertNotNull(result);\n assertTrue(result.isEmpty());\n }\n\n @Test\n void mergeMapShouldReturnDefaultMapWhenOverrideIsEmpty() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n Map overrideMap = new HashMap<>();\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n assertEquals(1, result.size());\n assertEquals(\"{\\\"key1\\\":\\\"value1\\\"}\", result.get(\"group1\"));\n }\n\n @Test\n void mergeMapShouldAddNewKeysFromOverrideMap() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group2\", \"{\\\"key2\\\":\\\"value2\\\"}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n assertEquals(2, result.size());\n assertEquals(\"{\\\"key1\\\":\\\"value1\\\"}\", result.get(\"group1\"));\n assertEquals(\"{\\\"key2\\\":\\\"value2\\\"}\", result.get(\"group2\"));\n }\n\n @Test\n void mergeMapShouldDeepMergeJsonObjects() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\",\\\"nested\\\":{\\\"a\\\":\\\"1\\\"}}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"key2\\\":\\\"value2\\\",\\\"nested\\\":{\\\"b\\\":\\\"2\\\"}}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n assertEquals(1, result.size());\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n assertEquals(\"value1\", resultNode.get(\"key1\").asText());\n assertEquals(\"value2\", resultNode.get(\"key2\").asText());\n assertEquals(\"1\", resultNode.get(\"nested\").get(\"a\").asText());\n assertEquals(\"2\", resultNode.get(\"nested\").get(\"b\").asText());\n }\n\n @Test\n void mergeMapShouldOverrideExistingValues() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"key1\\\":\\\"oldValue\\\"}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"key1\\\":\\\"newValue\\\"}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n assertEquals(1, result.size());\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n assertEquals(\"newValue\", resultNode.get(\"key1\").asText());\n }\n\n @Test\n void mergeMapShouldHandleComplexNestedStructures() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"config\",\n \"{\\\"server\\\":{\\\"port\\\":8080,\\\"host\\\":\\\"localhost\\\"},\\\"features\\\":{\\\"auth\\\":true}}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"config\",\n \"{\\\"server\\\":{\\\"port\\\":9090},\\\"features\\\":{\\\"logging\\\":true}}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n JsonNode resultNode = mapper.readTree(result.get(\"config\"));\n assertEquals(9090, resultNode.get(\"server\").get(\"port\").asInt());\n assertEquals(\"localhost\", resultNode.get(\"server\").get(\"host\").asText());\n assertTrue(resultNode.get(\"features\").get(\"auth\").asBoolean());\n assertTrue(resultNode.get(\"features\").get(\"logging\").asBoolean());\n }\n\n @Test\n void mergeMapShouldHandleArrayReplacement() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"items\\\":[1,2,3]}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"items\\\":[4,5,6]}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n JsonNode items = resultNode.get(\"items\");\n assertEquals(3, items.size());\n assertEquals(4, items.get(0).asInt());\n assertEquals(5, items.get(1).asInt());\n assertEquals(6, items.get(2).asInt());\n }\n\n @Test\n void mergeMapShouldHandleNullValues() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"key1\\\":null}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n assertTrue(resultNode.get(\"key1\").isNull());\n }\n\n @Test\n void mergeMapShouldThrowExceptionForInvalidJson() {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"invalid json\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n\n assertThrows(JsonProcessingException.class,\n () -> SystemConfigUtils.mergeMap(defaultMap, overrideMap));\n }\n\n @Test\n void mergeConfigMapShouldMergeConfigMaps() throws JsonProcessingException {\n ConfigMap defaultConfigMap = new ConfigMap();\n Metadata defaultMetadata = new Metadata();\n defaultMetadata.setName(\"default-config\");\n defaultConfigMap.setMetadata(defaultMetadata);\n Map defaultData = new HashMap<>();\n defaultData.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n defaultConfigMap.setData(defaultData);\n\n ConfigMap overrideConfigMap = new ConfigMap();\n Metadata overrideMetadata = new Metadata();\n overrideMetadata.setName(\"override-config\");\n overrideConfigMap.setMetadata(overrideMetadata);\n Map overrideData = new HashMap<>();\n overrideData.put(\"group1\", \"{\\\"key2\\\":\\\"value2\\\"}\");\n overrideConfigMap.setData(overrideData);\n\n ConfigMap result = SystemConfigUtils.mergeConfigMap(defaultConfigMap, overrideConfigMap);\n\n assertNotNull(result);\n assertEquals(\"override-config\", result.getMetadata().getName());\n assertNotNull(result.getData());\n assertEquals(1, result.getData().size());\n JsonNode resultNode = mapper.readTree(result.getData().get(\"group1\"));\n assertEquals(\"value1\", resultNode.get(\"key1\").asText());\n assertEquals(\"value2\", resultNode.get(\"key2\").asText());\n }\n\n @Test\n void mergeConfigMapShouldHandleNullData() throws JsonProcessingException {\n ConfigMap defaultConfigMap = new ConfigMap();\n Metadata defaultMetadata = new Metadata();\n defaultMetadata.setName(\"default-config\");\n defaultConfigMap.setMetadata(defaultMetadata);\n defaultConfigMap.setData(null);\n\n ConfigMap overrideConfigMap = new ConfigMap();\n Metadata overrideMetadata = new Metadata();\n overrideMetadata.setName(\"override-config\");\n overrideConfigMap.setMetadata(overrideMetadata);\n Map overrideData = new HashMap<>();\n overrideData.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n overrideConfigMap.setData(overrideData);\n\n ConfigMap result = SystemConfigUtils.mergeConfigMap(defaultConfigMap, overrideConfigMap);\n\n assertNotNull(result);\n assertNotNull(result.getData());\n assertEquals(1, result.getData().size());\n assertEquals(\"{\\\"key1\\\":\\\"value1\\\"}\", result.getData().get(\"group1\"));\n }\n\n @Test\n void mergeConfigMapShouldHandleBothNullData() throws JsonProcessingException {\n ConfigMap defaultConfigMap = new ConfigMap();\n Metadata defaultMetadata = new Metadata();\n defaultMetadata.setName(\"default-config\");\n defaultConfigMap.setMetadata(defaultMetadata);\n defaultConfigMap.setData(null);\n\n ConfigMap overrideConfigMap = new ConfigMap();\n Metadata overrideMetadata = new Metadata();\n overrideMetadata.setName(\"override-config\");\n overrideConfigMap.setMetadata(overrideMetadata);\n overrideConfigMap.setData(null);\n\n ConfigMap result = SystemConfigUtils.mergeConfigMap(defaultConfigMap, overrideConfigMap);\n\n assertNotNull(result);\n assertNotNull(result.getData());\n assertTrue(result.getData().isEmpty());\n }\n\n @Test\n void mergeConfigMapShouldUseOverrideMetadata() throws JsonProcessingException {\n ConfigMap defaultConfigMap = new ConfigMap();\n Metadata defaultMetadata = new Metadata();\n defaultMetadata.setName(\"default-config\");\n defaultConfigMap.setMetadata(defaultMetadata);\n defaultConfigMap.setData(new HashMap<>());\n\n ConfigMap overrideConfigMap = new ConfigMap();\n Metadata overrideMetadata = new Metadata();\n overrideMetadata.setName(\"override-config\");\n overrideConfigMap.setMetadata(overrideMetadata);\n overrideConfigMap.setData(new HashMap<>());\n\n ConfigMap result = SystemConfigUtils.mergeConfigMap(defaultConfigMap, overrideConfigMap);\n\n assertEquals(\"override-config\", result.getMetadata().getName());\n }\n\n @Test\n void mergeMapShouldHandlePrimitiveValueReplacement() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{\\\"number\\\":42,\\\"boolean\\\":true,\\\"string\\\":\\\"old\\\"}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"number\\\":99,\\\"boolean\\\":false,\\\"string\\\":\\\"new\\\"}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n assertEquals(99, resultNode.get(\"number\").asInt());\n assertFalse(resultNode.get(\"boolean\").asBoolean());\n assertEquals(\"new\", resultNode.get(\"string\").asText());\n }\n\n @Test\n void mergeMapShouldHandleEmptyJsonObjects() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\", \"{}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\", \"{\\\"key1\\\":\\\"value1\\\"}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n assertEquals(\"value1\", resultNode.get(\"key1\").asText());\n }\n\n @Test\n void mergeMapShouldHandleDeepNesting() throws JsonProcessingException {\n Map defaultMap = new HashMap<>();\n defaultMap.put(\"group1\",\n \"{\\\"level1\\\":{\\\"level2\\\":{\\\"level3\\\":{\\\"key\\\":\\\"value1\\\"}}}}\");\n Map overrideMap = new HashMap<>();\n overrideMap.put(\"group1\",\n \"{\\\"level1\\\":{\\\"level2\\\":{\\\"level3\\\":{\\\"newKey\\\":\\\"value2\\\"}}}}\");\n\n Map result = SystemConfigUtils.mergeMap(defaultMap, overrideMap);\n\n JsonNode resultNode = mapper.readTree(result.get(\"group1\"));\n JsonNode level3 = resultNode.get(\"level1\").get(\"level2\").get(\"level3\");\n assertEquals(\"value1\", level3.get(\"key\").asText());\n assertEquals(\"value2\", level3.get(\"newKey\").asText());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/infra/utils/VersionUtilsTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link VersionUtils}.\n *\n * @author guqing\n * @since 2.2.0\n */\nclass VersionUtilsTest {\n\n @Test\n void satisfiesRequires() {\n // match all requires\n String systemVersion = \"0.0.0\";\n String requires = \">=2.2.0\";\n boolean result = VersionUtils.satisfiesRequires(systemVersion, requires);\n assertThat(result).isTrue();\n\n systemVersion = \"2.0.0\";\n requires = \"*\";\n result = VersionUtils.satisfiesRequires(systemVersion, requires);\n assertThat(result).isTrue();\n\n systemVersion = \"2.0.0\";\n requires = \"\";\n result = VersionUtils.satisfiesRequires(systemVersion, requires);\n assertThat(result).isTrue();\n\n // match exact version\n systemVersion = \"2.0.0\";\n requires = \">=2.0.0\";\n result = VersionUtils.satisfiesRequires(systemVersion, requires);\n assertThat(result).isTrue();\n\n systemVersion = \"2.0.0\";\n requires = \">2.0.0\";\n result = VersionUtils.satisfiesRequires(systemVersion, requires);\n assertThat(result).isFalse();\n\n //an exact version x.y.z will implicitly mean the same as >=x.y.z\n systemVersion = \"2.1.0\";\n // means >=2.0.0\n requires = \"2.0.0\";\n result = VersionUtils.satisfiesRequires(systemVersion, requires);\n assertThat(result).isTrue();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/infra/utils/YamlUnstructuredLoaderTest.java", "content": "package run.halo.app.infra.utils;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.List;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.core.io.Resource;\nimport org.springframework.security.util.InMemoryResource;\nimport run.halo.app.extension.Unstructured;\n\n/**\n * Tests for {@link YamlUnstructuredLoader}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass YamlUnstructuredLoaderTest {\n\n private List yamlResources;\n private String notSpecYaml;\n\n @BeforeEach\n void setUp() {\n String viewCategoriesRoleYaml = \"\"\"\n apiVersion: v1alpha1\n kind: Fake\n metadata:\n name: test1\n hello:\n world: halo\n \"\"\";\n\n String multipleRoleYaml = \"\"\"\n apiVersion: v1alpha1\n kind: Fake\n metadata:\n name: test2\n hello:\n world: haha\n ---\n apiVersion: v1alpha1\n kind: Fake\n metadata:\n name: test2\n hello:\n world: bang\n \"\"\";\n\n notSpecYaml = \"\"\"\n server:\n port: 8090\n spring:\n jackson:\n date-format: yyyy-MM-dd HH:mm:ss\n \"\"\";\n\n yamlResources = Stream.of(viewCategoriesRoleYaml, multipleRoleYaml, notSpecYaml)\n .map(InMemoryResource::new)\n .toList();\n }\n\n @Test\n void loadTest() {\n Resource[] resources = yamlResources.toArray(Resource[]::new);\n YamlUnstructuredLoader yamlUnstructuredLoader = new YamlUnstructuredLoader(resources);\n List unstructuredList = yamlUnstructuredLoader.load();\n assertThat(unstructuredList).isNotNull();\n assertThat(unstructuredList).hasSize(3);\n\n assertThat(JsonUtils.objectToJson(unstructuredList)).isEqualToIgnoringWhitespace(\"\"\"\n [\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"name\": \"test1\"\n },\n \"hello\": {\n \"world\": \"halo\"\n }\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"name\": \"test2\"\n },\n \"hello\": {\n \"world\": \"haha\"\n }\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Fake\",\n \"metadata\": {\n \"name\": \"test2\"\n },\n \"hello\": {\n \"world\": \"bang\"\n }\n }\n ]\n \"\"\");\n }\n\n @Test\n void loadIgnore() {\n InMemoryResource resource = new InMemoryResource(notSpecYaml);\n YamlUnstructuredLoader yamlUnstructuredLoader = new YamlUnstructuredLoader(resource);\n List unstructuredList = yamlUnstructuredLoader.load();\n assertThat(unstructuredList).isEmpty();\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/migration/BackupReconcilerTest.java", "content": "package run.halo.app.migration;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.extension.ExtensionUtil.addFinalizers;\n\nimport java.io.IOException;\nimport java.time.Clock;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.time.ZoneId;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.Exceptions;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\n\n@ExtendWith(MockitoExtension.class)\nclass BackupReconcilerTest {\n\n @Mock\n MigrationService migrationService;\n\n @Mock\n ExtensionClient client;\n\n @InjectMocks\n BackupReconciler reconciler;\n\n @Test\n void whenFreshBackupIsComing() {\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n backup.getSpec().setFormat(\"zip\");\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n doNothing().when(client).update(backup);\n when(migrationService.backup(backup)).thenReturn(Mono.fromRunnable(() -> {\n var status = backup.getStatus();\n status.setFilename(\"fake-backup-filename\");\n status.setSize(1024L);\n }));\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n\n var status = backup.getStatus();\n assertEquals(Backup.Phase.SUCCEEDED, status.getPhase());\n assertNotNull(status.getStartTimestamp());\n assertNotNull(status.getCompletionTimestamp());\n assertEquals(\"fake-backup-filename\", status.getFilename());\n assertEquals(1024L, status.getSize());\n\n // 1. query\n // 2. pending -> running\n // 3. running -> succeeded\n verify(client, times(3)).fetch(Backup.class, name);\n verify(client, times(3)).update(backup);\n verify(migrationService).backup(backup);\n }\n\n @Test\n void whenBackupDeleted() {\n var name = \"fake-deleted-backup\";\n var backup = createPureBackup(name);\n backup.getMetadata().setDeletionTimestamp(Instant.now());\n addFinalizers(backup.getMetadata(), Set.of(Constant.HOUSE_KEEPER_FINALIZER));\n\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n when(migrationService.cleanup(backup)).thenReturn(Mono.empty());\n doNothing().when(client).update(backup);\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n\n assertFalse(backup.getMetadata().getFinalizers().contains(Constant.HOUSE_KEEPER_FINALIZER));\n verify(client).fetch(Backup.class, name);\n verify(migrationService).cleanup(backup);\n verify(client).update(backup);\n }\n\n @Test\n void setPhaseToFailedIfPhaseIsRunning() {\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n var status = backup.getStatus();\n status.setPhase(Backup.Phase.RUNNING);\n\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n doNothing().when(client).update(backup);\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n\n assertEquals(Backup.Phase.FAILED, status.getPhase());\n assertEquals(\"UnexpectedExit\", status.getFailureReason());\n // 1. add finalizer\n // 2. update status\n verify(client, times(2)).fetch(Backup.class, name);\n verify(client, times(2)).update(backup);\n }\n\n @Test\n void shouldReQueueIfExpiresAtSetAndNotExpired() {\n var now = Instant.now();\n reconciler.setClock(Clock.fixed(now, ZoneId.systemDefault()));\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n addFinalizers(backup.getMetadata(), Set.of(Constant.HOUSE_KEEPER_FINALIZER));\n backup.getSpec().setExpiresAt(now.plus(Duration.ofSeconds(3)));\n var status = backup.getStatus();\n status.setPhase(Backup.Phase.SUCCEEDED);\n\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertTrue(result.reEnqueue());\n assertEquals(Duration.ofSeconds(3), result.retryAfter());\n\n verify(client).fetch(Backup.class, name);\n verify(client, never()).update(backup);\n verify(client, never()).delete(backup);\n }\n\n @Test\n void shouldDeleteIfExpiresAtSetAndExpired() {\n var now = Instant.now();\n reconciler.setClock(Clock.fixed(now, ZoneId.systemDefault()));\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n addFinalizers(backup.getMetadata(), Set.of(Constant.HOUSE_KEEPER_FINALIZER));\n backup.getSpec().setExpiresAt(now.minus(Duration.ofSeconds(3)));\n var status = backup.getStatus();\n status.setPhase(Backup.Phase.SUCCEEDED);\n\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n doNothing().when(client).delete(backup);\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n\n verify(client).fetch(Backup.class, name);\n verify(client, never()).update(backup);\n verify(client).delete(backup);\n }\n\n @Test\n void whenBackupInterrupted() {\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n backup.getSpec().setFormat(\"zip\");\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n doNothing().when(client).update(backup);\n when(migrationService.backup(backup)).thenReturn(\n Mono.error(Exceptions.propagate(new InterruptedException())));\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n\n var status = backup.getStatus();\n assertEquals(Backup.Phase.FAILED, status.getPhase());\n assertNotNull(status.getStartTimestamp());\n assertNull(status.getCompletionTimestamp());\n assertEquals(\"Interrupted\", status.getFailureReason());\n\n // 1. query\n // 2. pending -> running\n // 3. running -> failed\n verify(client, times(3)).fetch(Backup.class, name);\n verify(client, times(3)).update(backup);\n verify(migrationService).backup(backup);\n }\n\n @Test\n void somethingWentWrongWhenBackup() {\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n backup.getSpec().setFormat(\"zip\");\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n doNothing().when(client).update(backup);\n when(migrationService.backup(backup))\n .thenReturn(Mono.error(Exceptions.propagate(new IOException(\"File not found\"))));\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n\n var status = backup.getStatus();\n assertEquals(Backup.Phase.FAILED, status.getPhase());\n assertNotNull(status.getStartTimestamp());\n assertNull(status.getCompletionTimestamp());\n assertEquals(\"SystemError\", status.getFailureReason());\n\n // 1. query\n // 2. pending -> running\n // 3. running -> failed\n verify(client, times(3)).fetch(Backup.class, name);\n verify(client, times(3)).update(backup);\n verify(migrationService).backup(backup);\n }\n\n @Test\n void whenBackupWasFailed() {\n var name = \"fake-backup\";\n var backup = createPureBackup(name);\n backup.getStatus().setPhase(Backup.Phase.FAILED);\n\n when(client.fetch(Backup.class, name)).thenReturn(Optional.of(backup));\n\n var result = reconciler.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n Mockito.verify(migrationService, never()).backup(any(Backup.class));\n }\n\n Backup createPureBackup(String name) {\n var metadata = new Metadata();\n metadata.setName(name);\n var backup = new Backup();\n backup.setMetadata(metadata);\n return backup;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/migration/impl/MigrationServiceImplTest.java", "content": "package run.halo.app.migration.impl;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.StandardOpenOption;\nimport java.nio.file.attribute.FileTime;\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.zip.ZipInputStream;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.core.io.buffer.DefaultDataBufferFactory;\nimport org.springframework.data.r2dbc.core.R2dbcEntityTemplate;\nimport org.springframework.data.r2dbc.core.ReactiveSelectOperation.ReactiveSelect;\nimport org.springframework.data.r2dbc.core.ReactiveSelectOperation.SelectWithQuery;\nimport org.springframework.r2dbc.connection.R2dbcTransactionManager;\nimport org.springframework.transaction.ReactiveTransaction;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.store.ExtensionStore;\nimport run.halo.app.extension.store.ExtensionStoreRepository;\nimport run.halo.app.infra.BackupRootGetter;\nimport run.halo.app.infra.exception.NotFoundException;\nimport run.halo.app.infra.properties.HaloProperties;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.migration.Backup;\n\n@ExtendWith(MockitoExtension.class)\nclass MigrationServiceImplTest {\n\n @Mock\n ExtensionStoreRepository repository;\n\n @Mock\n HaloProperties haloProperties;\n\n @Mock\n BackupRootGetter backupRoot;\n\n @Mock\n R2dbcEntityTemplate entityTemplate;\n\n @Mock\n R2dbcTransactionManager txManager;\n\n @InjectMocks\n @Spy\n MigrationServiceImpl migrationService;\n\n @Mock\n ReactiveSelect reactiveSelect;\n\n @Mock\n SelectWithQuery selectWithQuery;\n\n @TempDir\n Path tempDir;\n\n @Test\n void backupTest() throws IOException {\n Files.writeString(tempDir.resolve(\"fake-file\"), \"halo\", StandardOpenOption.CREATE_NEW);\n var extensionStores = List.of(\n createExtensionStore(\"fake-extension-store\", \"fake-data\")\n );\n var tx = mock(ReactiveTransaction.class);\n when(txManager.getReactiveTransaction(any())).thenReturn(Mono.just(tx));\n when(txManager.commit(tx)).thenReturn(Mono.empty());\n\n when(entityTemplate.select(ExtensionStore.class)).thenReturn(reactiveSelect);\n when(reactiveSelect.withFetchSize(100)).thenReturn(selectWithQuery);\n when(selectWithQuery.all())\n .thenReturn(Flux.fromIterable(extensionStores))\n .thenReturn(Flux.empty());\n\n when(haloProperties.getWorkDir()).thenReturn(tempDir);\n when(backupRoot.get()).thenReturn(tempDir.resolve(\"backups\"));\n var startTimestamp = Instant.now();\n var backup = createRunningBackup(\"fake-backup\", startTimestamp);\n StepVerifier.create(migrationService.backup(backup))\n .verifyComplete();\n\n // 1. backup workdir\n // 2. package backup\n verify(haloProperties).getWorkDir();\n verify(backupRoot).get();\n\n var status = backup.getStatus();\n var datetimePart = migrationService.getDateTimeFormatter().format(startTimestamp);\n assertEquals(datetimePart + \"-fake-backup.zip\", status.getFilename());\n var backupFile = migrationService.getBackupsRoot()\n .resolve(status.getFilename());\n assertTrue(Files.exists(backupFile));\n assertEquals(Files.size(backupFile), status.getSize());\n\n var target = tempDir.resolve(\"target\");\n try (var zis = new ZipInputStream(\n Files.newInputStream(backupFile, StandardOpenOption.READ))) {\n FileUtils.unzip(zis, tempDir.resolve(\"target\"));\n }\n\n var extensionsFile = target.resolve(\"extensions.data\");\n var workdir = target.resolve(\"workdir\");\n assertTrue(Files.exists(extensionsFile));\n assertTrue(Files.exists(workdir));\n\n var objectMapper = migrationService.getObjectMapper();\n var gotExtensionStores = objectMapper.readValue(extensionsFile.toFile(),\n new TypeReference>() {\n });\n assertEquals(gotExtensionStores, extensionStores);\n assertEquals(\"halo\", Files.readString(workdir.resolve(\"fake-file\")));\n }\n\n @Test\n void restoreTest() throws IOException, URISyntaxException {\n var unpackedBackup =\n getClass().getClassLoader().getResource(\"backups/backup-for-restoration\");\n assertNotNull(unpackedBackup);\n var backupFile = tempDir.resolve(\"backups\").resolve(\"fake-backup.zip\");\n Files.createDirectories(backupFile.getParent());\n FileUtils.zip(Path.of(unpackedBackup.toURI()), backupFile);\n var workdir = tempDir.resolve(\"workdir-for-restoration\");\n Files.createDirectory(workdir);\n\n\n var expectStore = createExtensionStore(\"fake-extension-store\", \"fake-data\");\n expectStore.setVersion(null);\n\n when(haloProperties.getWorkDir()).thenReturn(workdir);\n when(repository.deleteAll()).thenReturn(Mono.empty());\n when(repository.saveAll(List.of(expectStore))).thenReturn(Flux.empty());\n\n var tx = mock(ReactiveTransaction.class);\n when(txManager.getReactiveTransaction(any())).thenReturn(Mono.just(tx));\n when(txManager.commit(tx)).thenReturn(Mono.empty());\n\n var content = DataBufferUtils.read(backupFile,\n DefaultDataBufferFactory.sharedInstance,\n 2048,\n StandardOpenOption.READ);\n StepVerifier.create(migrationService.restore(content))\n .verifyComplete();\n\n\n verify(haloProperties).getWorkDir();\n verify(repository).deleteAll();\n verify(repository).saveAll(List.of(expectStore));\n\n // make sure the workdir is recovered.\n var fakeFile = workdir.resolve(\"fake-file\");\n assertEquals(\"halo\", Files.readString(fakeFile));\n }\n\n @Test\n void cleanupBackupTest() throws IOException {\n var backupFile = tempDir.resolve(\"workdir\").resolve(\"backups\").resolve(\"backup.zip\");\n Files.createDirectories(backupFile.getParent());\n Files.createFile(backupFile);\n\n when(backupRoot.get()).thenReturn(tempDir.resolve(\"workdir\").resolve(\"backups\"));\n var backup = createSucceededBackup(\"fake-backup\", \"backup.zip\");\n StepVerifier.create(migrationService.cleanup(backup))\n .verifyComplete();\n verify(haloProperties, never()).getWorkDir();\n verify(backupRoot).get();\n assertTrue(Files.notExists(backupFile));\n }\n\n @Test\n void cleanupBackupWithNoFilename() {\n var backup = createSucceededBackup(\"fake-backup\", null);\n StepVerifier.create(migrationService.cleanup(backup))\n .verifyComplete();\n verify(haloProperties, never()).getWorkDir();\n verify(backupRoot, never()).get();\n }\n\n @Test\n void downloadBackupTest() throws IOException {\n var backupFile = tempDir.resolve(\"workdir\").resolve(\"backups\").resolve(\"backup.zip\");\n Files.createDirectories(backupFile.getParent());\n Files.writeString(backupFile, \"this is a backup file.\", StandardOpenOption.CREATE_NEW);\n when(backupRoot.get()).thenReturn(tempDir.resolve(\"workdir\").resolve(\"backups\"));\n var backup = createSucceededBackup(\"fake-backup\", \"backup.zip\");\n\n StepVerifier.create(migrationService.download(backup))\n .assertNext(resource -> {\n assertEquals(\"backup.zip\", resource.getFilename());\n try {\n var content = resource.getContentAsString(UTF_8);\n assertEquals(\"this is a backup file.\", content);\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n\n verify(haloProperties, never()).getWorkDir();\n verify(backupRoot).get();\n }\n\n @Test\n void downloadBackupWhichDoesNotExist() {\n var backup = createSucceededBackup(\"fake-backup\", \"backup.zip\");\n when(backupRoot.get()).thenReturn(tempDir.resolve(\"workdir\").resolve(\"backups\"));\n\n StepVerifier.create(migrationService.download(backup))\n .expectError(NotFoundException.class)\n .verify();\n verify(haloProperties, never()).getWorkDir();\n verify(backupRoot).get();\n }\n\n @Test\n void getBackupFilesTest() throws Exception {\n var now = Instant.now();\n var backup1 = tempDir.resolve(\"backup1.zip\");\n Files.writeString(backup1, \"fake-content\");\n Files.setLastModifiedTime(backup1, FileTime.from(now));\n\n var backup2 = tempDir.resolve(\"backup2.zip\");\n Files.writeString(backup2, \"fake--content\");\n Files.setLastModifiedTime(\n backup2,\n FileTime.from(now.plus(Duration.ofSeconds(1)))\n );\n\n var backup3 = tempDir.resolve(\"backup3.not-a-zip\");\n Files.writeString(backup3, \"fake-content\");\n Files.setLastModifiedTime(\n backup3,\n FileTime.from(now.plus(Duration.ofSeconds(2)))\n );\n when(backupRoot.get()).thenReturn(tempDir);\n\n migrationService.afterPropertiesSet();\n migrationService.getBackupFiles()\n .as(StepVerifier::create)\n .assertNext(backupFile -> {\n assertEquals(\"backup2.zip\", backupFile.getFilename());\n assertEquals(13, backupFile.getSize());\n assertEquals(now.plus(Duration.ofSeconds(1)), backupFile.getLastModifiedTime());\n })\n .assertNext(backupFile -> {\n assertEquals(\"backup1.zip\", backupFile.getFilename());\n assertEquals(12, backupFile.getSize());\n assertEquals(now, backupFile.getLastModifiedTime());\n })\n .verifyComplete();\n }\n\n @Test\n void getBackupFileTest() throws Exception {\n var now = Instant.now();\n Files.writeString(tempDir.resolve(\"backup.zip\"), \"fake-content\");\n Files.setLastModifiedTime(tempDir.resolve(\"backup.zip\"), FileTime.from(now));\n when(backupRoot.get()).thenReturn(tempDir);\n\n migrationService.afterPropertiesSet();\n migrationService.getBackupFile(\"backup.zip\")\n .as(StepVerifier::create)\n .assertNext(backupFile -> {\n assertEquals(\"backup.zip\", backupFile.getFilename());\n assertEquals(12, backupFile.getSize());\n assertEquals(now, backupFile.getLastModifiedTime());\n })\n .verifyComplete();\n\n migrationService.getBackupFile(\"backup-not-exist.zip\")\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n Backup createSucceededBackup(String name, String filename) {\n var metadata = new Metadata();\n metadata.setName(name);\n var backup = new Backup();\n backup.setMetadata(metadata);\n var status = backup.getStatus();\n status.setPhase(Backup.Phase.SUCCEEDED);\n status.setCompletionTimestamp(Instant.now());\n status.setFilename(filename);\n status.setSize(1024L);\n return backup;\n }\n\n Backup createRunningBackup(String name, Instant startTimestamp) {\n var metadata = new Metadata();\n metadata.setName(name);\n var backup = new Backup();\n backup.setMetadata(metadata);\n var status = backup.getStatus();\n status.setPhase(Backup.Phase.RUNNING);\n status.setStartTimestamp(startTimestamp);\n return backup;\n }\n\n ExtensionStore createExtensionStore(String name, String data) {\n var store = new ExtensionStore();\n store.setName(name);\n store.setData(data.getBytes(UTF_8));\n store.setVersion(1024L);\n return store;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/DefaultNotificationCenterTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport java.util.Locale;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.notification.Notification;\nimport run.halo.app.core.extension.notification.NotificationTemplate;\nimport run.halo.app.core.extension.notification.NotifierDescriptor;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n/**\n * Tests for {@link DefaultNotificationCenter}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultNotificationCenterTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private ReasonNotificationTemplateSelector notificationTemplateSelector;\n\n @Mock\n private UserNotificationPreferenceService userNotificationPreferenceService;\n\n @Mock\n private NotificationTemplateRender notificationTemplateRender;\n\n @Mock\n private NotificationSender notificationSender;\n\n @Mock\n private RecipientResolver recipientResolver;\n\n @Mock\n private SubscriptionService subscriptionService;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @InjectMocks\n private DefaultNotificationCenter notificationCenter;\n\n @Test\n public void testNotify() {\n final Reason reason = new Reason();\n final Reason.Spec spec = new Reason.Spec();\n Reason.Subject subject = new Reason.Subject();\n subject.setApiVersion(\"content.halo.run/v1alpha1\");\n subject.setKind(\"Comment\");\n subject.setName(\"comment-a\");\n spec.setSubject(subject);\n spec.setReasonType(\"new-reply-on-comment\");\n spec.setAttributes(null);\n reason.setSpec(spec);\n reason.setMetadata(new Metadata());\n reason.getMetadata().setName(\"reason-a\");\n\n var spyNotificationCenter = spy(notificationCenter);\n var subscriber = new Subscriber(UserIdentity.anonymousWithEmail(\"A\"), \"fake-name\");\n when(recipientResolver.resolve(reason)).thenReturn(Flux.just(subscriber));\n\n doReturn(Mono.empty()).when(spyNotificationCenter)\n .dispatchNotification(eq(reason), any());\n\n spyNotificationCenter.notify(reason).block();\n\n verify(spyNotificationCenter).dispatchNotification(eq(reason), any());\n verify(recipientResolver).resolve(eq(reason));\n }\n\n List createSubscriptions() {\n Subscription subscription = new Subscription();\n subscription.setMetadata(new Metadata());\n subscription.getMetadata().setName(\"subscription-a\");\n\n subscription.setSpec(new Subscription.Spec());\n subscription.getSpec().setSubscriber(new Subscription.Subscriber());\n subscription.getSpec().getSubscriber().setName(\"anonymousUser#A\");\n\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(\"new-reply-on-comment\");\n interestReason.setSubject(createNewReplyOnCommentSubject());\n subscription.getSpec().setReason(interestReason);\n\n return List.of(subscription);\n }\n\n Subscription.ReasonSubject createNewReplyOnCommentSubject() {\n var reasonSubject = new Subscription.ReasonSubject();\n reasonSubject.setApiVersion(\"content.halo.run/v1alpha1\");\n reasonSubject.setKind(\"Comment\");\n reasonSubject.setName(\"comment-a\");\n return reasonSubject;\n }\n\n @Test\n public void testSubscribe() {\n var spyNotificationCenter = spy(notificationCenter);\n Subscription subscription = createSubscriptions().get(0);\n\n var subscriber = subscription.getSpec().getSubscriber();\n\n var reason = subscription.getSpec().getReason();\n\n doReturn(Mono.empty())\n .when(spyNotificationCenter).unsubscribe(eq(subscriber), eq(reason));\n\n when(client.create(any(Subscription.class))).thenReturn(Mono.empty());\n\n spyNotificationCenter.subscribe(subscriber, reason).block();\n\n verify(client).create(any(Subscription.class));\n }\n\n @Test\n public void testGetNotifiersBySubscriber() {\n UserNotificationPreference preference = new UserNotificationPreference();\n when(userNotificationPreferenceService.getByUser(any()))\n .thenReturn(Mono.just(preference));\n\n var reason = new Reason();\n reason.setMetadata(new Metadata());\n reason.getMetadata().setName(\"reason-a\");\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-reply-on-comment\");\n var subscriber = new Subscriber(UserIdentity.anonymousWithEmail(\"A\"), \"fake-name\");\n\n notificationCenter.getNotifiersBySubscriber(subscriber, reason)\n .collectList()\n .as(StepVerifier::create)\n .consumeNextWith(notifiers -> {\n assertThat(notifiers).hasSize(1);\n assertThat(notifiers.get(0)).isEqualTo(\"default-email-notifier\");\n })\n .verifyComplete();\n\n verify(userNotificationPreferenceService).getByUser(eq(subscriber.name()));\n }\n\n @Test\n public void testDispatchNotification() {\n var spyNotificationCenter = spy(notificationCenter);\n\n doReturn(Flux.just(\"email-notifier\"))\n .when(spyNotificationCenter).getNotifiersBySubscriber(any(), any());\n\n NotifierDescriptor notifierDescriptor = mock(NotifierDescriptor.class);\n when(client.fetch(eq(NotifierDescriptor.class), eq(\"email-notifier\")))\n .thenReturn(Mono.just(notifierDescriptor));\n\n var notificationElement = mock(DefaultNotificationCenter.NotificationElement.class);\n doReturn(Mono.just(notificationElement))\n .when(spyNotificationCenter).prepareNotificationElement(any(), any(), any());\n\n doReturn(Mono.empty()).when(spyNotificationCenter).sendNotification(any());\n\n var reason = new Reason();\n reason.setMetadata(new Metadata());\n reason.getMetadata().setName(\"reason-a\");\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-reply-on-comment\");\n\n var subscription = createSubscriptions().get(0);\n var subscriptionName = subscription.getMetadata().getName();\n var subscriber =\n new Subscriber(UserIdentity.of(subscription.getSpec().getSubscriber().getName()),\n subscriptionName);\n spyNotificationCenter.dispatchNotification(reason, subscriber).block();\n\n verify(client).fetch(eq(NotifierDescriptor.class), eq(\"email-notifier\"));\n verify(spyNotificationCenter).sendNotification(any());\n verify(spyNotificationCenter, times(0)).createNotification(any());\n }\n\n @Test\n public void testPrepareNotificationElement() {\n var spyNotificationCenter = spy(notificationCenter);\n\n doReturn(Mono.just(Locale.getDefault()))\n .when(spyNotificationCenter).getLocaleFromSubscriber(any());\n\n var notificationContent = mock(DefaultNotificationCenter.NotificationContent.class);\n doReturn(Mono.just(notificationContent))\n .when(spyNotificationCenter).inferenceTemplate(any(), any(), any());\n\n spyNotificationCenter.prepareNotificationElement(any(), any(), any())\n .block();\n\n verify(spyNotificationCenter).getLocaleFromSubscriber(any());\n verify(spyNotificationCenter).inferenceTemplate(any(), any(), any());\n }\n\n @Test\n public void testSendNotification() {\n var spyNotificationCenter = spy(notificationCenter);\n\n var context = mock(NotificationContext.class);\n doReturn(Mono.just(context))\n .when(spyNotificationCenter).notificationContextFrom(any());\n\n when(notificationSender.sendNotification(eq(\"fake-notifier-ext\"), any()))\n .thenReturn(Mono.empty());\n\n var element = mock(DefaultNotificationCenter.NotificationElement.class);\n var mockDescriptor = mock(NotifierDescriptor.class);\n when(element.descriptor()).thenReturn(mockDescriptor);\n when(element.subscriber()).thenReturn(mock(Subscriber.class));\n var notifierDescriptorSpec = mock(NotifierDescriptor.Spec.class);\n when(mockDescriptor.getSpec()).thenReturn(notifierDescriptorSpec);\n when(notifierDescriptorSpec.getNotifierExtName()).thenReturn(\"fake-notifier-ext\");\n\n spyNotificationCenter.sendNotification(element).block();\n\n verify(spyNotificationCenter).notificationContextFrom(any());\n verify(notificationSender).sendNotification(any(), any());\n }\n\n @Test\n public void testCreateNotification() {\n var element = mock(DefaultNotificationCenter.NotificationElement.class);\n var subscription = createSubscriptions().get(0);\n var user = mock(User.class);\n\n var subscriptionName = subscription.getMetadata().getName();\n var subscriber =\n new Subscriber(UserIdentity.of(subscription.getSpec().getSubscriber().getName()),\n subscriptionName);\n when(client.fetch(eq(User.class), eq(subscriber.name()))).thenReturn(Mono.just(user));\n when(element.subscriber()).thenReturn(subscriber);\n\n when(client.create(any(Notification.class))).thenReturn(Mono.empty());\n\n var reason = new Reason();\n reason.setMetadata(new Metadata());\n reason.getMetadata().setName(\"reason-a\");\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-reply-on-comment\");\n when(element.reason()).thenReturn(reason);\n\n notificationCenter.createNotification(element).block();\n\n verify(client).fetch(eq(User.class), eq(subscriber.name()));\n verify(client).create(any(Notification.class));\n }\n\n @Test\n public void testInferenceTemplate() {\n final var spyNotificationCenter = spy(notificationCenter);\n\n final var reasonType = mock(ReasonType.class);\n\n var reason = new Reason();\n reason.setMetadata(new Metadata());\n reason.getMetadata().setName(\"reason-a\");\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-reply-on-comment\");\n\n var reasonTypeName = reason.getSpec().getReasonType();\n\n doReturn(Mono.just(reasonType))\n .when(spyNotificationCenter).getReasonType(eq(reasonTypeName));\n doReturn(Mono.just(\"fake-unsubscribe-url\"))\n .when(spyNotificationCenter).getUnsubscribeUrl(anyString());\n\n final var locale = Locale.CHINESE;\n\n var template = new NotificationTemplate();\n template.setMetadata(new Metadata());\n template.getMetadata().setName(\"notification-template-a\");\n template.setSpec(new NotificationTemplate.Spec());\n template.getSpec().setTemplate(new NotificationTemplate.Template());\n template.getSpec().getTemplate().setRawBody(\"body\");\n template.getSpec().getTemplate().setHtmlBody(\"html-body\");\n template.getSpec().getTemplate().setTitle(\"title\");\n template.getSpec().setReasonSelector(new NotificationTemplate.ReasonSelector());\n template.getSpec().getReasonSelector().setReasonType(reasonTypeName);\n template.getSpec().getReasonSelector().setLanguage(locale.getLanguage());\n\n when(notificationTemplateRender.render(anyString(), any()))\n .thenReturn(Mono.empty());\n when(notificationTemplateSelector.select(eq(reasonTypeName), any()))\n .thenReturn(Mono.just(template));\n\n var subscriber = new Subscriber(UserIdentity.anonymousWithEmail(\"A\"), \"fake-name\");\n\n spyNotificationCenter.inferenceTemplate(reason, subscriber, locale).block();\n\n verify(spyNotificationCenter).getReasonType(eq(reasonTypeName));\n verify(notificationTemplateSelector).select(eq(reasonTypeName), any());\n }\n\n @Test\n void getLocaleFromSubscriberTest() {\n var subscription = mock(Subscriber.class);\n\n when(environmentFetcher.getBasic()).thenReturn(Mono.just(new SystemSetting.Basic()));\n notificationCenter.getLocaleFromSubscriber(subscription)\n .as(StepVerifier::create)\n .expectNext(Locale.getDefault())\n .verifyComplete();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/DefaultNotificationReasonEmitterTest.java", "content": "package run.halo.app.notification;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doAnswer;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.when;\n\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link DefaultNotificationReasonEmitter}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultNotificationReasonEmitterTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private DefaultNotificationReasonEmitter emitter;\n\n @Test\n void testEmitWhenReasonTypeNotFound() {\n var reasonType = createReasonType();\n when(client.fetch(eq(ReasonType.class), eq(reasonType.getMetadata().getName())))\n .thenReturn(Mono.empty());\n doEmmit(reasonType, reasonAttributes())\n .as(StepVerifier::create)\n .verifyErrorMessage(\"404 NOT_FOUND \\\"ReasonType [\" + reasonType.getMetadata().getName()\n + \"] not found, do you forget to register it?\\\"\");\n }\n\n @Test\n void testEmitWhenMissingAttributeValue() {\n var reasonType = createReasonType();\n when(client.fetch(eq(ReasonType.class), eq(reasonType.getMetadata().getName())))\n .thenReturn(Mono.just(reasonType));\n\n var map = reasonAttributes();\n map.put(\"commenter\", null);\n doEmmit(reasonType, map)\n .as(StepVerifier::create)\n .verifyErrorMessage(\"Reason property [commenter] is required.\");\n }\n\n @Test\n void testEmitWhenMissingOptionalAttribute() {\n var reasonType = createReasonType();\n when(client.fetch(eq(ReasonType.class), eq(reasonType.getMetadata().getName())))\n .thenReturn(Mono.just(reasonType));\n\n when(client.create(any(Reason.class))).thenReturn(Mono.empty());\n\n var map = reasonAttributes();\n map.put(\"postTitle\", null);\n doEmmit(reasonType, map)\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void testCreateReasonOnEmit() {\n var reasonType = createReasonType();\n when(client.fetch(eq(ReasonType.class), eq(reasonType.getMetadata().getName())))\n .thenReturn(Mono.just(reasonType));\n\n when(client.create(any(Reason.class))).thenReturn(Mono.empty());\n\n var spyEmitter = spy(emitter);\n doAnswer(as -> {\n var returnedValue = as.callRealMethod();\n JSONAssert.assertEquals(createReasonJson(),\n JsonUtils.objectToJson(returnedValue), true);\n return returnedValue;\n }).when(spyEmitter).createReason(any(), any());\n\n spyEmitter.emit(reasonType.getMetadata().getName(),\n builder -> builder.attributes(reasonAttributes())\n .subject(Reason.Subject.builder()\n .apiVersion(\"content.halo.run/v1alpha1\")\n .kind(\"Post\")\n .name(\"5152aea5-c2e8-4717-8bba-2263d46e19d5\")\n .title(\"Hello Halo\")\n .url(\"/archives/hello-halo\")\n .build()\n )\n )\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n Map reasonAttributes() {\n var map = new LinkedHashMap();\n map.put(\"postName\", \"5152aea5-c2e8-4717-8bba-2263d46e19d5\");\n map.put(\"postTitle\", \"Hello Halo\");\n map.put(\"commenter\", \"guqing\");\n map.put(\"commentName\", \"53a76c38-5df2-469d-ae1b-68f5ae21a398\");\n map.put(\"content\", \"测试评论\");\n return map;\n }\n\n private Mono doEmmit(ReasonType reasonType, Map map) {\n return emitter.emit(reasonType.getMetadata().getName(), builder -> {\n builder.attributes(map)\n .subject(Reason.Subject.builder()\n .apiVersion(\"content.halo.run/v1alpha1\")\n .kind(\"Post\")\n .name(\"5152aea5-c2e8-4717-8bba-2263d46e19d5\")\n .title(\"Hello Halo\")\n .url(\"/archives/hello-halo\")\n .build()\n );\n });\n }\n\n String createReasonJson() {\n return \"\"\"\n {\n \"spec\": {\n \"reasonType\": \"new-comment-on-post\",\n \"subject\": {\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Post\",\n \"name\": \"5152aea5-c2e8-4717-8bba-2263d46e19d5\",\n \"title\": \"Hello Halo\",\n \"url\": \"/archives/hello-halo\"\n },\n \"attributes\": {\n \"postName\": \"5152aea5-c2e8-4717-8bba-2263d46e19d5\",\n \"postTitle\": \"Hello Halo\",\n \"commentName\": \"53a76c38-5df2-469d-ae1b-68f5ae21a398\",\n \"content\": \"测试评论\",\n \"commenter\": \"guqing\"\n }\n },\n \"apiVersion\": \"notification.halo.run/v1alpha1\",\n \"kind\": \"Reason\",\n \"metadata\": {\n \"generateName\": \"reason-\"\n }\n }\n \"\"\";\n }\n\n ReasonType createReasonType() {\n return JsonUtils.jsonToObject(\"\"\"\n {\n \"apiVersion\": \"notification.halo.run/v1alpha1\",\n \"kind\": \"ReasonType\",\n \"metadata\": {\n \"name\": \"new-comment-on-post\"\n },\n \"spec\": {\n \"description\": \"当你的文章收到新评论时，触发事件\",\n \"displayName\": \"文章收到新评论\",\n \"properties\": [\n {\n \"name\": \"postName\",\n \"type\": \"string\"\n },\n {\n \"name\": \"postTitle\",\n \"type\": \"string\",\n \"optional\": true\n },\n {\n \"name\": \"commenter\",\n \"type\": \"string\"\n },\n {\n \"name\": \"commentName\",\n \"type\": \"string\"\n },\n {\n \"name\": \"content\",\n \"type\": \"string\"\n }\n ]\n }\n }\n \"\"\", ReasonType.class);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/DefaultNotificationSenderTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.mock;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link DefaultNotificationSender}.\n *\n * @author guqing\n * @since 2.9.0\n */\nclass DefaultNotificationSenderTest {\n\n @Nested\n class QueueItemTest {\n\n @Test\n void equalsTest() {\n var item1 =\n new DefaultNotificationSender.QueueItem(\"1\",\n mock(Runnable.class), 0);\n var item2 =\n new DefaultNotificationSender.QueueItem(\"1\",\n mock(Runnable.class), 1);\n\n assertThat(item1).isEqualTo(item2);\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/DefaultNotificationTemplateRenderTest.java", "content": "package run.halo.app.notification;\n\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport java.net.URL;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\n\n/**\n * Tests for {@link DefaultNotificationTemplateRender}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultNotificationTemplateRenderTest {\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @InjectMocks\n DefaultNotificationTemplateRender templateRender;\n\n @BeforeEach\n void setUp() throws MalformedURLException {\n var uri = URI.create(\"http://localhost:8090\");\n lenient().when(externalUrlSupplier.get()).thenReturn(uri);\n lenient().when(externalUrlSupplier.getRaw()).thenReturn(uri.toURL());\n }\n\n @Test\n void render() {\n final String template = \"\"\"\n 亲爱的博主\n\n [(${replier})] 在评论“[(${isQuoteReply ? quoteContent : commentContent})]”中回复了您，\n 以下是回复的具体内容：\n \n [(${content})]\n\n [(${site.title})]\n [(${site.url})]\n 祝好！\n 查看原文：[(${commentSubjectUrl})]\n \"\"\";\n final var model = Map.of(\n \"replier\", \"guqing\",\n \"isQuoteReply\", true,\n \"quoteContent\", \"这是引用的内容\",\n \"commentContent\", \"这是评论的内容\",\n \"commentSubjectUrl\", \"/archives/1\",\n \"content\", \"这是回复的内容\"\n );\n\n var basic = new SystemSetting.Basic();\n basic.setTitle(\"Halo\");\n basic.setLogo(\"https://halo.run/logo\");\n basic.setSubtitle(\"Halo\");\n when(environmentFetcher.fetch(eq(SystemSetting.Basic.GROUP), eq(SystemSetting.Basic.class)))\n .thenReturn(Mono.just(basic));\n\n templateRender.render(template, model)\n .as(StepVerifier::create)\n .consumeNextWith(render -> {\n assertThat(render).isEqualTo(\"\"\"\n 亲爱的博主\n\n guqing 在评论“这是引用的内容”中回复了您，\n 以下是回复的具体内容：\n \n 这是回复的内容\n \n Halo\n http://localhost:8090\n 祝好！\n 查看原文：/archives/1\n \"\"\");\n })\n .verifyComplete();\n\n verify(environmentFetcher).fetch(eq(SystemSetting.Basic.GROUP),\n eq(SystemSetting.Basic.class));\n verify(externalUrlSupplier).getRaw();\n }\n\n @Test\n void siteUrlTest() throws MalformedURLException {\n when(environmentFetcher.fetch(eq(SystemSetting.Basic.GROUP), eq(SystemSetting.Basic.class)))\n .thenReturn(Mono.just(new SystemSetting.Basic()));\n\n var template = \"查看通知\";\n var expected = \"查看通知\";\n\n when(externalUrlSupplier.getRaw()).thenReturn(new URL(\"http://localhost:8090/\"));\n templateRender.render(template,\n Map.of())\n .as(StepVerifier::create)\n .expectNext(expected)\n .verifyComplete();\n\n when(externalUrlSupplier.getRaw()).thenReturn(new URL(\"http://localhost:8090\"));\n templateRender.render(template,\n Map.of())\n .as(StepVerifier::create)\n .expectNext(expected)\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/DefaultNotifierConfigStoreTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.notification.DefaultNotifierConfigStore.RECEIVER_KEY;\nimport static run.halo.app.notification.DefaultNotifierConfigStore.SECRET_NAME;\nimport static run.halo.app.notification.DefaultNotifierConfigStore.SENDER_KEY;\n\nimport com.fasterxml.jackson.databind.node.JsonNodeFactory;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Secret;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link DefaultNotifierConfigStore}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultNotifierConfigStoreTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n DefaultNotifierConfigStore notifierConfigStore;\n\n @Test\n void fetchReceiverConfigTest() {\n var objectNode = mock(ObjectNode.class);\n var spyNotifierConfigStore = spy(notifierConfigStore);\n\n doReturn(Mono.just(objectNode)).when(spyNotifierConfigStore)\n .fetchConfig(eq(\"fake-notifier\"));\n var receiverConfig = mock(ObjectNode.class);\n when(objectNode.get(eq(RECEIVER_KEY))).thenReturn(receiverConfig);\n\n spyNotifierConfigStore.fetchReceiverConfig(\"fake-notifier\")\n .as(StepVerifier::create)\n .consumeNextWith(actual -> assertThat(actual).isEqualTo(receiverConfig))\n .verifyComplete();\n verify(objectNode).get(eq(RECEIVER_KEY));\n }\n\n @Test\n void fetchSenderConfigTest() {\n var objectNode = mock(ObjectNode.class);\n var spyNotifierConfigStore = spy(notifierConfigStore);\n\n doReturn(Mono.just(objectNode)).when(spyNotifierConfigStore)\n .fetchConfig(eq(\"fake-notifier\"));\n var senderConfig = mock(ObjectNode.class);\n when(objectNode.get(eq(DefaultNotifierConfigStore.SENDER_KEY))).thenReturn(senderConfig);\n\n spyNotifierConfigStore.fetchSenderConfig(\"fake-notifier\")\n .as(StepVerifier::create)\n .consumeNextWith(actual -> assertThat(actual).isEqualTo(senderConfig))\n .verifyComplete();\n verify(objectNode).get(eq(DefaultNotifierConfigStore.SENDER_KEY));\n }\n\n @Test\n void fetchConfigWhenSecretNotFound() {\n var spyNotifierConfigStore = spy(notifierConfigStore);\n\n var objectNode = JsonNodeFactory.instance.objectNode();\n doReturn(Mono.just(objectNode)).when(spyNotifierConfigStore)\n .fetchConfig(eq(\"fake-notifier\"));\n\n spyNotifierConfigStore.fetchSenderConfig(\"fake-notifier\")\n .as(StepVerifier::create)\n .consumeNextWith(actual -> assertThat(actual).isNotNull())\n .verifyComplete();\n\n spyNotifierConfigStore.fetchReceiverConfig(\"fake-notifier\")\n .as(StepVerifier::create)\n .consumeNextWith(actual -> assertThat(actual).isNotNull())\n .verifyComplete();\n }\n\n @Test\n void saveReceiverConfigTest() {\n var receiverConfig = mock(ObjectNode.class);\n var spyNotifierConfigStore = spy(notifierConfigStore);\n\n doReturn(Mono.empty()).when(spyNotifierConfigStore)\n .saveConfig(eq(\"fake-notifier\"), eq(RECEIVER_KEY), eq(receiverConfig));\n\n spyNotifierConfigStore.saveReceiverConfig(\"fake-notifier\", receiverConfig)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(spyNotifierConfigStore)\n .saveConfig(eq(\"fake-notifier\"), eq(RECEIVER_KEY), eq(receiverConfig));\n }\n\n @Test\n void saveSenderConfigTest() {\n var senderConfig = mock(ObjectNode.class);\n var spyNotifierConfigStore = spy(notifierConfigStore);\n\n doReturn(Mono.empty()).when(spyNotifierConfigStore)\n .saveConfig(eq(\"fake-notifier\"), eq(SENDER_KEY), eq(senderConfig));\n\n spyNotifierConfigStore.saveSenderConfig(\"fake-notifier\", senderConfig)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(spyNotifierConfigStore)\n .saveConfig(eq(\"fake-notifier\"), eq(SENDER_KEY), eq(senderConfig));\n\n }\n\n @Test\n void saveConfigTest() {\n when(client.fetch(eq(Secret.class), eq(SECRET_NAME))).thenReturn(Mono.empty());\n\n when(client.create(any(Secret.class)))\n .thenAnswer(answer -> Mono.just(answer.getArgument(0, Secret.class)));\n when(client.update(any(Secret.class)))\n .thenAnswer(answer -> Mono.just(answer.getArgument(0, Secret.class)));\n\n var objectNode = JsonNodeFactory.instance.objectNode();\n objectNode.put(\"k1\", \"v1\");\n notifierConfigStore.saveConfig(\"fake-notifier\", \"fake-key\", objectNode)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(client).fetch(eq(Secret.class), eq(SECRET_NAME));\n verify(client).create(assertArg(arg -> {\n assertThat(arg).isInstanceOf(Secret.class);\n var secret = (Secret) arg;\n assertThat(secret.getMetadata().getName()).isEqualTo(SECRET_NAME);\n assertThat(secret.getMetadata().getFinalizers())\n .contains(MetadataUtil.SYSTEM_FINALIZER);\n assertThat(secret.getStringData()).isNotNull();\n }));\n verify(client).update(assertArg(arg -> {\n assertThat(arg).isInstanceOf(Secret.class);\n var secret = (Secret) arg;\n assertThat(secret.getStringData().get(\"fake-notifier.json\"))\n .isEqualTo(\"{\\\"fake-key\\\":{\\\"k1\\\":\\\"v1\\\"}}\");\n }));\n }\n\n @Test\n void fetchConfigTest() {\n String s = \"{\\\"fake-key\\\":{\\\"k1\\\":\\\"v1\\\"}}\";\n var objectNode = JsonUtils.jsonToObject(s, ObjectNode.class);\n var secret = new Secret();\n secret.setStringData(Map.of(\"fake-notifier.json\", s));\n when(client.fetch(eq(Secret.class), eq(SECRET_NAME)))\n .thenReturn(Mono.just(secret));\n notifierConfigStore.fetchConfig(\"fake-notifier\")\n .as(StepVerifier::create)\n .consumeNextWith(actual -> assertThat(actual).isEqualTo(objectNode))\n .verifyComplete();\n }\n\n @Test\n void resolveKeyTest() {\n assertThat(notifierConfigStore.resolveKey(\"fake-notifier\"))\n .isEqualTo(\"fake-notifier.json\");\n assertThat(notifierConfigStore.resolveKey(\"other-notifier\"))\n .isEqualTo(\"other-notifier.json\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/DefaultSubscriberEmailResolverTest.java", "content": "package run.halo.app.notification;\n\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.AnonymousUserConst;\n\n/**\n * Tests for {@link DefaultSubscriberEmailResolver}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultSubscriberEmailResolverTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n DefaultSubscriberEmailResolver subscriberEmailResolver;\n\n @Test\n void testResolve() {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(AnonymousUserConst.PRINCIPAL + \"#test@example.com\");\n subscriberEmailResolver.resolve(subscriber)\n .as(StepVerifier::create)\n .expectNext(\"test@example.com\")\n .verifyComplete();\n\n subscriber.setName(AnonymousUserConst.PRINCIPAL + \"#\");\n subscriberEmailResolver.resolve(subscriber)\n .as(StepVerifier::create)\n .verifyErrorMessage(\"The subscriber does not have an email\");\n\n var user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-user\");\n user.setSpec(new User.UserSpec());\n user.getSpec().setEmail(\"test@halo.run\");\n user.getSpec().setEmailVerified(false);\n when(client.fetch(eq(User.class), eq(\"fake-user\"))).thenReturn(Mono.just(user));\n\n subscriber.setName(\"fake-user\");\n subscriberEmailResolver.resolve(subscriber)\n .as(StepVerifier::create)\n .verifyComplete();\n\n user.getSpec().setEmailVerified(true);\n when(client.fetch(eq(User.class), eq(\"fake-user\"))).thenReturn(Mono.just(user));\n\n subscriber.setName(\"fake-user\");\n subscriberEmailResolver.resolve(subscriber)\n .as(StepVerifier::create)\n .expectNext(\"test@halo.run\")\n .verifyComplete();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/LanguageUtilsTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\n\nimport java.util.List;\nimport java.util.Locale;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link LanguageUtils}.\n *\n * @author guqing\n * @since 2.9.0\n */\nclass LanguageUtilsTest {\n\n @Test\n void computeLangFromLocale() {\n List languages = LanguageUtils.computeLangFromLocale(Locale.CHINA);\n assertThat(languages).isEqualTo(List.of(\"default\", \"zh\", \"zh_CN\"));\n\n languages = LanguageUtils.computeLangFromLocale(Locale.CHINESE);\n assertThat(languages).isEqualTo(List.of(\"default\", \"zh\"));\n\n languages = LanguageUtils.computeLangFromLocale(Locale.TAIWAN);\n assertThat(languages).isEqualTo(List.of(\"default\", \"zh\", \"zh_TW\"));\n\n languages = LanguageUtils.computeLangFromLocale(Locale.ENGLISH);\n assertThat(languages).isEqualTo(List.of(\"default\", \"en\"));\n\n languages = LanguageUtils.computeLangFromLocale(Locale.US);\n assertThat(languages).isEqualTo(List.of(\"default\", \"en\", \"en_US\"));\n\n languages =\n LanguageUtils.computeLangFromLocale(Locale.forLanguageTag(\"en-US-x-lvariant-POSIX\"));\n assertThat(languages).isEqualTo(List.of(\"default\", \"en\", \"en_US\", \"en_US-POSIX\"));\n }\n\n @Test\n void computeLangFromLocaleWhenLanguageIsEmpty() {\n assertThatThrownBy(() -> {\n LanguageUtils.computeLangFromLocale(Locale.forLanguageTag(\"\"));\n }).isInstanceOf(IllegalArgumentException.class)\n .hasMessage(\"Locale \\\"\\\" cannot be used as it does not specify a language.\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/NotificationContextTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.time.Instant;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link NotificationContext}.\n *\n * @author guqing\n * @since 2.9.0\n */\nclass NotificationContextTest {\n\n @Test\n void constructTest() {\n // Create a test message payload\n NotificationContext.MessagePayload payload = new NotificationContext.MessagePayload();\n payload.setTitle(\"Test Title\");\n payload.setRawBody(\"Test Body\");\n payload.setHtmlBody(\"Html body\");\n\n // Create a test subject\n NotificationContext.Subject subject = NotificationContext.Subject.builder()\n .apiVersion(\"v1\")\n .kind(\"test\")\n .name(\"test-name\")\n .title(\"Test Subject\")\n .url(\"https://example.com\")\n .build();\n\n // Create a test message\n NotificationContext.Message message = new NotificationContext.Message();\n message.setPayload(payload);\n message.setSubject(subject);\n message.setRecipient(\"test-recipient\");\n message.setTimestamp(Instant.now());\n\n // Create a test receiver config\n ObjectMapper mapper = new ObjectMapper();\n ObjectNode receiverConfig = mapper.createObjectNode();\n receiverConfig.put(\"key\", \"value\");\n\n // Create a test sender config\n ObjectNode senderConfig = mapper.createObjectNode();\n senderConfig.put(\"key\", \"value\");\n\n // Create a test notification context\n NotificationContext notificationContext = new NotificationContext();\n notificationContext.setMessage(message);\n notificationContext.setReceiverConfig(receiverConfig);\n notificationContext.setSenderConfig(senderConfig);\n\n // Test getter methods\n assertThat(notificationContext.getMessage()).isNotNull();\n assertThat(notificationContext.getMessage().getPayload()).isEqualTo(payload);\n assertThat(notificationContext.getMessage().getSubject()).isEqualTo(subject);\n assertThat(\"test-recipient\").isEqualTo(notificationContext.getMessage().getRecipient());\n assertThat(notificationContext.getMessage().getTimestamp()).isNotNull();\n assertThat(notificationContext.getReceiverConfig()).isEqualTo(receiverConfig);\n assertThat(notificationContext.getSenderConfig()).isEqualTo(senderConfig);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/NotificationTriggerTest.java", "content": "package run.halo.app.notification;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.Optional;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\n\n/**\n * Test for {@link NotificationTrigger}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass NotificationTriggerTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n NotificationCenter notificationCenter;\n\n @InjectMocks\n NotificationTrigger notificationTrigger;\n\n @Test\n void shouldCleanUpAfterNotified() {\n var reason = mock(Reason.class);\n var metadata = mock(Metadata.class);\n when(reason.getMetadata()).thenReturn(metadata);\n when(metadata.getDeletionTimestamp()).thenReturn(null);\n when(metadata.getFinalizers()).thenReturn(Set.of());\n\n when(client.fetch(eq(Reason.class), eq(\"fake-reason\")))\n .thenReturn(Optional.of(reason));\n\n when(notificationCenter.notify(eq(reason))).thenReturn(Mono.empty());\n notificationTrigger.reconcile(new Reconciler.Request(\"fake-reason\"));\n\n verify(notificationCenter).notify(eq(reason));\n verify(metadata).setFinalizers(eq(Set.of(NotificationTrigger.TRIGGERED_FINALIZER)));\n verify(client).delete(any(Reason.class));\n }\n\n @Test\n void shouldRemoveFinalizerAfterDeleted() {\n var reason = mock(Reason.class);\n var metadata = mock(Metadata.class);\n when(reason.getMetadata()).thenReturn(metadata);\n when(metadata.getDeletionTimestamp()).thenReturn(Instant.now());\n when(metadata.getFinalizers())\n .thenReturn(Set.of(NotificationTrigger.TRIGGERED_FINALIZER));\n\n when(client.fetch(eq(Reason.class), eq(\"fake-reason\")))\n .thenReturn(Optional.of(reason));\n\n notificationTrigger.reconcile(new Reconciler.Request(\"fake-reason\"));\n\n verify(metadata).setFinalizers(eq(Set.of()));\n verify(client).update(eq(reason));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/ReasonNotificationTemplateSelectorImplTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport java.util.stream.Stream;\nimport lombok.NonNull;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.notification.NotificationTemplate;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link ReasonNotificationTemplateSelectorImpl}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ReasonNotificationTemplateSelectorImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n ReasonNotificationTemplateSelectorImpl templateSelector;\n\n @Test\n void select() {\n when(client.listAll(eq(NotificationTemplate.class), any(), any(Sort.class)))\n .thenReturn(Flux.fromIterable(templates()));\n // language priority: zh_CN -> zh -> default\n // if language is same, then compare creationTimestamp to get the latest one\n templateSelector.select(\"new-comment-on-post\", Locale.SIMPLIFIED_CHINESE)\n .as(StepVerifier::create)\n .consumeNextWith(template -> {\n assertThat(template.getMetadata().getName()).isEqualTo(\"template-2\");\n assertThat(template.getSpec().getTemplate().getTitle()).isEqualTo(\"B\");\n })\n .verifyComplete();\n }\n\n @Test\n void lookupTemplateByLocaleTest() {\n Map> map = new HashMap<>();\n map.put(\"zh_CN\", Optional.of(createNotificationTemplate(\"zh_CN-template\")));\n map.put(\"zh\", Optional.of(createNotificationTemplate(\"zh-template\")));\n map.put(\"default\", Optional.of(createNotificationTemplate(\"default-template\")));\n\n var sc = ReasonNotificationTemplateSelectorImpl\n .lookupTemplateByLocale(Locale.SIMPLIFIED_CHINESE, map);\n assertThat(sc).isNotNull();\n assertThat(sc.getMetadata().getName()).isEqualTo(\"zh_CN-template\");\n\n var c = ReasonNotificationTemplateSelectorImpl\n .lookupTemplateByLocale(Locale.CHINESE, map);\n assertThat(c).isNotNull();\n assertThat(c.getMetadata().getName()).isEqualTo(\"zh-template\");\n\n var e = ReasonNotificationTemplateSelectorImpl\n .lookupTemplateByLocale(Locale.ENGLISH, map);\n assertThat(e).isNotNull();\n assertThat(e.getMetadata().getName()).isEqualTo(\"default-template\");\n }\n\n @Test\n void matchReasonTypeTest() {\n var template = createNotificationTemplate(\"fake-template\");\n assertThat(ReasonNotificationTemplateSelectorImpl.matchReasonType(\"new-comment-on-post\")\n .test(template)).isTrue();\n\n assertThat(ReasonNotificationTemplateSelectorImpl.matchReasonType(\"fake-reason-type\")\n .test(template)).isFalse();\n }\n\n @Test\n void getLanguageKeyTest() {\n final var languageKeyFunc = ReasonNotificationTemplateSelectorImpl.getLanguageKey();\n var template = createNotificationTemplate(\"fake-template\");\n assertThat(languageKeyFunc.apply(template)).isEqualTo(\"zh_CN\");\n\n template.getSpec().getReasonSelector().setLanguage(\"\");\n template.getSpec().getReasonSelector().setReasonType(\"new-comment-on-post\");\n assertThat(languageKeyFunc.apply(template)).isEqualTo(\"default\");\n }\n\n @NonNull\n private static NotificationTemplate createNotificationTemplate(String name) {\n var template = new NotificationTemplate();\n template.setMetadata(new Metadata());\n template.getMetadata().setName(name);\n template.setSpec(new NotificationTemplate.Spec());\n template.getSpec().setReasonSelector(new NotificationTemplate.ReasonSelector());\n template.getSpec().getReasonSelector().setLanguage(\"zh_CN\");\n template.getSpec().getReasonSelector().setReasonType(\"new-comment-on-post\");\n return template;\n }\n\n List templates() {\n return Stream.of(\"\"\"\n {\n \"apiVersion\": \"notification.halo.run/v1alpha1\",\n \"kind\": \"NotificationTemplate\",\n \"metadata\": {\n \"name\": \"template-1\",\n \"creationTimestamp\": \"2023-01-01T00:00:00Z\"\n },\n \"spec\": {\n \"reasonSelector\": {\n \"language\": \"zh\",\n \"reasonType\": \"new-comment-on-post\"\n },\n \"template\": {\n \"body\": \"\",\n \"title\": \"A\"\n }\n }\n }\n \"\"\",\n \"\"\"\n {\n \"apiVersion\": \"notification.halo.run/v1alpha1\",\n \"kind\": \"NotificationTemplate\",\n \"metadata\": {\n \"name\": \"template-2\",\n \"creationTimestamp\": \"2023-01-01T00:00:03Z\"\n },\n \"spec\": {\n \"reasonSelector\": {\n \"language\": \"zh_CN\",\n \"reasonType\": \"new-comment-on-post\"\n },\n \"template\": {\n \"body\": \"\",\n \"title\": \"B\"\n }\n }\n }\n \"\"\",\n \"\"\"\n {\n \"apiVersion\": \"notification.halo.run/v1alpha1\",\n \"kind\": \"NotificationTemplate\",\n \"metadata\": {\n \"name\": \"template-3\",\n \"creationTimestamp\": \"2023-01-01T00:00:00Z\"\n },\n \"spec\": {\n \"reasonSelector\": {\n \"language\": \"zh_CN\",\n \"reasonType\": \"new-comment-on-post\"\n },\n \"template\": {\n \"body\": \"\",\n \"title\": \"C\"\n }\n }\n }\n \"\"\")\n .map(json -> JsonUtils.jsonToObject(json, NotificationTemplate.class))\n .toList();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/ReasonPayloadTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\n\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.core.extension.notification.Reason;\n\n/**\n * Tests for {@link ReasonPayload}.\n *\n * @author guqing\n * @since 2.9.0\n */\nclass ReasonPayloadTest {\n\n @Test\n public void testReasonPayloadBuilder() {\n Reason.Subject subject = Reason.Subject.builder()\n .kind(\"Post\")\n .apiVersion(\"content.halo.run/v1alpha1\")\n .name(\"fake-post\")\n .title(\"Fake post title\")\n .url(\"https://halo.run/fake-post\")\n .build();\n Map attributes = new HashMap<>();\n attributes.put(\"key1\", \"value1\");\n attributes.put(\"key2\", 2);\n attributes.put(\"key3\", \"value3\");\n\n ReasonPayload reasonPayload = ReasonPayload.builder()\n .subject(subject)\n .attribute(\"key1\", \"value1\")\n .attribute(\"key2\", 2)\n .attributes(Map.of(\"key3\", \"value3\"))\n .build();\n\n assertNotNull(reasonPayload);\n assertThat(reasonPayload).isNotNull();\n assertThat(reasonPayload.getSubject()).isEqualTo(subject);\n assertThat(reasonPayload.getAttributes()).isEqualTo(attributes);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/RecipientResolverImplTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.notification.Reason;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.Metadata;\n\n/**\n * Tests for {@link RecipientResolverImpl}.\n *\n * @author guqing\n * @since 2.15.0\n */\n@ExtendWith(MockitoExtension.class)\nclass RecipientResolverImplTest {\n\n @Mock\n private SubscriptionService subscriptionService;\n\n @InjectMocks\n private RecipientResolverImpl recipientResolver;\n\n @Test\n void testExpressionMatch() {\n var subscriber1 = new Subscription.Subscriber();\n subscriber1.setName(\"test\");\n final var subscription1 = createSubscription(subscriber1);\n subscription1.getMetadata().setName(\"test-subscription\");\n subscription1.getSpec().getReason().setSubject(null);\n subscription1.getSpec().getReason().setExpression(\"props.owner == 'test'\");\n\n var subscriber2 = new Subscription.Subscriber();\n subscriber2.setName(\"guqing\");\n final var subscription2 = createSubscription(subscriber2);\n subscription2.getMetadata().setName(\"guqing-subscription\");\n subscription2.getSpec().getReason().setSubject(null);\n subscription2.getSpec().getReason().setExpression(\"props.owner == 'guqing'\");\n\n var reason = new Reason();\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-comment-on-post\");\n reason.getSpec().setSubject(new Reason.Subject());\n reason.getSpec().getSubject().setApiVersion(\"content.halo.run/v1alpha1\");\n reason.getSpec().getSubject().setKind(\"Post\");\n reason.getSpec().getSubject().setName(\"fake-post\");\n var reasonAttributes = new ReasonAttributes();\n reasonAttributes.put(\"owner\", \"guqing\");\n reason.getSpec().setAttributes(reasonAttributes);\n\n when(subscriptionService.listByPerPage(anyString()))\n .thenReturn(Flux.just(subscription1, subscription2));\n\n recipientResolver.resolve(reason)\n .as(StepVerifier::create)\n .expectNext(new Subscriber(UserIdentity.of(\"guqing\"), \"guqing-subscription\"))\n .verifyComplete();\n\n verify(subscriptionService).listByPerPage(anyString());\n }\n\n @Test\n void testSubjectMatch() {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(\"test\");\n Subscription subscription = createSubscription(subscriber);\n\n when(subscriptionService.listByPerPage(anyString()))\n .thenReturn(Flux.just(subscription));\n\n var reason = new Reason();\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-comment-on-post\");\n reason.getSpec().setSubject(new Reason.Subject());\n reason.getSpec().getSubject().setApiVersion(\"content.halo.run/v1alpha1\");\n reason.getSpec().getSubject().setKind(\"Post\");\n reason.getSpec().getSubject().setName(\"fake-post\");\n\n recipientResolver.resolve(reason)\n .as(StepVerifier::create)\n .expectNext(new Subscriber(UserIdentity.of(\"test\"), \"fake-subscription\"))\n .verifyComplete();\n\n verify(subscriptionService).listByPerPage(anyString());\n }\n\n @Test\n void distinct() {\n // same subscriber to different subscriptions\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(\"test\");\n\n final var subscription1 = createSubscription(subscriber);\n subscription1.getMetadata().setName(\"sub-1\");\n\n final var subscription2 = createSubscription(subscriber);\n subscription2.getMetadata().setName(\"sub-2\");\n subscription2.getSpec().getReason().setSubject(null);\n subscription2.getSpec().getReason().setExpression(\"props.owner == 'guqing'\");\n\n when(subscriptionService.listByPerPage(anyString()))\n .thenReturn(Flux.just(subscription1, subscription2));\n\n var reason = new Reason();\n reason.setSpec(new Reason.Spec());\n reason.getSpec().setReasonType(\"new-comment-on-post\");\n reason.getSpec().setSubject(new Reason.Subject());\n reason.getSpec().getSubject().setApiVersion(\"content.halo.run/v1alpha1\");\n reason.getSpec().getSubject().setKind(\"Post\");\n reason.getSpec().getSubject().setName(\"fake-post\");\n var reasonAttributes = new ReasonAttributes();\n reasonAttributes.put(\"owner\", \"guqing\");\n reason.getSpec().setAttributes(reasonAttributes);\n\n recipientResolver.resolve(reason)\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n\n verify(subscriptionService).listByPerPage(anyString());\n }\n\n @Test\n void subjectMatchTest() {\n var subscriber = new Subscription.Subscriber();\n subscriber.setName(\"test\");\n\n final var subscription = createSubscription(subscriber);\n\n // match all name subscription\n var subject = new Reason.Subject();\n subject.setApiVersion(\"content.halo.run/v1alpha1\");\n subject.setKind(\"Post\");\n subject.setName(\"fake-post\");\n assertThat(RecipientResolverImpl.subjectMatch(subscription, subject)).isTrue();\n\n // different kind\n subject = new Reason.Subject();\n subject.setApiVersion(\"content.halo.run/v1alpha1\");\n subject.setKind(\"SinglePage\");\n subject.setName(\"fake-post\");\n assertThat(RecipientResolverImpl.subjectMatch(subscription, subject)).isFalse();\n\n // special case\n subscription.getSpec().getReason().getSubject().setName(\"other-post\");\n subject = new Reason.Subject();\n subject.setApiVersion(\"content.halo.run/v1alpha1\");\n subject.setKind(\"Post\");\n subject.setName(\"fake-post\");\n assertThat(RecipientResolverImpl.subjectMatch(subscription, subject)).isFalse();\n subject.setName(\"other-post\");\n assertThat(RecipientResolverImpl.subjectMatch(subscription, subject)).isTrue();\n }\n\n private static Subscription createSubscription(Subscription.Subscriber subscriber) {\n Subscription subscription = new Subscription();\n subscription.setMetadata(new Metadata());\n subscription.getMetadata().setName(\"fake-subscription\");\n subscription.setSpec(new Subscription.Spec());\n subscription.getSpec().setSubscriber(subscriber);\n\n var interestReason = new Subscription.InterestReason();\n interestReason.setReasonType(\"new-comment-on-post\");\n interestReason.setSubject(new Subscription.ReasonSubject());\n interestReason.getSubject().setApiVersion(\"content.halo.run/v1alpha1\");\n interestReason.getSubject().setKind(\"Post\");\n subscription.getSpec().setReason(interestReason);\n return subscription;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/SubscriptionServiceImplTest.java", "content": "package run.halo.app.notification;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.concurrent.atomic.AtomicLong;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tests for {@link SubscriptionServiceImpl}.\n *\n * @author guqing\n * @since 2.15.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SubscriptionServiceImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private SubscriptionServiceImpl subscriptionService;\n\n @Test\n void remove() {\n var i = new AtomicLong(1L);\n when(client.delete(any(Subscription.class))).thenAnswer(invocation -> {\n var subscription = (Subscription) invocation.getArgument(0);\n if (i.get() != subscription.getMetadata().getVersion()) {\n return Mono.error(new OptimisticLockingFailureException(\"fake-exception\"));\n }\n return Mono.just(subscription);\n });\n\n var subscription = new Subscription();\n subscription.setMetadata(new Metadata());\n subscription.getMetadata().setName(\"fake-subscription\");\n subscription.getMetadata().setVersion(0L);\n\n when(client.fetch(eq(Subscription.class), eq(\"fake-subscription\")))\n .thenAnswer(invocation -> {\n if (i.incrementAndGet() > 3) {\n subscription.getMetadata().setVersion(i.get());\n } else {\n subscription.getMetadata().setVersion(i.get() - 1);\n }\n return Mono.just(subscription);\n });\n\n subscriptionService.remove(subscription)\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n\n // give version=0, but the real version is 1\n // give version=1, but the real version is 2\n // give version=2, but the real version is 3\n // give version=3, but the real version is 3 (delete success)\n verify(client, times(3)).fetch(eq(Subscription.class), eq(\"fake-subscription\"));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/UserIdentityTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link UserIdentity}.\n *\n * @author guqing\n * @since 2.9.0\n */\nclass UserIdentityTest {\n\n\n @Test\n void getEmailTest() {\n var identity = UserIdentity.anonymousWithEmail(\"test@example.com\");\n assertThat(identity.getEmail().orElse(null)).isEqualTo(\"test@example.com\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/UserNotificationPreferenceServiceImplTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport java.util.Set;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link UserNotificationPreferenceServiceImpl}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass UserNotificationPreferenceServiceImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private UserNotificationPreferenceServiceImpl userNotificationPreferenceService;\n\n @Test\n void getByUser() {\n var configMap = new ConfigMap();\n configMap.setData(Map.of(\"notification\",\n \"{\\\"reasonTypeNotifier\\\":{\\\"comment\\\":{\\\"notifiers\\\":[\\\"test-notifier\\\"]}}}\"));\n when(client.fetch(ConfigMap.class, \"user-preferences-guqing\"))\n .thenReturn(Mono.just(configMap));\n userNotificationPreferenceService.getByUser(\"guqing\")\n .as(StepVerifier::create)\n .consumeNextWith(preference -> {\n assertThat(preference.getReasonTypeNotifier()).isNotNull();\n assertThat(preference.getReasonTypeNotifier().get(\"comment\")).isNotNull();\n assertThat(preference.getReasonTypeNotifier().get(\"comment\").getNotifiers())\n .containsExactly(\"test-notifier\");\n })\n .verifyComplete();\n\n verify(client).fetch(ConfigMap.class, \"user-preferences-guqing\");\n }\n\n @Test\n void getByUserWhenNotFound() {\n when(client.fetch(ConfigMap.class, \"user-preferences-guqing\"))\n .thenReturn(Mono.empty());\n userNotificationPreferenceService.getByUser(\"guqing\")\n .as(StepVerifier::create)\n .consumeNextWith(preference ->\n assertThat(preference.getReasonTypeNotifier()).isNotNull()\n )\n .verifyComplete();\n\n verify(client).fetch(ConfigMap.class, \"user-preferences-guqing\");\n }\n\n @Test\n void getByUserWhenConfigDataNotFound() {\n when(client.fetch(ConfigMap.class, \"user-preferences-guqing\"))\n .thenReturn(Mono.just(new ConfigMap()));\n userNotificationPreferenceService.getByUser(\"guqing\")\n .as(StepVerifier::create)\n .consumeNextWith(preference ->\n assertThat(preference.getReasonTypeNotifier()).isNotNull()\n )\n .verifyComplete();\n\n verify(client).fetch(ConfigMap.class, \"user-preferences-guqing\");\n }\n\n\n @Nested\n class UserNotificationPreferenceTest {\n\n @Test\n void getNotifiers() {\n var preference = new UserNotificationPreference();\n preference.getReasonTypeNotifier().put(\"comment\", null);\n // key doesn't exist\n assertThat(preference.getReasonTypeNotifier().getNotifiers(\"comment\"))\n .containsExactly(\"default-email-notifier\");\n\n // key exists but the value is null\n preference.getReasonTypeNotifier()\n .put(\"comment\", new UserNotificationPreference.NotifierSetting());\n assertThat(preference.getReasonTypeNotifier().getNotifiers(\"comment\")).isEmpty();\n\n // key exists and the value is not null\n preference.getReasonTypeNotifier().get(\"comment\").setNotifiers(Set.of(\"test-notifier\"));\n assertThat(preference.getReasonTypeNotifier().getNotifiers(\"comment\"))\n .containsExactly(\"test-notifier\");\n }\n\n @Test\n void toJson() throws JSONException {\n var preference = new UserNotificationPreference();\n preference.getReasonTypeNotifier().put(\"comment\",\n new UserNotificationPreference.NotifierSetting());\n preference.getReasonTypeNotifier().get(\"comment\").setNotifiers(Set.of(\"test-notifier\"));\n\n JSONAssert.assertEquals(\"\"\"\n {\n \"reasonTypeNotifier\": {\n \"comment\": {\n \"notifiers\": [\n \"test-notifier\"\n ]\n }\n }\n }\n \"\"\",\n JsonUtils.objectToJson(preference),\n true);\n }\n }\n\n @Test\n void buildUserPreferenceConfigMapName() {\n var preferenceConfigMapName = UserNotificationPreferenceServiceImpl\n .buildUserPreferenceConfigMapName(\"guqing\");\n assertEquals(\"user-preferences-guqing\", preferenceConfigMapName);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/notification/UserNotificationPreferenceTest.java", "content": "package run.halo.app.notification;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link UserNotificationPreference}.\n *\n * @author guqing\n * @since 2.9.0\n */\nclass UserNotificationPreferenceTest {\n\n @Test\n void preferenceCreation() {\n String s = \"\"\"\n {\n \"reasonTypeNotifier\": {\n \"comment\": {\n \"notifiers\": [\n \"email-notifier\",\n \"sms-notifier\"\n ]\n },\n \"new-post\": {\n \"notifiers\": [\n \"email-notifier\",\n \"webhook-router-notifier\"\n ]\n }\n }\n }\n \"\"\";\n var preference = JsonUtils.jsonToObject(s, UserNotificationPreference.class);\n assertThat(preference.getReasonTypeNotifier()).isNotNull();\n assertThat(preference.getReasonTypeNotifier().get(\"comment\").getNotifiers())\n .containsExactlyInAnyOrder(\"email-notifier\", \"sms-notifier\");\n assertThat(preference.getReasonTypeNotifier().get(\"new-post\").getNotifiers())\n .containsExactlyInAnyOrder(\"email-notifier\", \"webhook-router-notifier\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/endpoint/SubscriptionRouterTest.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport java.net.MalformedURLException;\nimport java.net.URI;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.core.extension.notification.Subscription;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.ExternalUrlSupplier;\n\n/**\n * Tests for {@link SubscriptionRouter}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SubscriptionRouterTest {\n\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @InjectMocks\n SubscriptionRouter subscriptionRouter;\n\n @Test\n void getUnsubscribeUrlTest() throws MalformedURLException {\n when(externalUrlSupplier.getRaw()).thenReturn(URI.create(\"https://halo.run\").toURL());\n var subscription = new Subscription();\n subscription.setMetadata(new Metadata());\n subscription.getMetadata().setName(\"fake-subscription\");\n subscription.setSpec(new Subscription.Spec());\n subscription.getSpec().setUnsubscribeToken(\"fake-unsubscribe-token\");\n\n var url = subscriptionRouter.getUnsubscribeUrl(subscription);\n assertThat(url).isEqualTo(\"https://halo.run/apis/api.notification.halo.run/v1alpha1\"\n + \"/subscriptions/fake-subscription/unsubscribe\"\n + \"?token=fake-unsubscribe-token\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/notification/endpoint/UserNotificationPreferencesEndpointTest.java", "content": "package run.halo.app.notification.endpoint;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.notification.NotifierDescriptor;\nimport run.halo.app.core.extension.notification.ReasonType;\nimport run.halo.app.extension.ExtensionUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.notification.UserNotificationPreferenceService;\n\n/**\n * Tests for {@link UserNotificationPreferencesEndpoint}.\n *\n * @author guqing\n * @since 2.10.0\n */\n@ExtendWith(MockitoExtension.class)\nclass UserNotificationPreferencesEndpointTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private UserNotificationPreferenceService userNotificationPreferenceService;\n\n @InjectMocks\n private UserNotificationPreferencesEndpoint userNotificationPreferencesEndpoint;\n\n private WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n webTestClient = WebTestClient\n .bindToRouterFunction(userNotificationPreferencesEndpoint.endpoint())\n .build();\n\n when(client.listAll(eq(ReasonType.class), assertArg(option ->\n assertThat(option.toString())\n .isEqualTo(\"NOT EXISTS metadata.labels['halo.run/hidden']\")),\n eq(ExtensionUtil.defaultSort()))\n ).thenReturn(Flux.empty());\n }\n\n @Test\n void listNotificationPreferences() {\n when(client.list(eq(NotifierDescriptor.class), eq(null), any())).thenReturn(Flux.empty());\n when(userNotificationPreferenceService.getByUser(any())).thenReturn(Mono.empty());\n webTestClient.post()\n .uri(\"/userspaces/{username}/notification-preferences\", \"guqing\")\n .exchange()\n .expectStatus()\n .isOk();\n }\n\n @Test\n void saveNotificationPreferences() {\n when(client.list(eq(NotifierDescriptor.class), eq(null), any())).thenReturn(Flux.empty());\n when(userNotificationPreferenceService.getByUser(any())).thenReturn(Mono.empty());\n webTestClient.post()\n .uri(\"/userspaces/{username}/notification-preferences\", \"guqing\")\n .exchange()\n .expectStatus()\n .isOk();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/BuiltInPluginsInitializerTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.doNothing;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.core.extension.Plugin.BUILT_IN_KEEPER_FINALIZER;\nimport static run.halo.app.core.extension.Plugin.SYSTEM_RESERVED_LABEL_KEY;\n\nimport java.io.IOException;\nimport java.net.URI;\nimport java.nio.file.Path;\nimport java.time.Instant;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.core.io.Resource;\nimport org.springframework.core.io.support.ResourcePatternResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.ExtensionInitializedEvent;\nimport run.halo.app.infra.exception.PluginAlreadyExistsException;\n\n@ExtendWith(MockitoExtension.class)\nclass BuiltInPluginsInitializerTest {\n\n @Mock\n ExtensionClient client;\n\n @Mock\n PluginService pluginService;\n\n @Mock\n ResourcePatternResolver resourcePatternResolver;\n\n @Mock\n PluginFinder pluginFinder;\n\n @InjectMocks\n BuiltInPluginsInitializer initializer;\n\n @BeforeEach\n void setUp() {\n initializer.setResourcePatternResolver(resourcePatternResolver);\n initializer.setPluginFinder(pluginFinder);\n }\n\n @Test\n void shouldCreateBuiltInPlugins() throws IOException {\n var resource = mock(Resource.class);\n when(resource.getFilename()).thenReturn(\"fake-plugin.jar\");\n var pluginUri = URI.create(\"file:///fake-plugin.jar\");\n var pluginPath = Path.of(pluginUri);\n when(resource.getURI()).thenReturn(pluginUri);\n when(resourcePatternResolver.getResources(isA(String.class)))\n .thenReturn(new Resource[] {resource});\n\n var fakePlugin = createPlugin();\n when(pluginFinder.find(pluginPath)).thenReturn(fakePlugin);\n when(pluginService.install(pluginPath)).thenReturn(Mono.just(fakePlugin));\n doNothing().when(client).update(fakePlugin);\n var event = mock(ExtensionInitializedEvent.class);\n\n initializer.onApplicationEvent(event);\n\n assertEquals(\"true\", fakePlugin.getMetadata().getLabels().get(SYSTEM_RESERVED_LABEL_KEY));\n assertTrue(fakePlugin.getMetadata().getFinalizers().contains(BUILT_IN_KEEPER_FINALIZER));\n }\n\n @Test\n void shouldUpgradeBuiltInPlugins() throws IOException {\n var resource = mock(Resource.class);\n when(resource.getFilename()).thenReturn(\"fake-plugin.jar\");\n var pluginUri = URI.create(\"file:///fake-plugin.jar\");\n var pluginPath = Path.of(pluginUri);\n when(resource.getURI()).thenReturn(pluginUri);\n when(resourcePatternResolver.getResources(isA(String.class)))\n .thenReturn(new Resource[] {resource});\n\n var fakePlugin = createPlugin();\n when(pluginFinder.find(pluginPath)).thenReturn(fakePlugin);\n when(pluginService.install(pluginPath))\n .thenReturn(Mono.error(new PluginAlreadyExistsException(\"fake-plugin\")));\n when(pluginService.upgrade(\"fake-plugin\", pluginPath))\n .thenReturn(Mono.just(fakePlugin));\n doNothing().when(client).update(fakePlugin);\n var event = mock(ExtensionInitializedEvent.class);\n\n initializer.onApplicationEvent(event);\n\n assertEquals(\"true\", fakePlugin.getMetadata().getLabels().get(SYSTEM_RESERVED_LABEL_KEY));\n assertTrue(fakePlugin.getMetadata().getFinalizers().contains(BUILT_IN_KEEPER_FINALIZER));\n }\n\n @Test\n void shouldResetDeletionTimestamp() throws IOException {\n var resource = mock(Resource.class);\n when(resource.getFilename()).thenReturn(\"fake-plugin.jar\");\n var pluginUri = URI.create(\"file:///fake-plugin.jar\");\n var pluginPath = Path.of(pluginUri);\n when(resource.getURI()).thenReturn(pluginUri);\n when(resourcePatternResolver.getResources(isA(String.class)))\n .thenReturn(new Resource[] {resource});\n\n var fakePlugin = createPlugin();\n fakePlugin.getMetadata().setDeletionTimestamp(Instant.now());\n when(pluginFinder.find(pluginPath)).thenReturn(fakePlugin);\n when(pluginService.install(pluginPath)).thenReturn(Mono.just(fakePlugin));\n doNothing().when(client).update(fakePlugin);\n\n var event = mock(ExtensionInitializedEvent.class);\n initializer.onApplicationEvent(event);\n\n assertNull(fakePlugin.getMetadata().getDeletionTimestamp());\n }\n\n Plugin createPlugin() {\n var plugin = new Plugin();\n plugin.setMetadata(new Metadata());\n plugin.getMetadata().setName(\"fake-plugin\");\n return plugin;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/DefaultDevelopmentPluginRepositoryTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.List;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.pf4j.PluginRepository;\n\n/**\n * Tests for {@link DefaultDevelopmentPluginRepository}.\n *\n * @author guqing\n * @since 2.8.0\n */\nclass DefaultDevelopmentPluginRepositoryTest {\n\n private PluginRepository developmentPluginRepository;\n\n @TempDir\n private Path tempDir;\n\n @BeforeEach\n void setUp() {\n var repository = new DefaultDevelopmentPluginRepository();\n repository.setFixedPaths(List.of(tempDir));\n this.developmentPluginRepository = repository;\n }\n\n @Test\n void deletePluginPath() {\n boolean deleted = developmentPluginRepository.deletePluginPath(null);\n assertThat(deleted).isFalse();\n\n // deletePluginPath is a no-op\n deleted = developmentPluginRepository.deletePluginPath(tempDir);\n assertThat(deleted).isTrue();\n assertThat(Files.exists(tempDir)).isTrue();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/DefaultPluginApplicationContextFactoryTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\nimport static org.mockito.Mockito.withSettings;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.pf4j.Plugin;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport run.halo.app.search.SearchService;\n\n@SpringBootTest\nclass DefaultPluginApplicationContextFactoryTest {\n\n @MockitoSpyBean\n SpringPluginManager pluginManager;\n\n DefaultPluginApplicationContextFactory factory;\n\n @BeforeEach\n void setUp() {\n factory = new DefaultPluginApplicationContextFactory(pluginManager);\n }\n\n @Test\n void shouldCreateCorrectly() {\n var pw = mock(PluginWrapper.class);\n when(pw.getPluginClassLoader()).thenReturn(this.getClass().getClassLoader());\n var plugin = mock(Plugin.class, withSettings().extraInterfaces(SpringPlugin.class));\n var sp = (SpringPlugin) plugin;\n var pluginContext = new PluginContext.PluginContextBuilder()\n .name(\"fake-plugin\")\n .version(\"1.0.0\")\n .build();\n when(sp.getPluginContext()).thenReturn(pluginContext);\n when(pw.getPlugin()).thenReturn(plugin);\n when(pluginManager.getPlugin(\"fake-plugin\")).thenReturn(pw);\n var context = factory.create(\"fake-plugin\");\n\n assertEquals(pw.getPluginClassLoader(), Thread.currentThread().getContextClassLoader());\n\n assertInstanceOf(PluginApplicationContext.class, context);\n assertNotNull(context.getBeanProvider(SearchService.class).getIfUnique());\n assertNotNull(context.getBeanProvider(PluginsRootGetter.class).getIfUnique());\n // TODO Add more assertions here.\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/DefaultPluginRouterFunctionRegistryTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.mock;\n\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.invocation.InvocationOnMock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\n\n/**\n * Tests for {@link DefaultPluginRouterFunctionRegistry}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultPluginRouterFunctionRegistryTest {\n\n @InjectMocks\n DefaultPluginRouterFunctionRegistry routerFunctionRegistry;\n\n @Test\n void shouldRegisterRouterFunction() {\n RouterFunction routerFunction = mock(InvocationOnMock::getMock);\n routerFunctionRegistry.register(Set.of(routerFunction));\n assertEquals(Set.of(routerFunction), routerFunctionRegistry.getRouterFunctions());\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/DefaultSettingFetcherTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoBean;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link DefaultSettingFetcher}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass DefaultSettingFetcherTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @MockitoBean\n private final PluginContext pluginContext = PluginContext.builder()\n .name(\"fake\")\n .configMapName(\"fake-config\")\n .build();\n\n @Mock\n private ApplicationContext applicationContext;\n\n private DefaultReactiveSettingFetcher reactiveSettingFetcher;\n private DefaultSettingFetcher settingFetcher;\n\n @BeforeEach\n void setUp() {\n this.reactiveSettingFetcher = new DefaultReactiveSettingFetcher(pluginContext, client);\n reactiveSettingFetcher.setApplicationContext(applicationContext);\n\n settingFetcher = new DefaultSettingFetcher(reactiveSettingFetcher);\n\n ConfigMap configMap = buildConfigMap();\n when(client.fetch(eq(ConfigMap.class), eq(pluginContext.getConfigMapName())))\n .thenReturn(Mono.just(configMap));\n }\n\n @Test\n void getValues() throws JSONException {\n Map values = settingFetcher.getValues();\n\n verify(client, times(1)).fetch(eq(ConfigMap.class), any());\n\n assertThat(values).hasSize(2);\n JSONAssert.assertEquals(getSns(), JsonUtils.objectToJson(values.get(\"sns\")), true);\n\n // The extensionClient will only be called once\n Map callAgain = settingFetcher.getValues();\n assertThat(callAgain).isNotNull();\n verify(client, times(1)).fetch(eq(ConfigMap.class), any());\n }\n\n @Test\n void getValuesWithUpdateCache() throws JSONException {\n Map values = settingFetcher.getValues();\n\n verify(client, times(1)).fetch(eq(ConfigMap.class), any());\n JSONAssert.assertEquals(getSns(), JsonUtils.objectToJson(values.get(\"sns\")), true);\n\n ConfigMap configMap = buildConfigMap();\n configMap.getData().put(\"sns\", \"\"\"\n {\n \"email\": \"abc@example.com\",\n \"github\": \"abc\"\n }\n \"\"\");\n when(client.fetch(eq(ConfigMap.class), eq(pluginContext.getConfigMapName())))\n .thenReturn(Mono.just(configMap));\n when(client.update(configMap)).thenReturn(Mono.just(configMap));\n reactiveSettingFetcher.reconcile(new Reconciler.Request(pluginContext.getConfigMapName()));\n\n // Make sure the method cache#put is called before the event is published\n // to avoid the event listener to fetch the old value from the cache\n verify(applicationContext).publishEvent(isA(PluginConfigUpdatedEvent.class));\n\n Map updatedValues = settingFetcher.getValues();\n verify(client, times(3)).fetch(eq(ConfigMap.class), any());\n assertThat(updatedValues).hasSize(2);\n JSONAssert.assertEquals(configMap.getData().get(\"sns\"),\n JsonUtils.objectToJson(updatedValues.get(\"sns\")), true);\n\n updatedValues = settingFetcher.getValues();\n assertThat(updatedValues).hasSize(2);\n verify(client, times(3)).fetch(eq(ConfigMap.class), any());\n }\n\n @Test\n void getGroupForObject() throws JSONException {\n Optional sns = settingFetcher.fetch(\"sns\", Sns.class);\n assertThat(sns.isEmpty()).isFalse();\n JSONAssert.assertEquals(getSns(), JsonUtils.objectToJson(sns.get()), true);\n }\n\n @Test\n void getGroup() {\n JsonNode jsonNode = settingFetcher.get(\"basic\");\n assertThat(jsonNode).isNotNull();\n assertThat(jsonNode.isObject()).isTrue();\n assertThat(jsonNode.get(\"color\").asText()).isEqualTo(\"red\");\n assertThat(jsonNode.get(\"width\").asInt()).isEqualTo(100);\n\n // missing key will return empty json node\n JsonNode emptyNode = settingFetcher.get(\"basic1\");\n assertThat(emptyNode.isEmpty()).isTrue();\n }\n\n private ConfigMap buildConfigMap() {\n ConfigMap configMap = new ConfigMap();\n Metadata metadata = new Metadata();\n metadata.setName(\"fake\");\n metadata.setLabels(Map.of(\"plugin.halo.run/plugin-name\", \"fake\"));\n configMap.setMetadata(metadata);\n configMap.setKind(\"ConfigMap\");\n configMap.setApiVersion(\"v1alpha1\");\n var map = new HashMap();\n map.put(\"sns\", getSns());\n map.put(\"basic\", \"\"\"\n {\n \"color\": \"red\",\n \"width\": \"100\"\n }\n \"\"\");\n configMap.setData(map);\n return configMap;\n }\n\n String getSns() {\n return \"\"\"\n {\n \"email\": \"example@example.com\",\n \"github\": \"example\",\n \"instagram\": \"123\",\n \"twitter\": \"halo-dev\",\n \"user\": {\n \"name\": \"guqing\",\n \"age\": \"18\"\n },\n \"nums\": [1, 2, 3]\n }\n \"\"\";\n }\n\n record Sns(String email, String github, String instagram, String twitter,\n Map user, List nums) {\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/HaloPluginManagerTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.when;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.RuntimeMode;\nimport org.springframework.context.ApplicationContext;\nimport run.halo.app.infra.SystemVersionSupplier;\n\n@ExtendWith(MockitoExtension.class)\nclass HaloPluginManagerTest {\n\n @Mock\n PluginProperties pluginProperties;\n\n @Mock\n SystemVersionSupplier systemVersionSupplier;\n\n @Mock\n PluginsRootGetter pluginsRootGetter;\n\n @Mock\n ApplicationContext rootContext;\n\n @InjectMocks\n HaloPluginManager pluginManager;\n\n @TempDir\n Path tempDir;\n\n @Test\n void shouldGetDependentsWhilePluginsNotResolved() throws Exception {\n when(pluginProperties.getRuntimeMode()).thenReturn(RuntimeMode.DEPLOYMENT);\n when(systemVersionSupplier.get()).thenReturn(Version.of(1, 2, 3));\n when(pluginsRootGetter.get()).thenReturn(tempDir);\n pluginManager.afterPropertiesSet();\n // if we don't invoke resolves\n var dependents = pluginManager.getDependents(\"fake-plugin\");\n assertTrue(dependents.isEmpty());\n }\n\n @Test\n void shouldGetDependentsWhilePluginsResolved() throws Exception {\n when(pluginProperties.getRuntimeMode()).thenReturn(RuntimeMode.DEPLOYMENT);\n when(systemVersionSupplier.get()).thenReturn(Version.of(1, 2, 3));\n when(pluginsRootGetter.get()).thenReturn(tempDir);\n pluginManager.afterPropertiesSet();\n pluginManager.loadPlugins();\n // if we don't invoke resolves\n var dependents = pluginManager.getDependents(\"fake-plugin\");\n assertTrue(dependents.isEmpty());\n }\n\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/OptionalDependentResolverTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.pf4j.PluginDependency;\nimport org.pf4j.PluginDescriptor;\n\n/**\n * Tests for {@link OptionalDependentResolver}.\n *\n * @author guqing\n * @since 2.20.11\n */\nclass OptionalDependentResolverTest {\n\n @Test\n void testNoPlugins() {\n OptionalDependentResolver resolver = new OptionalDependentResolver(List.of());\n assertTrue(resolver.getOptionalDependents(\"nonexistent\").isEmpty(),\n \"No dependents expected for non-existent plugin\");\n }\n\n @Test\n void testSinglePluginNoDependencies() {\n var pluginA = createpluginDescriptor(\"A\", List.of());\n OptionalDependentResolver resolver = new OptionalDependentResolver(List.of(pluginA));\n\n assertTrue(resolver.getOptionalDependents(\"A\").isEmpty(), \"A has no dependents\");\n }\n\n @Test\n void testSingleOptionalDependency() {\n var pluginA = createpluginDescriptor(\"A\", List.of(new PluginDependency(\"B?\")));\n var pluginB = createpluginDescriptor(\"B\", List.of());\n OptionalDependentResolver resolver =\n new OptionalDependentResolver(List.of(pluginA, pluginB));\n\n assertEquals(List.of(\"A\"), resolver.getOptionalDependents(\"B\"),\n \"B should have A as dependent\");\n assertTrue(resolver.getOptionalDependents(\"A\").isEmpty(), \"A has no dependents\");\n }\n\n @Test\n void testMultipleOptionalDependencies() {\n var pluginA = createpluginDescriptor(\"A\", List.of(\n new PluginDependency(\"B?\"),\n new PluginDependency(\"C?\"))\n );\n\n var pluginB = createpluginDescriptor(\"B\", List.of());\n\n var pluginC = createpluginDescriptor(\"C\", List.of());\n\n OptionalDependentResolver resolver =\n new OptionalDependentResolver(List.of(pluginA, pluginB, pluginC));\n\n assertEquals(List.of(\"A\"), resolver.getOptionalDependents(\"B\"),\n \"B should have A as dependent\");\n assertEquals(List.of(\"A\"), resolver.getOptionalDependents(\"C\"),\n \"C should have A as dependent\");\n assertTrue(resolver.getOptionalDependents(\"A\").isEmpty(), \"A has no dependents\");\n }\n\n @Test\n void testNestedDependencies() {\n var pluginA = createpluginDescriptor(\"A\", List.of(\n new PluginDependency(\"B?\")\n ));\n var pluginB = createpluginDescriptor(\"B\", List.of(\n new PluginDependency(\"C?\")\n ));\n var pluginC = createpluginDescriptor(\"C\", List.of());\n\n OptionalDependentResolver resolver =\n new OptionalDependentResolver(List.of(pluginA, pluginB, pluginC));\n\n assertEquals(List.of(\"B\"), resolver.getOptionalDependents(\"C\"),\n \"C should have B as dependent\");\n assertEquals(List.of(\"A\"), resolver.getOptionalDependents(\"B\"),\n \"B should have A as dependent\");\n assertTrue(resolver.getOptionalDependents(\"A\").isEmpty(), \"A has no dependents\");\n }\n\n @Test\n void testCircularDependencies() {\n var pluginA = createpluginDescriptor(\"A\", List.of(\n new PluginDependency(\"B?\")\n ));\n var pluginB = createpluginDescriptor(\"B\", List.of(\n new PluginDependency(\"A?\")\n ));\n OptionalDependentResolver resolver =\n new OptionalDependentResolver(List.of(pluginA, pluginB));\n\n assertEquals(List.of(\"B\"), resolver.getOptionalDependents(\"A\"),\n \"A should have B as dependent\");\n assertEquals(List.of(\"A\"), resolver.getOptionalDependents(\"B\"),\n \"B should have A as dependent\");\n }\n\n @Test\n void testNonOptionalDependencies() {\n var pluginA = createpluginDescriptor(\"A\", List.of(\n new PluginDependency(\"B\")\n ));\n var pluginB = createpluginDescriptor(\"B\", List.of());\n OptionalDependentResolver resolver =\n new OptionalDependentResolver(List.of(pluginA, pluginB));\n\n assertTrue(resolver.getOptionalDependents(\"B\").isEmpty(), \"B should have no dependents\");\n assertTrue(resolver.getOptionalDependents(\"A\").isEmpty(), \"A should have no dependents\");\n }\n\n PluginDescriptor createpluginDescriptor(String pluginName,\n List dependencies) {\n var descriptor = mock(PluginDescriptor.class);\n lenient().when(descriptor.getPluginId()).thenReturn(pluginName);\n lenient().when(descriptor.getDependencies()).thenReturn(dependencies);\n return descriptor;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/PluginExtensionLoaderUtilsTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static run.halo.app.plugin.PluginExtensionLoaderUtils.isSetting;\nimport static run.halo.app.plugin.PluginExtensionLoaderUtils.lookupExtensions;\n\nimport java.io.IOException;\nimport java.net.URL;\nimport java.net.URLClassLoader;\nimport java.util.Arrays;\nimport java.util.Objects;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.core.io.DefaultResourceLoader;\nimport run.halo.app.infra.utils.YamlUnstructuredLoader;\n\nclass PluginExtensionLoaderUtilsTest {\n\n @Test\n void lookupExtensionsAndIsSettingTest() throws IOException {\n var resourceLoader = new DefaultResourceLoader();\n var rootResource = resourceLoader.getResource(\"classpath:plugin/plugin-0.0.1/\");\n var classLoader = new URLClassLoader(new URL[] {rootResource.getURL()}, null);\n var resources = lookupExtensions(classLoader);\n assertTrue(resources.length >= 1);\n var settingResource = Arrays.stream(resources)\n .filter(r -> Objects.equals(\"setting.yaml\", r.getFilename()))\n .findFirst()\n .orElseThrow();\n\n var loader = new YamlUnstructuredLoader(settingResource);\n var unstructuredList = loader.load();\n assertEquals(1, unstructuredList.size());\n assertTrue(isSetting(\"fake-setting\").test(unstructuredList.get(0)));\n assertFalse(isSetting(\"non-fake-setting\").test(unstructuredList.get(0)));\n assertFalse(isSetting(\"\").test(unstructuredList.get(0)));\n assertFalse(isSetting(null).test(unstructuredList.get(0)));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/PluginRequestMappingHandlerMappingTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.mock;\nimport static org.springframework.mock.http.server.reactive.MockServerHttpRequest.get;\nimport static org.springframework.mock.http.server.reactive.MockServerHttpRequest.post;\nimport static org.springframework.web.bind.annotation.RequestMethod.GET;\nimport static org.springframework.web.bind.annotation.RequestMethod.HEAD;\n\nimport java.lang.reflect.Method;\nimport java.security.Principal;\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Set;\nimport java.util.function.Consumer;\nimport java.util.function.Predicate;\nimport java.util.stream.Collectors;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.core.MethodIntrospector;\nimport org.springframework.core.annotation.AnnotatedElementUtils;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.util.Assert;\nimport org.springframework.web.bind.annotation.GetMapping;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RequestMethod;\nimport org.springframework.web.bind.annotation.RestController;\nimport org.springframework.web.context.support.StaticWebApplicationContext;\nimport org.springframework.web.method.HandlerMethod;\nimport org.springframework.web.reactive.result.method.RequestMappingInfo;\nimport org.springframework.web.server.MethodNotAllowedException;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.util.pattern.PathPatternParser;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\n\n/**\n * Tests for {@link PluginRequestMappingHandlerMapping}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass PluginRequestMappingHandlerMappingTest {\n\n private final StaticWebApplicationContext wac = new StaticWebApplicationContext();\n\n private PluginRequestMappingHandlerMapping handlerMapping;\n\n\n @BeforeEach\n public void setup() {\n handlerMapping = new PluginRequestMappingHandlerMapping();\n this.handlerMapping.setApplicationContext(wac);\n }\n\n @Test\n public void shouldAddPathPrefixWhenExistingApiVersion() throws Exception {\n Method method = UserController.class.getMethod(\"getUser\");\n RequestMappingInfo info =\n this.handlerMapping.getPluginMappingForMethod(\"fakePlugin\", method,\n UserController.class);\n\n assertThat(info).isNotNull();\n assertThat(info.getPatternsCondition().getPatterns()).isEqualTo(\n Collections.singleton(\n new PathPatternParser().parse(\n \"/apis/api.plugin.halo.run/v1alpha1/plugins/fakePlugin/user/{id}\")));\n }\n\n @Test\n public void shouldKeepRawWhenMissingApiVersion() throws Exception {\n Method method = AppleMissingApiVersionController.class.getMethod(\"getName\");\n RequestMappingInfo info =\n this.handlerMapping.getPluginMappingForMethod(\"fakePlugin\", method,\n AppleMissingApiVersionController.class);\n\n assertThat(info.getPatternsCondition().getPatterns())\n .isEqualTo(Collections.singleton(new PathPatternParser().parse(\"/apples\")));\n }\n\n @Test\n void registerHandlerMethods() {\n assertThat(handlerMapping.getMappings(\"fakePlugin\")).isEmpty();\n\n UserController userController = mock(UserController.class);\n handlerMapping.registerHandlerMethods(\"fakePlugin\", userController);\n\n List mappings = handlerMapping.getMappings(\"fakePlugin\");\n assertThat(mappings).hasSize(1);\n assertThat(mappings.get(0).toString()).isEqualTo(\n \"{GET /apis/api.plugin.halo.run/v1alpha1/plugins/fakePlugin/user/{id}}\");\n }\n\n @Test\n void unregister() {\n UserController userController = mock(UserController.class);\n // register handler methods first\n handlerMapping.registerHandlerMethods(\"fakePlugin\", userController);\n assertThat(handlerMapping.getMappings(\"fakePlugin\")).hasSize(1);\n\n // unregister\n handlerMapping.unregister(\"fakePlugin\");\n assertThat(handlerMapping.getMappings(\"fakePlugin\")).isEmpty();\n }\n\n @Test\n public void getHandlerDirectMatch() {\n // register handler methods first\n handlerMapping.registerHandlerMethods(\"fakePlugin\", new TestController());\n\n // resolve an expected method from TestController\n Method expected =\n ResolvableMethod.on(TestController.class).annot(getMapping(\"/foo\")).build();\n\n // get handler by mock exchange\n ServerWebExchange exchange =\n MockServerWebExchange.from(\n get(\"/apis/api.plugin.halo.run/v1alpha1/plugins/fakePlugin/foo\"));\n HandlerMethod hm = (HandlerMethod) this.handlerMapping.getHandler(exchange).block();\n\n assertThat(hm).isNotNull();\n assertThat(hm.getMethod()).isEqualTo(expected);\n }\n\n @Test\n public void getHandlerBestMatch() {\n // register handler methods first\n handlerMapping.registerHandlerMethods(\"fakePlugin\", new TestController());\n\n Method expected =\n ResolvableMethod.on(TestController.class).annot(getMapping(\"/foo\").params(\"p\")).build();\n\n String requestPath = \"/apis/api.plugin.halo.run/v1alpha1/plugins/fakePlugin/foo?p=anything\";\n ServerWebExchange exchange = MockServerWebExchange.from(get(requestPath));\n HandlerMethod hm = (HandlerMethod) this.handlerMapping.getHandler(exchange).block();\n\n assertThat(hm).isNotNull();\n assertThat(hm.getMethod()).isEqualTo(expected);\n }\n\n @Test\n public void getHandlerRootPathMatch() {\n // register handler methods first\n handlerMapping.registerHandlerMethods(\"fakePlugin\", new TestController());\n Method expected =\n ResolvableMethod.on(TestController.class).annot(getMapping(\"\")).build();\n\n String requestPath = \"/apis/api.plugin.halo.run/v1alpha1/plugins/fakePlugin\";\n ServerWebExchange exchange = MockServerWebExchange.from(get(requestPath));\n HandlerMethod hm = (HandlerMethod) this.handlerMapping.getHandler(exchange).block();\n\n assertThat(hm).isNotNull();\n assertThat(hm.getMethod()).isEqualTo(expected);\n }\n\n @Test\n public void getHandlerRequestMethodNotAllowed() {\n // register handler methods first\n handlerMapping.registerHandlerMethods(\"fakePlugin\", new TestController());\n\n String requestPath = \"/apis/api.plugin.halo.run/v1alpha1/plugins/fakePlugin/bar\";\n ServerWebExchange exchange = MockServerWebExchange.from(post(requestPath));\n Mono mono = this.handlerMapping.getHandler(exchange);\n\n assertError(mono, MethodNotAllowedException.class,\n ex -> assertThat(ex.getSupportedMethods()).isEqualTo(\n Set.of(HttpMethod.GET, HttpMethod.HEAD)));\n }\n\n @Test\n void buildPrefix() {\n String s = handlerMapping.buildPrefix(\"fakePlugin\", \"v1\");\n assertThat(s).isEqualTo(\"/apis/api.plugin.halo.run/v1/plugins/fakePlugin\");\n\n s = handlerMapping.buildPrefix(\"fakePlugin\", \"fake.halo.run/v1alpha1\");\n assertThat(s).isEqualTo(\"/apis/fake.halo.run/v1alpha1\");\n }\n\n @SuppressWarnings(\"unchecked\")\n private void assertError(Mono mono, final Class exceptionClass,\n final Consumer consumer) {\n StepVerifier.create(mono)\n .consumeErrorWith(error -> {\n assertThat(error.getClass()).isEqualTo(exceptionClass);\n consumer.accept((T) error);\n })\n .verify();\n }\n\n private RequestMappingPredicate getMapping(String... path) {\n return new RequestMappingPredicate(path).method(GET).params();\n }\n\n public static class ResolvableMethod {\n private final Class objectClass;\n private final List> filters = new ArrayList<>(4);\n\n public ResolvableMethod(Class objectClass) {\n this.objectClass = objectClass;\n }\n\n public static ResolvableMethod on(Class objectClass) {\n return new ResolvableMethod(objectClass);\n }\n\n public ResolvableMethod annot(Predicate predicate) {\n filters.add(predicate);\n return this;\n }\n\n public Method build() {\n Set methods = MethodIntrospector.selectMethods(this.objectClass, this::isMatch);\n Assert.state(!methods.isEmpty(), () -> \"No matching method: \" + this);\n Assert.state(methods.size() == 1,\n () -> \"Multiple matching methods: \" + this + formatMethods(methods));\n return methods.iterator().next();\n }\n\n private String formatMethods(Set methods) {\n return \"\\nMatched:\\n\" + methods.stream()\n .map(Method::toGenericString).collect(Collectors.joining(\",\\n\\t\", \"[\\n\\t\", \"\\n]\"));\n }\n\n private boolean isMatch(Method method) {\n return this.filters.stream().allMatch(p -> p.test(method));\n }\n }\n\n public static class RequestMappingPredicate implements Predicate {\n\n private final String[] path;\n\n private RequestMethod[] method = {};\n\n private String[] params;\n\n\n private RequestMappingPredicate(String... path) {\n this.path = path;\n }\n\n\n public RequestMappingPredicate method(RequestMethod... methods) {\n this.method = methods;\n return this;\n }\n\n public RequestMappingPredicate params(String... params) {\n this.params = params;\n return this;\n }\n\n @Override\n public boolean test(Method method) {\n RequestMapping annot =\n AnnotatedElementUtils.findMergedAnnotation(method, RequestMapping.class);\n return annot != null\n && Arrays.equals(this.path, annot.path())\n && Arrays.equals(this.method, annot.method())\n && (this.params == null || Arrays.equals(this.params, annot.params()));\n }\n }\n\n @ApiVersion(\"v1alpha1\")\n @RestController\n @RequestMapping(\"/user\")\n static class UserController {\n\n @GetMapping(\"/{id}\")\n public Principal getUser() {\n return mock(Principal.class);\n }\n }\n\n @RestController\n @RequestMapping(\"/apples\")\n static class AppleMissingApiVersionController {\n\n @GetMapping\n public String getName() {\n return mock(String.class);\n }\n }\n\n @ApiVersion(\"v1alpha1\")\n @Controller\n @RequestMapping\n static class TestController {\n @GetMapping(\"/foo\")\n public void foo() {\n }\n\n @GetMapping(path = \"/foo\", params = \"p\")\n public void fooParam() {\n }\n\n @RequestMapping(path = \"/ba*\", method = {GET, HEAD})\n public void bar() {\n }\n\n @GetMapping(\"\")\n public void empty() {\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/PluginServiceImplTest.java", "content": "package run.halo.app.plugin;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static java.util.Objects.requireNonNull;\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.core.io.buffer.DefaultDataBufferFactory.sharedInstance;\n\nimport com.github.zafarkhaja.semver.Version;\nimport com.google.common.hash.Hashing;\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.time.Clock;\nimport java.time.Instant;\nimport java.time.ZoneId;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.concurrent.ExecutionException;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.Future;\nimport java.util.function.Consumer;\nimport java.util.stream.IntStream;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.RepeatedTest;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.PluginDescriptor;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport reactor.test.publisher.PublisherProbe;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.exception.PluginAlreadyExistsException;\nimport run.halo.app.infra.utils.FileUtils;\n\n@ExtendWith(MockitoExtension.class)\nclass PluginServiceImplTest {\n\n @Mock\n SystemVersionSupplier systemVersionSupplier;\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n PluginsRootGetter pluginsRootGetter;\n\n @Mock\n SpringPluginManager pluginManager;\n\n @Spy\n @InjectMocks\n PluginServiceImpl pluginService;\n\n @Nested\n class InstallUpdateReloadTest {\n\n Path fakePluginPath;\n\n @TempDir\n Path tempDirectory;\n\n @BeforeEach\n void setUp() throws URISyntaxException, IOException {\n fakePluginPath = tempDirectory.resolve(\"plugin-0.0.2.jar\");\n var fakePluingUri = requireNonNull(\n getClass().getClassLoader().getResource(\"plugin/plugin-0.0.2\")).toURI();\n FileUtils.jar(Paths.get(fakePluingUri), tempDirectory.resolve(\"plugin-0.0.2.jar\"));\n\n lenient().when(systemVersionSupplier.get()).thenReturn(Version.parse(\"0.0.0\"));\n }\n\n @Test\n void installWhenPluginExists() {\n var existingPlugin = new YamlPluginFinder().find(fakePluginPath);\n when(client.fetch(Plugin.class, \"fake-plugin\")).thenReturn(Mono.just(existingPlugin));\n var plugin = pluginService.install(fakePluginPath);\n StepVerifier.create(plugin)\n .expectError(PluginAlreadyExistsException.class)\n .verify();\n\n verify(client).fetch(Plugin.class, \"fake-plugin\");\n verify(systemVersionSupplier).get();\n }\n\n @Test\n void installWhenPluginNotExist() {\n when(pluginsRootGetter.get()).thenReturn(tempDirectory.resolve(\"plugins\"));\n when(client.fetch(Plugin.class, \"fake-plugin\")).thenReturn(Mono.empty());\n var createdPlugin = mock(Plugin.class);\n when(client.create(isA(Plugin.class))).thenReturn(Mono.just(createdPlugin));\n var plugin = pluginService.install(fakePluginPath);\n StepVerifier.create(plugin)\n .expectNext(createdPlugin)\n .verifyComplete();\n\n verify(client).fetch(Plugin.class, \"fake-plugin\");\n verify(systemVersionSupplier).get();\n verify(client).create(isA(Plugin.class));\n }\n\n @Test\n void upgradeWhenPluginNameMismatch() {\n var plugin = pluginService.upgrade(\"non-fake-plugin\", fakePluginPath);\n StepVerifier.create(plugin)\n .expectError(ServerWebInputException.class)\n .verify();\n\n verify(client, never()).fetch(Plugin.class, \"fake-plugin\");\n }\n\n @Test\n void upgradeWhenPluginNotFound() {\n when(client.fetch(Plugin.class, \"fake-plugin\")).thenReturn(Mono.empty());\n var plugin = pluginService.upgrade(\"fake-plugin\", fakePluginPath);\n StepVerifier.create(plugin)\n .expectError(ServerWebInputException.class)\n .verify();\n\n verify(client).fetch(Plugin.class, \"fake-plugin\");\n }\n\n @Test\n void upgradeNormally() {\n when(pluginsRootGetter.get()).thenReturn(tempDirectory.resolve(\"plugins\"));\n\n var oldFakePlugin = createPlugin(\"fake-plugin\", plugin -> {\n plugin.getSpec().setEnabled(true);\n plugin.getSpec().setVersion(\"0.0.1\");\n });\n\n when(client.fetch(Plugin.class, \"fake-plugin\"))\n .thenReturn(Mono.just(oldFakePlugin))\n .thenReturn(Mono.just(oldFakePlugin))\n .thenReturn(Mono.empty());\n\n when(client.update(oldFakePlugin)).thenReturn(Mono.just(oldFakePlugin));\n\n var plugin = pluginService.upgrade(\"fake-plugin\", fakePluginPath);\n\n StepVerifier.create(plugin)\n .expectNext(oldFakePlugin)\n .verifyComplete();\n\n verify(client).fetch(Plugin.class, \"fake-plugin\");\n verify(client).update(oldFakePlugin);\n assertTrue(oldFakePlugin.getSpec().getEnabled());\n assertEquals(\"0.0.2\", oldFakePlugin.getSpec().getVersion());\n assertEquals(\n tempDirectory.resolve(\"plugins\").resolve(\"fake-plugin-0.0.2.jar\").toString(),\n oldFakePlugin.getMetadata().getAnnotations().get(PluginConst.PLUGIN_PATH));\n }\n\n @Test\n void shouldNotReloadIfLoadLocationIsNotReady() {\n var pluginName = \"test-plugin\";\n\n var testPlugin = createPlugin(pluginName, plugin -> {\n });\n\n when(client.get(Plugin.class, pluginName)).thenReturn(Mono.just(testPlugin));\n\n pluginService.reload(pluginName)\n .as(StepVerifier::create)\n .consumeErrorWith(t -> {\n assertInstanceOf(IllegalStateException.class, t);\n assertEquals(\"Load location of plugin has not been populated.\",\n t.getMessage());\n })\n .verify();\n\n verify(client).get(Plugin.class, pluginName);\n }\n\n @Test\n void shouldReloadIfLoadLocationReady() {\n var pluginName = \"test-plugin\";\n\n var testPlugin = createPlugin(pluginName, plugin -> {\n plugin.getStatus().setLoadLocation(fakePluginPath.toUri());\n });\n\n when(client.get(Plugin.class, pluginName)).thenReturn(Mono.just(testPlugin));\n when(client.update(testPlugin)).thenReturn(Mono.just(testPlugin));\n\n pluginService.reload(pluginName)\n .as(StepVerifier::create)\n .expectNext(testPlugin)\n .verifyComplete();\n\n assertEquals(fakePluginPath.toString(),\n testPlugin.getMetadata().getAnnotations().get(PluginConst.PLUGIN_PATH));\n verify(client).get(Plugin.class, pluginName);\n verify(client).update(testPlugin);\n }\n\n }\n\n @Test\n void generateBundleVersionTest() {\n var plugin1 = mock(PluginWrapper.class);\n var plugin2 = mock(PluginWrapper.class);\n var plugin3 = mock(PluginWrapper.class);\n when(pluginManager.startedPlugins()).thenReturn(List.of(plugin1, plugin2, plugin3));\n\n var descriptor1 = mock(PluginDescriptor.class);\n var descriptor2 = mock(PluginDescriptor.class);\n var descriptor3 = mock(PluginDescriptor.class);\n when(plugin1.getDescriptor()).thenReturn(descriptor1);\n when(plugin2.getDescriptor()).thenReturn(descriptor2);\n when(plugin3.getDescriptor()).thenReturn(descriptor3);\n\n when(plugin1.getPluginId()).thenReturn(\"fake-1\");\n when(plugin2.getPluginId()).thenReturn(\"fake-2\");\n when(plugin3.getPluginId()).thenReturn(\"fake-3\");\n\n when(descriptor1.getVersion()).thenReturn(\"1.0.0\");\n when(descriptor2.getVersion()).thenReturn(\"2.0.0\");\n when(descriptor3.getVersion()).thenReturn(\"3.0.0\");\n\n var str = \"fake-1:1.0.0fake-2:2.0.0fake-3:3.0.0\";\n var result = Hashing.sha256().hashUnencodedChars(str).toString();\n assertThat(result.length()).isEqualTo(64);\n\n pluginService.generateBundleVersion()\n .as(StepVerifier::create)\n .consumeNextWith(version -> assertThat(version).isEqualTo(result))\n .verifyComplete();\n\n var plugin4 = mock(PluginWrapper.class);\n var descriptor4 = mock(PluginDescriptor.class);\n when(plugin4.getDescriptor()).thenReturn(descriptor4);\n when(plugin4.getPluginId()).thenReturn(\"fake-4\");\n when(descriptor4.getVersion()).thenReturn(\"3.0.0\");\n var str2 = \"fake-1:1.0.0fake-2:2.0.0fake-4:3.0.0\";\n var result2 = Hashing.sha256().hashUnencodedChars(str2).toString();\n when(pluginManager.startedPlugins()).thenReturn(List.of(plugin1, plugin2, plugin4));\n pluginService.generateBundleVersion()\n .as(StepVerifier::create)\n .consumeNextWith(version -> assertThat(version).isEqualTo(result2))\n .verifyComplete();\n\n assertThat(result).isNotEqualTo(result2);\n }\n\n @Test\n void shouldGenerateRandomBundleVersionInDevelopment() {\n var clock = Clock.fixed(Instant.now(), ZoneId.systemDefault());\n pluginService.setClock(clock);\n when(pluginManager.isDevelopment()).thenReturn(true);\n pluginService.generateBundleVersion()\n .as(StepVerifier::create)\n .expectNext(String.valueOf(clock.instant().toEpochMilli()))\n .verifyComplete();\n\n verify(pluginManager, never()).startedPlugins();\n }\n\n @Test\n void shouldGetStartedPluginNames() {\n var plugin1 = mock(PluginWrapper.class);\n when(plugin1.getPluginId()).thenReturn(\"plugin-1\");\n var plugin2 = mock(PluginWrapper.class);\n when(plugin2.getPluginId()).thenReturn(\"plugin-2\");\n when(pluginManager.startedPlugins()).thenReturn(List.of(plugin1, plugin2));\n\n pluginService.getStartedPluginNames()\n .as(StepVerifier::create)\n .expectNext(\"plugin-1\", \"plugin-2\")\n .verifyComplete();\n }\n\n @Nested\n class PluginStateChangeTest {\n\n @Test\n void shouldEnablePluginIfPluginWasNotStarted() {\n var plugin = createPlugin(\"fake-plugin\", p -> {\n p.getSpec().setEnabled(false);\n p.statusNonNull().setPhase(Plugin.Phase.RESOLVED);\n });\n\n when(client.get(Plugin.class, \"fake-plugin\")).thenReturn(Mono.just(plugin))\n .thenReturn(Mono.fromSupplier(() -> {\n plugin.statusNonNull().setPhase(Plugin.Phase.STARTED);\n return plugin;\n }));\n when(client.update(plugin)).thenReturn(Mono.just(plugin));\n\n pluginService.changeState(\"fake-plugin\", true, false)\n .as(StepVerifier::create)\n .expectNext(plugin)\n .verifyComplete();\n\n assertTrue(plugin.getSpec().getEnabled());\n }\n\n @Test\n void shouldDisablePluginIfAlreadyStarted() {\n var plugin = createPlugin(\"fake-plugin\", p -> {\n p.getSpec().setEnabled(true);\n p.statusNonNull().setPhase(Plugin.Phase.STARTED);\n });\n\n when(client.get(Plugin.class, \"fake-plugin\")).thenReturn(Mono.just(plugin))\n .thenReturn(Mono.fromSupplier(() -> {\n plugin.getStatus().setPhase(Plugin.Phase.STOPPED);\n return plugin;\n }));\n when(client.update(plugin)).thenReturn(Mono.just(plugin));\n\n pluginService.changeState(\"fake-plugin\", false, false)\n .as(StepVerifier::create)\n .expectNext(plugin)\n .verifyComplete();\n assertFalse(plugin.getSpec().getEnabled());\n }\n }\n\n @Nested\n class BundleCacheTest {\n\n PluginServiceImpl.BundleCache cache;\n\n @TempDir\n Path tempDir;\n\n @BeforeEach\n void setUp() {\n pluginService.setTempDir(tempDir);\n cache = pluginService.new BundleCache(\".js\");\n }\n\n @Test\n void shouldComputeBundleFileIfAbsent() {\n doReturn(Mono.just(\"different-version\")).when(pluginService).generateBundleVersion();\n var fakeContent = Mono.just(sharedInstance.wrap(\"fake-content\".getBytes(\n UTF_8)));\n cache.computeIfAbsent(\"fake-version\", fakeContent)\n .as(StepVerifier::create)\n .assertNext(resource -> {\n try {\n assertEquals(tempDir.resolve(\"different-version.js\"),\n resource.getFile().toPath());\n assertEquals(\"different-version.js\", resource.getFilename());\n assertEquals(\"fake-content\", resource.getContentAsString(UTF_8));\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n\n try {\n FileSystemUtils.deleteRecursively(tempDir);\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n cache.computeIfAbsent(\"fake-version\", fakeContent)\n .as(StepVerifier::create)\n .assertNext(resource -> {\n try {\n assertThat(Files.exists(tempDir)).isTrue();\n assertEquals(tempDir.resolve(\"different-version.js\"),\n resource.getFile().toPath());\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n }\n\n @Test\n void shouldNotComputeBundleFileIfPresentAndVersionIsMatch() {\n shouldComputeBundleFileIfAbsent();\n\n var fakeContent = Mono.just(\n sharedInstance.wrap(\"another-fake-content\".getBytes(UTF_8)));\n\n cache.computeIfAbsent(\"different-version\", fakeContent)\n .as(StepVerifier::create)\n .assertNext(resource -> {\n try {\n assertEquals(\"different-version.js\", resource.getFilename());\n // The content won't be changed if the version is matched.\n assertEquals(\"fake-content\", resource.getContentAsString(UTF_8));\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n }\n\n @Test\n void shouldComputeBundleFileIfPresentButVersionMismatch() {\n shouldComputeBundleFileIfAbsent();\n\n var fakeContent = Mono.just(\n sharedInstance.wrap(\"another-fake-content\".getBytes(UTF_8)));\n\n doReturn(Mono.just(\"updated-version\")).when(pluginService).generateBundleVersion();\n\n cache.computeIfAbsent(\"mismatch-version\", fakeContent)\n .as(StepVerifier::create)\n .assertNext(resource -> {\n try {\n assertTrue(Files.notExists(tempDir.resolve(\"different-version.js\")));\n assertEquals(\"updated-version.js\", resource.getFilename());\n assertEquals(\"another-fake-content\", resource.getContentAsString(UTF_8));\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n }\n\n @RepeatedTest(10)\n void concurrentComputeBundleFileIfAbsent() {\n lenient().doReturn(Mono.just(\"different-version\"))\n .when(pluginService)\n .generateBundleVersion();\n\n var executorService = Executors.newCachedThreadPool();\n\n var probes = new ArrayList>();\n List> futures = IntStream.range(0, 10)\n .mapToObj(i -> {\n var fakeContent = Mono.just(sharedInstance.wrap(\n (\"fake-content-\" + i).getBytes(UTF_8)\n ));\n var probe = PublisherProbe.of(fakeContent);\n probes.add(probe);\n return executorService.submit(\n () -> {\n cache.computeIfAbsent(\"fake-version\", probe.mono())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n });\n })\n .toList();\n executorService.shutdown();\n futures.forEach(future -> {\n try {\n future.get();\n } catch (InterruptedException | ExecutionException e) {\n throw new RuntimeException(e);\n }\n });\n\n // ensure only one probe was subscribed\n var subscribedCount = probes.stream()\n .filter(PublisherProbe::wasSubscribed)\n .count();\n assertEquals(1, subscribedCount);\n }\n }\n\n Plugin createPlugin(String name, Consumer pluginConsumer) {\n var plugin = new Plugin();\n plugin.setMetadata(new Metadata());\n plugin.getMetadata().setName(name);\n plugin.setSpec(new Plugin.PluginSpec());\n plugin.setStatus(new Plugin.PluginStatus());\n pluginConsumer.accept(plugin);\n return plugin;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/PluginsRootGetterImplTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.when;\n\nimport java.nio.file.Paths;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.infra.properties.HaloProperties;\n\n@ExtendWith(MockitoExtension.class)\nclass PluginsRootGetterImplTest {\n\n @Mock\n HaloProperties haloProperties;\n\n @InjectMocks\n PluginsRootGetterImpl pluginsRootGetter;\n\n @Test\n void shouldGetterPluginsRootCorrectly() {\n var haloWorkDir = Paths.get(\"halo-work-dir\");\n when(haloProperties.getWorkDir()).thenReturn(haloWorkDir);\n assertEquals(haloWorkDir.resolve(\"plugins\"), pluginsRootGetter.get());\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/SharedApplicationContextFactoryTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.context.ApplicationContext;\n\n/**\n * Tests for {@link SharedApplicationContextFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@SpringBootTest\nclass SharedApplicationContextFactoryTest {\n\n @Autowired\n ApplicationContext applicationContext;\n\n @Test\n void createSharedApplicationContext() {\n var sharedContext = SharedApplicationContextFactory.create(applicationContext);\n assertNotNull(sharedContext);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/SharedEventDispatcherTest.java", "content": "package run.halo.app.plugin;\n\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.mockito.Mockito.withSettings;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.Plugin;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.context.ApplicationEvent;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.context.Lifecycle;\n\n@ExtendWith(MockitoExtension.class)\nclass SharedEventDispatcherTest {\n\n @Mock\n SpringPluginManager pluginManager;\n\n @Mock\n ApplicationEventPublisher publisher;\n\n @InjectMocks\n SharedEventDispatcher dispatcher;\n\n @Test\n void shouldNotDispatchEventIfNotSharedEvent() {\n dispatcher.onApplicationEvent(new FakeEvent(this));\n verify(pluginManager, never()).getStartedPlugins();\n }\n\n @Test\n void shouldDispatchEventToAllStartedPlugins() {\n var pw = mock(PluginWrapper.class);\n var plugin = mock(Plugin.class, withSettings().extraInterfaces(SpringPlugin.class));\n var context =\n mock(ApplicationContext.class, withSettings().extraInterfaces(Lifecycle.class));\n when(((Lifecycle) context).isRunning()).thenReturn(true);\n when(((SpringPlugin) plugin).getApplicationContext()).thenReturn(context);\n when(pw.getPlugin()).thenReturn(plugin);\n when(pluginManager.startedPlugins()).thenReturn(List.of(pw));\n\n var event = new FakeSharedEvent(this);\n dispatcher.onApplicationEvent(event);\n\n verify(context).publishEvent(new HaloSharedEventDelegator(dispatcher, event));\n }\n\n @Test\n void shouldNotDispatchEventToAllStartedPluginsWhilePluginContextIsNotRunning() {\n var pw = mock(PluginWrapper.class);\n var plugin = mock(Plugin.class, withSettings().extraInterfaces(SpringPlugin.class));\n var context =\n mock(ApplicationContext.class, withSettings().extraInterfaces(Lifecycle.class));\n when(((Lifecycle) context).isRunning()).thenReturn(false);\n when(((SpringPlugin) plugin).getApplicationContext()).thenReturn(context);\n when(pw.getPlugin()).thenReturn(plugin);\n when(pluginManager.startedPlugins()).thenReturn(List.of(pw));\n var event = new FakeSharedEvent(this);\n dispatcher.onApplicationEvent(event);\n verify(context, never()).publishEvent(event);\n }\n\n @Test\n void shouldNotDispatchEventToAllStartedPluginsWhilePluginContextIsNotLifecycle() {\n var pw = mock(PluginWrapper.class);\n var plugin = mock(Plugin.class, withSettings().extraInterfaces(SpringPlugin.class));\n var context = mock(ApplicationContext.class);\n when(((SpringPlugin) plugin).getApplicationContext()).thenReturn(context);\n when(pw.getPlugin()).thenReturn(plugin);\n when(pluginManager.startedPlugins()).thenReturn(List.of(pw));\n var event = new FakeSharedEvent(this);\n dispatcher.onApplicationEvent(event);\n verify(context, never()).publishEvent(event);\n }\n\n @Test\n void shouldUnwrapPluginSharedEventAndRepublish() {\n var event = new PluginSharedEventDelegator(this, new FakeSharedEvent(this));\n dispatcher.onApplicationEvent(event);\n verify(publisher).publishEvent(event.getDelegate());\n }\n\n class FakeEvent extends ApplicationEvent {\n\n public FakeEvent(Object source) {\n super(source);\n }\n\n }\n\n @SharedEvent\n class FakeSharedEvent extends ApplicationEvent {\n\n public FakeSharedEvent(Object source) {\n super(source);\n }\n\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/SpringComponentsFinderTest.java", "content": "package run.halo.app.plugin;\n\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.io.FileNotFoundException;\nimport java.net.URL;\nimport java.net.URLClassLoader;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginStateEvent;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.util.ResourceUtils;\n\n/**\n * Tests for {@link SpringComponentsFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SpringComponentsFinderTest {\n\n @Mock\n private PluginManager pluginManager;\n\n @InjectMocks\n private SpringComponentsFinder finder;\n\n @Test\n void shouldNotInvokeReadClasspathStorages() {\n assertThrows(UnsupportedOperationException.class,\n () -> finder.readClasspathStorages()\n );\n }\n\n @Test\n void shouldNotInvokeReadPluginsStorages() {\n assertThrows(UnsupportedOperationException.class,\n () -> finder.readPluginsStorages()\n );\n }\n\n @Test\n void shouldPutEntryIfPluginCreated() throws FileNotFoundException {\n var pluginWrapper = mockPluginWrapper();\n when(pluginWrapper.getPluginState()).thenReturn(PluginState.CREATED);\n\n var event = new PluginStateEvent(pluginManager, pluginWrapper, null);\n finder.pluginStateChanged(event);\n\n var classNames = finder.findClassNames(\"fake-plugin\");\n assertEquals(Set.of(\"run.halo.fake.FakePlugin\"), classNames);\n }\n\n @Test\n void shouldRemoveEntryIfPluginUnloaded() throws FileNotFoundException {\n var pluginWrapper = mockPluginWrapper();\n when(pluginWrapper.getPluginState()).thenReturn(PluginState.CREATED);\n\n var event = new PluginStateEvent(pluginManager, pluginWrapper, null);\n finder.pluginStateChanged(event);\n\n var classNames = finder.findClassNames(\"fake-plugin\");\n assertFalse(classNames.isEmpty());\n\n when(pluginWrapper.getPluginState()).thenReturn(PluginState.UNLOADED);\n event = new PluginStateEvent(pluginManager, pluginWrapper, null);\n finder.pluginStateChanged(event);\n\n classNames = finder.findClassNames(\"fake-plugin\");\n assertTrue(classNames.isEmpty());\n }\n\n private PluginWrapper mockPluginWrapper() throws FileNotFoundException {\n var pluginWrapper = mock(PluginWrapper.class);\n when(pluginWrapper.getPluginId()).thenReturn(\"fake-plugin\");\n\n var pluginRootUrl = ResourceUtils.getURL(\"classpath:plugin/plugin-for-finder/\");\n var classLoader = new URLClassLoader(new URL[] {pluginRootUrl});\n when(pluginWrapper.getPluginClassLoader()).thenReturn(classLoader);\n return pluginWrapper;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/YamlPluginDescriptorFinderTest.java", "content": "package run.halo.app.plugin;\n\nimport static java.util.Objects.requireNonNull;\nimport static org.assertj.core.api.AssertionsForInterfaceTypes.assertThat;\n\nimport java.io.File;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.pf4j.PluginDescriptor;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.util.ResourceUtils;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link YamlPluginDescriptorFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass YamlPluginDescriptorFinderTest {\n\n private YamlPluginDescriptorFinder yamlPluginDescriptorFinder;\n\n private File testFile;\n private Path tempDirectory;\n\n @BeforeEach\n void setUp() throws IOException {\n yamlPluginDescriptorFinder = new YamlPluginDescriptorFinder();\n tempDirectory = Files.createTempDirectory(\"halo-plugin\");\n var plugin002Uri = requireNonNull(\n ResourceUtils.getFile(\"classpath:plugin/plugin-0.0.2\")).toURI();\n\n Path targetJarPath = tempDirectory.resolve(\"plugin-0.0.2.jar\");\n FileUtils.jar(Paths.get(plugin002Uri), targetJarPath);\n testFile = targetJarPath.toFile();\n }\n\n @AfterEach\n void tearDown() throws IOException {\n FileSystemUtils.deleteRecursively(tempDirectory);\n }\n\n @Test\n void isApplicable() throws IOException {\n // File not exists\n boolean applicable =\n yamlPluginDescriptorFinder.isApplicable(Path.of(\"/some/path/test.jar\"));\n assertThat(applicable).isFalse();\n\n // jar file is applicable\n Path tempJarFile = Files.createTempFile(\"test\", \".jar\");\n Path tempZipFile = Files.createTempFile(\"test\", \".zip\");\n try {\n applicable =\n yamlPluginDescriptorFinder.isApplicable(tempJarFile);\n assertThat(applicable).isTrue();\n // zip file is not applicable\n applicable =\n yamlPluginDescriptorFinder.isApplicable(tempZipFile);\n assertThat(applicable).isFalse();\n\n // directory is applicable\n applicable =\n yamlPluginDescriptorFinder.isApplicable(tempJarFile.getParent());\n assertThat(applicable).isTrue();\n } finally {\n FileUtils.deleteRecursivelyAndSilently(tempJarFile);\n FileUtils.deleteRecursivelyAndSilently(tempZipFile);\n }\n }\n\n @Test\n void find() throws JSONException {\n PluginDescriptor pluginDescriptor = yamlPluginDescriptorFinder.find(testFile.toPath());\n String actual = JsonUtils.objectToJson(pluginDescriptor);\n JSONAssert.assertEquals(\"\"\"\n {\n \"pluginId\": \"fake-plugin\",\n \"pluginDescription\": \"Fake description\",\n \"pluginClass\": \"run.halo.app.plugin.BasePlugin\",\n \"version\": \"0.0.2\",\n \"requires\": \">=2.0.0\",\n \"provider\": \"johnniang\",\n \"dependencies\": [],\n \"license\": \"GPLv3\"\n }\n \"\"\",\n actual,\n false);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/YamlPluginFinderTest.java", "content": "package run.halo.app.plugin;\n\nimport static java.util.Objects.requireNonNull;\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport java.io.File;\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.pf4j.PluginRuntimeException;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.core.io.Resource;\nimport org.springframework.security.util.InMemoryResource;\nimport org.springframework.util.FileCopyUtils;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.util.ResourceUtils;\nimport run.halo.app.core.extension.Plugin;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.infra.utils.FileUtils;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link YamlPluginDescriptorFinder}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass YamlPluginFinderTest {\n private YamlPluginFinder pluginFinder;\n\n private File testFile;\n\n @BeforeEach\n void setUp() throws FileNotFoundException {\n pluginFinder = new YamlPluginFinder();\n testFile = ResourceUtils.getFile(\"classpath:plugin/plugin.yaml\");\n }\n\n @Test\n void find() throws IOException {\n var tempDirectory = Files.createTempDirectory(\"halo-test-plugin\");\n try {\n var directories =\n Files.createDirectories(tempDirectory.resolve(\"build/resources/main\"));\n FileCopyUtils.copy(testFile, directories.resolve(\"plugin.yaml\").toFile());\n\n var plugin = pluginFinder.find(tempDirectory);\n assertThat(plugin).isNotNull();\n var status = plugin.getStatus();\n assertEquals(Plugin.Phase.PENDING, status.getPhase());\n assertEquals(tempDirectory.toUri(), status.getLoadLocation());\n } finally {\n FileUtils.deleteRecursivelyAndSilently(tempDirectory);\n }\n }\n\n @Test\n void findFromJar() throws IOException, URISyntaxException {\n Path tempDirectory = Files.createTempDirectory(\"halo-plugin\");\n try {\n var plugin002Uri = requireNonNull(\n getClass().getClassLoader().getResource(\"plugin/plugin-0.0.2\")).toURI();\n\n Path targetJarPath = tempDirectory.resolve(\"plugin-0.0.2.jar\");\n FileUtils.jar(Paths.get(plugin002Uri), targetJarPath);\n Plugin plugin = pluginFinder.find(targetJarPath);\n assertThat(plugin).isNotNull();\n assertThat(plugin.getMetadata().getName()).isEqualTo(\"fake-plugin\");\n } finally {\n FileSystemUtils.deleteRecursively(tempDirectory);\n }\n }\n\n @Test\n void unstructuredToPluginTest() throws JSONException {\n Plugin plugin = pluginFinder.unstructuredToPlugin(new FileSystemResource(testFile));\n assertThat(plugin).isNotNull();\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"displayName\": \"a name to show\",\n \"version\": \"0.0.1\",\n \"author\": {\n \"name\": \"guqing\"\n },\n \"logo\": \"https://guqing.xyz/avatar\",\n \"pluginDependencies\": {\n \"banana\": \"0.0.1\"\n },\n \"homepage\": \"https://github.com/guqing/halo-plugin-1\",\n \"description\": \"Tell me more about this plugin.\",\n \"license\": [\n {\n \"name\": \"MIT\"\n }\n ],\n \"requires\": \">=2.0.0\",\n \"enabled\": false\n },\n \"apiVersion\": \"plugin.halo.run/v1alpha1\",\n \"kind\": \"Plugin\",\n \"metadata\": {\n \"name\": \"plugin-1\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(plugin),\n true);\n }\n\n @Test\n void findFailedWhenFileNotFound() {\n var test = Paths.get(\"\");\n assertThatThrownBy(() -> pluginFinder.find(test))\n .isInstanceOf(PluginRuntimeException.class)\n .hasMessage(\"Unable to find plugin descriptor file: plugin.yaml\");\n }\n\n @Test\n void acceptArrayObjectLicense() throws JSONException {\n Resource pluginResource = new InMemoryResource(\"\"\"\n apiVersion: v1\n kind: Plugin\n metadata:\n name: plugin-1\n spec:\n license:\n - name: MIT\n url: https://exmple.com\n \"\"\");\n Plugin plugin = pluginFinder.unstructuredToPlugin(pluginResource);\n assertThat(plugin.getSpec()).isNotNull();\n JSONAssert.assertEquals(\"\"\"\n [{\n \"name\": \"MIT\",\n \"url\": \"https://exmple.com\"\n }]\n \"\"\", JsonUtils.objectToJson(plugin.getSpec().getLicense()), false);\n }\n\n @Test\n void deserializeLicense() throws JSONException, JsonProcessingException {\n String pluginJson = \"\"\"\n {\n \"apiVersion\": \"plugin.halo.run/v1alpha1\",\n \"kind\": \"Plugin\",\n \"metadata\": {\n \"name\": \"plugin-1\"\n },\n \"spec\": {\n \"license\": [\n {\n \"name\": \"MIT\",\n \"url\": \"https://exmple.com\"\n }\n ]\n }\n }\n \"\"\";\n Plugin plugin = Unstructured.OBJECT_MAPPER.readValue(pluginJson, Plugin.class);\n assertThat(plugin.getSpec()).isNotNull();\n JSONAssert.assertEquals(pluginJson, JsonUtils.objectToJson(plugin), false);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/extensionpoint/DefaultExtensionGetterTest.java", "content": "package run.halo.app.plugin.extensionpoint;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.infra.SystemSetting.ExtensionPointEnabled.GROUP;\n\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.ExtensionPoint;\nimport org.pf4j.PluginManager;\nimport org.springframework.beans.factory.BeanFactory;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.core.annotation.Order;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting.ExtensionPointEnabled;\nimport run.halo.app.plugin.extensionpoint.ExtensionPointDefinition.ExtensionPointType;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultExtensionGetterTest {\n\n @Mock\n ExtensionPointDefinitionGetter extensionPointDefinitionGetter;\n\n @Mock\n ExtensionDefinitionGetter extensionDefinitionGetter;\n\n @Mock\n PluginManager pluginManager;\n\n @Mock\n SystemConfigFetcher configFetcher;\n\n @Mock\n BeanFactory beanFactory;\n\n @Mock\n ObjectProvider extensionPointObjectProvider;\n\n @InjectMocks\n DefaultExtensionGetter getter;\n\n @Test\n void shouldGetExtensionBySingletonDefinitionWhenExtensionPointEnabledSet() {\n // prepare extension point definition\n when(extensionPointDefinitionGetter.getByClassName(any()))\n .thenReturn(Mono.fromSupplier(\n () -> createExtensionPointDefinition(\"fake-extension-point\",\n FakeExtensionPoint.class,\n ExtensionPointType.SINGLETON))\n );\n\n when(extensionDefinitionGetter.get(eq(\"fake-extension\")))\n .thenReturn(Mono.fromSupplier(() -> createExtensionDefinition(\n \"fake-extension\",\n FakeExtensionPointImpl.class,\n \"fake-extension-point\")));\n\n when(configFetcher.fetch(GROUP, ExtensionPointEnabled.class))\n .thenReturn(Mono.fromSupplier(() -> {\n var extensionPointEnabled = new ExtensionPointEnabled();\n extensionPointEnabled.put(\"fake-extension-point\",\n new LinkedHashSet<>(List.of(\"fake-extension\")));\n return extensionPointEnabled;\n }));\n\n @SuppressWarnings(\"unchecked\")\n ObjectProvider objectProvider = mock(ObjectProvider.class);\n when(objectProvider.orderedStream())\n .thenReturn(Stream.of(new FakeExtensionPointDefaultImpl()));\n when(beanFactory.getBeanProvider(FakeExtensionPoint.class)).thenReturn(objectProvider);\n\n var extensionImpl = new FakeExtensionPointImpl();\n\n var spyGetter = spy(getter);\n doReturn(List.of(extensionImpl)).when(spyGetter)\n .lookExtensions(eq(FakeExtensionPoint.class));\n\n spyGetter.getEnabledExtensions(FakeExtensionPoint.class)\n .as(StepVerifier::create)\n .expectNext(extensionImpl)\n .verifyComplete();\n }\n\n @Test\n void shouldGetDefaultSingletonDefinitionWhileExtensionPointEnabledNotSet() {\n when(extensionPointDefinitionGetter.getByClassName(any()))\n .thenReturn(Mono.fromSupplier(\n () -> createExtensionPointDefinition(\"fake-extension-point\",\n FakeExtensionPoint.class,\n ExtensionPointType.SINGLETON))\n );\n\n when(configFetcher.fetch(GROUP, ExtensionPointEnabled.class))\n .thenReturn(Mono.empty());\n\n @SuppressWarnings(\"unchecked\")\n ObjectProvider objectProvider = mock(ObjectProvider.class);\n var extensionDefaultImpl = new FakeExtensionPointDefaultImpl();\n when(objectProvider.orderedStream())\n .thenReturn(Stream.of(extensionDefaultImpl));\n when(beanFactory.getBeanProvider(FakeExtensionPoint.class)).thenReturn(objectProvider);\n\n var spyGetter = spy(getter);\n doReturn(List.of()).when(spyGetter)\n .lookExtensions(eq(FakeExtensionPoint.class));\n\n spyGetter.getEnabledExtensions(FakeExtensionPoint.class)\n .as(StepVerifier::create)\n .expectNext(extensionDefaultImpl)\n .verifyComplete();\n }\n\n @Test\n void shouldGetMultiInstanceExtensionWhileExtensionPointEnabledSet() {\n // prepare extension point definition\n when(extensionPointDefinitionGetter.getByClassName(any()))\n .thenReturn(Mono.fromSupplier(\n () -> createExtensionPointDefinition(\"fake-extension-point\",\n FakeExtensionPoint.class,\n ExtensionPointType.MULTI_INSTANCE))\n );\n\n when(extensionDefinitionGetter.get(eq(\"fake-extension\")))\n .thenReturn(Mono.fromSupplier(() -> createExtensionDefinition(\n \"fake-extension\",\n FakeExtensionPointImpl.class,\n \"fake-extension-point\")));\n\n when(extensionDefinitionGetter.get(eq(\"default-fake-extension\")))\n .thenReturn(Mono.fromSupplier(() -> createExtensionDefinition(\n \"default-fake-extension\",\n FakeExtensionPointDefaultImpl.class,\n \"fake-extension-point\")));\n\n when(configFetcher.fetch(GROUP, ExtensionPointEnabled.class))\n .thenReturn(Mono.fromSupplier(() -> {\n var extensionPointEnabled = new ExtensionPointEnabled();\n extensionPointEnabled.put(\"fake-extension-point\",\n new LinkedHashSet<>(List.of(\"default-fake-extension\", \"fake-extension\")));\n return extensionPointEnabled;\n }));\n\n @SuppressWarnings(\"unchecked\")\n ObjectProvider objectProvider = mock(ObjectProvider.class);\n var extensionDefaultImpl = new FakeExtensionPointDefaultImpl();\n when(objectProvider.orderedStream())\n .thenReturn(Stream.of(extensionDefaultImpl));\n when(beanFactory.getBeanProvider(FakeExtensionPoint.class)).thenReturn(objectProvider);\n\n var extensionImpl = new FakeExtensionPointImpl();\n var anotherExtensionImpl = new FakeExtensionPoint() {\n };\n\n var spyGetter = spy(getter);\n doReturn(List.of(extensionImpl, anotherExtensionImpl)).when(spyGetter)\n .lookExtensions(eq(FakeExtensionPoint.class));\n\n spyGetter.getEnabledExtensions(FakeExtensionPoint.class)\n .as(StepVerifier::create)\n // should keep the order of enabled extensions\n .expectNext(extensionDefaultImpl)\n .expectNext(extensionImpl)\n .verifyComplete();\n }\n\n\n @Test\n void shouldGetMultiInstanceExtensionWhileExtensionPointEnabledNotSet() {\n // prepare extension point definition\n when(extensionPointDefinitionGetter.getByClassName(any()))\n .thenReturn(Mono.fromSupplier(\n () -> createExtensionPointDefinition(\"fake-extension-point\",\n FakeExtensionPoint.class,\n ExtensionPointType.MULTI_INSTANCE))\n );\n\n when(configFetcher.fetch(GROUP, ExtensionPointEnabled.class))\n .thenReturn(Mono.empty());\n\n @SuppressWarnings(\"unchecked\")\n ObjectProvider objectProvider = mock(ObjectProvider.class);\n var extensionDefaultImpl = new FakeExtensionPointDefaultImpl();\n when(objectProvider.orderedStream())\n .thenReturn(Stream.of(extensionDefaultImpl));\n when(beanFactory.getBeanProvider(FakeExtensionPoint.class)).thenReturn(objectProvider);\n\n var extensionImpl = new FakeExtensionPointImpl();\n var anotherExtensionImpl = new FakeExtensionPoint() {\n };\n\n var spyGetter = spy(getter);\n doReturn(List.of(extensionImpl, anotherExtensionImpl)).when(spyGetter)\n .lookExtensions(eq(FakeExtensionPoint.class));\n\n spyGetter.getEnabledExtensions(FakeExtensionPoint.class)\n .as(StepVerifier::create)\n // should keep the order according to @Order annotation\n // order is 1\n .expectNext(extensionImpl)\n // order is 2\n .expectNext(extensionDefaultImpl)\n // order is not set\n .expectNext(anotherExtensionImpl)\n .verifyComplete();\n }\n\n @Test\n void shouldGetExtensionsFromPluginManagerAndApplicationContext() {\n var extensionFromPlugin = new FakeExtensionPointDefaultImpl();\n var extensionFromAppContext = new FakeExtensionPointImpl();\n\n var spyGetter = spy(getter);\n doReturn(List.of(extensionFromPlugin)).when(spyGetter)\n .lookExtensions(eq(FakeExtensionPoint.class));\n\n when(beanFactory.getBeanProvider(FakeExtensionPoint.class))\n .thenReturn(extensionPointObjectProvider);\n when(extensionPointObjectProvider.orderedStream())\n .thenReturn(Stream.of(extensionFromAppContext));\n var extensions = spyGetter.getExtensionList(FakeExtensionPoint.class);\n assertEquals(List.of(extensionFromAppContext, extensionFromPlugin), extensions);\n }\n\n interface FakeExtensionPoint extends ExtensionPoint {\n\n }\n\n @Order(1)\n static class FakeExtensionPointImpl implements FakeExtensionPoint {\n }\n\n @Order(2)\n static class FakeExtensionPointDefaultImpl implements FakeExtensionPoint {\n }\n\n ExtensionDefinition createExtensionDefinition(String name, Class clazz, String epdName) {\n var ed = new ExtensionDefinition();\n var metadata = new Metadata();\n metadata.setName(name);\n ed.setMetadata(metadata);\n var spec = new ExtensionDefinition.ExtensionSpec();\n spec.setClassName(clazz.getName());\n spec.setExtensionPointName(epdName);\n ed.setSpec(spec);\n return ed;\n }\n\n ExtensionPointDefinition createExtensionPointDefinition(String name,\n Class clazz,\n ExtensionPointType type) {\n var epd = new ExtensionPointDefinition();\n var metadata = new Metadata();\n metadata.setName(name);\n epd.setMetadata(metadata);\n var spec = new ExtensionPointDefinition.ExtensionPointSpec();\n spec.setClassName(clazz.getName());\n spec.setType(type);\n epd.setSpec(spec);\n return epd;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/plugin/resources/BundleResourceUtilsTest.java", "content": "package run.halo.app.plugin.resources;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\n\nimport java.net.MalformedURLException;\nimport java.net.URL;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.PluginClassLoader;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.core.io.Resource;\nimport run.halo.app.infra.exception.AccessDeniedException;\n\n/**\n * Tests for {@link BundleResourceUtils}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass BundleResourceUtilsTest {\n\n @Mock\n private PluginManager pluginManager;\n\n @BeforeEach\n void setUp() throws MalformedURLException {\n PluginWrapper pluginWrapper = Mockito.mock(PluginWrapper.class);\n PluginClassLoader pluginClassLoader = Mockito.mock(PluginClassLoader.class);\n lenient().when(pluginWrapper.getPluginClassLoader()).thenReturn(pluginClassLoader);\n lenient().when(pluginManager.getPlugin(eq(\"fake-plugin\"))).thenReturn(pluginWrapper);\n\n lenient().when(pluginClassLoader.getResource(eq(\"console/main.js\"))).thenReturn(\n new URL(\"file://console/main.js\"));\n lenient().when(pluginClassLoader.getResource(eq(\"console/style.css\"))).thenReturn(\n new URL(\"file://console/style.css\"));\n }\n\n @Test\n void getJsBundleResource() {\n Resource jsBundleResource =\n BundleResourceUtils.getJsBundleResource(pluginManager, \"fake-plugin\", \"main.js\");\n assertThat(jsBundleResource).isNotNull();\n assertThat(jsBundleResource.exists()).isTrue();\n\n jsBundleResource =\n BundleResourceUtils.getJsBundleResource(pluginManager, \"fake-plugin\", \"test.js\");\n assertThat(jsBundleResource).isNull();\n\n jsBundleResource =\n BundleResourceUtils.getJsBundleResource(pluginManager, \"nothing-plugin\", \"main.js\");\n assertThat(jsBundleResource).isNull();\n\n assertThatThrownBy(() -> {\n BundleResourceUtils.getJsBundleResource(pluginManager, \"fake-plugin\",\n \"../test/main.js\");\n }).isInstanceOf(AccessDeniedException.class);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/resources/ReverseProxyRouterFunctionFactoryTest.java", "content": "package run.halo.app.plugin.resources;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.Mockito.when;\n\nimport java.io.FileNotFoundException;\nimport java.net.URL;\nimport java.net.URLClassLoader;\nimport java.time.Duration;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.Spy;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginWrapper;\nimport org.springframework.boot.autoconfigure.web.WebProperties;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.http.CacheControl;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.util.ResourceUtils;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.core.extension.ReverseProxy.FileReverseProxyProvider;\nimport run.halo.app.core.extension.ReverseProxy.ReverseProxyRule;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.plugin.PluginConst;\n\n/**\n * Tests for {@link ReverseProxyRouterFunctionFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ReverseProxyRouterFunctionFactoryTest {\n\n @Mock\n private PluginManager pluginManager;\n\n @Mock\n private ApplicationContext applicationContext;\n\n @Spy\n WebProperties webProperties = new WebProperties();\n\n @InjectMocks\n private ReverseProxyRouterFunctionFactory factory;\n\n @Test\n void shouldProxyStaticResourceWithCacheControl() throws FileNotFoundException {\n var cache = webProperties.getResources().getCache();\n cache.setUseLastModified(true);\n cache.getCachecontrol().setMaxAge(Duration.ofDays(7));\n\n var routerFunction = factory.create(mockReverseProxy(), \"fakeA\");\n assertNotNull(routerFunction);\n var webClient = WebTestClient.bindToRouterFunction(routerFunction).build();\n\n var pluginWrapper = Mockito.mock(PluginWrapper.class);\n var pluginRoot = ResourceUtils.getURL(\"classpath:plugin/plugin-for-reverseproxy/\");\n var classLoader = new URLClassLoader(new URL[] {pluginRoot});\n when(pluginWrapper.getPluginClassLoader()).thenReturn(classLoader);\n when(pluginManager.getPlugin(\"fakeA\")).thenReturn(pluginWrapper);\n\n webClient.get().uri(\"/plugins/fakeA/assets/static/test.txt\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().cacheControl(CacheControl.maxAge(Duration.ofDays(7)))\n .expectHeader().value(HttpHeaders.LAST_MODIFIED, Assertions::assertNotNull)\n .expectBody(String.class).isEqualTo(\"Fake content.\");\n }\n\n @Test\n void shouldProxyStaticResourceWithoutLastModified() throws FileNotFoundException {\n var cache = webProperties.getResources().getCache();\n cache.setUseLastModified(false);\n cache.getCachecontrol().setMaxAge(Duration.ofDays(7));\n\n var routerFunction = factory.create(mockReverseProxy(), \"fakeA\");\n assertNotNull(routerFunction);\n var webClient = WebTestClient.bindToRouterFunction(routerFunction).build();\n\n var pluginWrapper = Mockito.mock(PluginWrapper.class);\n var pluginRoot = ResourceUtils.getURL(\"classpath:plugin/plugin-for-reverseproxy/\");\n var classLoader = new URLClassLoader(new URL[] {pluginRoot});\n when(pluginWrapper.getPluginClassLoader()).thenReturn(classLoader);\n when(pluginManager.getPlugin(\"fakeA\")).thenReturn(pluginWrapper);\n\n webClient.get().uri(\"/plugins/fakeA/assets/static/test.txt\")\n .exchange()\n .expectStatus().isOk()\n .expectHeader().cacheControl(CacheControl.maxAge(Duration.ofDays(7)))\n .expectHeader().lastModified(-1)\n .expectBody(String.class).isEqualTo(\"Fake content.\");\n }\n\n @Test\n void shouldReturnNotFoundIfResourceNotFound() throws FileNotFoundException {\n var routerFunction = factory.create(mockReverseProxy(), \"fakeA\");\n assertNotNull(routerFunction);\n var webClient = WebTestClient.bindToRouterFunction(routerFunction).build();\n\n var pluginWrapper = Mockito.mock(PluginWrapper.class);\n var pluginRoot = ResourceUtils.getURL(\"classpath:plugin/plugin-for-reverseproxy/\");\n var classLoader = new URLClassLoader(new URL[] {pluginRoot});\n when(pluginWrapper.getPluginClassLoader()).thenReturn(classLoader);\n when(pluginManager.getPlugin(\"fakeA\")).thenReturn(pluginWrapper);\n\n webClient.get().uri(\"/plugins/fakeA/assets/static/non-existing-file.txt\")\n .exchange()\n .expectHeader().cacheControl(CacheControl.empty())\n .expectStatus().isNotFound();\n }\n\n private ReverseProxy mockReverseProxy() {\n var reverseProxyRule = new ReverseProxyRule(\"/static/**\",\n new FileReverseProxyProvider(\"static\", \"\"));\n var reverseProxy = new ReverseProxy();\n var metadata = new Metadata();\n metadata.setLabels(\n Map.of(PluginConst.PLUGIN_NAME_LABEL_NAME, \"fakeA\"));\n reverseProxy.setMetadata(metadata);\n reverseProxy.setRules(List.of(reverseProxyRule));\n return reverseProxy;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/plugin/resources/ReverseProxyRouterFunctionRegistryTest.java", "content": "package run.halo.app.plugin.resources;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.ReverseProxy;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.plugin.PluginRouterFunctionRegistry;\n\n/**\n * Tests for {@link ReverseProxyRouterFunctionRegistry}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ReverseProxyRouterFunctionRegistryTest {\n\n @InjectMocks\n ReverseProxyRouterFunctionRegistry registry;\n\n @Mock\n ReverseProxyRouterFunctionFactory reverseProxyRouterFunctionFactory;\n\n @Mock\n PluginRouterFunctionRegistry pluginRouterFunctionRegistry;\n\n @Test\n void register() {\n ReverseProxy mock = getMockReverseProxy();\n registry.register(\"fake-plugin\", mock);\n\n assertThat(registry.reverseProxySize(\"fake-plugin\")).isEqualTo(1);\n\n // repeat register a same reverse proxy\n registry.register(\"fake-plugin\", mock);\n\n assertThat(registry.reverseProxySize(\"fake-plugin\")).isEqualTo(1);\n\n verify(reverseProxyRouterFunctionFactory, times(2)).create(any(), any());\n }\n\n @Test\n void removeByKeyValue() {\n ReverseProxy mock = getMockReverseProxy();\n registry.register(\"fake-plugin\", mock);\n\n registry.remove(\"fake-plugin\", \"test-reverse-proxy\");\n\n assertThat(registry.reverseProxySize(\"fake-plugin\")).isEqualTo(0);\n }\n\n private ReverseProxy getMockReverseProxy() {\n ReverseProxy mock = Mockito.mock(ReverseProxy.class);\n Metadata metadata = new Metadata();\n metadata.setName(\"test-reverse-proxy\");\n when(mock.getMetadata()).thenReturn(metadata);\n RouterFunction routerFunction = request -> Mono.empty();\n\n when(reverseProxyRouterFunctionFactory.create(any(), any()))\n .thenReturn(routerFunction);\n return mock;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/search/HaloDocumentEventsListenerTest.java", "content": "package run.halo.app.search;\n\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.search.event.HaloDocumentAddRequestEvent;\nimport run.halo.app.search.event.HaloDocumentDeleteRequestEvent;\nimport run.halo.app.search.event.HaloDocumentRebuildRequestEvent;\n\n@ExtendWith(MockitoExtension.class)\nclass HaloDocumentEventsListenerTest {\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @InjectMocks\n HaloDocumentEventsListener listener;\n\n @Test\n void shouldRebuildIndicesWhenReceivingRebuildRequestEvent() {\n listener.setBufferSize(1);\n var searchEngine = mock(SearchEngine.class);\n when(searchEngine.available()).thenReturn(true);\n when(extensionGetter.getEnabledExtension(SearchEngine.class))\n .thenReturn(Mono.just(searchEngine));\n var docsProvider = mock(HaloDocumentsProvider.class);\n\n var docs = List.of(new HaloDocument(), new HaloDocument(), new HaloDocument());\n\n when(docsProvider.fetchAll()).thenReturn(Flux.fromIterable(docs));\n when(extensionGetter.getExtensions(HaloDocumentsProvider.class))\n .thenReturn(Flux.just(docsProvider));\n listener.onApplicationEvent(new HaloDocumentRebuildRequestEvent(this));\n verify(searchEngine, times(3)).addOrUpdate(any());\n }\n\n @Test\n void shouldAddDocsWhenReceivingAddRequestEvent() {\n var searchEngine = mock(SearchEngine.class);\n when(searchEngine.available()).thenReturn(true);\n when(extensionGetter.getEnabledExtension(SearchEngine.class))\n .thenReturn(Mono.just(searchEngine));\n var docs = List.of(new HaloDocument());\n listener.onApplicationEvent(new HaloDocumentAddRequestEvent(this, docs));\n verify(searchEngine).addOrUpdate(docs);\n }\n\n @Test\n void shouldDeleteDocsWhenReceivingDeleteRequestEvent() {\n var searchEngine = mock(SearchEngine.class);\n when(searchEngine.available()).thenReturn(true);\n when(extensionGetter.getEnabledExtension(SearchEngine.class))\n .thenReturn(Mono.just(searchEngine));\n var docIds = List.of(\"1\", \"2\", \"3\");\n listener.onApplicationEvent(new HaloDocumentDeleteRequestEvent(this, docIds));\n verify(searchEngine).deleteDocument(docIds);\n }\n\n @Test\n void shouldFailWhenSearchEngineIsUnavailable() {\n var searchEngine = mock(SearchEngine.class);\n when(searchEngine.available()).thenReturn(false);\n when(extensionGetter.getEnabledExtension(SearchEngine.class))\n .thenReturn(Mono.just(searchEngine));\n assertThrows(\n SearchEngineUnavailableException.class,\n () -> listener.onApplicationEvent(new HaloDocumentRebuildRequestEvent(this))\n );\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/search/IndexEndpointTest.java", "content": "package run.halo.app.search;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.validation.Errors;\nimport org.springframework.web.reactive.function.server.HandlerStrategies;\nimport org.springframework.web.server.handler.ResponseStatusExceptionHandler;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.exception.RequestBodyValidationException;\n\n@ExtendWith(MockitoExtension.class)\nclass IndexEndpointTest {\n\n @Mock\n SearchService searchService;\n\n @InjectMocks\n IndexEndpoint endpoint;\n\n WebTestClient client;\n\n @BeforeEach\n void setUp() {\n client = WebTestClient.bindToRouterFunction(endpoint.endpoint())\n .handlerStrategies(HandlerStrategies.builder()\n .exceptionHandler(new ResponseStatusExceptionHandler())\n .build())\n .build();\n }\n\n @Test\n void shouldResponseBadRequestIfNotRequestBody() {\n client.post().uri(\"/indices/-/search\")\n .exchange()\n .expectStatus().isBadRequest();\n }\n\n @Test\n void shouldResponseBadRequestIfRequestBodyValidationFailed() {\n var option = new SearchOption();\n var errors = mock(Errors.class);\n when(searchService.search(any(SearchOption.class)))\n .thenReturn(Mono.error(new RequestBodyValidationException(errors)));\n\n client.post().uri(\"/indices/-/search\")\n .bodyValue(option)\n .exchange()\n .expectStatus().isBadRequest();\n }\n\n @Test\n void shouldSearchCorrectly() {\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n var searchResult = new SearchResult();\n when(searchService.search(any(SearchOption.class))).thenReturn(Mono.just(searchResult));\n\n client.post().uri(\"/indices/-/search\")\n .bodyValue(option)\n .exchange()\n .expectStatus().isOk()\n .expectBody(SearchResult.class)\n .isEqualTo(searchResult);\n\n verify(searchService).search(assertArg(o -> {\n assertEquals(\"halo\", o.getKeyword());\n // make sure the filters are overwritten\n assertTrue(o.getFilterExposed());\n assertTrue(o.getFilterPublished());\n assertFalse(o.getFilterRecycled());\n }));\n }\n\n @Test\n void shouldFailWhenSearchEngineIsUnavailable() {\n when(searchService.search(any(SearchOption.class)))\n .thenReturn(Mono.error(new SearchEngineUnavailableException()));\n\n client.post().uri(\"/indices/-/search\")\n .bodyValue(new SearchOption())\n .exchange()\n .expectStatus().is4xxClientError();\n }\n\n @Test\n void ensureGroupVersionNotModified() {\n assertEquals(\"api.halo.run/v1alpha1\", endpoint.groupVersion().toString());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/search/IndicesEndpointTest.java", "content": "package run.halo.app.search;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.verify;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.ValueSource;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport run.halo.app.search.event.HaloDocumentRebuildRequestEvent;\n\n@ExtendWith(MockitoExtension.class)\nclass IndicesEndpointTest {\n\n @Mock\n ApplicationEventPublisher publisher;\n\n @InjectMocks\n IndicesEndpoint endpoint;\n\n WebTestClient client;\n\n @BeforeEach\n void setUp() {\n client = WebTestClient.bindToRouterFunction(endpoint.endpoint()).build();\n }\n\n @ParameterizedTest\n @ValueSource(strings = {\"/indices/-/rebuild\"})\n void shouldRebuildIndices(String uri) {\n client.post().uri(uri)\n .exchange()\n .expectStatus().isAccepted();\n verify(publisher).publishEvent(assertArg(event -> {\n assertInstanceOf(HaloDocumentRebuildRequestEvent.class, event);\n assertEquals(endpoint, event.getSource());\n }));\n }\n\n @Test\n void ensureGroupVersionNotChanged() {\n assertEquals(\"api.console.halo.run/v1alpha1\", endpoint.groupVersion().toString());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/search/SearchServiceImplTest.java", "content": "package run.halo.app.search;\n\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.validation.Errors;\nimport org.springframework.validation.Validator;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.infra.exception.RequestBodyValidationException;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@ExtendWith(MockitoExtension.class)\nclass SearchServiceImplTest {\n\n @Mock\n Validator validator;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @InjectMocks\n SearchServiceImpl searchService;\n\n @Test\n void shouldThrowValidationErrorIfOptionIsInvalid() {\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n\n var errors = mock(Errors.class);\n when(errors.hasErrors()).thenReturn(true);\n when(validator.validateObject(option)).thenReturn(errors);\n\n searchService.search(option)\n .as(StepVerifier::create)\n .expectError(RequestBodyValidationException.class)\n .verify();\n }\n\n @Test\n void shouldThrowSearchEngineUnavailableExceptionIfNoSearchEngineFound() {\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n\n var errors = mock(Errors.class);\n when(errors.hasErrors()).thenReturn(false);\n when(validator.validateObject(option)).thenReturn(errors);\n\n when(extensionGetter.getEnabledExtension(SearchEngine.class)).thenReturn(Mono.empty());\n\n searchService.search(option)\n .as(StepVerifier::create)\n .expectError(SearchEngineUnavailableException.class)\n .verify();\n }\n\n @Test\n void shouldThrowSearchEngineUnavailableExceptionIfNoSearchEngineAvailable() {\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n\n var errors = mock(Errors.class);\n when(errors.hasErrors()).thenReturn(false);\n when(validator.validateObject(option)).thenReturn(errors);\n\n when(extensionGetter.getEnabledExtension(SearchEngine.class))\n .thenAnswer(invocation -> Mono.fromSupplier(() -> {\n var searchEngine = mock(SearchEngine.class);\n when(searchEngine.available()).thenReturn(false);\n return searchEngine;\n }));\n\n searchService.search(option)\n .as(StepVerifier::create)\n .expectError(SearchEngineUnavailableException.class);\n }\n\n @Test\n void shouldSearch() {\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n\n var errors = mock(Errors.class);\n when(errors.hasErrors()).thenReturn(false);\n when(validator.validateObject(option)).thenReturn(errors);\n\n var searchResult = mock(SearchResult.class);\n when(extensionGetter.getEnabledExtension(SearchEngine.class))\n .thenAnswer(invocation -> Mono.fromSupplier(() -> {\n var searchEngine = mock(SearchEngine.class);\n when(searchEngine.available()).thenReturn(true);\n when(searchEngine.search(option)).thenReturn(searchResult);\n return searchEngine;\n }));\n\n searchService.search(option)\n .as(StepVerifier::create)\n .expectNext(searchResult)\n .verifyComplete();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/search/lucene/LuceneSearchEngineIntegrationTest.java", "content": "package run.halo.app.search.lucene;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static run.halo.app.core.extension.content.Post.VisibleEnum.PRIVATE;\nimport static run.halo.app.core.extension.content.Post.VisibleEnum.PUBLIC;\n\nimport java.time.Duration;\nimport java.util.List;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.opentest4j.AssertionFailedError;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.core.retry.RetryException;\nimport org.springframework.core.retry.RetryPolicy;\nimport org.springframework.core.retry.RetryTemplate;\nimport org.springframework.dao.OptimisticLockingFailureException;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.test.StepVerifier;\nimport reactor.util.retry.Retry;\nimport run.halo.app.content.Content;\nimport run.halo.app.content.ContentUpdateParam;\nimport run.halo.app.content.PostRequest;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.search.SearchEngine;\nimport run.halo.app.search.SearchOption;\nimport run.halo.app.search.SearchResult;\n\n@DirtiesContext\n@SpringBootTest(properties = {\n \"halo.search-engine.lucene.enabled=true\",\n \"halo.extension.controller.disabled=false\"})\n@AutoConfigureWebTestClient\npublic class LuceneSearchEngineIntegrationTest {\n\n @Autowired\n WebTestClient webClient;\n\n @Autowired\n PostService postService;\n\n @Autowired\n ReactiveExtensionClient client;\n\n @Autowired\n SearchEngine searchEngine;\n\n @BeforeEach\n @AfterEach\n void cleanUp() {\n searchEngine.deleteAll();\n }\n\n @Test\n @WithMockUser(username = \"admin\", roles = AnonymousUserConst.Role)\n void shouldSearchPostAfterPostPublished() throws RetryException {\n var postName = \"first-post\";\n assertNoResult(1);\n createPost(postName);\n assertHasResult(5);\n unpublishPost(postName);\n assertNoResult(5);\n publishPost(postName);\n assertHasResult(5);\n privatePost(postName);\n assertNoResult(5);\n publicPost(postName);\n assertHasResult(5);\n recyclePost(postName);\n assertNoResult(5);\n recoverPost(postName);\n assertHasResult(5);\n deletePostPermanently(postName);\n assertNoResult(5);\n }\n\n void assertHasResult(int maxAttempts) throws RetryException {\n var retryTemplate = new RetryTemplate(RetryPolicy.builder()\n .delay(Duration.ofSeconds(1))\n .maxRetries(maxAttempts)\n .predicate(AssertionFailedError.class::isInstance)\n .build());\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n option.setHighlightPreTag(\"\");\n option.setHighlightPostTag(\"\");\n retryTemplate.execute(() -> {\n webClient.post().uri(\"/apis/api.halo.run/v1alpha1/indices/-/search\")\n .bodyValue(option)\n .exchange()\n .expectStatus().isOk()\n .expectBody(SearchResult.class).value(result -> {\n assertEquals(1, result.getTotal());\n assertEquals(\"halo\", result.getKeyword());\n var hits = result.getHits();\n assertEquals(1, hits.size());\n var doc = hits.get(0);\n assertEquals(\"post.content.halo.run-first-post\", doc.getId());\n assertEquals(\"post.content.halo.run\", doc.getType());\n assertEquals(\"first halo post\", doc.getTitle());\n assertNull(doc.getDescription());\n assertEquals(\"halo\", doc.getContent());\n });\n return null;\n });\n }\n\n void assertNoResult(int maxAttempts) throws RetryException {\n var retryTemplate = new RetryTemplate(RetryPolicy.builder()\n .delay(Duration.ofSeconds(1))\n .maxRetries(maxAttempts)\n .predicate(AssertionFailedError.class::isInstance)\n .build());\n\n var option = new SearchOption();\n option.setKeyword(\"halo\");\n option.setHighlightPreTag(\"\");\n option.setHighlightPostTag(\"\");\n option.setIncludeTagNames(List.of(\"search\"));\n option.setIncludeCategoryNames(List.of(\"halo\"));\n option.setIncludeOwnerNames(List.of(\"admin\"));\n retryTemplate.execute(() -> {\n webClient.post().uri(\"/apis/api.halo.run/v1alpha1/indices/-/search\")\n .bodyValue(option)\n .exchange()\n .expectStatus().isOk()\n .expectBody(SearchResult.class).value(result -> {\n assertEquals(0, result.getTotal());\n assertEquals(\"halo\", result.getKeyword());\n });\n return null;\n });\n }\n\n void deletePostPermanently(String postName) {\n client.get(Post.class, postName)\n .flatMap(client::delete)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void recoverPost(String postName) {\n client.get(Post.class, postName)\n .doOnNext(post -> post.getSpec().setDeleted(false))\n .flatMap(client::update)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void recyclePost(String postName) {\n client.get(Post.class, postName)\n .doOnNext(post -> post.getSpec().setDeleted(true))\n .flatMap(client::update)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void publicPost(String postName) {\n client.get(Post.class, postName)\n .doOnNext(post -> post.getSpec().setVisible(PUBLIC))\n .flatMap(client::update)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void privatePost(String postName) {\n client.get(Post.class, postName)\n .doOnNext(post -> post.getSpec().setVisible(PRIVATE))\n .flatMap(client::update)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void publishPost(String postName) {\n client.get(Post.class, postName)\n .flatMap(postService::publish)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void unpublishPost(String postName) {\n client.get(Post.class, postName)\n .flatMap(postService::unpublish)\n .retryWhen(optimisticLockRetry())\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n void createPost(String postName) {\n var post = new Post();\n var metadata = new Metadata();\n post.setMetadata(metadata);\n metadata.setName(postName);\n var spec = new Post.PostSpec();\n post.setSpec(spec);\n spec.setPublish(true);\n spec.setOwner(\"admin\");\n spec.setTitle(\"first halo post\");\n spec.setVisible(PUBLIC);\n spec.setAllowComment(true);\n spec.setPinned(false);\n spec.setPriority(0);\n spec.setSlug(\"/first-post\");\n spec.setDeleted(false);\n spec.setTags(List.of(\"search\"));\n spec.setCategories(List.of(\"halo\"));\n var excerpt = new Post.Excerpt();\n excerpt.setRaw(\"first post description\");\n excerpt.setAutoGenerate(false);\n spec.setExcerpt(excerpt);\n var content = new Content(\"halo\", \"halo\", \"Markdown\");\n var contentParam = ContentUpdateParam.from(content);\n var postRequest = new PostRequest(post, contentParam);\n postService.draftPost(postRequest)\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n Retry optimisticLockRetry() {\n return Retry.backoff(5, Duration.ofMillis(100))\n .filter(OptimisticLockingFailureException.class::isInstance);\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/search/lucene/LuceneSearchEngineTest.java", "content": "package run.halo.app.search.lucene;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.io.IOException;\nimport java.nio.file.Path;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.concurrent.CompletableFuture;\nimport java.util.concurrent.ExecutionException;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.TimeoutException;\nimport java.util.stream.IntStream;\nimport org.apache.lucene.index.DirectoryReader;\nimport org.apache.lucene.store.AlreadyClosedException;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.search.HaloDocument;\nimport run.halo.app.search.SearchOption;\n\n@ExtendWith(MockitoExtension.class)\nclass LuceneSearchEngineTest {\n\n LuceneSearchEngine searchEngine;\n\n @TempDir\n Path tempDir;\n\n @BeforeEach\n void setUp() throws Exception {\n this.searchEngine = new LuceneSearchEngine(tempDir);\n this.searchEngine.afterPropertiesSet();\n }\n\n @AfterEach\n void cleanUp() throws Exception {\n this.searchEngine.destroy();\n }\n\n @Test\n void shouldAddOrUpdateDocument() throws IOException {\n var haloDoc = createFakeHaloDoc();\n searchEngine.addOrUpdate(List.of(haloDoc));\n // validate the index\n var reader = DirectoryReader.open(searchEngine.getDirectory());\n assertEquals(1, reader.getDocCount(\"id\"));\n }\n\n @Test\n void shouldDeleteDocument() throws IOException {\n var haloDoc = createFakeHaloDoc();\n searchEngine.addOrUpdate(List.of(haloDoc));\n\n var reader = DirectoryReader.open(searchEngine.getDirectory());\n assertEquals(1, reader.getDocCount(\"id\"));\n\n this.searchEngine.deleteDocument(List.of(\"fake-id\"));\n\n reader = DirectoryReader.open(searchEngine.getDirectory());\n assertEquals(0, reader.getDocCount(\"id\"));\n }\n\n @Test\n void shouldDeleteAll() throws IOException {\n var haloDoc = createFakeHaloDoc();\n searchEngine.addOrUpdate(List.of(haloDoc));\n\n var reader = DirectoryReader.open(searchEngine.getDirectory());\n assertEquals(1, reader.getDocCount(\"id\"));\n\n this.searchEngine.deleteAll();\n\n reader = DirectoryReader.open(searchEngine.getDirectory());\n assertEquals(0, reader.getDocCount(\"id\"));\n }\n\n @Test\n void shouldAddOrUpdateDocumentConcurrently()\n throws ExecutionException, InterruptedException, TimeoutException {\n runConcurrently(() -> {\n var haloDoc = createFakeHaloDoc();\n searchEngine.addOrUpdate(List.of(haloDoc));\n });\n }\n\n @Test\n void shouldDeleteDocumentConcurrently()\n throws ExecutionException, InterruptedException, TimeoutException {\n runConcurrently(() -> {\n var haloDoc = createFakeHaloDoc();\n searchEngine.addOrUpdate(List.of(haloDoc));\n searchEngine.deleteDocument(List.of(haloDoc.getId()));\n });\n }\n\n @Test\n void shouldDeleteAllConcurrently()\n throws ExecutionException, InterruptedException, TimeoutException {\n runConcurrently(() -> {\n var haloDoc = createFakeHaloDoc();\n searchEngine.addOrUpdate(List.of(haloDoc));\n searchEngine.deleteAll();\n });\n }\n\n @Test\n void shouldDestroy() throws Exception {\n var directory = this.searchEngine.getDirectory();\n this.searchEngine.destroy();\n assertThrows(AlreadyClosedException.class, () -> DirectoryReader.open(directory));\n }\n\n @Test\n void shouldSearchNothingIfIndexNotFound() {\n var option = new SearchOption();\n option.setKeyword(\"fake\");\n option.setLimit(123);\n option.setHighlightPreTag(\"\");\n option.setHighlightPostTag(\"\");\n var result = this.searchEngine.search(option);\n assertEquals(0, result.getTotal());\n assertEquals(\"fake\", result.getKeyword());\n assertEquals(123, result.getLimit());\n assertEquals(0, result.getHits().size());\n }\n\n @Test\n void shouldSearch() {\n this.searchEngine.addOrUpdate(List.of(createFakeHaloDoc()));\n\n var option = new SearchOption();\n option.setKeyword(\"fake\");\n option.setLimit(123);\n option.setHighlightPreTag(\"\");\n option.setHighlightPostTag(\"\");\n var result = this.searchEngine.search(option);\n assertEquals(1, result.getTotal());\n assertEquals(\"fake\", result.getKeyword());\n assertEquals(123, result.getLimit());\n assertEquals(1, result.getHits().size());\n var gotHaloDoc = result.getHits().get(0);\n assertEquals(\"fake-id\", gotHaloDoc.getId());\n assertEquals(\"fake-title\", gotHaloDoc.getTitle());\n assertNull(gotHaloDoc.getDescription());\n assertEquals(\"fake-content\", gotHaloDoc.getContent());\n }\n\n void runConcurrently(Runnable runnable)\n throws ExecutionException, InterruptedException, TimeoutException {\n var executorService = Executors.newFixedThreadPool(10);\n var futures = IntStream.of(0, 10)\n .mapToObj(i -> CompletableFuture.runAsync(runnable, executorService))\n .toArray(CompletableFuture[]::new);\n CompletableFuture.allOf(futures).get(10, TimeUnit.SECONDS);\n executorService.shutdownNow();\n assertTrue(executorService.awaitTermination(10, TimeUnit.SECONDS));\n }\n\n HaloDocument createFakeHaloDoc() {\n var haloDoc = new HaloDocument();\n haloDoc.setId(\"fake-id\");\n haloDoc.setMetadataName(\"fake-name\");\n haloDoc.setTitle(\"fake-title\");\n haloDoc.setDescription(null);\n haloDoc.setContent(\"fake-content\");\n haloDoc.setType(\"fake-type\");\n haloDoc.setOwnerName(\"fake-owner\");\n var now = Instant.now();\n haloDoc.setCreationTimestamp(now);\n haloDoc.setUpdateTimestamp(null);\n haloDoc.setPermalink(\"/fake-permalink\");\n haloDoc.setAnnotations(Map.of(\"fake-anno-key\", \"fake-anno-value\"));\n return haloDoc;\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/search/post/PostEventsListenerTest.java", "content": "package run.halo.app.search.post;\n\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.assertArg;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationEventPublisher;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.event.post.PostDeletedEvent;\nimport run.halo.app.event.post.PostUpdatedEvent;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.search.event.HaloDocumentAddRequestEvent;\nimport run.halo.app.search.event.HaloDocumentDeleteRequestEvent;\n\n@ExtendWith(MockitoExtension.class)\nclass PostEventsListenerTest {\n\n @Mock\n ApplicationEventPublisher publisher;\n\n @Mock\n PostService postService;\n\n @Mock\n ReactiveExtensionClient client;\n\n @InjectMocks\n PostEventsListener listener;\n\n @Nested\n class PostUpdatedEventTest {\n\n @Test\n void shouldDoNothingIfPostIsDeleted() {\n when(client.fetch(Post.class, \"fake-post\"))\n .thenReturn(Mono.empty());\n var event = new PostUpdatedEvent(this, \"fake-post\");\n listener.onApplicationEvent(event)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(publisher, never()).publishEvent(any());\n }\n\n @Test\n void shouldRequestDeleteWhilePostIsDeleting() {\n var post = new Post();\n var metadata = new Metadata();\n metadata.setName(\"fake-post\");\n metadata.setDeletionTimestamp(Instant.now());\n post.setMetadata(metadata);\n when(client.fetch(Post.class, \"fake-post\"))\n .thenReturn(Mono.just(post));\n var event = new PostUpdatedEvent(this, \"fake-post\");\n listener.onApplicationEvent(event)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(publisher).publishEvent(\n assertArg(e -> assertInstanceOf(HaloDocumentDeleteRequestEvent.class, e))\n );\n }\n\n @Test\n void shouldRequestAddWhilePostIsNotDeleted() {\n var post = new Post();\n var metadata = new Metadata();\n metadata.setName(\"fake-post\");\n post.setMetadata(metadata);\n var spec = new Post.PostSpec();\n post.setSpec(spec);\n var status = new Post.PostStatus();\n post.setStatus(status);\n when(client.fetch(Post.class, \"fake-post\"))\n .thenReturn(Mono.just(post));\n var content = ContentWrapper.builder()\n .content(\"fake-content\")\n .raw(\"fake-content\")\n .build();\n when(postService.getReleaseContent(post)).thenReturn(Mono.just(content));\n var event = new PostUpdatedEvent(this, \"fake-post\");\n listener.onApplicationEvent(event)\n .as(StepVerifier::create)\n .verifyComplete();\n\n verify(publisher).publishEvent(\n assertArg(e -> assertInstanceOf(HaloDocumentAddRequestEvent.class, e))\n );\n }\n }\n\n @Nested\n class PostDeleteEventTest {\n\n @Test\n void shouldRequestDelete() {\n var post = new Post();\n var metadata = new Metadata();\n metadata.setName(\"fake-post\");\n post.setMetadata(metadata);\n var event = new PostDeletedEvent(this, post);\n listener.onApplicationEvent(event);\n\n verify(publisher).publishEvent(\n assertArg(e -> assertInstanceOf(HaloDocumentDeleteRequestEvent.class, e))\n );\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/search/post/PostHaloDocumentsProviderTest.java", "content": "package run.halo.app.search.post;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.ReactiveExtensionPaginatedOperator;\n\n@ExtendWith(MockitoExtension.class)\nclass PostHaloDocumentsProviderTest {\n\n @Mock\n PostService postService;\n\n @Mock\n ReactiveExtensionPaginatedOperator paginatedOperator;\n\n @InjectMocks\n PostHaloDocumentsProvider provider;\n\n @Test\n void ensureTypeNotModified() {\n assertEquals(\"post.content.halo.run\", provider.getType());\n }\n\n @Test\n void shouldFetchAll() {\n var post = createFakePost();\n when(paginatedOperator.list(same(Post.class), any(ListOptions.class)))\n .thenReturn(Flux.just(post));\n var content = ContentWrapper.builder()\n .content(\"fake-content\")\n .raw(\"fake-content\")\n .build();\n when(postService.getReleaseContent(post)).thenReturn(Mono.just(content));\n provider.fetchAll()\n .as(StepVerifier::create)\n .assertNext(doc -> {\n assertEquals(\"post.content.halo.run\", doc.getType());\n assertEquals(\"fake-post\", doc.getMetadataName());\n assertEquals(\"post.content.halo.run-fake-post\", doc.getId());\n assertEquals(\"fake-content\", doc.getContent());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFetchAllIfNoContent() {\n var post = createFakePost();\n when(paginatedOperator.list(same(Post.class), any(ListOptions.class)))\n .thenReturn(Flux.just(post));\n when(postService.getReleaseContent(post)).thenReturn(Mono.empty());\n provider.fetchAll()\n .as(StepVerifier::create)\n .assertNext(doc -> {\n assertEquals(\"post.content.halo.run\", doc.getType());\n assertEquals(\"fake-post\", doc.getMetadataName());\n assertEquals(\"post.content.halo.run-fake-post\", doc.getId());\n assertEquals(\"\", doc.getContent());\n })\n .verifyComplete();\n }\n\n Post createFakePost() {\n var post = new Post();\n var metadata = new Metadata();\n metadata.setName(\"fake-post\");\n post.setMetadata(metadata);\n var spec = new Post.PostSpec();\n var status = new Post.PostStatus();\n post.setSpec(spec);\n post.setStatus(status);\n return post;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/AuthProviderServiceImplTest.java", "content": "package run.halo.app.security;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.same;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.HashMap;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.AuthProvider;\nimport run.halo.app.core.extension.UserConnection;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link AuthProviderServiceImpl}.\n *\n * @author guqing\n * @since 2.4.0\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\nclass AuthProviderServiceImplTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n ObjectProvider systemFetchProvider;\n\n @Mock\n SystemConfigFetcher systemConfigFetcher;\n\n @InjectMocks\n AuthProviderServiceImpl authProviderService;\n\n @BeforeEach\n void setUp() {\n when(systemFetchProvider.getIfUnique()).thenReturn(systemConfigFetcher);\n }\n\n @Test\n void testEnable() throws JSONException {\n // Create a test auth provider\n AuthProvider authProvider = createAuthProvider(\"github\");\n when(client.get(eq(AuthProvider.class), eq(\"github\"))).thenReturn(Mono.just(authProvider));\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(ConfigMap.class);\n when(client.update(captor.capture())).thenReturn(Mono.empty());\n\n pileSystemConfigMap();\n\n // Call the method being tested\n authProviderService.enable(\"github\")\n .as(StepVerifier::create)\n .expectNext(authProvider)\n .verifyComplete();\n\n ConfigMap value = captor.getValue();\n JSONAssert.assertEquals(\"\"\"\n {\n \"states\": [\n {\n \"name\": \"github\",\n \"enabled\": true,\n \"priority\": 0\n }\n ]\n }\n \"\"\",\n value.getData().get(SystemSetting.AuthProvider.GROUP),\n true);\n // Verify the result\n verify(client).get(AuthProvider.class, \"github\");\n }\n\n @Test\n void testDisable() throws JSONException {\n // Create a test auth provider\n AuthProvider authProvider = createAuthProvider(\"github\");\n when(client.get(eq(AuthProvider.class), eq(\"github\"))).thenReturn(Mono.just(authProvider));\n\n AuthProvider local = createAuthProvider(\"local\");\n local.getMetadata().getLabels().put(AuthProvider.PRIVILEGED_LABEL, \"true\");\n\n ArgumentCaptor captor = ArgumentCaptor.forClass(ConfigMap.class);\n when(client.update(captor.capture())).thenReturn(Mono.empty());\n\n pileSystemConfigMap();\n\n // Call the method being tested\n Mono result = authProviderService.disable(\"github\");\n\n assertEquals(authProvider, result.block());\n ConfigMap value = captor.getValue();\n JSONAssert.assertEquals(\"\"\"\n {\n \"states\": [\n {\n \"name\": \"github\",\n \"enabled\": false,\n \"priority\": 0\n }\n ]\n }\n \"\"\",\n value.getData().get(SystemSetting.AuthProvider.GROUP),\n true);\n // Verify the result\n verify(client).get(AuthProvider.class, \"github\");\n }\n\n @Test\n @WithMockUser(username = \"admin\")\n void listAll() {\n AuthProvider github = createAuthProvider(\"github\");\n github.getSpec().setBindingUrl(\"fake-binding-url\");\n\n AuthProvider gitlab = createAuthProvider(\"gitlab\");\n gitlab.getSpec().setBindingUrl(\"fake-binding-url\");\n\n AuthProvider gitee = createAuthProvider(\"gitee\");\n\n when(client.listAll(same(AuthProvider.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.just(github, gitlab, gitee));\n when(client.listAll(same(UserConnection.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.empty());\n\n pileSystemConfigMap();\n\n authProviderService.listAll()\n .as(StepVerifier::create)\n .consumeNextWith(result -> {\n assertThat(result).hasSize(3);\n try {\n JSONAssert.assertEquals(\"\"\"\n [{\n \"name\": \"gitee\",\n \"displayName\": \"gitee\",\n \"authType\": \"OAUTH2\",\n \"isBound\": false,\n \"enabled\": false,\n \"priority\": 0,\n \"supportsBinding\": false,\n \"privileged\": false\n },\n {\n \"name\": \"github\",\n \"displayName\": \"github\",\n \"bindingUrl\": \"fake-binding-url\",\n \"authType\": \"OAUTH2\",\n \"isBound\": false,\n \"enabled\": false,\n \"priority\": 0,\n \"supportsBinding\": false,\n \"privileged\": false\n },\n {\n \"name\": \"gitlab\",\n \"displayName\": \"gitlab\",\n \"bindingUrl\": \"fake-binding-url\",\n \"authType\": \"OAUTH2\",\n \"isBound\": false,\n \"enabled\": false,\n \"priority\": 0,\n \"supportsBinding\": false,\n \"privileged\": false\n }]\n \"\"\",\n JsonUtils.objectToJson(result),\n true);\n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n }\n\n AuthProvider createAuthProvider(String name) {\n AuthProvider authProvider = new AuthProvider();\n authProvider.setMetadata(new Metadata());\n authProvider.getMetadata().setName(name);\n authProvider.getMetadata().setLabels(new HashMap<>());\n authProvider.setSpec(new AuthProvider.AuthProviderSpec());\n authProvider.getSpec().setDisplayName(name);\n authProvider.getSpec().setAuthType(AuthProvider.AuthType.OAUTH2);\n return authProvider;\n }\n\n void pileSystemConfigMap() {\n ConfigMap configMap = new ConfigMap();\n configMap.setData(new HashMap<>());\n when(systemConfigFetcher.getConfigMap())\n .thenReturn(Mono.just(configMap));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/CsrfSecurityTest.java", "content": "package run.halo.app.security;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.test.web.reactive.server.WebTestClient;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass CsrfSecurityTest {\n\n @Autowired\n WebTestClient webClient;\n\n @Test\n void shouldNotCheckCsrfForPatAuthentication() {\n webClient.post()\n .uri(\"/fake\")\n .headers(headers -> headers.setBearerAuth(\"pat_invalid\"))\n .exchange()\n .expectStatus()\n .isUnauthorized()\n .expectHeader()\n .exists(HttpHeaders.WWW_AUTHENTICATE);\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/DefaultServerAuthenticationEntryPointTest.java", "content": "package run.halo.app.security;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.springframework.http.HttpHeaders.WWW_AUTHENTICATE;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.security.authentication.AuthenticationCredentialsNotFoundException;\nimport org.springframework.security.web.server.savedrequest.ServerRequestCache;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultServerAuthenticationEntryPointTest {\n\n @Mock\n ServerRequestCache requestCache;\n\n @InjectMocks\n DefaultServerAuthenticationEntryPoint entryPoint;\n\n @Test\n void commenceForXhrRequest() {\n var mockReq = MockServerHttpRequest.get(\"/protected\")\n .header(\"X-Requested-With\", \"XMLHttpRequest\")\n .build();\n var mockExchange = MockServerWebExchange.builder(mockReq)\n .build();\n var commenceMono = entryPoint.commence(mockExchange,\n new AuthenticationCredentialsNotFoundException(\"Not Found\"));\n StepVerifier.create(commenceMono)\n .verifyComplete();\n var headers = mockExchange.getResponse().getHeaders();\n assertEquals(\"FormLogin realm=\\\"console\\\"\", headers.getFirst(WWW_AUTHENTICATE));\n }\n\n @Test\n void commenceForNormalRequest() {\n var mockReq = MockServerHttpRequest.get(\"/protected\")\n .build();\n var mockExchange = MockServerWebExchange.builder(mockReq)\n .build();\n Mockito.when(requestCache.saveRequest(mockExchange)).thenReturn(Mono.empty());\n var commenceMono = entryPoint.commence(mockExchange,\n new AuthenticationCredentialsNotFoundException(\"Not Found\"));\n StepVerifier.create(commenceMono)\n .verifyComplete();\n assertEquals(URI.create(\"/login?authentication_required\"),\n mockExchange.getResponse().getHeaders().getLocation());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/DefaultSuperAdminInitializerTest.java", "content": "package run.halo.app.security;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.mock;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.security.crypto.password.PasswordEncoder;\nimport run.halo.app.extension.MetadataUtil;\n\n/**\n * Tests for {@link DefaultSuperAdminInitializer}.\n */\nclass DefaultSuperAdminInitializerTest {\n\n @Test\n void createAdminShouldSetSystemProtectionFinalizer() {\n var passwordEncoder = mock(PasswordEncoder.class);\n var initializer = new DefaultSuperAdminInitializer(null, passwordEncoder);\n\n var admin = initializer.createAdmin(\"admin\", \"password\", \"admin@example.com\");\n\n assertThat(admin.getMetadata()).isNotNull();\n assertThat(admin.getMetadata().getFinalizers()).isNotNull();\n assertThat(admin.getMetadata().getFinalizers())\n .contains(MetadataUtil.SYSTEM_FINALIZER);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/DefaultUserDetailServiceTest.java", "content": "package run.halo.app.security;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertInstanceOf;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.core.authority.AuthorityUtils.authorityListToSet;\n\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.security.core.AuthenticationException;\nimport org.springframework.security.core.userdetails.User;\nimport org.springframework.security.core.userdetails.UserDetails;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.exception.UserNotFoundException;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultUserDetailServiceTest {\n\n @Mock\n UserService userService;\n\n @Mock\n RoleService roleService;\n\n @InjectMocks\n DefaultUserDetailService userDetailService;\n\n @Test\n void shouldUpdatePasswordSuccessfully() {\n var fakeUser = createFakeUserDetails();\n\n var user = new run.halo.app.core.extension.User();\n\n when(userService.updatePassword(\"faker\", \"new-fake-password\")).thenReturn(\n Mono.just(user)\n );\n\n var userDetailsMono = userDetailService.updatePassword(fakeUser, \"new-fake-password\");\n\n StepVerifier.create(userDetailsMono)\n .expectSubscription()\n .assertNext(userDetails -> assertEquals(\"new-fake-password\", userDetails.getPassword()))\n .verifyComplete();\n\n verify(userService, times(1)).updatePassword(eq(\"faker\"), eq(\"new-fake-password\"));\n }\n\n @Test\n void shouldReturnErrorWhenFailedToUpdatePassword() {\n var fakeUser = createFakeUserDetails();\n\n var exception = new RuntimeException(\"failed to update password\");\n when(userService.updatePassword(\"faker\", \"new-fake-password\")).thenReturn(\n Mono.error(exception)\n );\n\n var userDetailsMono = userDetailService.updatePassword(fakeUser, \"new-fake-password\");\n\n StepVerifier.create(userDetailsMono)\n .expectSubscription()\n .expectErrorMatches(throwable -> throwable == exception)\n .verify();\n verify(userService, times(1)).updatePassword(eq(\"faker\"), eq(\"new-fake-password\"));\n }\n\n @Test\n void shouldFindUserDetailsByExistingUsername() {\n var foundUser = createFakeUser();\n\n when(userService.getUser(\"faker\")).thenReturn(Mono.just(foundUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.just(\"fake-role\"));\n\n var userDetailsMono = userDetailService.findByUsername(\"faker\");\n\n StepVerifier.create(userDetailsMono)\n .expectSubscription()\n .assertNext(gotUser -> {\n assertEquals(foundUser.getMetadata().getName(), gotUser.getUsername());\n assertEquals(foundUser.getSpec().getPassword(), gotUser.getPassword());\n assertEquals(\n Set.of(\"ROLE_fake-role\", \"ROLE_authenticated\", \"ROLE_anonymous\"),\n authorityListToSet(gotUser.getAuthorities()));\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFindHaloUserDetailsWith2faDisabledWhen2faNotEnabled() {\n var fakeUser = createFakeUser();\n when(userService.getUser(\"faker\")).thenReturn(Mono.just(fakeUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.empty());\n userDetailService.findByUsername(\"faker\")\n .as(StepVerifier::create)\n .assertNext(userDetails -> {\n assertInstanceOf(HaloUserDetails.class, userDetails);\n assertFalse(((HaloUserDetails) userDetails).isTwoFactorAuthEnabled());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFindHaloUserDetailsWith2faDisabledWhen2faEnabledButNoTotpConfigured() {\n var fakeUser = createFakeUser();\n fakeUser.getSpec().setTwoFactorAuthEnabled(true);\n when(userService.getUser(\"faker\")).thenReturn(Mono.just(fakeUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.empty());\n userDetailService.findByUsername(\"faker\")\n .as(StepVerifier::create)\n .assertNext(userDetails -> {\n assertInstanceOf(HaloUserDetails.class, userDetails);\n assertFalse(((HaloUserDetails) userDetails).isTwoFactorAuthEnabled());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFindHaloUserDetailsWith2faEnabledWhen2faEnabledAndTotpConfigured() {\n var fakeUser = createFakeUser();\n fakeUser.getSpec().setTwoFactorAuthEnabled(true);\n fakeUser.getSpec().setTotpEncryptedSecret(\"fake-totp-encrypted-secret\");\n when(userService.getUser(\"faker\")).thenReturn(Mono.just(fakeUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.empty());\n userDetailService.findByUsername(\"faker\")\n .as(StepVerifier::create)\n .assertNext(userDetails -> {\n assertInstanceOf(HaloUserDetails.class, userDetails);\n assertTrue(((HaloUserDetails) userDetails).isTwoFactorAuthEnabled());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFindHaloUserDetailsWith2faDisabledWhen2faDisabledGlobally() {\n userDetailService.setTwoFactorAuthDisabled(true);\n var fakeUser = createFakeUser();\n fakeUser.getSpec().setTwoFactorAuthEnabled(true);\n fakeUser.getSpec().setTotpEncryptedSecret(\"fake-totp-encrypted-secret\");\n when(userService.getUser(\"faker\")).thenReturn(Mono.just(fakeUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.empty());\n userDetailService.findByUsername(\"faker\")\n .as(StepVerifier::create)\n .assertNext(userDetails -> {\n assertInstanceOf(HaloUserDetails.class, userDetails);\n assertFalse(((HaloUserDetails) userDetails).isTwoFactorAuthEnabled());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFindUserDetailsByExistingUsernameButWithoutAnyRoles() {\n var foundUser = createFakeUser();\n\n when(userService.getUser(\"faker\")).thenReturn(Mono.just(foundUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.empty());\n\n StepVerifier.create(userDetailService.findByUsername(\"faker\"))\n .expectSubscription()\n .assertNext(gotUser -> {\n assertEquals(foundUser.getMetadata().getName(), gotUser.getUsername());\n assertEquals(foundUser.getSpec().getPassword(), gotUser.getPassword());\n assertEquals(\n Set.of(\"ROLE_anonymous\", \"ROLE_authenticated\"),\n authorityListToSet(gotUser.getAuthorities()));\n })\n .verifyComplete();\n }\n\n @Test\n void shouldNotFindUserDetailsByNonExistingUsername() {\n when(userService.getUser(\"non-existing-user\")).thenReturn(\n Mono.error(() -> new UserNotFoundException(\"non-existing-user\")));\n\n var userDetailsMono = userDetailService.findByUsername(\"non-existing-user\");\n\n StepVerifier.create(userDetailsMono)\n .expectError(AuthenticationException.class)\n .verify();\n }\n\n @Test\n void shouldFindUserDetailsByEmail() {\n var foundUser = createFakeUser();\n\n when(userService.findUserByVerifiedEmail(\"faker@halo.run\"))\n .thenReturn(Mono.just(foundUser));\n when(roleService.getRolesByUsername(\"faker\")).thenReturn(Flux.just(\"fake-role\"));\n\n var userDetailsMono = userDetailService.findByUsername(\"faker@halo.run\");\n\n StepVerifier.create(userDetailsMono)\n .expectSubscription()\n .assertNext(gotUser -> {\n assertEquals(foundUser.getMetadata().getName(), gotUser.getUsername());\n assertEquals(foundUser.getSpec().getPassword(), gotUser.getPassword());\n assertEquals(\n Set.of(\"ROLE_fake-role\", \"ROLE_authenticated\", \"ROLE_anonymous\"),\n authorityListToSet(gotUser.getAuthorities()));\n })\n .verifyComplete();\n\n verify(userService, never()).getUser(any());\n }\n\n @Test\n void shouldReturnNotFoundWhenEmailNotExists() {\n when(userService.findUserByVerifiedEmail(\"non-existing-email@halo.run\"))\n .thenReturn(Mono.error(new UserNotFoundException(\"non-existing-email@halo.run\")));\n\n var userDetailsMono = userDetailService.findByUsername(\"non-existing-email@halo.run\");\n\n StepVerifier.create(userDetailsMono)\n .expectError(BadCredentialsException.class)\n .verify();\n }\n\n UserDetails createFakeUserDetails() {\n return User.builder()\n .username(\"faker\")\n .password(\"fake-password\")\n .roles(\"fake-role\")\n .build();\n }\n\n run.halo.app.core.extension.User createFakeUser() {\n var metadata = new Metadata();\n metadata.setName(\"faker\");\n\n var userSpec = new run.halo.app.core.extension.User.UserSpec();\n userSpec.setPassword(\"fake-password\");\n\n var user = new run.halo.app.core.extension.User();\n user.setMetadata(metadata);\n user.setSpec(userSpec);\n return user;\n\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/HaloServerRequestCacheTest.java", "content": "package run.halo.app.security;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.web.server.session.DefaultWebSessionManager;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\n\nclass HaloServerRequestCacheTest {\n\n HaloServerRequestCache requestCache;\n\n @BeforeEach\n void setUp() {\n requestCache = new HaloServerRequestCache();\n }\n\n @Test\n void shouldNotSaveIfPageNotCacheable() {\n var mockExchange =\n MockServerWebExchange.from(MockServerHttpRequest.get(\"/login\"));\n requestCache.saveRequest(mockExchange)\n .then(requestCache.getRedirectUri(mockExchange))\n .as(StepVerifier::create)\n .verifyComplete();\n }\n\n @Test\n void shouldSaveIfPageCacheable() {\n var mockExchange = MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/archives\")\n .queryParam(\"q\", \"v\")\n .accept(MediaType.TEXT_HTML)\n );\n requestCache.saveRequest(mockExchange)\n .then(requestCache.getRedirectUri(mockExchange))\n .as(StepVerifier::create)\n .expectNext(URI.create(\"/archives?q=v\"))\n .verifyComplete();\n }\n\n @Test\n void shouldSaveIfRedirectUriPresent() {\n var mockExchange = MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/login\")\n .queryParam(\"redirect_uri\", \"/halo?q=v#fragment\")\n );\n requestCache.saveRequest(mockExchange)\n .then(requestCache.getRedirectUri(mockExchange))\n .as(StepVerifier::create)\n .expectNext(URI.create(\"/halo?q=v#fragment\"))\n .verifyComplete();\n }\n\n @Test\n void shouldRemoveIfRedirectUriFound() {\n var sessionManager = new DefaultWebSessionManager();\n var mockExchange = MockServerWebExchange.builder(MockServerHttpRequest.get(\"/login\")\n .queryParam(\"redirect_uri\", \"/halo\")\n )\n .sessionManager(sessionManager)\n .build();\n var removeExchange = mockExchange.mutate()\n .request(builder -> builder.uri(URI.create(\"/halo\")))\n .build();\n requestCache.saveRequest(mockExchange)\n .then(Mono.defer(() -> requestCache.removeMatchingRequest(removeExchange)))\n .as(StepVerifier::create)\n .assertNext(request -> {\n Assertions.assertEquals(URI.create(\"/halo\"), request.getURI());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldRemoveIfRedirectUriFoundAndContainsFragment() {\n var sessionManager = new DefaultWebSessionManager();\n var mockExchange =\n MockServerWebExchange.builder(MockServerHttpRequest.get(\"/login\")\n .queryParam(\"redirect_uri\", \"/halo#fragment\")\n )\n .sessionManager(sessionManager)\n .build();\n var removeExchange = mockExchange.mutate()\n .request(builder -> builder.uri(URI.create(\"/halo\")))\n .build();\n requestCache.saveRequest(mockExchange)\n .then(Mono.defer(() -> requestCache.removeMatchingRequest(removeExchange)))\n .as(StepVerifier::create)\n .assertNext(request -> {\n Assertions.assertEquals(URI.create(\"/halo\"), request.getURI());\n })\n .verifyComplete();\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/InitializeRedirectionWebFilterTest.java", "content": "package run.halo.app.security;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.security.web.server.ServerRedirectStrategy;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.infra.InitializationStateGetter;\n\n/**\n * Tests for {@link InitializeRedirectionWebFilter}.\n *\n * @author guqing\n * @since 2.5.2\n */\n@ExtendWith(MockitoExtension.class)\nclass InitializeRedirectionWebFilterTest {\n\n @Mock\n private InitializationStateGetter initializationStateGetter;\n\n @Mock\n private ServerRedirectStrategy serverRedirectStrategy;\n\n @InjectMocks\n private InitializeRedirectionWebFilter filter;\n\n @BeforeEach\n void setUp() {\n filter.setRedirectStrategy(serverRedirectStrategy);\n }\n\n @Test\n void shouldRedirectWhenSystemNotInitialized() {\n when(initializationStateGetter.userInitialized()).thenReturn(Mono.just(false));\n\n WebFilterChain chain = mock(WebFilterChain.class);\n var paths = new String[] {\"/\", \"/console/test\", \"/uc/test\", \"/login\", \"/signup\"};\n for (String path : paths) {\n MockServerHttpRequest request = MockServerHttpRequest.get(path)\n .accept(MediaType.TEXT_HTML).build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n\n when(serverRedirectStrategy.sendRedirect(any(), any())).thenReturn(Mono.empty().then());\n\n Mono result = filter.filter(exchange, chain);\n\n StepVerifier.create(result)\n .expectNextCount(0)\n .expectComplete()\n .verify();\n\n verify(serverRedirectStrategy).sendRedirect(eq(exchange),\n eq(URI.create(\"/system/setup\")));\n verify(chain, never()).filter(eq(exchange));\n }\n }\n\n @Test\n void shouldNotRedirectWhenSystemInitialized() {\n lenient().when(initializationStateGetter.userInitialized()).thenReturn(Mono.just(true));\n\n WebFilterChain chain = mock(WebFilterChain.class);\n\n var paths = new String[] {\"/test\", \"/apis/test\", \"system/setup\", \"/logout\"};\n for (String path : paths) {\n MockServerHttpRequest request = MockServerHttpRequest.get(path)\n .accept(MediaType.TEXT_HTML).build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n when(chain.filter(any())).thenReturn(Mono.empty().then());\n Mono result = filter.filter(exchange, chain);\n\n StepVerifier.create(result)\n .expectNextCount(0)\n .expectComplete()\n .verify();\n\n verify(serverRedirectStrategy, never()).sendRedirect(eq(exchange), any());\n verify(chain).filter(eq(exchange));\n }\n }\n\n @Test\n void shouldNotRedirectTest() {\n WebFilterChain chain = mock(WebFilterChain.class);\n\n MockServerHttpRequest request = MockServerHttpRequest.get(\"/test\")\n .accept(MediaType.TEXT_HTML).build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n when(chain.filter(any())).thenReturn(Mono.empty().then());\n Mono result = filter.filter(exchange, chain);\n\n StepVerifier.create(result)\n .expectNextCount(0)\n .expectComplete()\n .verify();\n\n verify(serverRedirectStrategy, never()).sendRedirect(eq(exchange), any());\n verify(chain).filter(eq(exchange));\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/ResponseMap.java", "content": "package run.halo.app.security;\n\nimport java.util.HashMap;\n\npublic class ResponseMap extends HashMap {\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/authentication/WebExchangeMatchersTest.java", "content": "package run.halo.app.security.authentication;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.springframework.http.MediaType.ALL;\nimport static org.springframework.http.MediaType.APPLICATION_JSON;\nimport static org.springframework.http.MediaType.TEXT_HTML;\nimport static run.halo.app.security.authentication.WebExchangeMatchers.ignoringMediaTypeAll;\n\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport reactor.test.StepVerifier;\n\nclass WebExchangeMatchersTest {\n\n @Test\n void shouldNotMatchMediaTypeAll() {\n assertion(Set.of(APPLICATION_JSON), Set.of(APPLICATION_JSON, ALL), true);\n assertion(Set.of(APPLICATION_JSON), Set.of(ALL), false);\n assertion(Set.of(APPLICATION_JSON), Set.of(APPLICATION_JSON), true);\n assertion(Set.of(APPLICATION_JSON), Set.of(APPLICATION_JSON, TEXT_HTML), true);\n }\n\n void assertion(Set matchingMediaTypes,\n Set acceptMediaTypes,\n boolean expectMatch) {\n var matcher = ignoringMediaTypeAll(matchingMediaTypes.toArray(new MediaType[0]));\n MockServerHttpRequest request = MockServerHttpRequest.get(\"/fake\")\n .accept(acceptMediaTypes.toArray(new MediaType[0]))\n .build();\n var webExchange = MockServerWebExchange.from(request);\n StepVerifier.create(matcher.matches(webExchange))\n .consumeNextWith(matchResult -> assertEquals(expectMatch, matchResult.isMatch()))\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/authentication/impl/RsaKeyServiceTest.java", "content": "package run.halo.app.security.authentication.impl;\n\nimport static com.nimbusds.jose.jwk.KeyOperation.SIGN;\nimport static com.nimbusds.jose.jwk.KeyOperation.VERIFY;\nimport static org.junit.jupiter.api.Assertions.assertArrayEquals;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport com.nimbusds.jose.JOSEException;\nimport com.nimbusds.jose.JWSAlgorithm;\nimport com.nimbusds.jose.jwk.KeyUse;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.security.InvalidKeyException;\nimport java.security.KeyFactory;\nimport java.security.NoSuchAlgorithmException;\nimport java.security.interfaces.RSAPrivateCrtKey;\nimport java.security.interfaces.RSAPublicKey;\nimport java.security.spec.InvalidKeySpecException;\nimport java.security.spec.PKCS8EncodedKeySpec;\nimport java.security.spec.X509EncodedKeySpec;\nimport java.util.Set;\nimport javax.crypto.BadPaddingException;\nimport javax.crypto.Cipher;\nimport javax.crypto.IllegalBlockSizeException;\nimport javax.crypto.NoSuchPaddingException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.util.StringUtils;\nimport reactor.core.Exceptions;\nimport reactor.test.StepVerifier;\nimport run.halo.app.security.authentication.login.InvalidEncryptedMessageException;\n\n@ExtendWith(MockitoExtension.class)\nclass RsaKeyServiceTest {\n\n RsaKeyService service;\n\n @TempDir\n Path tempDir;\n\n @BeforeEach\n void setUp() throws JOSEException {\n service = new RsaKeyService(tempDir);\n service.afterPropertiesSet();\n }\n\n @Test\n void shouldGenerateKeyPair()\n throws IOException, NoSuchAlgorithmException, InvalidKeySpecException {\n byte[] privKeyBytes = Files.readAllBytes(tempDir.resolve(\"pat_id_rsa\"));\n byte[] pubKeyBytes = Files.readAllBytes(tempDir.resolve(\"pat_id_rsa.pub\"));\n\n var pubKeySpec = new X509EncodedKeySpec(pubKeyBytes);\n var privKeySpec = new PKCS8EncodedKeySpec(privKeyBytes);\n var keyFactory = KeyFactory.getInstance(RsaKeyService.ALGORITHM);\n var privKey = (RSAPrivateCrtKey) keyFactory.generatePrivate(privKeySpec);\n var pubKey = (RSAPublicKey) keyFactory.generatePublic(pubKeySpec);\n assertEquals(privKey.getModulus(), pubKey.getModulus());\n assertEquals(privKey.getPublicExponent(), pubKey.getPublicExponent());\n }\n\n @Test\n void shouldReadPublicKey() throws IOException {\n var realPubKeyBytes = Files.readAllBytes(tempDir.resolve(\"pat_id_rsa.pub\"));\n\n StepVerifier.create(service.readPublicKey())\n .assertNext(bytes -> assertArrayEquals(realPubKeyBytes, bytes))\n .verifyComplete();\n }\n\n @Test\n void shouldDecryptMessageCorrectly() {\n final String message = \"halo\";\n\n var mono = service.readPublicKey()\n .map(pubKeyBytes -> {\n var pubKeySpec = new X509EncodedKeySpec(pubKeyBytes);\n try {\n var keyFactory = KeyFactory.getInstance(RsaKeyService.ALGORITHM);\n var pubKey = keyFactory.generatePublic(pubKeySpec);\n var cipher = Cipher.getInstance(RsaKeyService.TRANSFORMATION);\n cipher.init(Cipher.ENCRYPT_MODE, pubKey);\n return cipher.doFinal(message.getBytes());\n } catch (NoSuchAlgorithmException | InvalidKeySpecException\n | NoSuchPaddingException | InvalidKeyException | IllegalBlockSizeException\n | BadPaddingException e) {\n throw Exceptions.propagate(e);\n }\n })\n .flatMap(service::decrypt)\n .map(String::new);\n\n StepVerifier.create(mono)\n .expectNext(message)\n .verifyComplete();\n }\n\n @Test\n void shouldFailToDecryptMessage() {\n StepVerifier.create(service.decrypt(\"invalid-bytes\".getBytes()))\n .verifyError(InvalidEncryptedMessageException.class);\n }\n\n @Test\n void shouldGetKeyIdFromJwk() {\n assertTrue(StringUtils.hasText(service.getKeyId()));\n }\n\n @Test\n void shouldGetJwk() {\n var jwk = service.getJwk();\n assertEquals(\"RSA\", jwk.getKeyType().getValue());\n assertEquals(JWSAlgorithm.RS256, jwk.getAlgorithm());\n assertEquals(KeyUse.SIGNATURE, jwk.getKeyUse());\n assertEquals(Set.of(SIGN, VERIFY), jwk.getKeyOperations());\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/authentication/login/LoginAuthenticationConverterTest.java", "content": "package run.halo.app.security.authentication.login;\n\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport io.github.resilience4j.ratelimiter.RateLimiter;\nimport io.github.resilience4j.ratelimiter.RateLimiterConfig;\nimport io.github.resilience4j.ratelimiter.RateLimiterRegistry;\nimport java.time.Duration;\nimport java.util.Base64;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.server.reactive.ServerHttpRequest;\nimport org.springframework.security.authentication.BadCredentialsException;\nimport org.springframework.security.authentication.UsernamePasswordAuthenticationToken;\nimport org.springframework.util.LinkedMultiValueMap;\nimport org.springframework.util.MultiValueMap;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.security.authentication.CryptoService;\nimport run.halo.app.security.authentication.exception.TooManyRequestsException;\n\n@ExtendWith(MockitoExtension.class)\nclass LoginAuthenticationConverterTest {\n\n @Mock\n ServerWebExchange exchange;\n\n @Mock\n CryptoService cryptoService;\n\n @Mock\n RateLimiterRegistry rateLimiterRegistry;\n\n @InjectMocks\n LoginAuthenticationConverter converter;\n\n MultiValueMap formData;\n\n @BeforeEach\n void setUp() {\n formData = new LinkedMultiValueMap<>();\n lenient().when(exchange.getFormData()).thenReturn(Mono.just(formData));\n var request = mock(ServerHttpRequest.class);\n var headers = new HttpHeaders();\n\n when(request.getHeaders()).thenReturn(headers);\n when(exchange.getRequest()).thenReturn(request);\n when(rateLimiterRegistry.rateLimiter(\"authentication-from-ip-unknown\",\n \"authentication\"))\n .thenReturn(RateLimiter.ofDefaults(\"authentication\"));\n }\n\n @Test\n void shouldTriggerRateLimit() {\n var username = \"username\";\n var password = \"password\";\n\n formData.add(\"username\", username);\n formData.add(\"password\", Base64.getEncoder().encodeToString(password.getBytes()));\n var rateLimiter = RateLimiter.of(\"authentication\", RateLimiterConfig.custom()\n .limitForPeriod(1)\n .limitRefreshPeriod(Duration.ofSeconds(1))\n .timeoutDuration(Duration.ofMillis(0))\n .build());\n assertTrue(rateLimiter.acquirePermission(1));\n when(rateLimiterRegistry.rateLimiter(\"authentication-from-ip-unknown\", \"authentication\"))\n .thenReturn(rateLimiter);\n StepVerifier.create(converter.convert(exchange))\n .expectError(TooManyRequestsException.class)\n .verify();\n\n verify(cryptoService, never()).decrypt(password.getBytes());\n }\n\n @Test\n void applyUsernameAndPasswordThenCreatesTokenSuccess() {\n var username = \"username\";\n var password = \"password\";\n var decryptedPassword = \"decrypted password\";\n\n formData.add(\"username\", username);\n formData.add(\"password\", Base64.getEncoder().encodeToString(password.getBytes()));\n\n when(cryptoService.decrypt(password.getBytes()))\n .thenReturn(Mono.just(decryptedPassword.getBytes()));\n StepVerifier.create(converter.convert(exchange))\n .expectNext(new UsernamePasswordAuthenticationToken(username, decryptedPassword))\n .verifyComplete();\n\n verify(cryptoService).decrypt(password.getBytes());\n }\n\n @Test\n void applyPasswordWithoutBase64FormatThenBadCredentialsException() {\n var username = \"username\";\n var password = \"+invalid-base64-format-password\";\n\n formData.add(\"username\", username);\n formData.add(\"password\", password);\n\n StepVerifier.create(converter.convert(exchange))\n .verifyError(BadCredentialsException.class);\n }\n\n @Test\n void applyUsernameAndInvalidPasswordThenBadCredentialsException() {\n var username = \"username\";\n var password = \"password\";\n\n formData.add(\"username\", username);\n formData.add(\"password\", Base64.getEncoder().encodeToString(password.getBytes()));\n\n when(cryptoService.decrypt(password.getBytes()))\n .thenReturn(Mono.error(() -> new InvalidEncryptedMessageException(\"invalid message\")));\n StepVerifier.create(converter.convert(exchange))\n .verifyError(BadCredentialsException.class);\n verify(cryptoService).decrypt(password.getBytes());\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/security/authentication/login/PublicKeyRouteBuilderTest.java", "content": "package run.halo.app.security.authentication.login;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Base64;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.authentication.CryptoService;\n\n@ExtendWith(MockitoExtension.class)\nclass PublicKeyRouteBuilderTest {\n\n WebTestClient webClient;\n\n @Mock\n CryptoService cryptoService;\n\n @BeforeEach\n void setUp() {\n webClient = WebTestClient.bindToRouterFunction(\n new PublicKeyRouteBuilder(cryptoService).build()\n ).build();\n }\n\n @Test\n void shouldReadPublicKey() {\n var publicKeyStr = \"public-key\";\n var encoder = Base64.getEncoder();\n when(cryptoService.readPublicKey()).thenReturn(Mono.just(publicKeyStr.getBytes()));\n webClient.get().uri(\"/login/public-key\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(PublicKeyRouteBuilder.PublicKeyResponse.class)\n .consumeWith(result -> {\n var response = result.getResponseBody();\n assertNotNull(response);\n assertEquals(encoder.encodeToString(publicKeyStr.getBytes()),\n response.getBase64Format());\n });\n\n verify(cryptoService).readPublicKey();\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/authentication/pat/PatTest.java", "content": "package run.halo.app.security.authentication.pat;\n\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport run.halo.app.security.PersonalAccessToken;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass PatTest {\n\n @Autowired\n WebTestClient webClient;\n\n @Test\n @WithMockUser(username = \"faker\", password = \"${noop}password\", roles = \"super-role\")\n void generatePat() {\n var requestPat = new PersonalAccessToken();\n var spec = requestPat.getSpec();\n spec.setRoles(List.of(\"super-role\"));\n spec.setName(\"Fake PAT\");\n webClient.post()\n .uri(\"/apis/uc.api.security.halo.run/v1alpha1/personalaccesstokens\")\n .bodyValue(requestPat)\n .exchange()\n .expectStatus().isOk()\n .expectBody(PersonalAccessToken.class)\n .value(pat -> {\n var annotations = pat.getMetadata().getAnnotations();\n assertTrue(annotations.containsKey(\"security.halo.run/access-token\"));\n });\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/authentication/rememberme/PersistentTokenBasedRememberMeServicesTest.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport java.util.Date;\nimport java.util.concurrent.atomic.AtomicReference;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.security.authentication.UsernamePasswordAuthenticationToken;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.web.authentication.rememberme.CookieTheftException;\nimport org.springframework.security.web.authentication.rememberme.InvalidCookieException;\nimport org.springframework.security.web.authentication.rememberme.PersistentRememberMeToken;\nimport org.springframework.security.web.authentication.rememberme.RememberMeAuthenticationException;\nimport org.springframework.security.web.server.WebFilterExchange;\nimport reactor.core.publisher.Mono;\n\n/**\n * Tests for {@link PersistentTokenBasedRememberMeServices}.\n *\n * @author guqing\n * @since 2.17.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PersistentTokenBasedRememberMeServicesTest {\n @Mock\n private CookieSignatureKeyResolver cookieSignatureKeyResolver;\n\n @Mock\n private ReactiveUserDetailsService userDetailsService;\n\n @Mock\n private RememberMeCookieResolver rememberMeCookieResolver;\n\n @Mock\n private PersistentRememberMeTokenRepository tokenRepository;\n\n @InjectMocks\n private PersistentTokenBasedRememberMeServices persistentTokenBasedRememberMeServices;\n\n @Nested\n class ProcessAutoLoginCookieTest {\n @Test\n void invalidCookieTest() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\"));\n assertThatThrownBy(() -> persistentTokenBasedRememberMeServices.processAutoLoginCookie(\n new String[] {\"test\"},\n exchange).block())\n .isInstanceOf(InvalidCookieException.class)\n .hasMessage(\"Cookie token did not contain 2 tokens, but contained '[test]'\");\n }\n\n @Test\n void noPersistentTokenFoundTest() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\"));\n when(tokenRepository.getTokenForSeries(eq(\"test-series\")))\n .thenReturn(Mono.empty());\n\n assertThatThrownBy(() -> persistentTokenBasedRememberMeServices.processAutoLoginCookie(\n new String[] {\"test-series\", \"test\"},\n exchange).block()\n ).isInstanceOf(RememberMeAuthenticationException.class)\n .hasMessage(\"No persistent token found for series id: test-series\");\n }\n\n @Test\n void tokenMismatchTest() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\"));\n when(tokenRepository.getTokenForSeries(eq(\"fake-series\")))\n .thenReturn(Mono.just(\n new PersistentRememberMeToken(\"test\", \"fake-series\", \"other-token-value\",\n new Date()))\n );\n when(tokenRepository.removeUserTokens(eq(\"test\"))).thenReturn(Mono.empty());\n assertThatThrownBy(() -> persistentTokenBasedRememberMeServices.processAutoLoginCookie(\n new String[] {\"fake-series\", \"token-value\"},\n exchange).block())\n .isInstanceOf(CookieTheftException.class)\n .hasMessage(\n \"Invalid remember-me token (Series/token) mismatch. Implies previous cookie \"\n + \"theft attack.\");\n }\n\n @Test\n void rememberMeLoginExpiredTest() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\"));\n when(tokenRepository.getTokenForSeries(eq(\"fake-series\")))\n .thenReturn(Mono.just(\n new PersistentRememberMeToken(\"test\", \"fake-series\", \"token-value\",\n new Date(Instant.now().minusSeconds(10).toEpochMilli())))\n );\n when(rememberMeCookieResolver.getCookieMaxAge()).thenReturn(Duration.ofSeconds(5));\n assertThatThrownBy(() -> persistentTokenBasedRememberMeServices.processAutoLoginCookie(\n new String[] {\"fake-series\", \"token-value\"},\n exchange).block())\n .isInstanceOf(RememberMeAuthenticationException.class)\n .hasMessage(\"Remember-me login has expired\");\n }\n\n @Test\n void successfulTest() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\"));\n when(tokenRepository.getTokenForSeries(eq(\"fake-series\")))\n .thenReturn(Mono.just(\n new PersistentRememberMeToken(\"test\", \"fake-series\", \"token-value\",\n new Date()))\n );\n when(rememberMeCookieResolver.getCookieMaxAge()).thenReturn(Duration.ofSeconds(5));\n\n var generatedTokenValue = new AtomicReference();\n when(tokenRepository.updateToken(eq(\"fake-series\"), any(), any()))\n .thenAnswer(invocation -> {\n var tokenValue = (String) invocation.getArgument(1);\n generatedTokenValue.compareAndSet(null, tokenValue);\n return Mono.empty();\n });\n\n when(userDetailsService.findByUsername(eq(\"test\"))).thenReturn(Mono.empty());\n\n persistentTokenBasedRememberMeServices.processAutoLoginCookie(\n new String[] {\"fake-series\", \"token-value\"}, exchange)\n .block();\n\n verify(rememberMeCookieResolver).setRememberMeCookie(eq(exchange),\n eq(persistentTokenBasedRememberMeServices.encodeCookie(\n new String[] {\"fake-series\", generatedTokenValue.get()})));\n }\n }\n\n @Test\n void onLoginSuccessTest() {\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/\"));\n var authentication = new UsernamePasswordAuthenticationToken(\"test\", \"test\");\n\n when(tokenRepository.createNewToken(any())).thenReturn(Mono.empty());\n persistentTokenBasedRememberMeServices.onLoginSuccess(exchange, authentication).block();\n\n verify(rememberMeCookieResolver).setRememberMeCookie(eq(exchange), any());\n }\n\n @Test\n void onLogoutTest() {\n var authentication = new UsernamePasswordAuthenticationToken(\"test\", \"test\");\n\n when(tokenRepository.removeUserTokens(eq(\"test\"))).thenReturn(Mono.empty());\n\n var filterExchange = mock(WebFilterExchange.class);\n persistentTokenBasedRememberMeServices.onLogout(filterExchange, authentication).block();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/authentication/rememberme/RememberTokenCleanerTest.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.spy;\n\nimport java.time.Duration;\nimport java.time.Instant;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\n\n/**\n * Test for {@link RememberTokenCleaner}.\n *\n * @author guqing\n * @since 2.17.0\n */\n@ExtendWith(MockitoExtension.class)\nclass RememberTokenCleanerTest {\n @InjectMocks\n private RememberTokenCleaner rememberTokenCleaner;\n\n @Test\n void test() {\n var spyRememberTokenCleaner = spy(rememberTokenCleaner);\n Mockito.doReturn(Duration.ofSeconds(30)).when(spyRememberTokenCleaner).getTokenValidity();\n var expiredTime = spyRememberTokenCleaner.getExpirationThreshold();\n\n var creationTime = Instant.now().minus(Duration.ofSeconds(31));\n // creationTime < expirationThreshold means it has expired\n assertThat(creationTime).isBefore(expiredTime);\n\n // not expired\n creationTime = Instant.now().minus(Duration.ofSeconds(29));\n assertThat(creationTime).isAfter(expiredTime);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/authentication/rememberme/TokenBasedRememberMeServicesTest.java", "content": "package run.halo.app.security.authentication.rememberme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.security.authentication.TestingAuthenticationToken;\nimport org.springframework.security.core.userdetails.User;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\n\n/**\n * Tests for {@link TokenBasedRememberMeServices}.\n *\n * @author guqing\n * @since 2.16.0\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\nclass TokenBasedRememberMeServicesTest {\n\n @Mock\n CookieSignatureKeyResolver cookieSignatureKeyResolver;\n\n @InjectMocks\n private TokenBasedRememberMeServices tokenBasedRememberMeServices;\n\n @Test\n void retrieveUserName() {\n var authentication = new TestingAuthenticationToken(\"fake-user\", \"test\");\n var username = tokenBasedRememberMeServices.retrieveUserName(authentication);\n\n var userDetails = new User(\"zhangsan\", \"test\", List.of());\n authentication = new TestingAuthenticationToken(userDetails, \"test\");\n username = tokenBasedRememberMeServices.retrieveUserName(authentication);\n assertThat(username).isEqualTo(\"zhangsan\");\n }\n\n @Test\n void makeTokenSignatureTest() {\n when(cookieSignatureKeyResolver.resolveSigningKey()).thenReturn(Mono.just(\"fake-key\"));\n var expireMs = 1716435187323L;\n tokenBasedRememberMeServices.makeTokenSignature(expireMs, \"fake-user\", \"pwd-1\",\n TokenBasedRememberMeServices.DEFAULT_ALGORITHM)\n .as(StepVerifier::create)\n .expectNext(\"29f1c7ccbb489741392d27ba5c30f30d05c79ee66289b6d6da5b431bba99a0c7\")\n .verifyComplete();\n }\n\n @Test\n void encodeCookieTest() {\n var expireMs = 1716435187323L;\n var cookieTokens = new String[] {\"fake-user\", Long.toString(expireMs),\n TokenBasedRememberMeServices.DEFAULT_ALGORITHM,\n \"29f1c7ccbb489741392d27ba5c30f30d05c79ee66289b6d6da5b431bba99a0c7\"};\n var encode = tokenBasedRememberMeServices.encodeCookie(cookieTokens);\n assertThat(encode)\n .isEqualTo(\"ZmFrZS11c2VyOjE3MTY0MzUxODczMjM6U0hBLTI1NjoyOWYxYzdjY2JiNDg5NzQxMz\"\n + \"kyZDI3YmE1YzMwZjMwZDA1Yzc5ZWU2NjI4OWI2ZDZkYTViNDMxYmJhOTlhMGM3\");\n }\n\n @Test\n void decodeCookieTest() {\n var cookieValue = \"YWRtaW46MTcxODk2NDE3NDgwODpTSEE\"\n + \"tMjU2OmNkOTM0ZTAyZWQ4NGJmMzc1ZTA4MmE1OWU4YTA3NTNiMzA3ODg1MjZmYzA3Yjgy\"\n + \"YzVmY2Y3YmJiYzdjYzRkNWU\";\n // 123 % 4 = 3, so we need to add 1 '=' to make it a multiple of 4 for\n // spring-security/gh-15127\n assertThat(cookieValue.length()).isEqualTo(123);\n var cookie = tokenBasedRememberMeServices.decodeCookie(cookieValue);\n assertThat(cookie).containsExactly(\"admin\", \"1718964174808\", \"SHA-256\",\n \"cd934e02ed84bf375e082a59e8a0753b30788526fc07b82c5fcf7bbbc7cc4d5e\");\n\n cookieValue = \"ZmFrZS11c2VyOjE3MTY0MzUxODczMjM6U0hBLTI1NjoyOWYxYzdjY2JiNDg5NzQxMz\"\n + \"kyZDI3YmE1YzMwZjMwZDA1Yzc5ZWU2NjI4OWI2ZDZkYTViNDMxYmJhOTlhMGM3\";\n assertThat(cookieValue.length()).isEqualTo(128);\n cookie = tokenBasedRememberMeServices.decodeCookie(cookieValue);\n assertThat(cookie).containsExactly(\"fake-user\", \"1716435187323\", \"SHA-256\",\n \"29f1c7ccbb489741392d27ba5c30f30d05c79ee66289b6d6da5b431bba99a0c7\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/authentication/twofactor/TwoFactorAuthSettingsTest.java", "content": "package run.halo.app.security.authentication.twofactor;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.params.provider.Arguments.arguments;\n\nimport java.util.stream.Stream;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\n\nclass TwoFactorAuthSettingsTest {\n\n @ParameterizedTest\n @MethodSource(\"isAvailableCases\")\n void isAvailableTest(TwoFactorAuthSettings settings, boolean expectAvailable) {\n assertEquals(expectAvailable, settings.isAvailable());\n }\n\n static Stream isAvailableCases() {\n return Stream.of(\n arguments(settings(false, true, true), false),\n arguments(settings(false, false, false), false),\n arguments(settings(false, false, true), false),\n arguments(settings(false, true, false), false),\n arguments(settings(true, true, true), true),\n arguments(settings(true, false, false), false),\n arguments(settings(true, false, true), true),\n arguments(settings(true, true, false), false)\n );\n }\n\n static TwoFactorAuthSettings settings(boolean enabled, boolean emailVerified,\n boolean totpConfigured) {\n var settings = new TwoFactorAuthSettings();\n settings.setEnabled(enabled);\n settings.setEmailVerified(emailVerified);\n settings.setTotpConfigured(totpConfigured);\n return settings;\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/security/authorization/AuthorityUtilsTest.java", "content": "package run.halo.app.security.authorization;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static run.halo.app.security.authorization.AuthorityUtils.authoritiesToRoles;\nimport static run.halo.app.security.authorization.AuthorityUtils.containsSuperRole;\n\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.security.core.authority.SimpleGrantedAuthority;\n\nclass AuthorityUtilsTest {\n\n @Test\n void authoritiesToRolesTest() {\n var authorities = List.of(\n new SimpleGrantedAuthority(\"ROLE_admin\"),\n new SimpleGrantedAuthority(\"ROLE_owner\"),\n new SimpleGrantedAuthority(\"ROLE_manager\"),\n new SimpleGrantedAuthority(\"faker\"),\n new SimpleGrantedAuthority(\"SCOPE_system:read\")\n );\n\n var roles = authoritiesToRoles(authorities);\n\n assertEquals(Set.of(\"admin\", \"owner\", \"manager\"), roles);\n }\n\n @Test\n void containsSuperRoleTest() {\n assertTrue(containsSuperRole(Set.of(\"super-role\")));\n assertTrue(containsSuperRole(Set.of(\"super-role\", \"admin\")));\n assertFalse(containsSuperRole(Set.of(\"admin\")));\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/security/authorization/AuthorizationTest.java", "content": "package run.halo.app.security.authorization;\n\nimport static org.mockito.ArgumentMatchers.anySet;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\nimport static run.halo.app.core.extension.Role.ROLE_AGGREGATE_LABEL_PREFIX;\n\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Import;\nimport org.springframework.http.MediaType;\nimport org.springframework.lang.NonNull;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsPasswordService;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.Role.PolicyRule;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.AnonymousUserConst;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\n@DirtiesContext\n@Import(AuthorizationTest.TestConfig.class)\nclass AuthorizationTest {\n\n @Autowired\n WebTestClient webClient;\n\n @MockitoSpyBean\n ReactiveUserDetailsService userDetailsService;\n\n @MockitoSpyBean\n ReactiveUserDetailsPasswordService userDetailsPasswordService;\n\n @MockitoSpyBean\n RoleService roleService;\n\n @Autowired\n ExtensionClient client;\n\n @BeforeEach\n void setUp() {\n webClient = webClient.mutateWith(csrf());\n }\n\n @Test\n void anonymousUserAccessProtectedApi() {\n when(userDetailsService.findByUsername(eq(AnonymousUserConst.PRINCIPAL)))\n .thenReturn(Mono.empty());\n\n webClient.get().uri(\"/apis/fake.halo.run/v1/posts\")\n .header(\"X-Requested-With\", \"XMLHttpRequest\")\n .exchange()\n .expectStatus().isUnauthorized();\n\n webClient.get().uri(\"/apis/fake.halo.run/v1/posts\")\n .exchange()\n .expectStatus().isFound()\n .expectHeader().location(\"/login?authentication_required\");\n\n verify(roleService, times(2)).listDependenciesFlux(anySet());\n }\n\n @Test\n void anonymousUserAccessAuthenticationFreeApi() {\n when(userDetailsService.findByUsername(eq(AnonymousUserConst.PRINCIPAL)))\n .thenReturn(Mono.empty());\n Role role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(AnonymousUserConst.Role);\n role.setRules(new ArrayList<>());\n PolicyRule policyRule = new PolicyRule.Builder()\n .apiGroups(\"fake.halo.run\")\n .verbs(\"list\")\n .resources(\"posts\")\n .build();\n role.getRules().add(policyRule);\n when(roleService.listDependenciesFlux(anySet())).thenReturn(Flux.just(role));\n webClient.get().uri(\"/apis/fake.halo.run/v1/posts\").exchange().expectStatus()\n .isOk()\n .expectBody(String.class).isEqualTo(\"returned posts\");\n\n webClient.get().uri(\"/apis/fake.halo.run/v1/posts/hello-halo\")\n .header(\"X-Requested-With\", \"XMLHttpRequest\")\n .exchange()\n .expectStatus()\n .isUnauthorized();\n\n webClient.get().uri(\"/apis/fake.halo.run/v1/posts/hello-halo\")\n .exchange()\n .expectStatus()\n .isFound()\n .expectHeader().location(\"/login?authentication_required\");\n\n verify(roleService, times(3)).listDependenciesFlux(anySet());\n }\n\n @Test\n @WithMockUser(username = \"user\", roles = \"post.read\")\n void authenticatedUserAccessAuthenticationFreeApi() {\n Role role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(AnonymousUserConst.Role);\n role.setRules(new ArrayList<>());\n PolicyRule policyRule = new PolicyRule.Builder()\n .apiGroups(\"fake.halo.run\")\n .verbs(\"list\")\n .resources(\"posts\")\n .build();\n role.getRules().add(policyRule);\n\n when(roleService.listDependenciesFlux(anySet())).thenReturn(Flux.just(role));\n\n webClient.get().uri(\"/apis/fake.halo.run/v1/posts\").exchange().expectStatus()\n .isOk()\n .expectBody(String.class).isEqualTo(\"returned posts\");\n verify(roleService).listDependenciesFlux(anySet());\n }\n\n @Test\n void anonymousUserShouldAccessResourcesByAggregatedRoles() {\n // create a role\n var role = new Role();\n role.setMetadata(new Metadata());\n role.getMetadata().setName(\"fake-role-with-aggregate-to-anonymous\");\n role.getMetadata().setLabels(new HashMap<>(Map.of(\n ROLE_AGGREGATE_LABEL_PREFIX + AnonymousUserConst.Role, \"true\"\n )));\n role.setRules(new ArrayList<>());\n var policyRule = new PolicyRule.Builder()\n .apiGroups(\"fake.halo.run\")\n .verbs(\"list\")\n .resources(\"fakes\")\n .build();\n role.getRules().add(policyRule);\n client.create(role);\n\n webClient.get().uri(\"/apis/fake.halo.run/v1/fakes\").exchange()\n .expectStatus()\n .isOk();\n }\n\n @TestConfiguration\n static class TestConfig {\n\n @Bean\n public RouterFunction postRoute() {\n return RouterFunctions.route()\n .GET(\"/apis/fake.halo.run/v1/posts\", request -> ServerResponse.ok()\n .contentType(MediaType.TEXT_PLAIN)\n .bodyValue(\"returned posts\")\n )\n .PUT(\"/apis/fake.halo.run/v1/posts/{name}\", request -> ServerResponse.ok()\n .contentType(MediaType.TEXT_PLAIN)\n .bodyValue(\"updated post \" + request.pathVariable(\"name\"))\n )\n .GET(\"/apis/fake.halo.run/v1/fakes\", request -> ServerResponse.ok().build())\n .build();\n }\n\n @NonNull\n Mono queryPosts(ServerRequest request) {\n return ServerResponse.ok().contentType(MediaType.TEXT_PLAIN)\n .bodyValue(\"returned posts\");\n }\n\n @NonNull\n Mono updatePost(ServerRequest request) {\n var name = request.pathVariable(\"name\");\n return ServerResponse.ok().contentType(MediaType.TEXT_PLAIN)\n .bodyValue(\"updated post \" + name);\n }\n\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/authorization/DefaultRuleResolverTest.java", "content": "package run.halo.app.security.authorization;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.mock.http.server.reactive.MockServerHttpRequest.method;\nimport static org.springframework.security.authentication.UsernamePasswordAuthenticationToken.authenticated;\nimport static org.springframework.security.core.authority.AuthorityUtils.createAuthorityList;\n\nimport java.util.List;\nimport java.util.Set;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.security.core.userdetails.User;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.core.extension.Role.PolicyRule;\nimport run.halo.app.core.user.service.RoleService;\nimport run.halo.app.extension.Metadata;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultRuleResolverTest {\n\n @Mock\n RoleService roleService;\n\n @InjectMocks\n DefaultRuleResolver ruleResolver;\n\n @Test\n void visitRules() {\n when(roleService.listDependenciesFlux(Set.of(\"ruleReadPost\")))\n .thenReturn(Flux.just(mockRole()));\n var fakeUser = new User(\"admin\", \"123456\", createAuthorityList(\"ROLE_ruleReadPost\"));\n var authentication = authenticated(fakeUser, fakeUser.getPassword(),\n fakeUser.getAuthorities());\n\n var cases = getRequestResolveCases();\n cases.forEach(requestResolveCase -> {\n var httpMethod = HttpMethod.valueOf(requestResolveCase.method);\n var request = method(httpMethod, requestResolveCase.url).build();\n var requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n StepVerifier.create(ruleResolver.visitRules(authentication, requestInfo))\n .assertNext(\n visitor -> assertEquals(requestResolveCase.expected, visitor.isAllowed()))\n .verifyComplete();\n });\n\n verify(roleService, times(cases.size())).listDependenciesFlux(Set.of(\"ruleReadPost\"));\n }\n\n @Test\n void visitRulesForUserspaceScope() {\n when(roleService.listDependenciesFlux(Set.of(\"ruleReadPost\")))\n .thenReturn(Flux.just(mockRole()));\n var fakeUser = new User(\"admin\", \"123456\", createAuthorityList(\"ROLE_ruleReadPost\"));\n var authentication =\n authenticated(fakeUser, fakeUser.getPassword(), fakeUser.getAuthorities());\n var cases = List.of(\n new RequestResolveCase(\"/api/v1/categories\", \"POST\", true),\n new RequestResolveCase(\"/api/v1/categories\", \"DELETE\", true),\n new RequestResolveCase(\"/api/v1/userspaces/bar/categories\", \"DELETE\", false),\n new RequestResolveCase(\"/api/v1/userspaces/admin/categories\", \"DELETE\", true),\n new RequestResolveCase(\"/api/v1/posts\", \"GET\", true),\n\n new RequestResolveCase(\"/api/v1/userspaces/foo/posts\", \"GET\", false),\n new RequestResolveCase(\"/api/v1/userspaces/admin/posts\", \"GET\", true)\n );\n cases.forEach(requestResolveCase -> {\n var httpMethod = HttpMethod.valueOf(requestResolveCase.method);\n var request = method(httpMethod, requestResolveCase.url).build();\n var requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n StepVerifier.create(ruleResolver.visitRules(authentication, requestInfo))\n .assertNext(\n visitor -> assertEquals(requestResolveCase.expected, visitor.isAllowed()))\n .verifyComplete();\n });\n }\n\n Role mockRole() {\n var role = new Role();\n var rules = List.of(\n new PolicyRule.Builder().apiGroups(\"\").resources(\"posts\").verbs(\"list\", \"get\").build(),\n new PolicyRule.Builder().apiGroups(\"\").resources(\"categories\").verbs(\"*\").build(),\n new PolicyRule.Builder().apiGroups(\"api.plugin.halo.run\")\n .resources(\"plugins/users\")\n .resourceNames(\"foo/bar\").verbs(\"*\").build(),\n new PolicyRule.Builder().apiGroups(\"api.plugin.halo.run\")\n .resources(\"plugins/users\")\n .resourceNames(\"foo\").verbs(\"*\").build(),\n new PolicyRule.Builder().nonResourceURLs(\"/healthy\").verbs(\"get\", \"post\", \"head\")\n .build());\n role.setRules(rules);\n var metadata = new Metadata();\n metadata.setName(\"ruleReadPost\");\n role.setMetadata(metadata);\n return role;\n }\n\n List getRequestResolveCases() {\n return List.of(new RequestResolveCase(\"/api/v1/tags\", \"GET\", false),\n new RequestResolveCase(\"/api/v1/tags/tagName\", \"GET\", false),\n\n new RequestResolveCase(\"/api/v1/categories/aName\", \"GET\", true),\n new RequestResolveCase(\"/api/v1//categories\", \"POST\", true),\n new RequestResolveCase(\"/api/v1/categories\", \"DELETE\", true),\n new RequestResolveCase(\"/api/v1/posts\", \"GET\", true),\n new RequestResolveCase(\"/api/v1/posts/aName\", \"GET\", true),\n\n new RequestResolveCase(\"/api/v1/posts\", \"DELETE\", false),\n new RequestResolveCase(\"/api/v1/posts/aName\", \"UPDATE\", false),\n\n // group resource url\n new RequestResolveCase(\"/apis/group/v1/posts\", \"GET\", false),\n\n // plugin custom resource url\n new RequestResolveCase(\"/apis/api.plugin.halo.run/v1alpha1/plugins/foo/users\", \"GET\",\n true),\n new RequestResolveCase(\"/apis/api.plugin.halo.run/v1alpha1/plugins/foo/users/bar\",\n \"GET\", true),\n new RequestResolveCase(\"/apis/api.plugin.halo.run/v1alpha1/plugins/foo/posts/bar\",\n \"GET\", false),\n\n // non resource url\n new RequestResolveCase(\"/healthy\", \"GET\", true),\n new RequestResolveCase(\"/healthy\", \"POST\", true),\n new RequestResolveCase(\"/healthy\", \"HEAD\", true),\n new RequestResolveCase(\"//healthy\", \"GET\", false),\n new RequestResolveCase(\"/healthy/name\", \"GET\", false),\n new RequestResolveCase(\"/healthy1\", \"GET\", false),\n\n new RequestResolveCase(\"//healthy//name\", \"GET\", false),\n new RequestResolveCase(\"/\", \"GET\", false));\n }\n\n record RequestResolveCase(String url, String method, boolean expected) {\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/authorization/PolicyRuleTest.java", "content": "package run.halo.app.security.authorization;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.core.extension.Role;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link Role.PolicyRule}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass PolicyRuleTest {\n private ObjectMapper objectMapper;\n\n @BeforeEach\n void setUp() {\n objectMapper = JsonUtils.DEFAULT_JSON_MAPPER;\n }\n\n @Test\n public void constructPolicyRule() throws JsonProcessingException, JSONException {\n Role.PolicyRule policyRule = new Role.PolicyRule(null, null, null, null, null);\n assertThat(policyRule).isNotNull();\n JSONAssert.assertEquals(\"\"\"\n {\n \"apiGroups\": [],\n \"resources\": [],\n \"resourceNames\": [],\n \"nonResourceURLs\": [],\n \"verbs\": []\n }\n \"\"\",\n JsonUtils.objectToJson(policyRule),\n true);\n\n Role.PolicyRule policyByBuilder = new Role.PolicyRule.Builder().build();\n JSONAssert.assertEquals(\"\"\"\n {\n \"apiGroups\": [],\n \"resources\": [],\n \"resourceNames\": [],\n \"nonResourceURLs\": [],\n \"verbs\": []\n }\n \"\"\",\n JsonUtils.objectToJson(policyByBuilder),\n true);\n\n Role.PolicyRule policyNonNull = new Role.PolicyRule.Builder()\n .apiGroups(\"group\")\n .resources(\"resource-1\", \"resource-2\")\n .resourceNames(\"resourceName\")\n .nonResourceURLs(\"non resource url\")\n .verbs(\"verbs\")\n .build();\n\n JsonNode expected = objectMapper.readTree(\"\"\"\n {\n \"apiGroups\": [\n \"group\"\n ],\n \"resources\": [\n \"resource-1\",\n \"resource-2\"\n ],\n \"resourceNames\": [\n \"resourceName\"\n ],\n \"nonResourceURLs\": [\n \"non resource url\"\n ],\n \"verbs\": [\n \"verbs\"\n ]\n }\n \"\"\");\n JsonNode policyNonNullJson = objectMapper.valueToTree(policyNonNull);\n assertThat(policyNonNullJson).isEqualTo(expected);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/authorization/RbacRequestEvaluationTest.java", "content": "package run.halo.app.security.authorization;\n\nimport static org.assertj.core.api.AssertionsForClassTypes.assertThat;\n\nimport org.junit.jupiter.api.Test;\nimport run.halo.app.core.extension.Role;\n\n/**\n * Tests for {@link RbacRequestEvaluation}.\n *\n * @author guqing\n * @since 2.4.0\n */\nclass RbacRequestEvaluationTest {\n\n @Test\n void resourceNameMatches() {\n RbacRequestEvaluation rbacRequestEvaluation = new RbacRequestEvaluation();\n assertThat(matchResourceName(rbacRequestEvaluation, \"\", \"fake/test\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"\", \"fake\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"\", \"\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"*\", null)).isTrue();\n\n assertThat(matchResourceName(rbacRequestEvaluation, \"*/test\", \"fake/test\")).isTrue();\n\n assertThat(matchResourceName(rbacRequestEvaluation, \"*/test\", \"hello/test\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"*/test\", \"hello/fake\")).isFalse();\n\n assertThat(matchResourceName(rbacRequestEvaluation, \"test/*\", \"hello/fake\")).isFalse();\n assertThat(matchResourceName(rbacRequestEvaluation, \"test/*\", \"test/fake\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"test/*\", \"test\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"test/*\", \"hello\")).isFalse();\n\n assertThat(matchResourceName(rbacRequestEvaluation, \"*/*\", \"test/fake\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"*/*\", \"test\")).isTrue();\n\n assertThat(matchResourceName(rbacRequestEvaluation, \"*\", \"test\")).isTrue();\n assertThat(matchResourceName(rbacRequestEvaluation, \"*\", \"hello\")).isTrue();\n }\n\n boolean matchResourceName(RbacRequestEvaluation rbacRequestEvaluation, String rule,\n String requestedName) {\n return rbacRequestEvaluation.resourceNameMatches(new Role.PolicyRule.Builder()\n .resourceNames(rule)\n .build(), requestedName);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/authorization/RequestInfoResolverTest.java", "content": "package run.halo.app.security.authorization;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.springframework.mock.http.server.reactive.MockServerHttpRequest.method;\n\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.HttpMethod;\n\n/**\n * Tests for {@link RequestInfoFactory}.\n *\n * @author guqing\n * @see RequestInfo\n * @since 2.0.0\n */\npublic class RequestInfoResolverTest {\n\n @Test\n void shouldResolveAsWatchRequestWhenRequestIsWebSocket() {\n var request = method(HttpMethod.GET, \"/apis/fake.halo.run/v1alpha1/fakes\")\n .header(\"Upgrade\", \"websocket\")\n .header(\"Connection\", \"Upgrade\")\n .build();\n RequestInfo requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n assertThat(requestInfo).isNotNull();\n assertThat(requestInfo.getVerb()).isEqualTo(\"watch\");\n }\n\n @Test\n void shouldNotResolveAsWatchRequestWhenRequestIsNotWebSocket() {\n var request = method(HttpMethod.GET, \"/apis/fake.halo.run/v1alpha1/fakes\")\n .header(\"Upgrade\", \"websocket\")\n .build();\n RequestInfo requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n assertThat(requestInfo).isNotNull();\n assertThat(requestInfo.getVerb()).isEqualTo(\"list\");\n }\n\n @Test\n public void requestInfoTest() {\n for (SuccessCase successCase : getTestRequestInfos()) {\n final var request = method(HttpMethod.valueOf(successCase.method), successCase.url)\n .build();\n\n RequestInfo requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n\n assertNotNull(requestInfo, successCase::toString);\n assertEquals(successCase.expectedVerb, requestInfo.getVerb(), successCase::toString);\n assertThat(requestInfo.getApiPrefix()).isEqualTo(successCase.expectedAPIPrefix);\n assertThat(requestInfo.getApiGroup()).isEqualTo(successCase.expectedAPIGroup);\n assertThat(requestInfo.getApiVersion()).isEqualTo(successCase.expectedAPIVersion);\n assertThat(requestInfo.getResource()).isEqualTo(successCase.expectedResource);\n assertThat(requestInfo.getSubresource()).isEqualTo(successCase.expectedSubresource);\n assertThat(requestInfo.getName()).isEqualTo(successCase.expectedName);\n assertThat(requestInfo.getParts()).isEqualTo(successCase.expectedParts);\n }\n }\n\n @Test\n public void nonApiRequestInfoTest() {\n Map map = new HashMap<>();\n map.put(\"simple groupless\", new NonApiCase(\"/api/version/resource\", true));\n map.put(\"simple group\",\n new NonApiCase(\"/apis/group/version/resource/name/subresource\", true));\n map.put(\"more steps\", new NonApiCase(\"/api/version/resource/name/subresource\", true));\n map.put(\"group list\", new NonApiCase(\"/apis/batch/v1/job\", true));\n map.put(\"group get\", new NonApiCase(\"/apis/batch/v1/job/foo\", true));\n map.put(\"group subresource\", new NonApiCase(\"/apis/batch/v1/job/foo/scale\", true));\n\n // bad case\n map.put(\"bad root\", new NonApiCase(\"/not-api/version/resource\", false));\n map.put(\"group without enough steps\", new NonApiCase(\"/apis/extensions/v1beta1\", false));\n map.put(\"group without enough steps 2\", new NonApiCase(\"/apis/extensions/v1beta1/\", false));\n map.put(\"not enough steps\", new NonApiCase(\"/api/version\", false));\n map.put(\"one step\", new NonApiCase(\"/api\", false));\n map.put(\"zero step\", new NonApiCase(\"/\", false));\n map.put(\"empty\", new NonApiCase(\"\", false));\n\n map.forEach((k, v) -> {\n var request = method(HttpMethod.GET, v.url).build();\n RequestInfo requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n if (requestInfo.isResourceRequest() != v.expected) {\n throw new RuntimeException(\n String.format(\"%s: expected %s, actual %s\", k, v.expected,\n requestInfo.isResourceRequest()));\n }\n });\n }\n\n @Test\n void pluginsScopedAndPluginManage() {\n List testCases =\n List.of(\n new CustomSuccessCase(\"DELETE\", \"/apis/api.plugin.halo.run/v1/plugins/other/posts\",\n \"delete\", \"apis\", \"api.plugin.halo.run\", \"v1\", \"\", \"plugins\", \"posts\", \"\", \"\",\n new String[] {\"plugins\", \"other\", \"posts\"}),\n\n // api group identification\n new CustomSuccessCase(\"POST\",\n \"/apis/api.plugin.halo.run/v1/plugins/other/posts/foo\",\n \"create\", \"apis\",\n \"api.plugin.halo.run\", \"v1\", \"\", \"plugins\", \"posts\", \"other\", \"foo\",\n new String[] {\"plugins\", \"other\", \"posts\", \"foo\"}),\n\n // api version identification\n new CustomSuccessCase(\"POST\",\n \"/apis/api.plugin.halo.run/v1beta3/plugins/other/posts/bar\", \"create\",\n \"apis\", \"api.plugin.halo.run\", \"v1beta3\", \"\", \"plugins\", \"posts\", \"other\",\n \"bar\",\n new String[] {\"plugins\", \"other\", \"posts\", \"bar\"}));\n\n // 以 /apis 开头的 plugins 资源为 core 中管理插件使用的资源\n for (CustomSuccessCase successCase : testCases) {\n var request =\n method(HttpMethod.valueOf(successCase.method),\n successCase.url).build();\n RequestInfo requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n assertThat(requestInfo).isNotNull();\n assertRequestInfoCase(successCase, requestInfo);\n }\n\n List pluginScopedCases =\n List.of(\n new CustomSuccessCase(\"DELETE\", \"/apis/api.plugin.halo.run/v1/plugins/other/posts\",\n \"delete\", \"apis\", \"api.plugin.halo.run\", \"v1\", \"\", \"plugins\", \"posts\",\n \"other\", \"\", new String[] {\"plugins\", \"other\", \"posts\"}),\n\n // api group identification\n new CustomSuccessCase(\"POST\",\n \"/apis/api.plugin.halo.run/v1/plugins/other/posts/some-name\", \"create\", \"apis\",\n \"api.plugin.halo.run\", \"v1\", \"other\", \"plugins\", \"posts\", \"other\", \"some-name\",\n new String[] {\"plugins\", \"other\", \"posts\", \"some-name\"}));\n\n for (CustomSuccessCase pluginScopedCase : pluginScopedCases) {\n var request =\n method(HttpMethod.valueOf(pluginScopedCase.method),\n pluginScopedCase.url).build();\n RequestInfo requestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n assertThat(requestInfo).isNotNull();\n assertRequestInfoCase(pluginScopedCase, requestInfo);\n }\n }\n\n private void assertRequestInfoCase(CustomSuccessCase pluginScopedCase,\n RequestInfo requestInfo) {\n assertThat(requestInfo.getVerb()).isEqualTo(pluginScopedCase.expectedVerb);\n assertThat(requestInfo.getParts()).isEqualTo(pluginScopedCase.expectedParts);\n assertThat(requestInfo.getApiGroup()).isEqualTo(pluginScopedCase.expectedAPIGroup);\n assertThat(requestInfo.getResource()).isEqualTo(pluginScopedCase.expectedResource);\n assertThat(requestInfo.getSubresource())\n .isEqualTo(pluginScopedCase.expectedSubresource());\n assertThat(requestInfo.getSubName())\n .isEqualTo(pluginScopedCase.expectedSubName());\n }\n\n @Test\n public void errorCaseTest() {\n List errorCases = List.of(new ErrorCases(\"no resource path\", \"/\"),\n new ErrorCases(\"just apiversion\", \"/api/version/\"),\n new ErrorCases(\"just prefix, group, version\", \"/apis/group/version/\"),\n new ErrorCases(\"apiversion with no resource\", \"/api/version/\"),\n new ErrorCases(\"bad prefix\", \"/badprefix/version/resource\"),\n new ErrorCases(\"missing api group\", \"/apis/version/resource\"));\n for (ErrorCases errorCase : errorCases) {\n var request =\n method(HttpMethod.GET, errorCase.url).build();\n RequestInfo apiRequestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n if (apiRequestInfo.isResourceRequest()) {\n throw new RuntimeException(\n String.format(\"%s: expected non-resource request\", errorCase.desc));\n }\n }\n\n List postCases =\n List.of(new ErrorCases(\"api resource has name and no subresource but post\",\n \"/api/version/themes/install\"),\n new ErrorCases(\"apis resource has name and no subresource but post\",\n \"/apis/api.halo.run/v1alpha1/themes/install\"));\n for (ErrorCases errorCase : postCases) {\n var request =\n method(HttpMethod.POST, errorCase.url).build();\n RequestInfo apiRequestInfo = RequestInfoFactory.INSTANCE.newRequestInfo(request);\n if (apiRequestInfo.isResourceRequest()) {\n throw new RuntimeException(\n String.format(\"%s: expected non-resource request\", errorCase.desc));\n }\n }\n }\n\n public record NonApiCase(String url, boolean expected) {\n }\n\n public record ErrorCases(String desc, String url) {\n }\n\n\n public record SuccessCase(String method, String url, String expectedVerb,\n String expectedAPIPrefix, String expectedAPIGroup,\n String expectedAPIVersion, String expectedNamespace,\n String expectedResource, String expectedSubresource,\n String expectedName, String[] expectedParts) {\n }\n\n public record CustomSuccessCase(String method, String url, String expectedVerb,\n String expectedAPIPrefix, String expectedAPIGroup,\n String expectedAPIVersion, String expectedNamespace,\n String expectedResource, String expectedSubresource,\n String expectedName, String expectedSubName,\n String[] expectedParts) {\n }\n\n List getTestRequestInfos() {\n String namespaceAll = \"*\";\n return List.of(\n new SuccessCase(\"GET\", \"/api/v1/namespaces\", \"list\", \"api\", \"\", \"v1\", \"\", \"namespaces\",\n \"\", \"\", new String[] {\"namespaces\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other\", \"get\", \"api\", \"\", \"v1\", \"other\",\n \"namespaces\", \"\", \"other\", new String[] {\"namespaces\", \"other\"}),\n\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts\", \"list\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts/foo\", \"get\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"foo\", new String[] {\"posts\", \"foo\"}),\n new SuccessCase(\"HEAD\", \"/api/v1/namespaces/other/posts/foo\", \"get\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"foo\", new String[] {\"posts\", \"foo\"}),\n new SuccessCase(\"GET\", \"/api/v1/posts\", \"list\", \"api\", \"\", \"v1\", namespaceAll, \"posts\",\n \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"HEAD\", \"/api/v1/posts\", \"list\", \"api\", \"\", \"v1\", namespaceAll, \"posts\",\n \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts/foo\", \"get\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"foo\", new String[] {\"posts\", \"foo\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts\", \"list\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n\n // special verbs\n new SuccessCase(\"GET\", \"/api/v1/proxy/namespaces/other/posts/foo\", \"proxy\", \"api\", \"\",\n \"v1\", \"other\", \"posts\", \"\", \"foo\", new String[] {\"posts\", \"foo\"}),\n new SuccessCase(\"GET\",\n \"/api/v1/proxy/namespaces/other/posts/foo/subpath/not/a/subresource\", \"proxy\",\n \"api\", \"\", \"v1\", \"other\", \"posts\", \"\", \"foo\",\n new String[] {\"posts\", \"foo\", \"subpath\", \"not\", \"a\", \"subresource\"}),\n new SuccessCase(\"GET\", \"/api/v1/watch/posts\", \"watch\", \"api\", \"\", \"v1\", namespaceAll,\n \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/posts?watch=true\", \"watch\", \"api\", \"\", \"v1\",\n namespaceAll, \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/posts?watch=false\", \"list\", \"api\", \"\", \"v1\",\n namespaceAll, \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/watch/namespaces/other/posts\", \"watch\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts?watch=true\", \"watch\", \"api\", \"\",\n \"v1\", \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts?watch=false\", \"list\", \"api\", \"\",\n \"v1\", \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n\n // subresource identification\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts/foo/status\", \"get\", \"api\", \"\",\n \"v1\", \"other\", \"posts\", \"status\", \"foo\", new String[] {\"posts\", \"foo\", \"status\"}),\n new SuccessCase(\"GET\", \"/api/v1/namespaces/other/posts/foo/proxy/subpath\", \"get\", \"api\",\n \"\", \"v1\", \"other\", \"posts\", \"proxy\", \"foo\",\n new String[] {\"posts\", \"foo\", \"proxy\", \"subpath\"}),\n new SuccessCase(\"PUT\", \"/api/v1/namespaces/other/finalize\", \"update\", \"api\", \"\", \"v1\",\n \"other\", \"namespaces\", \"finalize\", \"other\",\n new String[] {\"namespaces\", \"other\", \"finalize\"}),\n new SuccessCase(\"PUT\", \"/api/v1/namespaces/other/status\", \"update\", \"api\", \"\", \"v1\",\n \"other\", \"namespaces\", \"status\", \"other\",\n new String[] {\"namespaces\", \"other\", \"status\"}),\n\n // verb identification\n new SuccessCase(\"PATCH\", \"/api/v1/namespaces/other/posts/foo\", \"patch\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"foo\", new String[] {\"posts\", \"foo\"}),\n new SuccessCase(\"DELETE\", \"/api/v1/namespaces/other/posts/foo\", \"delete\", \"api\", \"\",\n \"v1\", \"other\", \"posts\", \"\", \"foo\", new String[] {\"posts\", \"foo\"}),\n new SuccessCase(\"POST\", \"/api/v1/namespaces/other/posts\", \"create\", \"api\", \"\", \"v1\",\n \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n\n // deletecollection verb identification\n new SuccessCase(\"DELETE\", \"/api/v1/nodes?all=true\", \"deletecollection\", \"api\", \"\", \"v1\",\n \"\",\n \"nodes\", \"\", \"\", new String[] {\"nodes\"}),\n new SuccessCase(\"DELETE\", \"/api/v1/namespaces?all=false\", \"delete\", \"api\", \"\",\n \"v1\", \"\",\n \"namespaces\", \"\", \"\", new String[] {\"namespaces\"}),\n new SuccessCase(\"DELETE\", \"/api/v1/namespaces/other/posts?all=true\", \"deletecollection\",\n \"api\",\n \"\", \"v1\", \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n new SuccessCase(\"DELETE\", \"/apis/extensions/v1/namespaces/other/posts?all=true\",\n \"deletecollection\", \"apis\", \"extensions\", \"v1\", \"other\", \"posts\", \"\", \"\",\n new String[] {\"posts\"}),\n\n // api group identification\n new SuccessCase(\"POST\", \"/apis/extensions/v1/namespaces/other/posts\", \"create\", \"apis\",\n \"extensions\", \"v1\", \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}),\n\n // api version identification\n new SuccessCase(\"POST\", \"/apis/extensions/v1beta3/namespaces/other/posts\", \"create\",\n \"apis\", \"extensions\", \"v1beta3\", \"other\", \"posts\", \"\", \"\", new String[] {\"posts\"}));\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/device/DeviceServiceImplTest.java", "content": "package run.halo.app.security.device;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.stream.Stream;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\n\n/**\n * Tests for {@link DeviceServiceImpl}.\n *\n * @author guqing\n * @since 2.17.0\n */\nclass DeviceServiceImplTest {\n\n static Stream deviceInfoParseTest() {\n return Stream.of(\n Arguments.of(\n \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like \"\n + \"Gecko) Chrome/126.0.0.0 Safari/537.36\",\n \"Mac OS X 10.15.7\",\n \"Chrome 126.0\"\n ),\n Arguments.of(\n \"Mozilla/5.0 (Phone; OpenHarmony 5.0) AppleWebKit/537.36 (KHTML, like Gecko) \"\n + \"Chrome/114.0.0.0 Safari/537.36 ArkWeb/4.1.6.1 Mobile HuaweiBrowser/5.0.4\"\n + \".300\",\n \"OpenHarmony 5.0\",\n \"Chrome 114.0\"\n )\n );\n }\n\n @ParameterizedTest\n @MethodSource\n void deviceInfoParseTest(String userAgent, String expectedOs, String expectedBrowser) {\n var info = DeviceServiceImpl.DeviceInfo.parse(userAgent);\n assertThat(info.os()).isEqualTo(expectedOs);\n assertThat(info.browser()).isEqualTo(expectedBrowser);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/jackson2/HaloSecurityJacksonModuleTest.java", "content": "package run.halo.app.security.jackson2;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport com.fasterxml.jackson.core.JsonProcessingException;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Function;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.converter.json.Jackson2ObjectMapperBuilder;\nimport org.springframework.security.authentication.UsernamePasswordAuthenticationToken;\nimport org.springframework.security.core.Authentication;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.core.context.SecurityContextImpl;\nimport org.springframework.security.core.userdetails.User;\nimport org.springframework.security.jackson2.SecurityJackson2Modules;\nimport org.springframework.security.oauth2.client.authentication.OAuth2AuthenticationToken;\nimport org.springframework.security.oauth2.core.user.DefaultOAuth2User;\nimport org.springframework.security.web.authentication.switchuser.SwitchUserGrantedAuthority;\nimport run.halo.app.security.authentication.login.HaloUser;\nimport run.halo.app.security.authentication.oauth2.HaloOAuth2AuthenticationToken;\nimport run.halo.app.security.authentication.twofactor.TwoFactorAuthentication;\n\nclass HaloSecurityJacksonModuleTest {\n\n ObjectMapper objectMapper;\n\n @BeforeEach\n void setUp() {\n this.objectMapper = Jackson2ObjectMapperBuilder.json()\n .modules(SecurityJackson2Modules.getModules(this.getClass().getClassLoader()))\n .modules(modules -> modules.add(new HaloSecurityJackson2Module()))\n .indentOutput(true)\n .build();\n }\n\n @Test\n void codecHaloUserTest() throws JsonProcessingException {\n codecAssert(haloUser -> UsernamePasswordAuthenticationToken.authenticated(haloUser,\n haloUser.getPassword(),\n haloUser.getAuthorities()));\n }\n\n @Test\n void codecTwoFactorAuthenticationTokenTest() throws JsonProcessingException {\n codecAssert(haloUser -> {\n var authentication = UsernamePasswordAuthenticationToken.authenticated(haloUser,\n haloUser.getPassword(),\n haloUser.getAuthorities());\n return new TwoFactorAuthentication(authentication);\n });\n }\n\n @Test\n void codecHaloOAuth2AuthenticationTokenTest() throws JsonProcessingException {\n codecAssert(haloUser -> {\n var oauth2User = new DefaultOAuth2User(List.of(), Map.of(\"name\", \"halo\"), \"name\");\n var oauth2Token = new OAuth2AuthenticationToken(oauth2User, List.of(), \"github\");\n return new HaloOAuth2AuthenticationToken(haloUser, oauth2Token);\n });\n }\n\n @Test\n void shouldReadSwitchUserGrantedAuthority() throws JsonProcessingException {\n codecAssert(haloUser -> {\n var authentication = UsernamePasswordAuthenticationToken.authenticated(\n haloUser.getUsername(), haloUser.getPassword(), haloUser.getAuthorities()\n );\n var switchUserGrantedAuthority =\n new SwitchUserGrantedAuthority(\"ADMIN\", authentication);\n var extendedAuthorities = new ArrayList<>(authentication.getAuthorities());\n extendedAuthorities.add(switchUserGrantedAuthority);\n authentication = UsernamePasswordAuthenticationToken.authenticated(\n authentication.getPrincipal(), authentication.getCredentials(), extendedAuthorities\n );\n return authentication;\n });\n }\n\n void codecAssert(Function authenticationConverter)\n throws JsonProcessingException {\n var userDetails = User.withUsername(\"faker\")\n .password(\"123456\")\n .authorities(\"ROLE_USER\")\n .build();\n var haloUser = new HaloUser(userDetails, true, \"fake-encrypted-secret\");\n\n var authentication = authenticationConverter.apply(haloUser);\n\n var securityContext = new SecurityContextImpl(authentication);\n var securityContextJson = objectMapper.writeValueAsString(securityContext);\n\n var deserializedSecurityContext =\n objectMapper.readValue(securityContextJson, SecurityContext.class);\n\n assertEquals(deserializedSecurityContext, securityContext);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/preauth/SystemSetupEndpointTest.java", "content": "package run.halo.app.security.preauth;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.Properties;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link SystemSetupEndpoint}.\n *\n * @author guqing\n * @since 2.20.0\n */\nclass SystemSetupEndpointTest {\n\n @Test\n void placeholderTest() {\n var properties = new Properties();\n properties.setProperty(\"username\", \"guqing\");\n properties.setProperty(\"timestamp\", \"2024-09-30\");\n var str = SystemSetupEndpoint.PROPERTY_PLACEHOLDER_HELPER.replacePlaceholders(\"\"\"\n ${username}\n ${timestamp}\n \"\"\", properties);\n assertThat(str).isEqualTo(\"\"\"\n guqing\n 2024-09-30\n \"\"\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/security/session/InMemoryReactiveIndexedSessionRepositoryTest.java", "content": "package run.halo.app.security.session;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.springframework.session.ReactiveFindByIndexNameSessionRepository.PRINCIPAL_NAME_INDEX_NAME;\n\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport reactor.test.StepVerifier;\n\n/**\n * Tests for {@link InMemoryReactiveIndexedSessionRepository}.\n *\n * @author guqing\n * @since 2.15.0\n */\nclass InMemoryReactiveIndexedSessionRepositoryTest {\n private InMemoryReactiveIndexedSessionRepository sessionRepository;\n\n @BeforeEach\n void setUp() {\n sessionRepository = new InMemoryReactiveIndexedSessionRepository(new ConcurrentHashMap<>());\n }\n\n @Test\n void principalNameIndexTest() {\n sessionRepository.createSession()\n .doOnNext(session -> {\n session.setAttribute(PRINCIPAL_NAME_INDEX_NAME,\n \"test\");\n })\n .map(session -> sessionRepository.indexResolver.resolveIndexesFor(session))\n .as(StepVerifier::create)\n .consumeNextWith(map -> {\n assertThat(map).containsEntry(\n PRINCIPAL_NAME_INDEX_NAME,\n \"test\");\n });\n\n sessionRepository.findByPrincipalName(\"test\")\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n\n sessionRepository.findByIndexNameAndIndexValue(\n PRINCIPAL_NAME_INDEX_NAME, \"test\")\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n }\n\n @Test\n void saveTest() {\n var indexKey = createSession(\"fake-session-1\", \"test\");\n\n assertThat(sessionRepository.getSessionIdIndexMap()).hasSize(1);\n assertThat(\n sessionRepository.getSessionIdIndexMap().containsValue(Set.of(indexKey))).isTrue();\n\n assertThat(sessionRepository.getIndexSessionIdMap()).hasSize(1);\n assertThat(sessionRepository.getIndexSessionIdMap().containsKey(indexKey)).isTrue();\n assertThat(sessionRepository.getIndexSessionIdMap().get(indexKey)).isEqualTo(\n Set.of(\"fake-session-1\"));\n }\n\n @Test\n void saveToUpdateTest() {\n // same session id will update the index\n createSession(\"fake-session-1\", \"test\");\n var indexKey2 = createSession(\"fake-session-1\", \"test2\");\n\n assertThat(sessionRepository.getSessionIdIndexMap()).hasSize(1);\n assertThat(\n sessionRepository.getSessionIdIndexMap().containsValue(Set.of(indexKey2))).isTrue();\n\n assertThat(sessionRepository.getIndexSessionIdMap()).hasSize(1);\n assertThat(sessionRepository.getIndexSessionIdMap().containsKey(indexKey2)).isTrue();\n assertThat(sessionRepository.getIndexSessionIdMap().get(indexKey2)).isEqualTo(\n Set.of(\"fake-session-1\"));\n }\n\n @Test\n void deleteByIdTest() {\n createSession(\"fake-session-2\", \"test1\");\n sessionRepository.deleteById(\"fake-session-2\")\n .as(StepVerifier::create)\n .verifyComplete();\n assertThat(sessionRepository.getSessionIdIndexMap()).isEmpty();\n assertThat(sessionRepository.getIndexSessionIdMap()).isEmpty();\n }\n\n InMemoryReactiveIndexedSessionRepository.IndexKey createSession(String sessionId,\n String principalName) {\n var indexKey = new InMemoryReactiveIndexedSessionRepository.IndexKey(\n PRINCIPAL_NAME_INDEX_NAME, principalName);\n sessionRepository.createSession()\n .doOnNext(session -> {\n session.setAttribute(indexKey.attributeName(), indexKey.attributeValue());\n session.setId(sessionId);\n })\n .flatMap(sessionRepository::save)\n .as(StepVerifier::create)\n .verifyComplete();\n return indexKey;\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/switchuser/SwitchUserConfigurerTest.java", "content": "package run.halo.app.security.switchuser;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.test.web.reactive.server.SecurityMockServerConfigurers.csrf;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.security.core.userdetails.ReactiveUserDetailsService;\nimport org.springframework.security.core.userdetails.User;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\n\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass SwitchUserConfigurerTest {\n\n @Autowired\n WebTestClient webClient;\n\n @MockitoSpyBean\n ReactiveUserDetailsService userDetailsService;\n\n @Test\n @WithMockUser(username = \"admin\", roles = \"super-role\")\n void shouldSwitchWithSuperRole() {\n when(userDetailsService.findByUsername(\"faker\"))\n .thenReturn(Mono.fromSupplier(() -> User.withUsername(\"faker\")\n .password(\"password\")\n .roles(\"user\")\n .build()));\n var result = webClient.mutateWith(csrf())\n .post()\n .uri(\"/login/impersonate?username={username}&redirect_uri={redirect_uri}\",\n \"faker\", \"/fake-success\"\n )\n .exchange()\n .expectStatus().isFound()\n .expectHeader().location(\"/fake-success\")\n .expectCookie().exists(\"SESSION\")\n .expectBody().returnResult();\n var session = result.getResponseCookies().getFirst(\"SESSION\");\n assertNotNull(session);\n }\n\n @Test\n @WithSwitchUser(\n username = \"admin\", roles = {\"super-role\"},\n targetUsername = \"faker\", targetRoles = {\"user\"}\n )\n void shouldLogoutSuccessfully() {\n webClient.mutateWith(csrf())\n .post().uri(\"/logout/impersonate?redirect_uri={redirect_uri}\", \"/fake-logout-success\")\n .exchange()\n .expectStatus().isFound()\n .expectHeader().location(\"/fake-logout-success\");\n }\n\n @Test\n @WithMockUser(username = \"admin\", roles = \"non-super-role\")\n void shouldNotSwitchWithoutSuperRole() {\n webClient.mutateWith(csrf())\n .post()\n .uri(\"/login/impersonate?username={username}&redirect_uri={redirect_uri}\",\n \"faker\", \"/fake-success\"\n )\n .exchange()\n .expectStatus().isForbidden();\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/switchuser/SwitchUserSecurityContextFactory.java", "content": "package run.halo.app.security.switchuser;\n\nimport static org.springframework.security.authentication.UsernamePasswordAuthenticationToken.authenticated;\nimport static org.springframework.security.web.server.authentication.SwitchUserWebFilter.ROLE_PREVIOUS_ADMINISTRATOR;\n\nimport org.springframework.security.core.authority.AuthorityUtils;\nimport org.springframework.security.core.context.SecurityContext;\nimport org.springframework.security.core.context.SecurityContextImpl;\nimport org.springframework.security.test.context.support.WithSecurityContextFactory;\nimport org.springframework.security.web.authentication.switchuser.SwitchUserGrantedAuthority;\n\nclass SwitchUserSecurityContextFactory implements WithSecurityContextFactory {\n\n @Override\n public SecurityContext createSecurityContext(WithSwitchUser annotation) {\n var username = annotation.username();\n var roles = annotation.roles();\n var switchToUsername = annotation.targetUsername();\n var switchToRoles = annotation.targetRoles();\n\n var currentAuthentication =\n authenticated(username, \"password\", AuthorityUtils.createAuthorityList(roles));\n var switchAuthority =\n new SwitchUserGrantedAuthority(ROLE_PREVIOUS_ADMINISTRATOR, currentAuthentication);\n\n var targetAuthorities = AuthorityUtils.createAuthorityList(switchToRoles);\n targetAuthorities.add(switchAuthority);\n var authentication = authenticated(switchToUsername, \"password\",\n targetAuthorities);\n return new SecurityContextImpl(authentication);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/security/switchuser/WithSwitchUser.java", "content": "package run.halo.app.security.switchuser;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Inherited;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\nimport org.springframework.security.test.context.support.WithSecurityContext;\n\n@Target({ElementType.METHOD, ElementType.TYPE})\n@Retention(RetentionPolicy.RUNTIME)\n@Inherited\n@Documented\n@WithSecurityContext(factory = SwitchUserSecurityContextFactory.class)\n@interface WithSwitchUser {\n\n String username();\n\n String targetUsername();\n\n String[] roles() default {};\n\n String[] targetRoles() default {};\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/CompositeTemplateResolverTest.java", "content": "package run.halo.app.theme;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.thymeleaf.templateresolver.ITemplateResolver;\nimport org.thymeleaf.templateresolver.TemplateResolution;\nimport run.halo.app.infra.exception.NotFoundException;\n\nclass CompositeTemplateResolverTest {\n\n @Test\n void shouldGetBlankNameIfNoResolvers() {\n var resolver = new CompositeTemplateResolver(null);\n assertEquals(\"\", resolver.getName());\n }\n\n @Test\n void shouldGetNameIfResolversProvided() {\n var resolverA = mock(ITemplateResolver.class);\n when(resolverA.getName()).thenReturn(\"A\");\n var resolverB = mock(ITemplateResolver.class);\n when(resolverB.getName()).thenReturn(\"B\");\n var resolver = new CompositeTemplateResolver(List.of(resolverB, resolverA));\n assertEquals(\"B, A\", resolver.getName());\n }\n\n @Test\n void shouldGetNullOrder() {\n var resolver = new CompositeTemplateResolver(null);\n assertNull(resolver.getOrder());\n }\n\n @Test\n void shouldThrowNotFoundExceptionIfNoResolvers() {\n var resolver = new CompositeTemplateResolver(null);\n assertThrows(\n NotFoundException.class,\n () -> resolver.resolveTemplate(null, null, null, null)\n );\n }\n\n @Test\n void shouldThrowNotFoundExceptionIfAllResolversReturnNull() {\n var resolverA = mock(ITemplateResolver.class);\n when(resolverA.resolveTemplate(null, null, null, null)).thenReturn(null);\n var resolverB = mock(ITemplateResolver.class);\n when(resolverB.resolveTemplate(null, null, null, null)).thenReturn(null);\n var resolver = new CompositeTemplateResolver(List.of(resolverA, resolverB));\n assertThrows(\n NotFoundException.class,\n () -> resolver.resolveTemplate(null, null, null, null)\n );\n }\n\n @Test\n void shouldResolveTemplateIfResolvedByOneOfResolvers() {\n var resolverA = mock(ITemplateResolver.class);\n var resolution = mock(TemplateResolution.class);\n when(resolverA.resolveTemplate(null, null, null, null))\n .thenReturn(resolution);\n var resolverB = mock(ITemplateResolver.class);\n when(resolverB.resolveTemplate(null, null, null, null))\n .thenReturn(null);\n var resolver = new CompositeTemplateResolver(List.of(resolverA, resolverB));\n assertEquals(resolution, resolver.resolveTemplate(null, null, null, null));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/ReactiveFinderExpressionParserTests.java", "content": "package run.halo.app.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.when;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.node.ArrayNode;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.standard.expression.IStandardVariableExpressionEvaluator;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport org.thymeleaf.templateresource.StringTemplateResource;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.dialect.HaloProcessorDialect;\n\n/**\n * Tests expression parser for reactive return value.\n *\n * @author guqing\n * @see ReactiveSpelVariableExpressionEvaluator\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\npublic class ReactiveFinderExpressionParserTests {\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private ObjectProvider extensionGetterProvider;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n private TemplateEngine templateEngine;\n\n @BeforeEach\n void setUp() {\n HaloProcessorDialect haloProcessorDialect = new HaloProcessorDialect();\n templateEngine = new TemplateEngine();\n templateEngine.setDialects(Set.of(haloProcessorDialect, new SpringStandardDialect() {\n @Override\n public IStandardVariableExpressionEvaluator getVariableExpressionEvaluator() {\n return new ReactiveSpelVariableExpressionEvaluator();\n }\n }));\n templateEngine.addTemplateResolver(new TestTemplateResolver());\n lenient().when(applicationContext.getBean(eq(SystemConfigFetcher.class)))\n .thenReturn(environmentFetcher);\n when(applicationContext.getBeanProvider(ExtensionGetter.class))\n .thenReturn(extensionGetterProvider);\n when(extensionGetterProvider.getIfUnique()).thenReturn(null);\n lenient().when(environmentFetcher.fetchComment())\n .thenReturn(Mono.just(new SystemSetting.Comment()));\n }\n\n @Test\n void javascriptInlineParser() {\n Context context = getContext();\n context.setVariable(\"target\", new TestReactiveFinder());\n context.setVariable(\"genericMap\", Map.of(\"key\", \"value\"));\n String result = templateEngine.process(\"javascriptInline\", context);\n assertThat(result).isEqualTo(\"\"\"\n

value

\n

ruibaby

\n

guqing

\n

bar

\n \n \"\"\");\n }\n\n static class TestReactiveFinder {\n public Mono getName() {\n return Mono.just(\"guqing\");\n }\n\n public Flux names() {\n return Flux.just(\"guqing\", \"johnniang\", \"ruibaby\");\n }\n\n public Flux users() {\n return Flux.just(\n new TestUser(\"guqing\"), new TestUser(\"ruibaby\"), new TestUser(\"johnniang\")\n );\n }\n\n public Flux objectJsonNodeFlux() {\n ObjectNode objectNode = JsonUtils.DEFAULT_JSON_MAPPER.createObjectNode();\n objectNode.put(\"name\", \"guqing\");\n return Flux.just(objectNode);\n }\n\n public Mono> mapMono() {\n return Mono.just(Map.of(\"foo\", \"bar\"));\n }\n\n public Mono arrayNodeMono() {\n ArrayNode arrayNode = JsonUtils.DEFAULT_JSON_MAPPER.createArrayNode();\n arrayNode.add(arrayNode.objectNode().put(\"foo\", \"bar\"));\n return Mono.just(arrayNode);\n }\n }\n\n record TestUser(String name) {\n }\n\n private Context getContext() {\n Context context = new Context();\n context.setVariable(\n ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME,\n new ThymeleafEvaluationContext(applicationContext, null));\n return context;\n }\n\n static class TestTemplateResolver extends StringTemplateResolver {\n @Override\n protected ITemplateResource computeTemplateResource(IEngineConfiguration configuration,\n String ownerTemplate, String template,\n Map templateResolutionAttributes) {\n return new StringTemplateResource(\"\"\"\n

\n

\n

\n

\n \n \"\"\");\n }\n\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/SiteSettingVariablesAcquirerTest.java", "content": "package run.halo.app.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.net.MalformedURLException;\nimport java.net.URL;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.infra.ExternalUrlSupplier;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.theme.finders.vo.SiteSettingVo;\n\n/**\n * Tests for {@link SiteSettingVariablesAcquirer}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\npublic class SiteSettingVariablesAcquirerTest {\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @Mock\n private SystemVersionSupplier systemVersionSupplier;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @InjectMocks\n private SiteSettingVariablesAcquirer siteSettingVariablesAcquirer;\n\n @Test\n void acquireWhenExternalUrlSet() throws MalformedURLException {\n var url = new URL(\"https://halo.run\");\n when(externalUrlSupplier.getURL(any())).thenReturn(url);\n when(systemVersionSupplier.get()).thenReturn(Version.parse(\"0.0.0-alpha.1\"));\n when(environmentFetcher.getConfig()).thenReturn(Mono.just(Map.of()));\n\n siteSettingVariablesAcquirer.acquire(mock(ServerWebExchange.class))\n .as(StepVerifier::create)\n .consumeNextWith(result -> {\n assertThat(result).containsKey(\"site\");\n assertThat(result.get(\"site\")).isInstanceOf(SiteSettingVo.class);\n var site = (SiteSettingVo) result.get(\"site\");\n assertThat(site)\n .extracting(SiteSettingVo::url)\n .isEqualTo(url);\n assertThat(site)\n .extracting(SiteSettingVo::version)\n .isEqualTo(\"0.0.0-alpha.1\");\n })\n .verifyComplete();\n verify(externalUrlSupplier).getURL(any());\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/ThemeContextTest.java", "content": "package run.halo.app.theme;\n\nimport java.nio.file.Path;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link ThemeContext}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass ThemeContextTest {\n\n @Test\n void constructorBuilderTest() throws JSONException {\n var path = Path.of(\"/tmp/themes/testTheme\");\n var testTheme = ThemeContext.builder()\n .name(\"testTheme\")\n .path(path)\n .active(true)\n .build();\n var got = JsonUtils.objectToJson(testTheme);\n var expect = String.format(\"\"\"\n {\n \"name\": \"testTheme\",\n \"path\": \"%s\",\n \"active\": true\n }\n \"\"\", path.toUri());\n JSONAssert.assertEquals(expect, got, false);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/ThemeIntegrationTest.java", "content": "package run.halo.app.theme;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNull;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.security.web.server.util.matcher.ServerWebExchangeMatchers.pathMatchers;\n\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport org.hamcrest.Matchers;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Import;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.web.server.util.matcher.ServerWebExchangeMatcher.MatchResult;\nimport org.springframework.test.annotation.DirtiesContext;\nimport org.springframework.test.context.bean.override.mockito.MockitoBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.InitializationStateGetter;\nimport run.halo.app.infra.utils.HaloUtils;\nimport run.halo.app.security.AfterSecurityWebFilter;\nimport run.halo.app.theme.router.ModelConst;\n\n@SpringBootTest\n@Import(ThemeIntegrationTest.TestConfig.class)\n@AutoConfigureWebTestClient\n@DirtiesContext\npublic class ThemeIntegrationTest {\n\n @Autowired\n WebTestClient webClient;\n\n @MockitoBean\n InitializationStateGetter initializationStateGetter;\n\n @Autowired\n ExtensionClient client;\n\n @BeforeEach\n void setUp() {\n when(initializationStateGetter.userInitialized()).thenReturn(Mono.just(true));\n\n // create a menu item\n var menuItem = new MenuItem();\n menuItem.setMetadata(new Metadata());\n menuItem.getMetadata().setName(\"main-menu-home\");\n menuItem.setSpec(new MenuItem.MenuItemSpec());\n menuItem.getSpec().setDisplayName(\"Home\");\n menuItem.getSpec().setHref(\"/\");\n client.create(menuItem);\n\n // create a primary menu\n var menu = new Menu();\n menu.setMetadata(new Metadata());\n menu.getMetadata().setName(\"main-menu\");\n menu.setSpec(new Menu.Spec());\n menu.getSpec().setDisplayName(\"Mail Menu\");\n menu.getSpec().setMenuItems(new LinkedHashSet<>(List.of(\"main-menu-home\")));\n client.create(menu);\n }\n\n @TestConfiguration\n static class TestConfig {\n\n @Bean\n RouterFunction noTemplateExistsRoute() {\n return RouterFunctions.route()\n .GET(\n \"/no-template-exists\",\n request -> ServerResponse.ok().render(\"no-template-exists\")\n )\n .build();\n }\n\n @Bean\n RouterFunction noCacheRoute() {\n return RouterFunctions.route()\n .GET(\n \"/should-not-cache\",\n request -> ServerResponse.ok().render(\"no-template-exists\")\n )\n .before(HaloUtils.noCache())\n .build();\n }\n\n @Bean\n AfterSecurityWebFilter poweredByHaloTemplateEngineCheckFilter() {\n var matcher = pathMatchers(HttpMethod.GET, \"/should-not-cache\");\n return (exchange, chain) -> chain.filter(exchange)\n .flatMap(v -> matcher.matches(exchange)\n .filter(MatchResult::isMatch)\n .switchIfEmpty(Mono.fromRunnable(() -> {\n assertNull(exchange.getAttribute(ModelConst.NO_CACHE));\n assertTrue(exchange.getRequiredAttribute(\n ModelConst.POWERED_BY_HALO_TEMPLATE_ENGINE)\n );\n }).then(Mono.empty()))\n .doOnNext(m -> {\n assertTrue(exchange.getRequiredAttribute(ModelConst.NO_CACHE));\n assertFalse(exchange.getRequiredAttribute(\n ModelConst.POWERED_BY_HALO_TEMPLATE_ENGINE)\n );\n })\n )\n .then();\n }\n\n }\n\n @Test\n void shouldRespondNotFoundIfNoTemplateFound() {\n webClient.get()\n .uri(\"/no-template-exists\")\n .accept(MediaType.TEXT_HTML)\n .exchange()\n .expectStatus().isNotFound()\n .expectBody(String.class)\n .value(Matchers.containsString(\"Template no-template-exists was not found\"));\n\n webClient.get()\n .uri(\"/should-not-cache\")\n .accept(MediaType.TEXT_HTML)\n .exchange()\n .expectStatus().isNotFound()\n .expectBody(String.class)\n .value(Matchers.containsString(\"Template no-template-exists was not found\"));\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/ThemeLinkBuilderTest.java", "content": "package run.halo.app.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.lenient;\n\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport java.nio.file.Paths;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport run.halo.app.infra.ExternalUrlSupplier;\n\n/**\n * Tests for {@link ThemeLinkBuilder}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ThemeLinkBuilderTest {\n @Mock\n private ExternalUrlSupplier externalUrlSupplier;\n\n @BeforeEach\n void setUp() {\n // Mock external url supplier\n lenient().when(externalUrlSupplier.get()).thenReturn(URI.create(\"\"));\n }\n\n @Test\n void processTemplateLinkWithNoActive() {\n ThemeLinkBuilder themeLinkBuilder =\n new ThemeLinkBuilder(getTheme(false), externalUrlSupplier);\n\n String link = \"/post\";\n String processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(\"/post?preview-theme=test-theme\");\n\n processed = themeLinkBuilder.processLink(null, \"/post?foo=bar\");\n assertThat(processed).isEqualTo(\"/post?foo=bar&preview-theme=test-theme\");\n }\n\n @Test\n void processTemplateLinkWithActive() {\n ThemeLinkBuilder themeLinkBuilder =\n new ThemeLinkBuilder(getTheme(true), externalUrlSupplier);\n\n String link = \"/post\";\n String processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(\"/post\");\n }\n\n @Test\n void processAssetsLink() {\n // activated theme\n ThemeLinkBuilder themeLinkBuilder =\n new ThemeLinkBuilder(getTheme(true), externalUrlSupplier);\n\n String link = \"/assets/css/style.css\";\n String processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(\"/themes/test-theme/assets/css/style.css\");\n\n // preview theme\n getTheme(false);\n link = \"/assets/js/main.js\";\n processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(\"/themes/test-theme/assets/js/main.js\");\n }\n\n @Test\n void processNullLink() {\n ThemeLinkBuilder themeLinkBuilder =\n new ThemeLinkBuilder(getTheme(false), externalUrlSupplier);\n\n String link = null;\n String processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(null);\n\n // empty link\n link = \"\";\n processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(\"/?preview-theme=test-theme\");\n }\n\n @Test\n void processAbsoluteLink() {\n ThemeLinkBuilder themeLinkBuilder =\n new ThemeLinkBuilder(getTheme(false), externalUrlSupplier);\n String link = \"https://github.com/halo-dev\";\n String processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(link);\n\n link = \"http://example.com\";\n processed = themeLinkBuilder.processLink(null, link);\n assertThat(processed).isEqualTo(link);\n }\n\n @Test\n void linkInSite() throws URISyntaxException {\n URI uri = new URI(\"\");\n // relative link is always in site\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"/post\")).isTrue();\n\n // absolute link is not in site\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"https://example.com\")).isFalse();\n\n uri = new URI(\"https://example.com\");\n // link in externalUrl is in site link\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"http://example.com/hello/world\")).isTrue();\n // scheme is different but authority is same\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"https://example.com/hello/world\")).isTrue();\n\n // scheme is same and authority is different\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"http://halo.run/hello/world\")).isFalse();\n // scheme is different and authority is different\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"https://halo.run/hello/world\")).isFalse();\n\n // port is different\n uri = new URI(\"http://localhost:8090\");\n assertThat(ThemeLinkBuilder.linkInSite(uri, \"http://localhost:3000\")).isFalse();\n }\n\n private ThemeContext getTheme(boolean isActive) {\n return ThemeContext.builder()\n .name(\"test-theme\")\n .path(Paths.get(\"/themes/test-theme\"))\n .active(isActive)\n .build();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/ThemeLocaleContextResolverTest.java", "content": "package run.halo.app.theme;\n\nimport static java.util.Locale.CANADA;\nimport static java.util.Locale.CHINA;\nimport static java.util.Locale.CHINESE;\nimport static java.util.Locale.ENGLISH;\nimport static java.util.Locale.GERMAN;\nimport static java.util.Locale.GERMANY;\nimport static java.util.Locale.JAPAN;\nimport static java.util.Locale.JAPANESE;\nimport static java.util.Locale.KOREA;\nimport static java.util.Locale.UK;\nimport static java.util.Locale.US;\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static run.halo.app.theme.ThemeLocaleContextResolver.LANGUAGE_COOKIE_NAME;\nimport static run.halo.app.theme.ThemeLocaleContextResolver.TIME_ZONE_COOKIE_NAME;\n\nimport java.util.Arrays;\nimport java.util.Collections;\nimport java.util.Locale;\nimport java.util.TimeZone;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.context.i18n.TimeZoneAwareLocaleContext;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.web.server.ServerWebExchange;\n\n/**\n * Test for {@link ThemeLocaleContextResolver}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass ThemeLocaleContextResolverTest {\n private final ThemeLocaleContextResolver resolver = new ThemeLocaleContextResolver();\n\n @Test\n public void resolveTimeZone() {\n TimeZoneAwareLocaleContext localeContext =\n (TimeZoneAwareLocaleContext) this.resolver.resolveLocaleContext(\n exchangeTimeZone(CHINA));\n assertThat(localeContext.getTimeZone()).isNotNull();\n assertThat(localeContext.getTimeZone())\n .isEqualTo(TimeZone.getTimeZone(\"America/Adak\"));\n assertThat(localeContext.getLocale()).isNotNull();\n assertThat(localeContext.getLocale().getLanguage()).isEqualTo(\"en\");\n }\n\n @Test\n public void resolve() {\n assertThat(this.resolver.resolveLocaleContext(exchange(CANADA)).getLocale())\n .isEqualTo(CANADA);\n assertThat(this.resolver.resolveLocaleContext(exchange(US, CANADA)).getLocale())\n .isEqualTo(US);\n }\n\n @Test\n public void resolveFromParam() {\n assertThat(this.resolver.resolveLocaleContext(exchangeForParam(\"en\")).getLocale())\n .isEqualTo(ENGLISH);\n assertThat(this.resolver.resolveLocaleContext(exchangeForParam(\"zh\")).getLocale())\n .isEqualTo(CHINESE);\n assertThat(this.resolver.resolveLocaleContext(exchangeForParam(\"zh-CN\")).getLocale())\n .isEqualTo(CHINA);\n assertThat(this.resolver.resolveLocaleContext(exchangeForParam(\"zh-cn\")).getLocale())\n .isEqualTo(CHINA);\n }\n\n @Test\n public void resolvePreferredSupported() {\n this.resolver.setSupportedLocales(Collections.singletonList(CANADA));\n assertThat(this.resolver.resolveLocaleContext(exchange(US, CANADA)).getLocale()).isEqualTo(\n CANADA);\n }\n\n @Test\n public void resolvePreferredNotSupported() {\n this.resolver.setSupportedLocales(Collections.singletonList(CANADA));\n assertThat(this.resolver.resolveLocaleContext(exchange(US, UK)).getLocale()).isEqualTo(US);\n }\n\n @Test\n public void resolvePreferredNotSupportedWithDefault() {\n this.resolver.setSupportedLocales(Arrays.asList(US, JAPAN));\n this.resolver.setDefaultLocale(JAPAN);\n assertThat(this.resolver.resolveLocaleContext(exchange(KOREA)).getLocale()).isEqualTo(\n JAPAN);\n }\n\n @Test\n public void resolvePreferredAgainstLanguageOnly() {\n this.resolver.setSupportedLocales(Collections.singletonList(ENGLISH));\n assertThat(\n this.resolver.resolveLocaleContext(exchange(GERMANY, US, UK)).getLocale()).isEqualTo(\n ENGLISH);\n }\n\n @Test\n public void resolvePreferredAgainstCountryIfPossible() {\n this.resolver.setSupportedLocales(Arrays.asList(ENGLISH, UK));\n assertThat(\n this.resolver.resolveLocaleContext(exchange(GERMANY, US, UK)).getLocale()).isEqualTo(\n UK);\n }\n\n @Test\n public void resolvePreferredAgainstLanguageWithMultipleSupportedLocales() {\n this.resolver.setSupportedLocales(Arrays.asList(GERMAN, US));\n assertThat(\n this.resolver.resolveLocaleContext(exchange(GERMANY, US, UK)).getLocale()).isEqualTo(\n GERMAN);\n }\n\n @Test\n public void resolveMissingAcceptLanguageHeader() {\n MockServerHttpRequest request = MockServerHttpRequest.get(\"/\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isNull();\n }\n\n @Test\n public void resolveMissingAcceptLanguageHeaderWithDefault() {\n this.resolver.setDefaultLocale(US);\n\n MockServerHttpRequest request = MockServerHttpRequest.get(\"/\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isEqualTo(US);\n }\n\n @Test\n public void resolveEmptyAcceptLanguageHeader() {\n MockServerHttpRequest request =\n MockServerHttpRequest.get(\"/\").header(HttpHeaders.ACCEPT_LANGUAGE, \"\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isNull();\n }\n\n @Test\n public void resolveEmptyAcceptLanguageHeaderWithDefault() {\n this.resolver.setDefaultLocale(US);\n\n MockServerHttpRequest request =\n MockServerHttpRequest.get(\"/\").header(HttpHeaders.ACCEPT_LANGUAGE, \"\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isEqualTo(US);\n }\n\n @Test\n public void resolveInvalidAcceptLanguageHeader() {\n MockServerHttpRequest request =\n MockServerHttpRequest.get(\"/\").header(HttpHeaders.ACCEPT_LANGUAGE, \"en_US\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isNull();\n }\n\n @Test\n public void resolveInvalidAcceptLanguageHeaderWithDefault() {\n this.resolver.setDefaultLocale(US);\n\n MockServerHttpRequest request =\n MockServerHttpRequest.get(\"/\").header(HttpHeaders.ACCEPT_LANGUAGE, \"en_US\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isEqualTo(US);\n }\n\n @Test\n public void defaultLocale() {\n this.resolver.setDefaultLocale(JAPANESE);\n MockServerHttpRequest request = MockServerHttpRequest.get(\"/\").build();\n MockServerWebExchange exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isEqualTo(JAPANESE);\n\n request = MockServerHttpRequest.get(\"/\").acceptLanguageAsLocales(US).build();\n exchange = MockServerWebExchange.from(request);\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isEqualTo(US);\n }\n\n @Test\n void resolveUnderminedLocale() {\n var request = MockServerHttpRequest.get(\"/\")\n .header(HttpHeaders.ACCEPT_LANGUAGE, \"und\")\n .build();\n var exchange = MockServerWebExchange.from(request);\n\n assertThat(this.resolver.resolveLocaleContext(exchange).getLocale()).isNull();\n }\n\n private ServerWebExchange exchange(Locale... locales) {\n return MockServerWebExchange.from(\n MockServerHttpRequest.get(\"\").acceptLanguageAsLocales(locales));\n }\n\n private ServerWebExchange exchangeTimeZone(Locale... locales) {\n return MockServerWebExchange.from(\n MockServerHttpRequest.get(\"\").acceptLanguageAsLocales(locales)\n .cookie(new HttpCookie(TIME_ZONE_COOKIE_NAME, \"America/Adak\"))\n .cookie(new HttpCookie(LANGUAGE_COOKIE_NAME, \"en\")));\n }\n\n private ServerWebExchange exchangeForParam(String language) {\n return MockServerWebExchange.from(\n MockServerHttpRequest.get(\"/index?language=\" + language));\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/ViewNameResolverTest.java", "content": "package run.halo.app.theme;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\nimport static org.mockito.Mockito.when;\n\nimport java.io.IOException;\nimport java.net.URI;\nimport java.net.URISyntaxException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.api.io.TempDir;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.boot.thymeleaf.autoconfigure.ThymeleafProperties;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\n\n/**\n * Tests for {@link DefaultViewNameResolver}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\nclass ViewNameResolverTest {\n\n @Mock\n ThemeResolver themeResolver;\n\n @Mock\n ThymeleafProperties thymeleafProperties;\n\n @InjectMocks\n DefaultViewNameResolver viewNameResolver;\n\n @TempDir\n Path themePath;\n\n @BeforeEach\n void setUp() {\n when(thymeleafProperties.getSuffix()).thenReturn(ThymeleafProperties.DEFAULT_SUFFIX);\n }\n\n @Test\n void resolveViewNameOrDefault() throws URISyntaxException, IOException {\n var templatesPath = themePath.resolve(\"templates\");\n if (!Files.exists(templatesPath)) {\n Files.createDirectory(templatesPath);\n }\n Files.createFile(templatesPath.resolve(\"post_news.html\"));\n Files.createFile(templatesPath.resolve(\"post_docs.html\"));\n\n\n var exchange = Mockito.mock(ServerWebExchange.class);\n when(themeResolver.getTheme(exchange))\n .thenReturn(Mono.fromSupplier(() -> ThemeContext.builder()\n .name(\"fake-theme\")\n .path(themePath)\n .active(true)\n .build())\n );\n\n MockServerRequest request = MockServerRequest.builder()\n .uri(new URI(\"/\")).method(HttpMethod.GET)\n .exchange(exchange)\n .build();\n\n viewNameResolver.resolveViewNameOrDefault(request, \"post_news\", \"post\")\n .as(StepVerifier::create)\n .expectNext(\"post_news\")\n .verifyComplete();\n\n // post_docs.html\n String viewName = \"post_docs\" + thymeleafProperties.getSuffix();\n viewNameResolver.resolveViewNameOrDefault(request, viewName, \"post\")\n .as(StepVerifier::create)\n .expectNext(viewName)\n .verifyComplete();\n\n viewNameResolver.resolveViewNameOrDefault(request, \"post_nothing\", \"post\")\n .as(StepVerifier::create)\n .expectNext(\"post\")\n .verifyComplete();\n }\n\n @Test\n void processName() {\n var suffix = thymeleafProperties.getSuffix();\n assertThat(viewNameResolver.computeResourceName(\"post_news\"))\n .isEqualTo(\"post_news\" + suffix);\n assertThat(\n viewNameResolver.computeResourceName(\"post_news\" + suffix))\n .isEqualTo(\"post_news\" + suffix);\n assertThat(viewNameResolver.computeResourceName(\"post_news.test\"))\n .isEqualTo(\"post_news.test\" + suffix);\n\n assertThatThrownBy(() -> viewNameResolver.computeResourceName(null))\n .isInstanceOf(IllegalArgumentException.class)\n .hasMessage(\"Name must not be null\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/CommentElementTagProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.element.IElementTagStructureHandler;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport org.thymeleaf.templateresource.StringTemplateResource;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Tests for {@link CommentElementTagProcessor}.\n *\n * @author guqing\n * @see ExtensionComponentsFinder\n * @see HaloProcessorDialect\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CommentElementTagProcessorTest {\n\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private ExtensionGetter extensionGetter;\n\n @Mock\n private ObjectProvider extensionGetterProvider;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n private TemplateEngine templateEngine;\n\n @BeforeEach\n void setUp() {\n HaloProcessorDialect haloProcessorDialect = new HaloProcessorDialect();\n templateEngine = new TemplateEngine();\n templateEngine.setDialects(Set.of(haloProcessorDialect, new SpringStandardDialect()));\n templateEngine.addTemplateResolver(new TestTemplateResolver());\n lenient().when(applicationContext.getBean(eq(ExtensionGetter.class)))\n .thenReturn(extensionGetter);\n when(applicationContext.getBeanProvider(ExtensionGetter.class))\n .thenReturn(extensionGetterProvider);\n when(extensionGetterProvider.getIfUnique()).thenReturn(null);\n }\n\n @Test\n void doProcess() {\n Context context = getContext();\n\n when(applicationContext.getBean(eq(SystemConfigFetcher.class)))\n .thenReturn(environmentFetcher);\n var commentSetting = mock(SystemSetting.Comment.class);\n when(environmentFetcher.fetchComment())\n .thenReturn(Mono.just(commentSetting));\n when(commentSetting.getEnable()).thenReturn(true);\n\n when(extensionGetter.getEnabledExtensions(eq(CommentWidget.class)))\n .thenReturn(Flux.empty());\n String result = templateEngine.process(\"commentWidget\", context);\n assertThat(result).isEqualTo(\"\"\"\n \n \n \n

comment widget:

\n \\s\n \n \n \"\"\");\n\n when(extensionGetter.getEnabledExtensions(eq(CommentWidget.class)))\n .thenReturn(Flux.just(new DefaultCommentWidget()));\n result = templateEngine.process(\"commentWidget\", context);\n assertThat(result).isEqualTo(\"\"\"\n \n \n \n

comment widget:

\n

Comment in default widget

\n \n \n \"\"\");\n }\n\n static class DefaultCommentWidget implements CommentWidget {\n\n @Override\n public void render(ITemplateContext context, IProcessableElementTag tag,\n IElementTagStructureHandler structureHandler) {\n structureHandler.replaceWith(\"

Comment in default widget

\", false);\n }\n }\n\n private Context getContext() {\n Context context = new Context();\n context.setVariable(\n ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME,\n new ThymeleafEvaluationContext(applicationContext, null));\n return context;\n }\n\n static class TestTemplateResolver extends StringTemplateResolver {\n @Override\n protected ITemplateResource computeTemplateResource(IEngineConfiguration configuration,\n String ownerTemplate, String template,\n Map templateResolutionAttributes) {\n if (template.equals(\"commentWidget\")) {\n return new StringTemplateResource(commentWidget());\n }\n return null;\n }\n\n private String commentWidget() {\n return \"\"\"\n \n \n \n

comment widget:

\n \n \n \n \"\"\";\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/CommentEnabledVariableProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.context.WebEngineContext;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.web.IWebExchange;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Tests for {@link CommentEnabledVariableProcessor}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CommentEnabledVariableProcessorTest {\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private ExtensionGetter extensionGetter;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @BeforeEach\n void setUp() {\n lenient().when(applicationContext.getBean(eq(ExtensionGetter.class)))\n .thenReturn(extensionGetter);\n }\n\n @Test\n void getCommentWidget() {\n when(applicationContext.getBean(eq(SystemConfigFetcher.class)))\n .thenReturn(environmentFetcher);\n SystemSetting.Comment commentSetting = mock(SystemSetting.Comment.class);\n when(environmentFetcher.fetchComment())\n .thenReturn(Mono.just(commentSetting));\n\n CommentWidget commentWidget = mock(CommentWidget.class);\n when(extensionGetter.getEnabledExtensions(CommentWidget.class))\n .thenReturn(Flux.just(commentWidget));\n WebEngineContext webContext = mock(WebEngineContext.class);\n var evaluationContext = mock(ThymeleafEvaluationContext.class);\n when(webContext.getVariable(\n eq(ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME)))\n .thenReturn(evaluationContext);\n when(evaluationContext.getApplicationContext()).thenReturn(applicationContext);\n IWebExchange webExchange = mock(IWebExchange.class);\n when(webContext.getExchange()).thenReturn(webExchange);\n\n // comment disabled\n when(commentSetting.getEnable()).thenReturn(true);\n assertThat(\n CommentEnabledVariableProcessor.getCommentWidget(webContext).isPresent()).isTrue();\n\n // comment enabled\n when(commentSetting.getEnable()).thenReturn(false);\n assertThat(\n CommentEnabledVariableProcessor.getCommentWidget(webContext).isPresent()).isFalse();\n\n // comment enabled and ENABLE_COMMENT_ATTRIBUTE is true\n when(commentSetting.getEnable()).thenReturn(true);\n when(webExchange.getAttributeValue(CommentWidget.ENABLE_COMMENT_ATTRIBUTE))\n .thenReturn(true);\n assertThat(\n CommentEnabledVariableProcessor.getCommentWidget(webContext).isPresent()).isTrue();\n\n // comment enabled and ENABLE_COMMENT_ATTRIBUTE is false\n when(commentSetting.getEnable()).thenReturn(true);\n when(webExchange.getAttributeValue(CommentWidget.ENABLE_COMMENT_ATTRIBUTE))\n .thenReturn(false);\n assertThat(\n CommentEnabledVariableProcessor.getCommentWidget(webContext).isPresent()).isFalse();\n\n // comment enabled and ENABLE_COMMENT_ATTRIBUTE is null\n when(commentSetting.getEnable()).thenReturn(true);\n when(webExchange.getAttributeValue(CommentWidget.ENABLE_COMMENT_ATTRIBUTE))\n .thenReturn(null);\n assertThat(\n CommentEnabledVariableProcessor.getCommentWidget(webContext).isPresent()).isTrue();\n\n // comment enabled and ENABLE_COMMENT_ATTRIBUTE is 'false'\n when(commentSetting.getEnable()).thenReturn(true);\n when(webExchange.getAttributeValue(CommentWidget.ENABLE_COMMENT_ATTRIBUTE))\n .thenReturn(\"false\");\n assertThat(\n CommentEnabledVariableProcessor.getCommentWidget(webContext).isPresent()).isFalse();\n }\n\n @Test\n void populateAllowCommentAttribute() {\n WebEngineContext webContext = mock(WebEngineContext.class);\n IWebExchange webExchange = mock(IWebExchange.class);\n when(webContext.getExchange()).thenReturn(webExchange);\n\n CommentEnabledVariableProcessor.populateAllowCommentAttribute(webContext, true);\n verify(webExchange).setAttributeValue(\n eq(CommentEnabledVariableProcessor.COMMENT_ENABLED_MODEL_ATTRIBUTE), eq(true));\n\n CommentEnabledVariableProcessor.populateAllowCommentAttribute(webContext, false);\n verify(webExchange).setAttributeValue(\n eq(CommentEnabledVariableProcessor.COMMENT_ENABLED_MODEL_ATTRIBUTE), eq(false));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/ContentTemplateHeadProcessorIntegrationTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport org.jsoup.Jsoup;\nimport org.jsoup.nodes.Document;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.core.annotation.AnnotationAwareOrderComparator;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport org.thymeleaf.templateresource.StringTemplateResource;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * Integration tests for {@link ContentTemplateHeadProcessor}.\n *\n * @author guqing\n * @see HaloProcessorDialect\n * @see GlobalHeadInjectionProcessor\n * @see ContentTemplateHeadProcessor\n * @see TemplateHeadProcessor\n * @see TemplateGlobalHeadProcessor\n * @see TemplateFooterElementTagProcessor\n * @since 2.7.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ContentTemplateHeadProcessorIntegrationTest {\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private PostFinder postFinder;\n\n @Mock\n private SinglePageFinder singlePageFinder;\n\n @Mock\n private SystemConfigFetcher fetcher;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n private TemplateEngine templateEngine;\n\n @BeforeEach\n void setUp() {\n HaloProcessorDialect haloProcessorDialect = new HaloProcessorDialect();\n templateEngine = new TemplateEngine();\n templateEngine.setDialects(Set.of(haloProcessorDialect, new SpringStandardDialect()));\n templateEngine.addTemplateResolver(new TestTemplateResolver());\n\n Map map = new HashMap<>();\n map.put(\"postTemplateHeadProcessor\",\n new ContentTemplateHeadProcessor(postFinder, singlePageFinder));\n map.put(\"templateGlobalHeadProcessor\", new TemplateGlobalHeadProcessor(fetcher));\n map.put(\"seoProcessor\", new GlobalSeoProcessor(fetcher));\n map.put(\"duplicateMetaTagProcessor\", new DuplicateMetaTagProcessor());\n lenient().when(applicationContext.getBeansOfType(eq(TemplateHeadProcessor.class)))\n .thenReturn(map);\n\n SystemSetting.Seo seo = new SystemSetting.Seo();\n seo.setKeywords(\"global keywords\");\n seo.setDescription(\"global description\");\n lenient().when(fetcher.fetch(eq(SystemSetting.Seo.GROUP), eq(SystemSetting.Seo.class)))\n .thenReturn(Mono.just(seo));\n\n SystemSetting.CodeInjection codeInjection = new SystemSetting.CodeInjection();\n codeInjection.setGlobalHead(\n \"\");\n codeInjection.setContentHead(\n \"\");\n lenient().when(fetcher.fetch(eq(SystemSetting.CodeInjection.GROUP),\n eq(SystemSetting.CodeInjection.class))).thenReturn(Mono.just(codeInjection));\n\n lenient().when(fetcher.fetch(eq(SystemSetting.Seo.GROUP), eq(SystemSetting.Seo.class)))\n .thenReturn(Mono.empty());\n\n lenient().when(applicationContext.getBeanProvider(ExtensionGetter.class))\n .thenAnswer(invocation -> {\n var objectProvider = mock(ObjectProvider.class);\n when(objectProvider.getIfUnique()).thenReturn(extensionGetter);\n return objectProvider;\n });\n lenient().when(extensionGetter.getExtensions(TemplateHeadProcessor.class)).thenReturn(\n Flux.fromIterable(map.values()).sort(AnnotationAwareOrderComparator.INSTANCE)\n );\n lenient().when(applicationContext.getBean(eq(SystemConfigFetcher.class)))\n .thenReturn(fetcher);\n lenient().when(fetcher.fetchComment()).thenReturn(Mono.just(new SystemSetting.Comment()));\n }\n\n\n @Test\n void overrideGlobalMetaTest() {\n Context context = getContext();\n context.setVariable(\"name\", \"fake-post\");\n // template id flag is used by TemplateGlobalHeadProcessor\n context.setVariable(ModelConst.TEMPLATE_ID, DefaultTemplateEnum.POST.getValue());\n\n List> htmlMetas = new ArrayList<>();\n htmlMetas.add(mutableMetaMap(\"keyword\", \"postK1,postK2\"));\n htmlMetas.add(mutableMetaMap(\"description\", \"post-description\"));\n htmlMetas.add(mutableMetaMap(\"other\", \"post-other-meta\"));\n Post.PostSpec postSpec = new Post.PostSpec();\n postSpec.setHtmlMetas(htmlMetas);\n Metadata metadata = new Metadata();\n metadata.setName(\"fake-post\");\n PostVo postVo = PostVo.builder().spec(postSpec).metadata(metadata).build();\n when(postFinder.getByName(eq(\"fake-post\"))).thenReturn(Mono.just(postVo));\n\n String result = templateEngine.process(\"post\", context);\n /*\n this test case shows:\n 1. global seo meta keywords and description is overridden by content head meta\n 2. global head meta is overridden by content head meta\n 3. but global head meta is not overridden by global seo meta\n */\n var outputSettings = new Document.OutputSettings().prettyPrint(true);\n var actual = Jsoup.parse(result).outputSettings(outputSettings).html();\n var expected = Jsoup.parse(\"\"\"\n \n \n \n \n Post detail\n \n \n \n \n this is body\n \"\"\"\n ).outputSettings(outputSettings).html();\n assertThat(actual).isEqualTo(expected);\n }\n\n Map mutableMetaMap(String nameValue, String contentValue) {\n Map map = new HashMap<>();\n map.put(\"name\", nameValue);\n map.put(\"content\", contentValue);\n return map;\n }\n\n private Context getContext() {\n Context context = new Context();\n context.setVariable(\n ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME,\n new ThymeleafEvaluationContext(applicationContext, null));\n return context;\n }\n\n static class TestTemplateResolver extends StringTemplateResolver {\n @Override\n protected ITemplateResource computeTemplateResource(IEngineConfiguration configuration,\n String ownerTemplate, String template,\n Map templateResolutionAttributes) {\n if (template.equals(\"post\")) {\n return new StringTemplateResource(postTemplate());\n }\n return null;\n }\n\n private String postTemplate() {\n return \"\"\"\n \n \n \n \n Post detail\n \n \n this is body\n \n \n \"\"\";\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/ContentTemplateHeadProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link ContentTemplateHeadProcessor}.\n *\n * @author guqing\n * @since 2.5.0\n */\nclass ContentTemplateHeadProcessorTest {\n\n @Nested\n class ExcerptToMetaDescriptionTest {\n @Test\n void toMetaWhenExcerptIsNull() {\n List> htmlMetas = new ArrayList<>();\n htmlMetas.add(createMetaMap(\"keywords\", \"test\"));\n var result = ContentTemplateHeadProcessor.excerptToMetaDescriptionIfAbsent(htmlMetas,\n null);\n assertThat(result).hasSize(2);\n assertThat(result.get(0)).containsEntry(\"name\", \"keywords\");\n assertThat(result.get(1)).containsEntry(\"name\", \"description\")\n .containsEntry(\"content\", \"\");\n }\n\n @Test\n void toMetaWhenWhenHtmlMetaIsNull() {\n var result = ContentTemplateHeadProcessor.excerptToMetaDescriptionIfAbsent(null,\n null);\n assertThat(result).hasSize(1);\n assertThat(result.get(0)).containsEntry(\"name\", \"description\")\n .containsEntry(\"content\", \"\");\n }\n\n @Test\n void toMetaWhenWhenExcerptNotEmpty() {\n List> htmlMetas = new ArrayList<>();\n htmlMetas.add(createMetaMap(\"keywords\", \"test\"));\n var result = ContentTemplateHeadProcessor.excerptToMetaDescriptionIfAbsent(htmlMetas,\n \"test excerpt\");\n assertThat(result).hasSize(2);\n assertThat(result.get(0)).containsEntry(\"name\", \"keywords\");\n assertThat(result.get(1)).containsEntry(\"name\", \"description\")\n .containsEntry(\"content\", \"test excerpt\");\n }\n\n @Test\n void toMetaWhenWhenDescriptionExistsAndEmpty() {\n List> htmlMetas = new ArrayList<>();\n htmlMetas.add(createMetaMap(\"keywords\", \"test\"));\n htmlMetas.add(createMetaMap(\"description\", \"\"));\n var result = ContentTemplateHeadProcessor.excerptToMetaDescriptionIfAbsent(htmlMetas,\n \"test excerpt\");\n assertThat(result).hasSize(2);\n assertThat(result.get(0)).containsEntry(\"name\", \"keywords\");\n assertThat(result.get(1)).containsEntry(\"name\", \"description\")\n .containsEntry(\"content\", \"test excerpt\");\n }\n\n @Test\n void toMetaWhenWhenDescriptionExistsAndNotEmpty() {\n List> htmlMetas = new ArrayList<>();\n htmlMetas.add(createMetaMap(\"keywords\", \"test\"));\n htmlMetas.add(createMetaMap(\"description\", \"test description\"));\n var result = ContentTemplateHeadProcessor.excerptToMetaDescriptionIfAbsent(htmlMetas,\n \"test excerpt\");\n assertThat(result).hasSize(2);\n assertThat(result.get(0)).containsEntry(\"name\", \"keywords\");\n assertThat(result.get(1)).containsEntry(\"name\", \"description\")\n .containsEntry(\"content\", \"test description\");\n }\n\n Map createMetaMap(String nameValue, String contentValue) {\n Map metaMap = new HashMap<>();\n metaMap.put(\"name\", nameValue);\n metaMap.put(\"content\", contentValue);\n return metaMap;\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/DuplicateMetaTagProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.util.regex.Matcher;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link DuplicateMetaTagProcessor}.\n *\n * @author guqing\n * @since 2.8.0\n */\nclass DuplicateMetaTagProcessorTest {\n\n @Test\n void extractMetaTag() {\n // normal\n String text = \"\";\n Matcher matcher = DuplicateMetaTagProcessor.META_PATTERN.matcher(text);\n assertThat(matcher.find()).isTrue();\n assertThat(matcher.group(1)).isEqualTo(\"description\");\n\n // name and content are not in the general order\n text = \"\";\n matcher = DuplicateMetaTagProcessor.META_PATTERN.matcher(text);\n assertThat(matcher.find()).isTrue();\n assertThat(matcher.group(1)).isEqualTo(\"keywords\");\n\n // no closing slash\n text = \"\";\n matcher = DuplicateMetaTagProcessor.META_PATTERN.matcher(text);\n assertThat(matcher.find()).isTrue();\n assertThat(matcher.group(1)).isEqualTo(\"keywords\");\n\n // multiple line breaks and other stuff\n text = \"\"\"\n \n \n \n \"\"\";\n matcher = DuplicateMetaTagProcessor.META_PATTERN.matcher(text);\n assertThat(matcher.find()).isTrue();\n assertThat(matcher.group(1)).isEqualTo(\"description\");\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/GeneratorMetaProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.when;\n\nimport java.io.FileNotFoundException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.test.context.bean.override.mockito.MockitoBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.util.ResourceUtils;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.InitializationStateGetter;\nimport run.halo.app.theme.ThemeContext;\nimport run.halo.app.theme.ThemeResolver;\n\n@SpringBootTest\n@AutoConfigureWebTestClient\nclass GeneratorMetaProcessorTest {\n\n @Autowired\n WebTestClient webClient;\n\n @MockitoBean\n InitializationStateGetter initializationStateGetter;\n\n @MockitoBean\n ThemeResolver themeResolver;\n\n @BeforeEach\n void setUp() throws FileNotFoundException, URISyntaxException {\n when(initializationStateGetter.userInitialized()).thenReturn(Mono.just(true));\n var themeContext = ThemeContext.builder()\n .name(\"default\")\n .path(Path.of(ResourceUtils.getURL(\"classpath:themes/default\").toURI()))\n .active(true)\n .build();\n when(themeResolver.getTheme(any(ServerWebExchange.class)))\n .thenReturn(Mono.just(themeContext));\n }\n\n @Test\n void requestIndexPage() {\n webClient.get().uri(\"/\")\n .exchange()\n .expectStatus().isOk()\n .expectBody()\n .consumeWith(System.out::println)\n .xpath(\"/html/head/meta[@name=\\\"generator\\\"][starts-with(@content, \\\"Halo \\\")]\")\n .exists();\n }\n\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/HaloPostTemplateHandlerTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.junit.jupiter.api.Assertions.assertThrows;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.thymeleaf.spring6.expression.ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME;\n\nimport java.util.List;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.engine.ITemplateHandler;\nimport org.thymeleaf.model.IOpenElementTag;\nimport org.thymeleaf.model.IStandaloneElementTag;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n@ExtendWith(MockitoExtension.class)\nclass HaloPostTemplateHandlerTest {\n\n HaloPostTemplateHandler postHandler;\n\n @Mock\n ITemplateContext templateContext;\n\n @Mock\n ITemplateHandler next;\n\n @Mock\n ApplicationContext applicationContext;\n\n @Mock\n IStandaloneElementTag standaloneElementTag;\n\n @Mock\n IOpenElementTag openElementTag;\n\n @Mock\n ObjectProvider extensionGetterProvider;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n\n @BeforeEach\n void setUp() {\n postHandler = new HaloPostTemplateHandler();\n var evaluationContext = mock(ThymeleafEvaluationContext.class);\n when(evaluationContext.getApplicationContext()).thenReturn(applicationContext);\n when(templateContext.getVariable(THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME))\n .thenReturn(evaluationContext);\n when(applicationContext.getBeanProvider(ExtensionGetter.class))\n .thenReturn(extensionGetterProvider);\n when(extensionGetterProvider.getIfUnique()).thenReturn(extensionGetter);\n }\n\n @ParameterizedTest\n @MethodSource(\"provideEmptyElementTagProcessors\")\n void shouldHandleStandaloneElementIfNoElementTagProcessors(\n List processors\n ) {\n when(extensionGetter.getExtensionList(ElementTagPostProcessor.class))\n .thenReturn(processors);\n\n postHandler.setContext(templateContext);\n postHandler.setNext(next);\n postHandler.handleStandaloneElement(standaloneElementTag);\n verify(next).handleStandaloneElement(standaloneElementTag);\n }\n\n @Test\n void shouldHandleStandaloneElementIfOneElementTagProcessorProvided() {\n var processor = mock(ElementTagPostProcessor.class);\n var newTag = mock(IStandaloneElementTag.class);\n when(processor.process(SecureTemplateContextWrapper.wrap(templateContext),\n standaloneElementTag))\n .thenReturn(Mono.just(newTag));\n when(extensionGetter.getExtensionList(ElementTagPostProcessor.class))\n .thenReturn(List.of(processor));\n\n postHandler.setContext(templateContext);\n postHandler.setNext(next);\n postHandler.handleStandaloneElement(standaloneElementTag);\n verify(next).handleStandaloneElement(newTag);\n }\n\n @Test\n void shouldHandleStandaloneElementIfTagTypeChanged() {\n var processor = mock(ElementTagPostProcessor.class);\n var newTag = mock(IStandaloneElementTag.class);\n when(processor.process(SecureTemplateContextWrapper.wrap(templateContext),\n standaloneElementTag))\n .thenReturn(Mono.just(newTag));\n when(extensionGetter.getExtensionList(ElementTagPostProcessor.class))\n .thenReturn(List.of(processor));\n\n postHandler.setContext(templateContext);\n postHandler.setNext(next);\n postHandler.handleStandaloneElement(standaloneElementTag);\n verify(next).handleStandaloneElement(newTag);\n }\n\n @Test\n void shouldHandleStandaloneElementIfMoreElementTagProcessorsProvided() {\n var processor1 = mock(ElementTagPostProcessor.class);\n var processor2 = mock(ElementTagPostProcessor.class);\n var newTag1 = mock(IStandaloneElementTag.class);\n var newTag2 = mock(IStandaloneElementTag.class);\n when(processor1.process(SecureTemplateContextWrapper.wrap(templateContext),\n standaloneElementTag))\n .thenReturn(Mono.just(newTag1));\n when(processor2.process(SecureTemplateContextWrapper.wrap(templateContext), newTag1))\n .thenReturn(Mono.just(newTag2));\n when(extensionGetter.getExtensionList(ElementTagPostProcessor.class))\n .thenReturn(List.of(processor1, processor2));\n\n postHandler.setContext(templateContext);\n postHandler.setNext(next);\n postHandler.handleStandaloneElement(standaloneElementTag);\n verify(next).handleStandaloneElement(newTag2);\n }\n\n @Test\n void shouldNotHandleIfProcessedTagTypeChanged() {\n var processor = mock(ElementTagPostProcessor.class);\n var newTag = mock(IOpenElementTag.class);\n when(processor.process(SecureTemplateContextWrapper.wrap(templateContext),\n standaloneElementTag))\n .thenReturn(Mono.just(newTag));\n when(extensionGetter.getExtensionList(ElementTagPostProcessor.class))\n .thenReturn(List.of(processor));\n\n postHandler.setContext(templateContext);\n postHandler.setNext(next);\n assertThrows(ClassCastException.class,\n () -> postHandler.handleStandaloneElement(standaloneElementTag)\n );\n }\n\n static Stream> provideEmptyElementTagProcessors() {\n return Stream.of(\n null,\n List.of()\n );\n }\n\n}" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/HaloProcessorDialectTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport com.google.common.collect.ImmutableSortedMap;\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.ApplicationContext;\nimport org.springframework.core.annotation.AnnotationAwareOrderComparator;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport org.thymeleaf.templateresource.StringTemplateResource;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemSetting.CodeInjection;\nimport run.halo.app.infra.SystemSetting.Seo;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.Constant;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.finders.vo.UserVo;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * Tests for {@link HaloProcessorDialect}.\n *\n * @author guqing\n * @see HaloProcessorDialect\n * @see GlobalHeadInjectionProcessor\n * @see ContentTemplateHeadProcessor\n * @see TemplateHeadProcessor\n * @see TemplateGlobalHeadProcessor\n * @see TemplateFooterElementTagProcessor\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass HaloProcessorDialectTest {\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n private PostFinder postFinder;\n\n @Mock\n private SinglePageFinder singlePageFinder;\n\n @Mock\n private SystemConfigFetcher fetcher;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n private TemplateEngine templateEngine;\n\n @BeforeEach\n void setUp() {\n HaloProcessorDialect haloProcessorDialect = new HaloProcessorDialect();\n templateEngine = new TemplateEngine();\n templateEngine.setDialects(Set.of(haloProcessorDialect, new SpringStandardDialect()));\n templateEngine.addTemplateResolver(new TestTemplateResolver());\n\n Map map = new HashMap<>();\n map.put(\"postTemplateHeadProcessor\",\n new ContentTemplateHeadProcessor(postFinder, singlePageFinder));\n map.put(\"templateGlobalHeadProcessor\", new TemplateGlobalHeadProcessor(fetcher));\n map.put(\"faviconHeadProcessor\", new DefaultFaviconHeadProcessor(fetcher));\n map.put(\"globalSeoProcessor\", new GlobalSeoProcessor(fetcher));\n map.put(\"indexSeoProcessor\", new IndexSeoProcessor(fetcher));\n\n CodeInjection codeInjection = new CodeInjection();\n codeInjection.setContentHead(\"\");\n codeInjection.setGlobalHead(\"\");\n codeInjection.setFooter(\"
hello this is global footer.
\");\n lenient().when(fetcher.fetch(eq(CodeInjection.GROUP), eq(CodeInjection.class)))\n .thenReturn(Mono.just(codeInjection));\n\n lenient().when(applicationContext.getBean(eq(SystemConfigFetcher.class)))\n .thenReturn(fetcher);\n lenient().when(fetcher.fetch(eq(Seo.GROUP), eq(Seo.class)))\n .thenReturn(Mono.empty());\n\n lenient().when(applicationContext.getBeanProvider(ExtensionGetter.class))\n .then(invocation -> {\n @SuppressWarnings(\"unchecked\")\n ObjectProvider objectProvider = mock(ObjectProvider.class);\n when(objectProvider.getIfUnique()).thenReturn(extensionGetter);\n return objectProvider;\n });\n lenient().when(extensionGetter.getExtensions(TemplateHeadProcessor.class)).thenReturn(\n Flux.fromIterable(map.values()).sort(AnnotationAwareOrderComparator.INSTANCE)\n );\n\n lenient().when(fetcher.fetchComment())\n .thenReturn(Mono.just(new SystemSetting.Comment()));\n }\n\n @Test\n void globalHeadAndFooterProcessors() {\n SystemSetting.Basic basic = new SystemSetting.Basic();\n basic.setFavicon(\"favicon.ico\");\n when(fetcher.fetch(eq(SystemSetting.Basic.GROUP),\n eq(SystemSetting.Basic.class))).thenReturn(Mono.just(basic));\n\n when(extensionGetter.getExtensions(TemplateFooterProcessor.class))\n .thenReturn(Flux.empty());\n\n Context context = getContext();\n\n String result = templateEngine.process(\"index\", context);\n assertThat(result).isEqualTo(\"\"\"\n \n \n \n \n Index\n \n \n \n \n

index

\n
\n
hello this is global footer.
\n
\n \n \n \n \"\"\");\n }\n\n @Test\n void contentHeadAndFooterAndPostProcessors() {\n Context context = getContext();\n context.setVariable(\"name\", \"fake-post\");\n // template id flag is used by TemplateGlobalHeadProcessor\n context.setVariable(ModelConst.TEMPLATE_ID, DefaultTemplateEnum.POST.getValue());\n\n List> htmlMetas = new ArrayList<>();\n htmlMetas.add(ImmutableSortedMap.of(\"name\", \"post-meta-V1\", \"content\", \"post-meta-V1\"));\n htmlMetas.add(ImmutableSortedMap.of(\"name\", \"post-meta-V2\", \"content\", \"post-meta-V2\"));\n Post.PostSpec postSpec = new Post.PostSpec();\n postSpec.setHtmlMetas(htmlMetas);\n Metadata metadata = new Metadata();\n metadata.setName(\"fake-post\");\n PostVo postVo = PostVo.builder()\n .spec(postSpec)\n .metadata(metadata).build();\n when(postFinder.getByName(eq(\"fake-post\"))).thenReturn(Mono.just(postVo));\n\n SystemSetting.Basic basic = new SystemSetting.Basic();\n basic.setFavicon(null);\n when(fetcher.fetch(eq(SystemSetting.Basic.GROUP),\n eq(SystemSetting.Basic.class))).thenReturn(Mono.just(basic));\n\n when(extensionGetter.getExtensions(TemplateFooterProcessor.class))\n .thenReturn(Flux.empty());\n\n String result = templateEngine.process(\"post\", context);\n assertThat(result).isEqualTo(\"\"\"\n \n \n \n \n Post\n \n \n \\\n \\\n \\\n \n \n

post

\n
\n
hello this is global footer.
\n
\n \n \n \n \"\"\");\n }\n\n @Test\n void shouldSetMetaDescriptionIfContainingMetaDescriptionVariable() {\n var context = getContext();\n context.setVariable(Constant.META_DESCRIPTION_VARIABLE_NAME, \"Fake description\");\n when(fetcher.fetch(Seo.GROUP, Seo.class)).thenReturn(Mono.empty());\n when(fetcher.fetch(SystemSetting.Basic.GROUP, SystemSetting.Basic.class))\n .thenReturn(Mono.empty());\n var result = templateEngine.process(\"seo\", context);\n assertTrue(result.contains(\"\"\"\n \\\n \"\"\"));\n }\n\n @Test\n void blockSeo() {\n final Context context = getContext();\n Seo seo = new Seo();\n seo.setBlockSpiders(true);\n when(fetcher.fetch(eq(Seo.GROUP),\n eq(Seo.class))).thenReturn(Mono.just(seo));\n SystemSetting.Basic basic = new SystemSetting.Basic();\n basic.setFavicon(\"favicon.ico\");\n when(fetcher.fetch(eq(SystemSetting.Basic.GROUP),\n eq(SystemSetting.Basic.class))).thenReturn(Mono.just(basic));\n\n String result = templateEngine.process(\"seo\", context);\n assertThat(result).isEqualTo(\"\"\"\n \n \n \n \n Seo Test\n \\\n \n \n \n \n seo setting test.\n \n \n \"\"\");\n }\n\n @Test\n void indexSeoWithKeywordsAndDescription() {\n Context context = getContext();\n context.setVariable(ModelConst.TEMPLATE_ID, DefaultTemplateEnum.INDEX.getValue());\n Seo seo = new Seo();\n seo.setKeywords(\"K1, K2, K3\");\n seo.setDescription(\"This is a description.\");\n when(fetcher.fetch(eq(Seo.GROUP),\n eq(Seo.class))).thenReturn(Mono.just(seo));\n SystemSetting.Basic basic = new SystemSetting.Basic();\n basic.setFavicon(\"favicon.ico\");\n when(fetcher.fetch(eq(SystemSetting.Basic.GROUP),\n eq(SystemSetting.Basic.class))).thenReturn(Mono.just(basic));\n\n String result = templateEngine.process(\"seo\", context);\n assertThat(result).isEqualTo(\"\"\"\n \n \n \n \n Seo Test\n \n \n \n \n \n \n seo setting test.\n \n \n \"\"\");\n }\n\n @Nested\n class AnnotationExpressionObjectFactoryTest {\n\n @Test\n void getWhenAnnotationsIsNull() {\n Context context = getContext();\n context.setVariable(\"user\", createUser());\n\n String result = templateEngine.process(\"annotationsGetExpression\", context);\n assertThat(result).isEqualTo(\"

\\n\");\n }\n\n @Test\n void getWhenAnnotationsExists() {\n Context context = getContext();\n UserVo user = createUser();\n user.getMetadata().setAnnotations(Map.of(\"background\", \"fake-background\"));\n context.setVariable(\"user\", user);\n\n String result = templateEngine.process(\"annotationsGetExpression\", context);\n assertThat(result).isEqualTo(\"

fake-background

\\n\");\n }\n\n @Test\n void getOrDefaultWhenAnnotationsIsNull() {\n Context context = getContext();\n UserVo user = createUser();\n user.getMetadata().setAnnotations(Map.of(\"background\", \"red\"));\n context.setVariable(\"user\", user);\n\n String result = templateEngine.process(\"annotationsGetOrDefaultExpression\", context);\n assertThat(result).isEqualTo(\"

red

\\n\");\n }\n\n @Test\n void getOrDefaultWhenAnnotationsExists() {\n Context context = getContext();\n context.setVariable(\"user\", createUser());\n\n String result = templateEngine.process(\"annotationsGetOrDefaultExpression\", context);\n assertThat(result).isEqualTo(\"

default-value

\\n\");\n }\n\n @Test\n void containsWhenAnnotationsIsNull() {\n Context context = getContext();\n context.setVariable(\"user\", createUser());\n\n String result = templateEngine.process(\"annotationsContainsExpression\", context);\n assertThat(result).isEqualTo(\"

false

\\n\");\n }\n\n @Test\n void containsWhenAnnotationsIsNotNull() {\n Context context = getContext();\n UserVo user = createUser();\n user.getMetadata().setAnnotations(Map.of(\"background\", \"\"));\n context.setVariable(\"user\", user);\n\n String result = templateEngine.process(\"annotationsContainsExpression\", context);\n assertThat(result).isEqualTo(\"

true

\\n\");\n }\n\n UserVo createUser() {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-user\");\n user.setSpec(new User.UserSpec());\n return UserVo.from(user);\n }\n }\n\n private Context getContext() {\n Context context = new Context();\n context.setVariable(\n ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME,\n new ThymeleafEvaluationContext(applicationContext, null));\n return context;\n }\n\n static class TestTemplateResolver extends StringTemplateResolver {\n @Override\n protected ITemplateResource computeTemplateResource(IEngineConfiguration configuration,\n String ownerTemplate, String template,\n Map templateResolutionAttributes) {\n if (template.equals(DefaultTemplateEnum.INDEX.getValue())) {\n return new StringTemplateResource(indexTemplate());\n }\n\n if (template.equals(DefaultTemplateEnum.POST.getValue())) {\n return new StringTemplateResource(postTemplate());\n }\n\n if (template.equals(\"seo\")) {\n return new StringTemplateResource(seoTemplate());\n }\n\n if (template.equals(\"annotationsGetExpression\")) {\n return new StringTemplateResource(annotationsGetExpression());\n }\n if (template.equals(\"annotationsGetOrDefaultExpression\")) {\n return new StringTemplateResource(annotationsGetOrDefaultExpression());\n }\n if (template.equals(\"annotationsContainsExpression\")) {\n return new StringTemplateResource(annotationsContainsExpression());\n }\n return null;\n }\n\n private String indexTemplate() {\n return commonTemplate().formatted(\"Index\", \"\"\"\n

index

\n
\n \n
\n \"\"\");\n }\n\n private String postTemplate() {\n return commonTemplate().formatted(\"Post\", \"\"\"\n

post

\n
\n \n
\n \"\"\");\n }\n\n private String commonTemplate() {\n return \"\"\"\n \n \n \n \n %s\n \n \n %s\n \n \n \"\"\";\n }\n\n private String seoTemplate() {\n return \"\"\"\n \n \n \n \n Seo Test\n \n \n seo setting test.\n \n \n \"\"\";\n }\n\n private String annotationsGetExpression() {\n return \"\"\"\n

\n \"\"\";\n }\n\n private String annotationsGetOrDefaultExpression() {\n return \"\"\"\n

\n \"\"\";\n }\n\n private String annotationsContainsExpression() {\n return \"\"\"\n

\n \"\"\";\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/HaloSpringSecurityDialectTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.params.provider.Arguments.arguments;\nimport static org.springframework.http.MediaType.TEXT_HTML;\n\nimport java.util.List;\nimport java.util.Locale;\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.Arguments;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.security.access.expression.method.MethodSecurityExpressionHandler;\nimport org.springframework.security.authentication.UsernamePasswordAuthenticationToken;\nimport org.springframework.security.core.authority.AuthorityUtils;\nimport org.springframework.security.core.context.SecurityContextImpl;\nimport org.springframework.security.web.server.context.ServerSecurityContextRepository;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.WebContext;\nimport org.thymeleaf.extras.springsecurity6.util.SpringSecurityContextUtils;\nimport org.thymeleaf.spring6.SpringWebFluxTemplateEngine;\nimport org.thymeleaf.spring6.web.webflux.SpringWebFluxWebApplication;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\n\n// @ExtendWith(MockitoExtension.class)\n@SpringBootTest\nclass HaloSpringSecurityDialectTest {\n\n TemplateEngine templateEngine;\n\n @Autowired\n ServerSecurityContextRepository securityContextRepository;\n\n @Autowired\n ObjectProvider expressionHandler;\n\n\n @BeforeEach\n void setUp() {\n var haloSpringSecurityDialect =\n new HaloSpringSecurityDialect(securityContextRepository, expressionHandler);\n templateEngine = new SpringWebFluxTemplateEngine();\n templateEngine.addTemplateResolver(new StringTemplateResolver());\n templateEngine.addDialect(haloSpringSecurityDialect);\n }\n\n static Stream shouldEvaluateSecAuthorizeAttr() {\n return Stream.of(\n arguments(\n \"Evaluate sec:authorize to true when role match\",\n List.of(\"ROLE_ADMIN\"),\n \"\"\"\n

Admin

\\\n \"\"\",\n \"\"\"\n

Admin

\\\n \"\"\"),\n arguments(\n \"Evaluate sec:authorize to false when role not match\",\n List.of(\"ROLE_USER\"),\n \"\"\"\n

\\\n \"\"\",\n \"\")\n );\n }\n\n @ParameterizedTest(name = \"{0}\")\n @MethodSource\n void shouldEvaluateSecAuthorizeAttr(String name, List authorities, String template,\n String expected) {\n var request = MockServerHttpRequest.get(\"/halo-sec-authorize\").build();\n var exchange = new MockServerWebExchange.Builder(request).build();\n var webExchange = SpringWebFluxWebApplication.buildApplication(null)\n .buildExchange(exchange, Locale.getDefault(), TEXT_HTML, UTF_8);\n var context = new WebContext(webExchange);\n var authentication = new UsernamePasswordAuthenticationToken(\"fake-user\", \"fake-credential\",\n AuthorityUtils.createAuthorityList(authorities));\n var securityContext = new SecurityContextImpl(authentication);\n context.setVariable(SpringSecurityContextUtils.SECURITY_CONTEXT_MODEL_ATTRIBUTE_NAME,\n securityContext);\n var result = templateEngine.process(template, context);\n assertEquals(expected, result);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/InjectionExcluderProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link InjectionExcluderProcessor}.\n *\n * @author guqing\n * @since 2.20.0\n */\nclass InjectionExcluderProcessorTest {\n\n @Nested\n class PageInjectionExcluderTest {\n final InjectionExcluderProcessor.PageInjectionExcluder pageInjectionExcluder =\n new InjectionExcluderProcessor.PageInjectionExcluder();\n\n @Test\n void excludeTest() {\n var cases = new String[] {\n \"login\",\n \"signup\",\n \"logout\",\n \"password-reset/email/reset\",\n \"error/404\",\n \"error/500\",\n \"challenges/totp\"\n };\n\n for (String templateName : cases) {\n assertThat(pageInjectionExcluder.isExcluded(templateName)).isTrue();\n }\n }\n\n @Test\n void shouldNotExcludeTest() {\n var cases = new String[] {\n \"index\",\n \"post\",\n \"page\",\n \"category\",\n \"tag\",\n \"archive\",\n \"search\",\n \"feed\",\n \"sitemap\",\n \"robots\",\n \"custom\",\n \"error\",\n \"login.html\",\n };\n\n for (String templateName : cases) {\n assertThat(pageInjectionExcluder.isExcluded(templateName)).isFalse();\n }\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/LinkExpressionObjectDialectTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link LinkExpressionObjectDialect}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass LinkExpressionObjectDialectTest {\n\n private final LinkExpressionObjectDialect linkExpressionObjectDialect =\n new LinkExpressionObjectDialect();\n\n @Test\n void getExpressionObjectFactory() {\n assertThat(linkExpressionObjectDialect.getName())\n .isEqualTo(\"themeLink\");\n assertThat(linkExpressionObjectDialect.getExpressionObjectFactory())\n .isInstanceOf(DefaultLinkExpressionFactory.class);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/dialect/TemplateFooterElementTagProcessorTest.java", "content": "package run.halo.app.theme.dialect;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport java.util.HashSet;\nimport java.util.Map;\nimport java.util.Set;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.beans.factory.ObjectProvider;\nimport org.springframework.context.ApplicationContext;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.context.ITemplateContext;\nimport org.thymeleaf.model.IModel;\nimport org.thymeleaf.model.IProcessableElementTag;\nimport org.thymeleaf.processor.IProcessor;\nimport org.thymeleaf.processor.element.IElementTagStructureHandler;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.spring6.expression.ThymeleafEvaluationContext;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport org.thymeleaf.templateresource.StringTemplateResource;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\n\n/**\n * Tests for {@link TemplateFooterElementTagProcessor}.\n *\n * @author guqing\n * @since 2.17.0\n */\n@ExtendWith(MockitoExtension.class)\nclass TemplateFooterElementTagProcessorTest {\n @Mock\n private ApplicationContext applicationContext;\n\n @Mock\n ExtensionGetter extensionGetter;\n\n @Mock\n private SystemConfigFetcher fetcher;\n\n private TemplateEngine templateEngine;\n\n @BeforeEach\n void setUp() {\n HaloProcessorDialect haloProcessorDialect = new MockHaloProcessorDialect();\n templateEngine = new TemplateEngine();\n templateEngine.setDialects(Set.of(haloProcessorDialect, new SpringStandardDialect()));\n templateEngine.addTemplateResolver(new MockTemplateResolver());\n\n SystemSetting.CodeInjection codeInjection = new SystemSetting.CodeInjection();\n codeInjection.setFooter(\n \"

Powered by Halo

\");\n lenient().when(fetcher.fetch(eq(SystemSetting.CodeInjection.GROUP),\n eq(SystemSetting.CodeInjection.class))).thenReturn(Mono.just(codeInjection));\n\n lenient().when(applicationContext.getBeanProvider(ExtensionGetter.class))\n .thenAnswer(invocation -> {\n var objectProvider = mock(ObjectProvider.class);\n when(objectProvider.getIfUnique()).thenReturn(extensionGetter);\n return objectProvider;\n });\n lenient().when(applicationContext.getBean(eq(SystemConfigFetcher.class)))\n .thenReturn(fetcher);\n }\n\n @Test\n void footerProcessorTest() {\n when(extensionGetter.getExtensions(TemplateFooterProcessor.class))\n .thenReturn(Flux.just(new FakeFooterCodeInjection()));\n\n String result = templateEngine.process(\"fake-template\", getContext());\n // footer injected code is not processable\n assertThat(result).isEqualToIgnoringWhitespace(\"\"\"\n

Powered by Halo

\n
© 2024 guqing's blog
\n
\n \"\"\");\n }\n\n private Context getContext() {\n Context context = new Context();\n context.setVariable(\n ThymeleafEvaluationContext.THYMELEAF_EVALUATION_CONTEXT_CONTEXT_VARIABLE_NAME,\n new ThymeleafEvaluationContext(applicationContext, null));\n return context;\n }\n\n static class MockTemplateResolver extends StringTemplateResolver {\n @Override\n protected ITemplateResource computeTemplateResource(IEngineConfiguration configuration,\n String ownerTemplate, String template,\n Map templateResolutionAttributes) {\n return new StringTemplateResource(\"\"\"\n \n \"\"\");\n }\n }\n\n static class MockHaloProcessorDialect extends HaloProcessorDialect {\n @Override\n public Set getProcessors(String dialectPrefix) {\n var processors = new HashSet();\n processors.add(new TemplateFooterElementTagProcessor(dialectPrefix));\n return processors;\n }\n }\n\n static class FakeFooterCodeInjection implements TemplateFooterProcessor {\n\n @Override\n public Mono process(ITemplateContext context, IProcessableElementTag tag,\n IElementTagStructureHandler structureHandler, IModel model) {\n var factory = context.getModelFactory();\n // regular footer text\n var copyRight = factory.createText(\"
© 2024 guqing's blog
\");\n model.add(copyRight);\n // variable footer text\n model.add(factory.createText(\"
\"));\n return Mono.empty();\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/endpoint/ThemeEndpointTest.java", "content": "package run.halo.app.theme.endpoint;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static org.springframework.web.reactive.function.BodyInserters.fromMultipartData;\n\nimport java.io.File;\nimport java.io.IOException;\nimport java.net.URI;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.Map;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.reactivestreams.Publisher;\nimport org.springframework.core.io.FileSystemResource;\nimport org.springframework.http.MediaType;\nimport org.springframework.http.client.MultipartBodyBuilder;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.util.FileSystemUtils;\nimport org.springframework.util.ResourceUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.core.user.service.SettingConfigService;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.ReactiveUrlDataBufferFetcher;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.theme.TemplateEngineManager;\nimport run.halo.app.theme.service.ThemeService;\n\n/**\n * Tests for {@link ThemeEndpoint}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ThemeEndpointTest {\n\n @Mock\n ThemeRootGetter themeRoot;\n\n @Mock\n ThemeService themeService;\n\n @Mock\n TemplateEngineManager templateEngineManager;\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private SystemConfigFetcher environmentFetcher;\n\n @Mock\n private ReactiveUrlDataBufferFetcher urlDataBufferFetcher;\n\n @Mock\n private SettingConfigService settingConfigService;\n\n @InjectMocks\n ThemeEndpoint themeEndpoint;\n\n private Path tmpHaloWorkDir;\n\n WebTestClient webTestClient;\n\n private File defaultTheme;\n\n @BeforeEach\n void setUp() throws IOException {\n tmpHaloWorkDir = Files.createTempDirectory(\"halo-theme-endpoint-test\");\n lenient().when(themeRoot.get()).thenReturn(tmpHaloWorkDir);\n defaultTheme = ResourceUtils.getFile(\"classpath:themes/test-theme.zip\");\n webTestClient = WebTestClient\n .bindToRouterFunction(themeEndpoint.endpoint())\n .build();\n }\n\n @AfterEach\n void tearDown() throws IOException {\n FileSystemUtils.deleteRecursively(tmpHaloWorkDir);\n }\n\n @Nested\n class UpgradeTest {\n\n @Test\n void shouldNotOkIfThemeNotInstalled() {\n var bodyBuilder = new MultipartBodyBuilder();\n bodyBuilder.part(\"file\", new FileSystemResource(defaultTheme))\n .contentType(MediaType.MULTIPART_FORM_DATA);\n\n when(themeService.upgrade(eq(\"invalid-missing-manifest\"), isA(Publisher.class)))\n .thenReturn(\n Mono.error(() -> new ServerWebInputException(\"Failed to upgrade theme\")));\n\n webTestClient.post()\n .uri(\"/themes/invalid-missing-manifest/upgrade\")\n .body(fromMultipartData(bodyBuilder.build()))\n .exchange()\n .expectStatus().isBadRequest();\n\n verify(themeService).upgrade(eq(\"invalid-missing-manifest\"), isA(Publisher.class));\n }\n\n @Test\n void shouldUpgradeSuccessfullyIfThemeInstalled() {\n var bodyBuilder = new MultipartBodyBuilder();\n bodyBuilder.part(\"file\", new FileSystemResource(defaultTheme))\n .contentType(MediaType.MULTIPART_FORM_DATA);\n\n var metadata = new Metadata();\n metadata.setName(\"default\");\n var newTheme = new Theme();\n newTheme.setMetadata(metadata);\n\n when(themeService.upgrade(eq(\"default\"), isA(Publisher.class)))\n .thenReturn(Mono.just(newTheme));\n\n when(templateEngineManager.clearCache(eq(\"default\")))\n .thenReturn(Mono.empty());\n\n webTestClient.post()\n .uri(\"/themes/default/upgrade\")\n .body(fromMultipartData(bodyBuilder.build()))\n .exchange()\n .expectStatus().isOk();\n\n verify(themeService).upgrade(eq(\"default\"), isA(Publisher.class));\n\n verify(templateEngineManager, times(1)).clearCache(eq(\"default\"));\n }\n\n @Test\n void upgradeFromUri() {\n var uri = URI.create(\"https://example.com/test-theme.zip\");\n var metadata = new Metadata();\n metadata.setName(\"default\");\n var fakeTheme = new Theme();\n fakeTheme.setMetadata(metadata);\n when(themeService.upgrade(eq(\"default\"), any()))\n .thenReturn(Mono.just(fakeTheme));\n when(templateEngineManager.clearCache(eq(\"default\")))\n .thenReturn(Mono.empty());\n var body = new ThemeEndpoint.UpgradeFromUriRequest(uri);\n webTestClient.post()\n .uri(\"/themes/default/upgrade-from-uri\")\n .bodyValue(body)\n .exchange()\n .expectStatus().isOk()\n .expectBody(Theme.class).isEqualTo(fakeTheme);\n\n verify(themeService).upgrade(eq(\"default\"), any());\n\n verify(templateEngineManager, times(1)).clearCache(eq(\"default\"));\n }\n }\n\n @Test\n void install() {\n var multipartBodyBuilder = new MultipartBodyBuilder();\n multipartBodyBuilder.part(\"file\", new FileSystemResource(defaultTheme))\n .contentType(MediaType.MULTIPART_FORM_DATA);\n\n var installedTheme = new Theme();\n var metadata = new Metadata();\n metadata.setName(\"fake-name\");\n installedTheme.setMetadata(metadata);\n when(themeService.install(any())).thenReturn(Mono.just(installedTheme));\n\n webTestClient.post()\n .uri(\"/themes/install\")\n .body(fromMultipartData(multipartBodyBuilder.build()))\n .exchange()\n .expectStatus().isOk()\n .expectBody(Theme.class)\n .isEqualTo(installedTheme);\n\n verify(themeService).install(any());\n\n\n when(themeService.install(any())).thenReturn(\n Mono.error(new RuntimeException(\"Fake exception\")));\n // Verify the theme is installed.\n webTestClient.post()\n .uri(\"/themes/install\")\n .body(fromMultipartData(multipartBodyBuilder.build()))\n .exchange()\n .expectStatus().is5xxServerError();\n }\n\n @Test\n void installFromUri() {\n final URI uri = URI.create(\"https://example.com/test-theme.zip\");\n var metadata = new Metadata();\n metadata.setName(\"fake-theme\");\n var theme = new Theme();\n theme.setMetadata(metadata);\n\n when(themeService.install(any())).thenReturn(Mono.just(theme));\n var body = new ThemeEndpoint.UpgradeFromUriRequest(uri);\n webTestClient.post()\n .uri(\"/themes/-/install-from-uri\")\n .bodyValue(body)\n .exchange()\n .expectStatus().isOk()\n .expectBody(Theme.class).isEqualTo(theme);\n\n verify(themeService).install(any());\n }\n\n @Test\n void reloadTheme() {\n when(themeService.reloadTheme(any())).thenReturn(Mono.empty());\n webTestClient.put()\n .uri(\"/themes/fake/reload\")\n .exchange()\n .expectStatus().isOk();\n }\n\n @Test\n void resetSettingConfig() {\n when(themeService.resetSettingConfig(any())).thenReturn(Mono.empty());\n webTestClient.put()\n .uri(\"/themes/fake/reset-config\")\n .exchange()\n .expectStatus().isOk();\n }\n\n @Nested\n class UpdateThemeConfigTest {\n\n @Test\n void updateJsonConfigTest() {\n Theme theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.setSpec(new Theme.ThemeSpec());\n theme.getSpec().setConfigMapName(\"fake-config-map\");\n\n when(client.fetch(eq(Theme.class), eq(\"fake-theme\"))).thenReturn(Mono.just(theme));\n when(settingConfigService.upsertConfig(eq(\"fake-config-map\"), any()))\n .thenReturn(Mono.empty());\n\n webTestClient.put()\n .uri(\"/themes/fake-theme/json-config\")\n .body(Mono.just(Map.of()), Map.class)\n .exchange()\n .expectStatus().is2xxSuccessful();\n }\n }\n\n @Test\n void fetchActivatedTheme() {\n var theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.getMetadata().setName(\"fake-activated\");\n when(themeService.fetchActivatedTheme()).thenReturn(Mono.just(theme));\n webTestClient.get()\n .uri(\"/themes/-/activation\")\n .exchange()\n .expectStatus().isOk()\n .expectBody(Theme.class)\n .isEqualTo(theme);\n }\n\n @Test\n void fetchThemeSetting() {\n Theme theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.getMetadata().setName(\"fake\");\n theme.setSpec(new Theme.ThemeSpec());\n theme.getSpec().setSettingName(\"fake-setting\");\n\n when(client.fetch(eq(Setting.class), eq(\"fake-setting\")))\n .thenReturn(Mono.just(new Setting()));\n\n when(client.fetch(eq(Theme.class), eq(\"fake\"))).thenReturn(Mono.just(theme));\n webTestClient.get()\n .uri(\"/themes/fake/setting\")\n .exchange()\n .expectStatus().isOk();\n\n verify(client).fetch(eq(Setting.class), eq(\"fake-setting\"));\n verify(client).fetch(eq(Theme.class), eq(\"fake\"));\n }\n\n @Test\n void fetchThemeJsonConfigTest() {\n Theme theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.getMetadata().setName(\"fake\");\n theme.setSpec(new Theme.ThemeSpec());\n theme.getSpec().setConfigMapName(\"fake-config\");\n\n when(settingConfigService.fetchConfig(eq(\"fake-config\"))).thenReturn(Mono.empty());\n\n when(client.fetch(eq(Theme.class), eq(\"fake\"))).thenReturn(Mono.just(theme));\n webTestClient.get()\n .uri(\"/themes/fake/json-config\")\n .exchange()\n .expectStatus().isOk();\n\n verify(settingConfigService).fetchConfig(eq(\"fake-config\"));\n verify(client).fetch(eq(Theme.class), eq(\"fake\"));\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/engine/DefaultThemeTemplateAvailabilityProviderTest.java", "content": "package run.halo.app.theme.engine;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\nimport static org.mockito.Mockito.when;\n\nimport java.io.FileNotFoundException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.boot.thymeleaf.autoconfigure.ThymeleafProperties;\nimport org.springframework.util.ResourceUtils;\nimport run.halo.app.theme.ThemeContext;\n\n@ExtendWith(MockitoExtension.class)\nclass DefaultThemeTemplateAvailabilityProviderTest {\n\n @InjectMocks\n DefaultThemeTemplateAvailabilityProvider provider;\n\n @Mock\n ThymeleafProperties thymeleafProperties;\n\n @Test\n void templateAvailableTest() throws FileNotFoundException, URISyntaxException {\n var themeUrl = ResourceUtils.getURL(\"classpath:themes/default\");\n var themePath = Path.of(themeUrl.toURI());\n\n when(thymeleafProperties.getSuffix()).thenReturn(\".html\");\n var themeContext = ThemeContext.builder()\n .name(\"default\")\n .path(themePath)\n .build();\n boolean templateAvailable = provider.isTemplateAvailable(themeContext, \"fake\");\n assertFalse(templateAvailable);\n\n templateAvailable = provider.isTemplateAvailable(themeContext, \"index\");\n assertTrue(templateAvailable);\n\n templateAvailable = provider.isTemplateAvailable(themeContext, \"timezone\");\n assertTrue(templateAvailable);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/engine/PluginClassloaderTemplateResolverTest.java", "content": "package run.halo.app.theme.engine;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.PluginManager;\n\n/**\n * Tests for {@link PluginClassloaderTemplateResolver}.\n *\n * @author guqing\n * @since 2.11.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PluginClassloaderTemplateResolverTest {\n\n @Mock\n private PluginManager haloPluginManager;\n\n @InjectMocks\n private PluginClassloaderTemplateResolver templateResolver;\n\n @Test\n void matchPluginTemplateWhenOwnerTemplateMatch() {\n var result =\n templateResolver.matchPluginTemplate(\"plugin:fake-plugin:doc\", \"modules/layout\");\n assertThat(result.matches()).isTrue();\n assertThat(result.pluginName()).isEqualTo(\"fake-plugin\");\n assertThat(result.templateName()).isEqualTo(\"modules/layout\");\n assertThat(result.ownerTemplateName()).isEqualTo(\"doc\");\n }\n\n @Test\n void matchPluginTemplateWhenDoesNotMatch() {\n var result =\n templateResolver.matchPluginTemplate(\"doc\", \"modules/layout\");\n assertThat(result.matches()).isFalse();\n }\n\n @Test\n void matchPluginTemplateWhenTemplateMatch() {\n var result =\n templateResolver.matchPluginTemplate(\"doc\", \"plugin:fake-plugin:modules/layout\");\n assertThat(result.matches()).isTrue();\n assertThat(result.pluginName()).isEqualTo(\"fake-plugin\");\n assertThat(result.templateName()).isEqualTo(\"modules/layout\");\n assertThat(result.ownerTemplateName()).isEqualTo(\"doc\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/FinderRegistryTest.java", "content": "package run.halo.app.theme.finders;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\n\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.ApplicationContext;\n\n/**\n * Tests for {@link FinderRegistry}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass FinderRegistryTest {\n\n private DefaultFinderRegistry finderRegistry;\n @Mock\n private ApplicationContext applicationContext;\n\n @BeforeEach\n void setUp() {\n finderRegistry = new DefaultFinderRegistry(applicationContext);\n }\n\n @Test\n void registerFinder() {\n assertThatThrownBy(() -> {\n finderRegistry.putFinder(new Object());\n }).isInstanceOf(IllegalStateException.class)\n .hasMessage(\"Finder must be annotated with @Finder\");\n\n String s = finderRegistry.putFinder(new FakeFinder());\n assertThat(s).isEqualTo(\"test\");\n }\n\n @Test\n void removeFinder() {\n String s = finderRegistry.putFinder(new FakeFinder());\n assertThat(s).isEqualTo(\"test\");\n Object test = finderRegistry.get(\"test\");\n assertThat(test).isNotNull();\n finderRegistry.removeFinder(s);\n\n test = finderRegistry.get(\"test\");\n assertThat(test).isNull();\n }\n\n @Test\n void getFinders() {\n assertThat(finderRegistry.getFinders()).hasSize(0);\n\n finderRegistry.putFinder(new FakeFinder());\n Map finders = finderRegistry.getFinders();\n assertThat(finders).hasSize(1);\n }\n\n @Finder(\"test\")\n static class FakeFinder {\n\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/CategoryFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.when;\n\nimport com.fasterxml.jackson.core.type.TypeReference;\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.function.Function;\nimport java.util.stream.Collectors;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.data.domain.Sort;\nimport org.springframework.util.ResourceUtils;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.CategoryService;\nimport run.halo.app.core.extension.content.Category;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.theme.finders.vo.CategoryTreeVo;\nimport run.halo.app.theme.finders.vo.CategoryVo;\n\n/**\n * Tests for {@link CategoryFinderImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass CategoryFinderImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private CategoryService categoryService;\n\n private CategoryFinderImpl categoryFinder;\n\n @BeforeEach\n void setUp() {\n categoryFinder = new CategoryFinderImpl(client, categoryService);\n lenient().when(categoryService.isCategoryHidden(any())).thenReturn(Mono.just(false));\n }\n\n @Test\n void getByName() throws JSONException {\n when(client.fetch(eq(Category.class), eq(\"hello\")))\n .thenReturn(Mono.just(category()));\n CategoryVo categoryVo = categoryFinder.getByName(\"hello\").block();\n categoryVo.getMetadata().setCreationTimestamp(null);\n JSONAssert.assertEquals(\"\"\"\n {\n \"metadata\": {\n \"name\": \"hello\",\n \"annotations\": {\n \"K1\": \"V1\"\n }\n },\n \"spec\": {\n \"displayName\": \"displayName-1\",\n \"slug\": \"slug-1\",\n \"description\": \"description-1\",\n \"cover\": \"cover-1\",\n \"template\": \"template-1\",\n \"priority\": 0,\n \"children\": [\n \"C1\",\n \"C2\"\n ],\n \"preventParentPostCascadeQuery\": false,\n \"hideFromList\": false\n }\n }\n \"\"\",\n JsonUtils.objectToJson(categoryVo),\n true);\n }\n\n @Test\n void list() {\n ListResult categories = new ListResult<>(1, 10, 3,\n categories().stream()\n .sorted(CategoryFinderImpl.defaultComparator())\n .toList());\n when(client.listBy(eq(Category.class), any(ListOptions.class), any(PageRequest.class)))\n .thenReturn(Mono.just(categories));\n ListResult list = categoryFinder.list(1, 10).block();\n assertThat(list.getItems()).hasSize(3);\n assertThat(list.get().map(categoryVo -> categoryVo.getMetadata().getName()).toList())\n .isEqualTo(List.of(\"c3\", \"c2\", \"hello\"));\n }\n\n @Test\n void listAsTree() {\n when(client.listAll(eq(Category.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(categoriesForTree()));\n List treeVos = categoryFinder.listAsTree().collectList().block();\n assertThat(treeVos).hasSize(1);\n }\n\n @Test\n void listSubTreeByName() {\n when(client.listAll(eq(Category.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(categoriesForTree()));\n List treeVos = categoryFinder.listAsTree(\"E\").collectList().block();\n assertThat(treeVos.get(0).getMetadata().getName()).isEqualTo(\"E\");\n assertThat(treeVos.get(0).getChildren()).hasSize(2);\n assertThat(treeVos.get(0).getChildren().get(0).getMetadata().getName()).isEqualTo(\"A\");\n assertThat(treeVos.get(0).getChildren().get(1).getMetadata().getName()).isEqualTo(\"C\");\n }\n\n /**\n * Test for {@link CategoryFinderImpl#listAsTree()}.\n *\n * @see Fix #2532\n */\n @Test\n void listAsTreeMore() {\n when(client.listAll(eq(Category.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(moreCategories()));\n List treeVos = categoryFinder.listAsTree().collectList().block();\n String s = visualizeTree(treeVos);\n assertThat(s).isEqualTo(\"\"\"\n 全部 (7)\n ├── FIT2CLOUD (4)\n │ ├── DataEase (0)\n │ ├── Halo (2)\n │ ├── MeterSphere (0)\n │ └── JumpServer (0)\n └── 默认分类 (3)\n \"\"\");\n }\n\n @Nested\n class CategoryPostCountTest {\n\n /**\n *

Structure below.

\n * 
\n         * 全部 (35)\n         * ├── FIT2CLOUD (15)\n         * │   ├── DataEase (10)\n         * │   │   ├── SubNode1 (4)\n         * │   │   │   ├── Leaf1 (2)\n         * │   │   │   ├── Leaf2 (2)\n         * │   │   ├── SubNode2 (6)  (independent)\n         * │   │       ├── IndependentChild1 (3)\n         * │   │       ├── IndependentChild2 (3)\n         * │   ├── IndependentNode (5)  (independent)\n         * │       ├── IndependentChild3 (2)\n         * │       ├── IndependentChild4 (3)\n         * ├── AnotherRootChild (20)\n         * │   ├── Child1 (8)\n         * │   │   ├── SubChild1 (3)\n         * │   │   │   ├── DeepNode1 (1)\n         * │   │   │   ├── DeepNode2 (1)\n         * │   │   │   │   ├── DeeperNode (1)\n         * │   │   ├── SubChild2 (5)\n         * │   │       ├── DeepNode3 (2)  (independent)\n         * │   │           ├── DeepNode4 (1)\n         * │   │           ├── DeepNode5 (1)\n         * │   ├── Child2 (12)\n         * │       ├── IndependentSubNode (12)  (independent)\n         * │           ├── SubNode3 (6)\n         * │           ├── SubNode4 (6)\n         *
\n */\n private List categories;\n\n @BeforeEach\n void setUp() throws IOException {\n var file = ResourceUtils.getFile(\"classpath:categories/independent-post-count.json\");\n var json = Files.readString(file.toPath());\n categories = JsonUtils.jsonToObject(json, new TypeReference<>() {\n });\n }\n\n @Test\n void computePostCountFromTree() {\n when(client.listAll(eq(Category.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(categories));\n var treeVos = categoryFinder.listAsTree(\"全部\")\n .collectList().block();\n assertThat(treeVos).hasSize(1);\n String s = visualizeTree(treeVos.get(0).getChildren());\n assertThat(s).isEqualTo(\"\"\"\n 全部 (84)\n ├── AnotherRootChild (51)\n │ ├── Child1 (19)\n │ │ ├── SubChild1 (6)\n │ │ │ ├── DeepNode1 (1)\n │ │ │ └── DeepNode2 (2)\n │ │ │ └── DeeperNode (1)\n │ │ └── SubChild2 (5)\n │ │ └── DeepNode3 (4) (Independent)\n │ │ ├── DeepNode4 (1)\n │ │ └── DeepNode5 (1)\n │ └── Child2 (12)\n │ └── IndependentSubNode (24) (Independent)\n │ ├── SubNode3 (6)\n │ └── SubNode4 (6)\n └── FIT2CLOUD (33)\n ├── DataEase (18)\n │ ├── SubNode1 (8)\n │ │ ├── Leaf1 (2)\n │ │ └── Leaf2 (2)\n │ └── SubNode2 (12) (Independent)\n │ ├── IndependentChild1 (3)\n │ └── IndependentChild2 (3)\n └── IndependentNode (10) (Independent)\n ├── IndependentChild3 (2)\n └── IndependentChild4 (3)\n \"\"\");\n }\n\n @Test\n void getBreadcrumbsTest() {\n when(client.listAll(eq(Category.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(categories));\n // first level\n var breadcrumbs = categoryFinder.getBreadcrumbs(\"全部\").collectList().block();\n assertThat(toNames(breadcrumbs)).containsSequence(\"全部\");\n\n // second level\n breadcrumbs = categoryFinder.getBreadcrumbs(\"AnotherRootChild\").collectList().block();\n assertThat(toNames(breadcrumbs)).containsSequence(\"全部\", \"AnotherRootChild\");\n\n // more levels\n breadcrumbs = categoryFinder.getBreadcrumbs(\"DeepNode5\").collectList().block();\n assertThat(toNames(breadcrumbs)).containsSequence(\"全部\", \"AnotherRootChild\", \"Child1\",\n \"SubChild2\", \"DeepNode3\", \"DeepNode5\");\n\n breadcrumbs = categoryFinder.getBreadcrumbs(\"IndependentChild4\").collectList().block();\n assertThat(toNames(breadcrumbs)).containsSequence(\"全部\", \"FIT2CLOUD\",\n \"IndependentNode\",\n \"IndependentChild4\");\n\n breadcrumbs = categoryFinder.getBreadcrumbs(\"SubNode4\").collectList().block();\n assertThat(toNames(breadcrumbs)).containsSequence(\"全部\", \"AnotherRootChild\", \"Child2\",\n \"IndependentSubNode\", \"SubNode4\");\n\n // not exist\n breadcrumbs = categoryFinder.getBreadcrumbs(\"not-exist\").collectList().block();\n assertThat(toNames(breadcrumbs)).isEmpty();\n }\n\n @Test\n void getBreadcrumbsForHiddenTest() {\n Map categoryMap = categories.stream()\n .collect(\n Collectors.toMap(item -> item.getMetadata().getName(), Function.identity()));\n var category = categoryMap.get(\"IndependentNode\");\n category.getSpec().setHideFromList(true);\n when(client.listAll(eq(Category.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(categoryMap.values()));\n\n when(categoryService.isCategoryHidden(eq(\"IndependentChild4\")))\n .thenReturn(Mono.just(true));\n\n var breadcrumbs = categoryFinder.getBreadcrumbs(\"IndependentChild4\")\n .collectList().block();\n assertThat(toNames(breadcrumbs)).containsSequence(\"全部\", \"FIT2CLOUD\",\n \"IndependentNode\",\n \"IndependentChild4\");\n }\n\n static List toNames(List categories) {\n if (categories == null) {\n return List.of();\n }\n return categories.stream()\n .map(category -> category.getMetadata().getName())\n .toList();\n }\n }\n\n private List categoriesForTree() {\n /*\n * D\n * ├── E\n * │ ├── A\n * │ │ └── B\n * │ └── C\n * └── G\n * ├── F\n * └── H\n */\n Category d = category();\n d.getMetadata().setName(\"D\");\n d.getSpec().setChildren(List.of(\"E\", \"G\", \"F\"));\n\n Category e = category();\n e.getMetadata().setName(\"E\");\n e.getSpec().setChildren(List.of(\"A\", \"C\"));\n\n Category a = category();\n a.getMetadata().setName(\"A\");\n a.getSpec().setChildren(List.of(\"B\"));\n\n Category b = category();\n b.getMetadata().setName(\"B\");\n b.getSpec().setChildren(null);\n\n Category c = category();\n c.getMetadata().setName(\"C\");\n c.getSpec().setChildren(null);\n\n Category g = category();\n g.getMetadata().setName(\"G\");\n g.getSpec().setChildren(null);\n\n Category f = category();\n f.getMetadata().setName(\"F\");\n f.getSpec().setChildren(List.of(\"H\"));\n\n Category h = category();\n h.getMetadata().setName(\"H\");\n h.getSpec().setChildren(null);\n return List.of(d, e, a, b, c, g, f, h);\n }\n\n /**\n * Visualize a tree.\n */\n String visualizeTree(List categoryTreeVos) {\n Category.CategorySpec categorySpec = new Category.CategorySpec();\n categorySpec.setSlug(\"/\");\n categorySpec.setDisplayName(\"全部\");\n Integer postCount = categoryTreeVos.stream()\n .map(CategoryTreeVo::getPostCount)\n .filter(Objects::nonNull)\n .reduce(Integer::sum)\n .orElse(0);\n CategoryTreeVo root = CategoryTreeVo.builder()\n .spec(categorySpec)\n .postCount(postCount)\n .children(categoryTreeVos)\n .metadata(new Metadata())\n .build();\n StringBuilder stringBuilder = new StringBuilder();\n root.print(stringBuilder, \"\", \"\");\n return stringBuilder.toString();\n }\n\n private List categories() {\n Category category2 = JsonUtils.deepCopy(category());\n category2.getMetadata().setName(\"c2\");\n category2.getSpec().setPriority(2);\n\n Category category3 = JsonUtils.deepCopy(category());\n category3.getMetadata().setName(\"c3\");\n category3.getMetadata().setCreationTimestamp(Instant.now().plusSeconds(20));\n category3.getSpec().setPriority(2);\n return List.of(category2, category(), category3);\n }\n\n private Category category() {\n final Category category = new Category();\n\n Metadata metadata = new Metadata();\n metadata.setName(\"hello\");\n metadata.setAnnotations(Map.of(\"K1\", \"V1\"));\n metadata.setCreationTimestamp(Instant.now());\n category.setMetadata(metadata);\n\n Category.CategorySpec categorySpec = new Category.CategorySpec();\n categorySpec.setSlug(\"slug-1\");\n categorySpec.setDisplayName(\"displayName-1\");\n categorySpec.setCover(\"cover-1\");\n categorySpec.setDescription(\"description-1\");\n categorySpec.setTemplate(\"template-1\");\n categorySpec.setPriority(0);\n categorySpec.setChildren(List.of(\"C1\", \"C2\"));\n category.setSpec(categorySpec);\n return category;\n }\n\n private List moreCategories() {\n // see also https://github.com/halo-dev/halo/issues/2643\n String s = \"\"\"\n [\n {\n \"spec\":{\n \"displayName\":\"默认分类\",\n \"slug\":\"default\",\n \"description\":\"这是你的默认分类，如不需要，删除即可。\",\n \"cover\":\"\",\n \"template\":\"\",\n \"priority\":1,\n \"children\":[\n ]\n },\n \"status\":{\n \"permalink\":\"/categories/default\",\n \"postCount\":3,\n \"visiblePostCount\":3\n },\n \"apiVersion\":\"content.halo.run/v1alpha1\",\n \"kind\":\"Category\",\n \"metadata\":{\n \"name\":\"76514a40-6ef1-4ed9-b58a-e26945bde3ca\",\n \"version\":16,\n \"creationTimestamp\":\"2022-10-08T06:17:47.589181Z\"\n }\n },\n {\n \"spec\":{\n \"displayName\":\"MeterSphere\",\n \"slug\":\"metersphere\",\n \"description\":\"\",\n \"cover\":\"\",\n \"template\":\"\",\n \"priority\":2,\n \"children\":[\n ]\n },\n \"status\":{\n \"permalink\":\"/categories/metersphere\",\n \"postCount\":0,\n \"visiblePostCount\":0\n },\n \"apiVersion\":\"content.halo.run/v1alpha1\",\n \"kind\":\"Category\",\n \"metadata\":{\n \"finalizers\":[\n \"category-protection\"\n ],\n \"name\":\"acf09686-d5a7-4227-ba8c-3aeff063f12f\",\n \"version\":13,\n \"creationTimestamp\":\"2022-10-08T06:32:36.650974Z\"\n }\n },\n {\n \"spec\":{\n \"displayName\":\"DataEase\",\n \"slug\":\"dataease\",\n \"description\":\"\",\n \"cover\":\"\",\n \"template\":\"\",\n \"priority\":0,\n \"children\":[\n ]\n },\n \"status\":{\n \"permalink\":\"/categories/dataease\",\n \"postCount\":0,\n \"visiblePostCount\":0\n },\n \"apiVersion\":\"content.halo.run/v1alpha1\",\n \"kind\":\"Category\",\n \"metadata\":{\n \"finalizers\":[\n \"category-protection\"\n ],\n \"name\":\"bd95f914-22fc-4de5-afcc-a9ffba2f6401\",\n \"version\":13,\n \"creationTimestamp\":\"2022-10-08T06:32:53.353838Z\"\n }\n },\n {\n \"spec\":{\n \"displayName\":\"FIT2CLOUD\",\n \"slug\":\"fit2cloud\",\n \"description\":\"\",\n \"cover\":\"\",\n \"template\":\"\",\n \"priority\":0,\n \"children\":[\n \"bd95f914-22fc-4de5-afcc-a9ffba2f6401\",\n \"e1150fd9-4512-453c-9186-f8de9c156c3d\",\n \"acf09686-d5a7-4227-ba8c-3aeff063f12f\",\n \"ed064d5e-2b6f-4123-8114-78d0c6f2c4e2\",\n \"non-existent-children-name\"\n ]\n },\n \"status\":{\n \"permalink\":\"/categories/fit2cloud\",\n \"postCount\":2,\n \"visiblePostCount\":2\n },\n \"apiVersion\":\"content.halo.run/v1alpha1\",\n \"kind\":\"Category\",\n \"metadata\":{\n \"finalizers\":[\n \"category-protection\"\n ],\n \"name\":\"c25c17ae-4a7b-43c5-a424-76950b9622cd\",\n \"version\":14,\n \"creationTimestamp\":\"2022-10-08T06:32:27.802025Z\"\n }\n },\n {\n \"spec\":{\n \"displayName\":\"Halo\",\n \"slug\":\"halo\",\n \"description\":\"\",\n \"cover\":\"\",\n \"template\":\"\",\n \"priority\":1,\n \"children\":[\n ]\n },\n \"status\":{\n \"permalink\":\"/categories/halo\",\n \"postCount\":2,\n \"visiblePostCount\":2\n },\n \"apiVersion\":\"content.halo.run/v1alpha1\",\n \"kind\":\"Category\",\n \"metadata\":{\n \"finalizers\":[\n \"category-protection\"\n ],\n \"name\":\"e1150fd9-4512-453c-9186-f8de9c156c3d\",\n \"version\":15,\n \"creationTimestamp\":\"2022-10-08T06:32:42.991788Z\"\n }\n },\n {\n \"spec\":{\n \"displayName\":\"JumpServer\",\n \"slug\":\"jumpserver\",\n \"description\":\"\",\n \"cover\":\"\",\n \"template\":\"\",\n \"priority\":3,\n \"children\":[\n ]\n },\n \"status\":{\n \"permalink\":\"/categories/jumpserver\",\n \"postCount\":0,\n \"visiblePostCount\":0\n },\n \"apiVersion\":\"content.halo.run/v1alpha1\",\n \"kind\":\"Category\",\n \"metadata\":{\n \"finalizers\":[\n \"category-protection\"\n ],\n \"name\":\"ed064d5e-2b6f-4123-8114-78d0c6f2c4e2\",\n \"version\":13,\n \"creationTimestamp\":\"2022-10-08T06:33:00.557435Z\"\n }\n }\n ]\n \"\"\";\n return JsonUtils.jsonToObject(s, new TypeReference<>() {\n });\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/CommentPublicQueryServiceImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.function.Predicate;\nimport java.util.stream.Stream;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.mockito.stubbing.Answer;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.extension.Counter;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.user.service.UserService;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link CommentFinderImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\nclass CommentPublicQueryServiceImplTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n UserService userService;\n\n @Mock\n CounterService counterService;\n\n @InjectMocks\n CommentPublicQueryServiceImpl commentPublicQueryService;\n\n @BeforeEach\n void setUp() {\n when(userService.getUserOrGhost(eq(\"fake-user\"))).thenReturn(Mono.just(createUser()));\n }\n\n @Nested\n class ListCommentTest {\n @Test\n void desensitizeComment() throws JSONException {\n var commentOwner = new Comment.CommentOwner();\n commentOwner.setName(\"fake-user\");\n commentOwner.setDisplayName(\"Fake User\");\n commentOwner.setAnnotations(new HashMap<>() {\n {\n put(Comment.CommentOwner.KIND_EMAIL, \"mail@halo.run\");\n }\n });\n var comment = commentForCompare(\"1\", null, true, 0);\n comment.getSpec().setIpAddress(\"127.0.0.1\");\n comment.getSpec().setOwner(commentOwner);\n\n Counter counter = new Counter();\n counter.setUpvote(0);\n when(counterService.getByName(any())).thenReturn(Mono.just(counter));\n\n var result = commentPublicQueryService.toCommentVo(comment).block();\n result.getMetadata().setCreationTimestamp(null);\n result.getSpec().setCreationTime(null);\n JSONAssert.assertEquals(\"\"\"\n {\n \"metadata\":{\n \"name\":\"1\"\n },\n \"spec\":{\n \"owner\":{\n \"name\":\"\",\n \"displayName\":\"Fake User\",\n \"annotations\":{\n \n }\n },\n \"ipAddress\":\"\",\n \"priority\":0,\n \"top\":true\n },\n \"owner\":{\n \"kind\":\"User\",\n \"displayName\":\"fake-display-name\"\n },\n \"stats\":{\n \"upvote\":0\n }\n }\n \"\"\",\n JsonUtils.objectToJson(result),\n true);\n }\n\n Comment commentForCompare(String name, Instant creationTime, boolean top, int priority) {\n Comment comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(name);\n comment.getMetadata().setCreationTimestamp(Instant.now());\n comment.setSpec(new Comment.CommentSpec());\n comment.getSpec().setCreationTime(creationTime);\n comment.getSpec().setTop(top);\n comment.getSpec().setPriority(priority);\n return comment;\n }\n\n @SuppressWarnings(\"unchecked\")\n private void mockWhenListComment() {\n // Mock\n Comment commentNotApproved = createComment();\n commentNotApproved.getMetadata().setName(\"comment-not-approved\");\n commentNotApproved.getSpec().setApproved(false);\n\n Comment commentApproved = createComment();\n commentApproved.getMetadata().setName(\"comment-approved\");\n commentApproved.getSpec().setApproved(true);\n\n Comment notApprovedWithAnonymous = createComment();\n notApprovedWithAnonymous.getMetadata().setName(\"comment-not-approved-anonymous\");\n notApprovedWithAnonymous.getSpec().setApproved(false);\n notApprovedWithAnonymous.getSpec().getOwner().setName(AnonymousUserConst.PRINCIPAL);\n\n Comment commentApprovedButAnotherOwner = createComment();\n commentApprovedButAnotherOwner.getMetadata()\n .setName(\"comment-approved-but-another-owner\");\n commentApprovedButAnotherOwner.getSpec().setApproved(true);\n commentApprovedButAnotherOwner.getSpec().getOwner().setName(\"another\");\n\n Comment commentNotApprovedAndAnotherOwner = createComment();\n commentNotApprovedAndAnotherOwner.getMetadata()\n .setName(\"comment-not-approved-and-another\");\n commentNotApprovedAndAnotherOwner.getSpec().setApproved(false);\n commentNotApprovedAndAnotherOwner.getSpec().getOwner().setName(\"another\");\n\n Comment notApprovedAndAnotherRef = createComment();\n notApprovedAndAnotherRef.getMetadata()\n .setName(\"comment-not-approved-and-another-ref\");\n notApprovedAndAnotherRef.getSpec().setApproved(false);\n Ref anotherRef =\n Ref.of(\"another-fake-post\", GroupVersionKind.fromExtension(Post.class));\n notApprovedAndAnotherRef.getSpec().setSubjectRef(anotherRef);\n\n when(client.list(eq(Comment.class), any(),\n any(),\n eq(1),\n eq(10))\n ).thenAnswer((Answer>>) invocation -> {\n Predicate predicate =\n invocation.getArgument(1, Predicate.class);\n List comments = Stream.of(\n commentNotApproved,\n commentApproved,\n commentApprovedButAnotherOwner,\n commentNotApprovedAndAnotherOwner,\n notApprovedWithAnonymous,\n notApprovedAndAnotherRef\n ).filter(predicate).toList();\n return Mono.just(new ListResult<>(1, 10, comments.size(), comments));\n });\n\n extractedUser();\n when(client.fetch(eq(User.class), any())).thenReturn(Mono.just(createUser()));\n\n Counter counter = new Counter();\n counter.setUpvote(9);\n when(counterService.getByName(any())).thenReturn(Mono.just(counter));\n }\n\n Comment createComment() {\n Comment comment = new Comment();\n comment.setMetadata(new Metadata());\n comment.getMetadata().setName(\"fake-comment\");\n comment.setSpec(new Comment.CommentSpec());\n comment.setStatus(new Comment.CommentStatus());\n\n comment.getSpec().setRaw(\"fake-raw\");\n comment.getSpec().setContent(\"fake-content\");\n comment.getSpec().setHidden(false);\n comment.getSpec()\n .setSubjectRef(Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class)));\n Comment.CommentOwner commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(User.KIND);\n commentOwner.setName(\"fake-user\");\n commentOwner.setDisplayName(\"fake-display-name\");\n comment.getSpec().setOwner(commentOwner);\n return comment;\n }\n }\n\n private void extractedUser() {\n User another = createUser();\n another.getMetadata().setName(\"another\");\n when(userService.getUserOrGhost(eq(\"another\"))).thenReturn(Mono.just(another));\n\n User ghost = createUser();\n ghost.getMetadata().setName(\"ghost\");\n when(userService.getUserOrGhost(eq(\"ghost\"))).thenReturn(Mono.just(ghost));\n when(userService.getUserOrGhost(eq(\"fake-user\"))).thenReturn(Mono.just(createUser()));\n when(userService.getUserOrGhost(any())).thenReturn(Mono.just(ghost));\n }\n\n User createUser() {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-user\");\n user.setSpec(new User.UserSpec());\n user.getSpec().setDisplayName(\"fake-display-name\");\n return user;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/CommentPublicQueryServiceIntegrationTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport com.fasterxml.jackson.databind.JsonNode;\nimport com.fasterxml.jackson.databind.node.ObjectNode;\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.stream.Collectors;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.annotation.DirtiesContext;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.core.extension.content.Comment;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.Reply;\nimport run.halo.app.extension.Extension;\nimport run.halo.app.extension.ExtensionStoreUtil;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Ref;\nimport run.halo.app.extension.SchemeManager;\nimport run.halo.app.extension.store.ReactiveExtensionStoreClient;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.infra.exception.DuplicateNameException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@DirtiesContext\n@SpringBootTest\nclass CommentPublicQueryServiceIntegrationTest {\n\n @Autowired\n private SchemeManager schemeManager;\n\n @Autowired\n private ReactiveExtensionClient client;\n\n @Autowired\n private ReactiveExtensionStoreClient storeClient;\n\n Mono deleteImmediately(Extension extension) {\n var name = extension.getMetadata().getName();\n var scheme = schemeManager.get(extension.getClass());\n\n // delete from db\n var storeName = ExtensionStoreUtil.buildStoreName(scheme, name);\n return storeClient.delete(storeName, extension.getMetadata().getVersion())\n .thenReturn(extension);\n }\n\n @Nested\n class CommentListTest {\n private final List storedComments = commentsForStore();\n\n @Autowired\n private CommentPublicQueryServiceImpl commentPublicQueryService;\n\n @BeforeEach\n void setUp() {\n Flux.fromIterable(storedComments)\n .flatMap(comment -> client.create(comment))\n .as(StepVerifier::create)\n .expectNextCount(storedComments.size())\n .verifyComplete();\n }\n\n @AfterEach\n void tearDown() {\n Flux.fromIterable(storedComments)\n .flatMap(CommentPublicQueryServiceIntegrationTest.this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(storedComments.size())\n .verifyComplete();\n }\n\n @Test\n void listWhenUserNotLogin() {\n Ref ref = Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class));\n commentPublicQueryService.list(ref, 1, 10)\n .as(StepVerifier::create)\n .consumeNextWith(listResult -> {\n assertThat(listResult.getTotal()).isEqualTo(2);\n assertThat(listResult.getItems().size()).isEqualTo(2);\n assertThat(listResult.getItems().get(0).getMetadata().getName())\n .isEqualTo(\"comment-approved\");\n })\n .verifyComplete();\n }\n\n @Test\n @WithMockUser(username = AnonymousUserConst.PRINCIPAL)\n void listWhenUserIsAnonymous() {\n Ref ref = Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class));\n commentPublicQueryService.list(ref, 1, 10)\n .as(StepVerifier::create)\n .consumeNextWith(listResult -> {\n assertThat(listResult.getTotal()).isEqualTo(2);\n assertThat(listResult.getItems().size()).isEqualTo(2);\n assertThat(listResult.getItems().get(0).getMetadata().getName())\n .isEqualTo(\"comment-approved\");\n })\n .verifyComplete();\n }\n\n @Test\n @WithMockUser(username = \"fake-user\")\n void listWhenUserLoggedIn() {\n Ref ref = Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class));\n commentPublicQueryService.list(ref, 1, 10)\n .as(StepVerifier::create)\n .consumeNextWith(listResult -> {\n assertThat(listResult.getTotal()).isEqualTo(3);\n assertThat(listResult.getItems().size()).isEqualTo(3);\n assertThat(listResult.getItems().get(0).getMetadata().getName())\n .isEqualTo(\"comment-approved\");\n assertThat(listResult.getItems().get(1).getMetadata().getName())\n .isEqualTo(\"comment-approved-but-another-owner\");\n assertThat(listResult.getItems().get(2).getMetadata().getName())\n .isEqualTo(\"comment-not-approved\");\n })\n .verifyComplete();\n }\n\n List commentsForStore() {\n // Mock\n Comment commentNotApproved = fakeComment();\n commentNotApproved.getMetadata().setName(\"comment-not-approved\");\n commentNotApproved.getSpec().setApproved(false);\n\n Comment commentApproved = fakeComment();\n commentApproved.getMetadata().setName(\"comment-approved\");\n commentApproved.getSpec().setApproved(true);\n\n Comment notApprovedWithAnonymous = fakeComment();\n notApprovedWithAnonymous.getMetadata().setName(\"comment-not-approved-anonymous\");\n notApprovedWithAnonymous.getSpec().setApproved(false);\n notApprovedWithAnonymous.getSpec().getOwner().setName(AnonymousUserConst.PRINCIPAL);\n\n Comment commentApprovedButAnotherOwner = fakeComment();\n commentApprovedButAnotherOwner.getMetadata()\n .setName(\"comment-approved-but-another-owner\");\n commentApprovedButAnotherOwner.getSpec().setApproved(true);\n commentApprovedButAnotherOwner.getSpec().getOwner().setName(\"another\");\n\n Comment commentNotApprovedAndAnotherOwner = fakeComment();\n commentNotApprovedAndAnotherOwner.getMetadata()\n .setName(\"comment-not-approved-and-another\");\n commentNotApprovedAndAnotherOwner.getSpec().setApproved(false);\n commentNotApprovedAndAnotherOwner.getSpec().getOwner().setName(\"another\");\n\n Comment notApprovedAndAnotherRef = fakeComment();\n notApprovedAndAnotherRef.getMetadata()\n .setName(\"comment-not-approved-and-another-ref\");\n notApprovedAndAnotherRef.getSpec().setApproved(false);\n Ref anotherRef =\n Ref.of(\"another-fake-post\", GroupVersionKind.fromExtension(Post.class));\n notApprovedAndAnotherRef.getSpec().setSubjectRef(anotherRef);\n\n return List.of(\n commentNotApproved,\n commentApproved,\n commentApprovedButAnotherOwner,\n commentNotApprovedAndAnotherOwner,\n notApprovedWithAnonymous,\n notApprovedAndAnotherRef\n );\n }\n\n Comment fakeComment() {\n Comment comment = createComment();\n comment.getMetadata().setDeletionTimestamp(null);\n comment.getMetadata().setName(\"fake-comment\");\n\n comment.getSpec().setRaw(\"fake-raw\");\n comment.getSpec().setContent(\"fake-content\");\n comment.getSpec().setHidden(false);\n comment.getSpec()\n .setSubjectRef(Ref.of(\"fake-post\", GroupVersionKind.fromExtension(Post.class)));\n Comment.CommentOwner commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(User.KIND);\n commentOwner.setName(\"fake-user\");\n commentOwner.setDisplayName(\"fake-display-name\");\n comment.getSpec().setOwner(commentOwner);\n return comment;\n }\n }\n\n @Nested\n class CommentDefaultSortTest {\n private final List commentList = createCommentList();\n\n @BeforeEach\n void setUp() {\n Flux.fromIterable(commentList)\n .flatMap(comment -> client.create(comment))\n .as(StepVerifier::create)\n .expectNextCount(commentList.size())\n .verifyComplete();\n }\n\n @AfterEach\n void tearDown() {\n Flux.fromIterable(commentList)\n .flatMap(CommentPublicQueryServiceIntegrationTest.this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(commentList.size())\n .verifyComplete();\n }\n\n @Test\n void sortTest() {\n var comments = client.listAll(Comment.class, new ListOptions(),\n CommentPublicQueryServiceImpl.defaultCommentSort())\n .collectList()\n .block();\n assertThat(comments).isNotNull();\n\n var result = comments.stream()\n .map(comment -> comment.getMetadata().getName())\n .collect(Collectors.joining(\", \"));\n assertThat(result).isEqualTo(\"1, 2, 4, 3, 5, 6, 10, 14, 9, 8, 7, 11, 12, 13\");\n }\n\n List createCommentList() {\n // 1, now + 1s, top, 0\n // 2, now + 2s, top, 1\n // 3, now + 3s, top, 2\n // 4, now + 4s, top, 2\n // 5, now + 4s, top, 3\n // 6, now + 4s, no, 0\n // 7, now + 1s, no, 0\n // 8, now + 2s, no, 0\n // 9, now + 3s, no, 0\n // 10, null, no, 0\n // 11, null, no, 1\n // 12, null, no, 3\n // 13, now + 3s, no, 3\n Instant now = Instant.now();\n var comment1 = commentForCompare(\"1\", now.plusSeconds(1), true, 0);\n var comment2 = commentForCompare(\"2\", now.plusSeconds(2), true, 1);\n var comment3 = commentForCompare(\"3\", now.plusSeconds(3), true, 2);\n var comment4 = commentForCompare(\"4\", now.plusSeconds(4), true, 2);\n var comment5 = commentForCompare(\"5\", now.plusSeconds(4), true, 3);\n var comment6 = commentForCompare(\"6\", now.plusSeconds(4), true, 3);\n var comment7 = commentForCompare(\"7\", now.plusSeconds(1), false, 0);\n var comment8 = commentForCompare(\"8\", now.plusSeconds(2), false, 0);\n var comment9 = commentForCompare(\"9\", now.plusSeconds(3), false, 0);\n var comment10 = commentForCompare(\"10\", now.plusSeconds(3), false, 0);\n var comment11 = commentForCompare(\"11\", now, false, 0);\n var comment12 = commentForCompare(\"12\", now, false, 1);\n var comment13 = commentForCompare(\"13\", now, false, 3);\n var comment14 = commentForCompare(\"14\", now.plusSeconds(3), false, 3);\n\n return List.of(comment1, comment2, comment3, comment4, comment5, comment6, comment7,\n comment8, comment9, comment10, comment11, comment12, comment13, comment14);\n }\n\n Comment commentForCompare(String name, Instant creationTime, boolean top, int priority) {\n var comment = createComment();\n comment.getMetadata().setName(name);\n comment.getMetadata().setCreationTimestamp(creationTime);\n comment.getSpec().setCreationTime(creationTime);\n comment.getSpec().setTop(top);\n comment.getSpec().setPriority(priority);\n return comment;\n }\n }\n\n @Nested\n class ListReplyTest {\n private final List storedReplies = mockRelies();\n\n @Autowired\n private CommentPublicQueryServiceImpl commentPublicQueryService;\n\n @BeforeEach\n void setUp() {\n // create comment\n var comment = createComment();\n client.create(comment)\n .onErrorResume(DuplicateNameException.class, e -> Mono.just(comment))\n .as(StepVerifier::create)\n .expectNextCount(1)\n .verifyComplete();\n Flux.fromIterable(storedReplies)\n .flatMap(reply -> client.create(reply))\n .as(StepVerifier::create)\n .expectNextCount(storedReplies.size())\n .verifyComplete();\n }\n\n @AfterEach\n void tearDown() {\n Flux.fromIterable(storedReplies)\n .flatMap(CommentPublicQueryServiceIntegrationTest.this::deleteImmediately)\n .as(StepVerifier::create)\n .expectNextCount(storedReplies.size())\n .verifyComplete();\n }\n\n @Test\n void listWhenUserNotLogin() {\n commentPublicQueryService.listReply(\"fake-comment\", 1, 10)\n .as(StepVerifier::create)\n .consumeNextWith(listResult -> {\n assertThat(listResult.getTotal()).isEqualTo(2);\n assertThat(listResult.getItems().size()).isEqualTo(2);\n assertThat(listResult.getItems().get(0).getMetadata().getName())\n .isEqualTo(\"reply-approved\");\n })\n .verifyComplete();\n }\n\n @Test\n @WithMockUser(username = AnonymousUserConst.PRINCIPAL)\n void listWhenUserIsAnonymous() {\n commentPublicQueryService.listReply(\"fake-comment\", 1, 10)\n .as(StepVerifier::create)\n .consumeNextWith(listResult -> {\n assertThat(listResult.getTotal()).isEqualTo(2);\n assertThat(listResult.getItems().size()).isEqualTo(2);\n assertThat(listResult.getItems().get(0).getMetadata().getName())\n .isEqualTo(\"reply-approved\");\n })\n .verifyComplete();\n }\n\n @Test\n @WithMockUser(username = \"fake-user\")\n void listWhenUserLoggedIn() {\n commentPublicQueryService.listReply(\"fake-comment\", 1, 10)\n .as(StepVerifier::create)\n .consumeNextWith(listResult -> {\n assertThat(listResult.getTotal()).isEqualTo(3);\n assertThat(listResult.getItems().size()).isEqualTo(3);\n assertThat(listResult.getItems().get(0).getMetadata().getName())\n .isEqualTo(\"reply-approved\");\n assertThat(listResult.getItems().get(1).getMetadata().getName())\n .isEqualTo(\"reply-approved-but-another-owner\");\n assertThat(listResult.getItems().get(2).getMetadata().getName())\n .isEqualTo(\"reply-not-approved\");\n })\n .verifyComplete();\n }\n\n @Test\n void desensitizeReply() throws JSONException {\n var reply = createReply();\n reply.getSpec().getOwner()\n .setAnnotations(new HashMap<>() {\n {\n put(Comment.CommentOwner.KIND_EMAIL, \"mail@halo.run\");\n }\n });\n reply.getSpec().setIpAddress(\"127.0.0.1\");\n\n var result = commentPublicQueryService.toReplyVo(reply).block();\n result.getMetadata().setCreationTimestamp(null);\n var jsonObject = JsonUtils.jsonToObject(fakeReplyJson(), JsonNode.class);\n ((ObjectNode) jsonObject.get(\"owner\"))\n .put(\"displayName\", \"已删除用户\");\n JSONAssert.assertEquals(jsonObject.toString(),\n JsonUtils.objectToJson(result),\n true);\n }\n\n String fakeReplyJson() {\n return \"\"\"\n {\n \"metadata\":{\n \"name\":\"fake-reply\"\n },\n \"spec\":{\n \"raw\":\"fake-raw\",\n \"content\":\"fake-content\",\n \"owner\":{\n \"kind\":\"User\",\n \"name\":\"\",\n \"displayName\":\"fake-display-name\",\n \"annotations\":{\n \"email-hash\": \\\n \"79783106d88279c6c8f94f1f4dec22bdb9f90a8d14c9d6c6628a11430e236cbf\"\n }\n },\n \"creationTime\": \"2024-03-11T06:23:42.923294424Z\",\n \"ipAddress\":\"\",\n \"hidden\": false,\n \"allowNotification\": false,\n \"top\": false,\n \"priority\": 0,\n \"commentName\":\"fake-comment\"\n },\n \"owner\":{\n \"kind\":\"User\",\n \"displayName\":\"fake-display-name\"\n },\n \"stats\":{\n \"upvote\":0\n }\n }\n \"\"\";\n }\n\n private List mockRelies() {\n // Mock\n Reply notApproved = createReply();\n notApproved.getMetadata().setName(\"reply-not-approved\");\n notApproved.getSpec().setApproved(false);\n\n Reply approved = createReply();\n approved.getMetadata().setName(\"reply-approved\");\n approved.getSpec().setApproved(true);\n\n Reply notApprovedWithAnonymous = createReply();\n notApprovedWithAnonymous.getMetadata().setName(\"reply-not-approved-anonymous\");\n notApprovedWithAnonymous.getSpec().setApproved(false);\n notApprovedWithAnonymous.getSpec().getOwner().setName(AnonymousUserConst.PRINCIPAL);\n\n Reply approvedButAnotherOwner = createReply();\n approvedButAnotherOwner.getMetadata()\n .setName(\"reply-approved-but-another-owner\");\n approvedButAnotherOwner.getSpec().setApproved(true);\n approvedButAnotherOwner.getSpec().getOwner().setName(\"another\");\n\n Reply notApprovedAndAnotherOwner = createReply();\n notApprovedAndAnotherOwner.getMetadata()\n .setName(\"reply-not-approved-and-another\");\n notApprovedAndAnotherOwner.getSpec().setApproved(false);\n notApprovedAndAnotherOwner.getSpec().getOwner().setName(\"another\");\n\n Reply notApprovedAndAnotherCommentName = createReply();\n notApprovedAndAnotherCommentName.getMetadata()\n .setName(\"reply-approved-and-another-comment-name\");\n notApprovedAndAnotherCommentName.getSpec().setApproved(false);\n notApprovedAndAnotherCommentName.getSpec().setCommentName(\"another-fake-comment\");\n\n return List.of(\n notApproved,\n approved,\n approvedButAnotherOwner,\n notApprovedAndAnotherOwner,\n notApprovedWithAnonymous,\n notApprovedAndAnotherCommentName\n );\n }\n\n Reply createReply() {\n var reply = JsonUtils.jsonToObject(fakeReplyJson(), Reply.class);\n reply.getMetadata().setName(\"fake-reply\");\n\n reply.getSpec().setRaw(\"fake-raw\");\n reply.getSpec().setContent(\"fake-content\");\n reply.getSpec().setHidden(false);\n reply.getSpec().setCommentName(\"fake-comment\");\n Comment.CommentOwner commentOwner = new Comment.CommentOwner();\n commentOwner.setKind(User.KIND);\n commentOwner.setName(\"fake-user\");\n commentOwner.setDisplayName(\"fake-display-name\");\n reply.getSpec().setOwner(commentOwner);\n return reply;\n }\n }\n\n Comment createComment() {\n return JsonUtils.jsonToObject(\"\"\"\n {\n \"spec\": {\n \"raw\": \"fake-raw\",\n \"content\": \"fake-content\",\n \"owner\": {\n \"kind\": \"User\",\n \"name\": \"fake-user\"\n },\n \"userAgent\": \"\",\n \"ipAddress\": \"\",\n \"approvedTime\": \"2024-02-28T09:15:16.095Z\",\n \"creationTime\": \"2024-02-28T06:23:42.923294424Z\",\n \"priority\": 0,\n \"top\": false,\n \"allowNotification\": false,\n \"approved\": true,\n \"hidden\": false,\n \"subjectRef\": {\n \"group\": \"content.halo.run\",\n \"version\": \"v1alpha1\",\n \"kind\": \"SinglePage\",\n \"name\": \"67\"\n },\n \"lastReadTime\": \"2024-02-29T03:39:04.230Z\"\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Comment\",\n \"metadata\": {\n \"name\": \"fake-comment\",\n \"creationTimestamp\": \"2024-02-28T06:23:42.923439037Z\"\n }\n }\n \"\"\", Comment.class);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/MenuFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\n\nimport java.util.Collections;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.util.function.Tuple2;\nimport reactor.util.function.Tuples;\nimport run.halo.app.core.extension.Menu;\nimport run.halo.app.core.extension.MenuItem;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.theme.finders.vo.MenuVo;\n\n/**\n * Tests for {@link MenuFinderImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass MenuFinderImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @InjectMocks\n private MenuFinderImpl menuFinder;\n\n @Test\n void listAsTree() {\n Tuple2, List> tuple = testTree();\n Mockito.when(client.list(eq(Menu.class), eq(null), eq(null)))\n .thenReturn(Flux.fromIterable(tuple.getT1()));\n Mockito.when(client.list(eq(MenuItem.class), eq(null), any()))\n .thenReturn(Flux.fromIterable(tuple.getT2()));\n\n List menuVos = menuFinder.listAsTree().collectList().block();\n assertThat(visualizeTree(menuVos)).isEqualTo(\"\"\"\n D\n └── E\n ├── A\n │ └── B\n └── C\n X\n └── G\n Y\n └── F\n └── H\n \"\"\");\n }\n\n /**\n * Visualize a tree.\n */\n String visualizeTree(List menuVos) {\n StringBuilder stringBuilder = new StringBuilder();\n for (MenuVo menuVo : menuVos) {\n menuVo.print(stringBuilder);\n }\n return stringBuilder.toString();\n }\n\n Tuple2, List> testTree() {\n /*\n * D\n * ├── E\n * │ ├── A\n * │ │ └── B\n * │ └── C\n * X── G\n * Y── F\n * └── H\n */\n Menu menuD = menu(\"D\", of(\"E\"));\n Menu menuX = menu(\"X\", of(\"G\"));\n Menu menuY = menu(\"Y\", of(\"F\"));\n\n MenuItem itemE = menuItem(\"E\", of(\"A\", \"C\", \"non-existent-children-name\"));\n MenuItem itemG = menuItem(\"G\", null);\n MenuItem itemF = menuItem(\"F\", of(\"H\"));\n MenuItem itemA = menuItem(\"A\", of(\"B\"));\n MenuItem itemB = menuItem(\"B\", null);\n MenuItem itemC = menuItem(\"C\", null);\n MenuItem itemH = menuItem(\"H\", null);\n return Tuples.of(List.of(menuD, menuX, menuY),\n List.of(itemE, itemG, itemF, itemA, itemB, itemC, itemH));\n }\n\n LinkedHashSet of(String... names) {\n LinkedHashSet list = new LinkedHashSet<>();\n Collections.addAll(list, names);\n return list;\n }\n\n Menu menu(String name, LinkedHashSet menuItemNames) {\n Menu menu = new Menu();\n Metadata metadata = new Metadata();\n metadata.setName(name);\n menu.setMetadata(metadata);\n\n Menu.Spec spec = new Menu.Spec();\n spec.setDisplayName(name);\n spec.setMenuItems(menuItemNames);\n menu.setSpec(spec);\n return menu;\n }\n\n MenuItem menuItem(String name, LinkedHashSet childrenNames) {\n MenuItem menuItem = new MenuItem();\n Metadata metadata = new Metadata();\n metadata.setName(name);\n menuItem.setMetadata(metadata);\n\n MenuItem.MenuItemSpec spec = new MenuItem.MenuItemSpec();\n spec.setPriority(0);\n spec.setDisplayName(name);\n spec.setChildren(childrenNames);\n menuItem.setSpec(spec);\n\n MenuItem.MenuItemStatus status = new MenuItem.MenuItemStatus();\n menuItem.setStatus(status);\n return menuItem;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/PluginFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.assertj.core.api.Assertions.assertThatThrownBy;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.pf4j.DefaultVersionManager;\nimport org.pf4j.PluginDescriptor;\nimport org.pf4j.PluginManager;\nimport org.pf4j.PluginState;\nimport org.pf4j.PluginWrapper;\n\n/**\n * Tests for {@link PluginFinderImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PluginFinderImplTest {\n\n @Mock\n private PluginManager haloPluginManager;\n\n @InjectMocks\n private PluginFinderImpl pluginFinder;\n\n @Test\n void available() {\n assertThat(pluginFinder.available(null)).isFalse();\n\n boolean available = pluginFinder.available(\"fake-plugin\");\n assertThat(available).isFalse();\n\n PluginWrapper mockPluginWrapper = Mockito.mock(PluginWrapper.class);\n when(haloPluginManager.getPlugin(eq(\"fake-plugin\")))\n .thenReturn(mockPluginWrapper);\n\n when(mockPluginWrapper.getPluginState()).thenReturn(PluginState.RESOLVED);\n available = pluginFinder.available(\"fake-plugin\");\n assertThat(available).isFalse();\n\n when(mockPluginWrapper.getPluginState()).thenReturn(PluginState.STARTED);\n available = pluginFinder.available(\"fake-plugin\");\n assertThat(available).isTrue();\n }\n\n @Test\n void availableWithVersionTest() {\n when(haloPluginManager.getVersionManager()).thenReturn(new DefaultVersionManager());\n\n assertThatThrownBy(() -> pluginFinder.available(\"fake-plugin\", null))\n .isInstanceOf(IllegalArgumentException.class);\n\n boolean available = pluginFinder.available(\"fake-plugin\", \"1.0.0\");\n assertThat(available).isFalse();\n\n PluginWrapper mockPluginWrapper = Mockito.mock(PluginWrapper.class);\n when(haloPluginManager.getPlugin(eq(\"fake-plugin\")))\n .thenReturn(mockPluginWrapper);\n\n when(mockPluginWrapper.getPluginState()).thenReturn(PluginState.STARTED);\n var descriptor = mock(PluginDescriptor.class);\n when(mockPluginWrapper.getDescriptor()).thenReturn(descriptor);\n when(descriptor.getVersion()).thenReturn(\"1.0.0\");\n\n available = pluginFinder.available(\"fake-plugin\", \"1.0.0\");\n assertThat(available).isTrue();\n\n available = pluginFinder.available(\"fake-plugin\", \">=1.0.0\");\n assertThat(available).isTrue();\n\n available = pluginFinder.available(\"fake-plugin\", \"<2.0.0\");\n assertThat(available).isTrue();\n\n available = pluginFinder.available(\"fake-plugin\", \"2.0.0\");\n assertThat(available).isFalse();\n\n available = pluginFinder.available(\"fake-plugin\", \"<1.0.0\");\n assertThat(available).isFalse();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/PostFinderImplIntegrationTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.thymeleaf.IEngineConfiguration;\nimport org.thymeleaf.TemplateEngine;\nimport org.thymeleaf.context.Context;\nimport org.thymeleaf.spring6.SpringTemplateEngine;\nimport org.thymeleaf.spring6.dialect.SpringStandardDialect;\nimport org.thymeleaf.standard.expression.IStandardVariableExpressionEvaluator;\nimport org.thymeleaf.templateresolver.StringTemplateResolver;\nimport org.thymeleaf.templateresource.ITemplateResource;\nimport org.thymeleaf.templateresource.StringTemplateResource;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.theme.ReactiveSpelVariableExpressionEvaluator;\nimport run.halo.app.theme.finders.PostPublicQueryService;\n\n/**\n * Tests for {@link PostFinderImpl}.\n *\n * @author guqing\n * @since 2.19.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostFinderImplIntegrationTest {\n\n private TemplateEngine templateEngine;\n\n @Mock\n private PostPublicQueryService postPublicQueryService;\n\n @InjectMocks\n private PostFinderImpl postFinder;\n\n @Mock\n private TemplateResourceComputer templateResourceComputer;\n\n @BeforeEach\n void setUp() {\n templateEngine = new SpringTemplateEngine();\n templateEngine.setDialect(new SpringStandardDialect() {\n @Override\n public IStandardVariableExpressionEvaluator getVariableExpressionEvaluator() {\n return ReactiveSpelVariableExpressionEvaluator.INSTANCE;\n }\n });\n templateEngine.addTemplateResolver(new TestTemplateResolver(templateResourceComputer));\n }\n\n @Test\n void listTest() {\n var context = new Context();\n context.setVariable(\"postFinder\", postFinder);\n\n // empty param\n when(templateResourceComputer.compute(eq(\"post\"))).thenReturn(new StringTemplateResource(\"\"\"\n \n \"\"\"));\n\n when(postPublicQueryService.list(any(), any()))\n .thenReturn(Mono.just(ListResult.emptyResult()));\n\n var result = templateEngine.process(\"post\", context);\n assertThat(result).isEqualToIgnoringWhitespace(\n \"ListResult(page=0, size=0, total=0, items=[])\");\n\n when(templateResourceComputer.compute(eq(\"post\"))).thenReturn(new StringTemplateResource(\"\"\"\n \n \n \"\"\"));\n result = templateEngine.process(\"post\", context);\n assertThat(result).isEqualToIgnoringWhitespace(\"\");\n }\n\n static class TestTemplateResolver extends StringTemplateResolver {\n private final TemplateResourceComputer templateResourceComputer;\n\n TestTemplateResolver(TemplateResourceComputer templateResourceComputer) {\n this.templateResourceComputer = templateResourceComputer;\n }\n\n @Override\n protected ITemplateResource computeTemplateResource(IEngineConfiguration configuration,\n String ownerTemplate, String template,\n Map templateResolutionAttributes) {\n return templateResourceComputer.compute(template);\n }\n }\n\n interface TemplateResourceComputer {\n ITemplateResource compute(String template);\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/PostFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Predicate;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.counter.CounterService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.theme.finders.CategoryFinder;\nimport run.halo.app.theme.finders.ContributorFinder;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.finders.vo.ListedPostVo;\nimport run.halo.app.theme.finders.vo.PostArchiveVo;\nimport run.halo.app.theme.finders.vo.PostArchiveYearMonthVo;\nimport run.halo.app.theme.router.DefaultQueryPostPredicateResolver;\n\n/**\n * Tests for {@link PostFinderImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostFinderImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private CounterService counterService;\n\n @Mock\n private PostService postService;\n\n @Mock\n private CategoryFinder categoryFinder;\n\n @Mock\n private TagFinder tagFinder;\n\n @Mock\n private ContributorFinder contributorFinder;\n\n @Mock\n private PostPublicQueryService publicQueryService;\n\n @InjectMocks\n private PostFinderImpl postFinder;\n\n @Test\n void predicate() {\n Predicate predicate = new DefaultQueryPostPredicateResolver().getPredicate().block();\n assertThat(predicate).isNotNull();\n\n List strings = posts().stream().filter(predicate)\n .map(post -> post.getMetadata().getName())\n .toList();\n assertThat(strings).isEqualTo(List.of(\"post-1\", \"post-2\", \"post-6\"));\n }\n\n @Test\n void archives() {\n List listedPostVos = postsForArchives().stream()\n .map(ListedPostVo::from)\n .toList();\n ListResult listResult = new ListResult<>(1, 10, 3, listedPostVos);\n when(publicQueryService.list(any(), any(PageRequest.class)))\n .thenReturn(Mono.just(listResult));\n\n ListResult archives = postFinder.archives(1, 10).block();\n assertThat(archives).isNotNull();\n\n List items = archives.getItems();\n assertThat(items.size()).isEqualTo(2);\n assertThat(items.get(0).getYear()).isEqualTo(\"2022\");\n assertThat(items.get(0).getMonths().size()).isEqualTo(1);\n List months = items.get(0).getMonths();\n assertThat(months.get(0).getMonth()).isEqualTo(\"12\");\n assertThat(months.get(0).getPosts()).hasSize(2);\n\n assertThat(items.get(1).getYear()).isEqualTo(\"2021\");\n assertThat(items.get(1).getMonths()).hasSize(1);\n assertThat(items.get(1).getMonths().get(0).getMonth()).isEqualTo(\"01\");\n }\n\n List postsForArchives() {\n Post post1 = post(1);\n post1.getSpec().setPublish(true);\n post1.getSpec().setPublishTime(Instant.parse(\"2021-01-01T00:00:00Z\"));\n post1.getMetadata().setCreationTimestamp(Instant.now());\n\n Post post2 = post(2);\n post2.getSpec().setPublish(true);\n post2.getSpec().setPublishTime(Instant.parse(\"2022-12-01T00:00:00Z\"));\n post2.getMetadata().setCreationTimestamp(Instant.now());\n\n Post post3 = post(3);\n post3.getSpec().setPublish(true);\n post3.getSpec().setPublishTime(Instant.parse(\"2022-12-03T00:00:00Z\"));\n post3.getMetadata().setCreationTimestamp(Instant.now());\n return List.of(post1, post2, post3);\n }\n\n List posts() {\n // 置顶的排前面按 priority 排序\n // 再根据发布时间排序\n // 相同再根据名称排序\n // 6, 2, 1, 5, 4, 3\n Post post1 = post(1);\n post1.getSpec().setPinned(false);\n post1.getSpec().setPublishTime(Instant.now().plusSeconds(20));\n\n Post post2 = post(2);\n post2.getSpec().setPinned(true);\n post2.getSpec().setPriority(2);\n post2.getSpec().setPublishTime(Instant.now());\n\n Post post3 = post(3);\n post3.getSpec().setDeleted(true);\n post3.getSpec().setPublishTime(Instant.now());\n\n Post post4 = post(4);\n post4.getSpec().setVisible(Post.VisibleEnum.PRIVATE);\n post4.getSpec().setPublishTime(Instant.now());\n\n Post post5 = post(5);\n post5.getSpec().setPublish(false);\n post5.getMetadata().getLabels().clear();\n post5.getSpec().setPublishTime(Instant.now());\n\n Post post6 = post(6);\n post6.getSpec().setPinned(true);\n post6.getSpec().setPriority(3);\n post6.getSpec().setPublishTime(Instant.now());\n\n return List.of(post1, post2, post3, post4, post5, post6);\n }\n\n Post post(int i) {\n final Post post = new Post();\n Metadata metadata = new Metadata();\n metadata.setName(\"post-\" + i);\n metadata.setCreationTimestamp(Instant.now());\n metadata.setAnnotations(Map.of(\"K1\", \"V1\"));\n metadata.setLabels(new HashMap<>());\n metadata.getLabels().put(Post.PUBLISHED_LABEL, \"true\");\n post.setMetadata(metadata);\n\n Post.PostSpec postSpec = new Post.PostSpec();\n postSpec.setDeleted(false);\n postSpec.setAllowComment(true);\n postSpec.setPublishTime(Instant.now());\n postSpec.setPinned(false);\n postSpec.setPriority(0);\n postSpec.setPublish(true);\n postSpec.setVisible(Post.VisibleEnum.PUBLIC);\n postSpec.setTitle(\"title-\" + i);\n postSpec.setSlug(\"slug-\" + i);\n post.setSpec(postSpec);\n\n Post.PostStatus postStatus = new Post.PostStatus();\n postStatus.setPermalink(\"/post-\" + i);\n postStatus.setContributors(List.of(\"contributor-1\", \"contributor-2\"));\n postStatus.setExcerpt(\"hello world!\");\n post.setStatus(postStatus);\n return post;\n }\n\n @Nested\n class PostQueryTest {\n\n @Test\n void toPageRequestTest() {\n var query = new PostFinderImpl.PostQuery();\n var result = query.toPageRequest();\n assertThat(result.getSort()).isEqualTo(PostFinderImpl.defaultSort());\n\n query.setSort(List.of(\"spec.publishTime,desc\"));\n result = query.toPageRequest();\n assertThat(result.getSort())\n .isEqualTo(Sort.by(Sort.Order.desc(\"spec.publishTime\"))\n .and(PostFinderImpl.defaultSort()));\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/PostPublicQueryServiceImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.ReactivePostContentHandler;\n\n/**\n * Tests for {@link PostPublicQueryServiceImpl}.\n *\n * @author guqing\n * @since 2.7.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostPublicQueryServiceImplTest {\n\n @Mock\n private ExtensionGetter extensionGetter;\n\n @InjectMocks\n private PostPublicQueryServiceImpl postPublicQueryService;\n\n @Test\n void extendPostContent() {\n when(extensionGetter.getEnabledExtensions(\n eq(ReactivePostContentHandler.class))).thenReturn(\n Flux.just(new PostContentHandlerB(), new PostContentHandlerA(),\n new PostContentHandlerC()));\n Post post = TestPost.postV1();\n post.getMetadata().setName(\"fake-post\");\n ContentWrapper contentWrapper =\n ContentWrapper.builder().content(\"fake-content\").raw(\"fake-raw\").rawType(\"markdown\")\n .build();\n postPublicQueryService.extendPostContent(post, contentWrapper)\n .as(StepVerifier::create).consumeNextWith(contentVo -> {\n assertThat(contentVo.getContent()).isEqualTo(\"fake-content-B-A-C\");\n }).verifyComplete();\n }\n\n static class PostContentHandlerA implements ReactivePostContentHandler {\n\n @Override\n public Mono handle(PostContentContext postContent) {\n postContent.setContent(postContent.getContent() + \"-A\");\n return Mono.just(postContent);\n }\n }\n\n static class PostContentHandlerB implements ReactivePostContentHandler {\n\n @Override\n public Mono handle(PostContentContext postContent) {\n postContent.setContent(postContent.getContent() + \"-B\");\n return Mono.just(postContent);\n }\n }\n\n static class PostContentHandlerC implements ReactivePostContentHandler {\n\n @Override\n public Mono handle(PostContentContext postContent) {\n postContent.setContent(postContent.getContent() + \"-C\");\n return Mono.just(postContent);\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/SinglePageConversionServiceImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.lang.NonNull;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.content.ContentWrapper;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.plugin.extensionpoint.ExtensionGetter;\nimport run.halo.app.theme.ReactiveSinglePageContentHandler;\n\n/**\n * Tests for {@link SinglePageConversionServiceImpl}.\n *\n * @author guqing\n * @since 2.7.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageConversionServiceImplTest {\n\n @Mock\n private ExtensionGetter extensionGetter;\n\n @InjectMocks\n private SinglePageConversionServiceImpl pageConversionService;\n\n @Test\n void extendPageContent() {\n when(extensionGetter.getEnabledExtensions(\n eq(ReactiveSinglePageContentHandler.class)))\n .thenReturn(\n Flux.just(new PageContentHandlerB(),\n new PageContentHandlerA(),\n new PageContentHandlerC())\n );\n ContentWrapper contentWrapper = ContentWrapper.builder()\n .content(\"fake-content\")\n .raw(\"fake-raw\")\n .rawType(\"markdown\")\n .build();\n SinglePage singlePage = new SinglePage();\n singlePage.setMetadata(new Metadata());\n singlePage.getMetadata().setName(\"fake-page\");\n pageConversionService.extendPageContent(singlePage, contentWrapper)\n .as(StepVerifier::create)\n .consumeNextWith(contentVo -> {\n assertThat(contentVo.getContent()).isEqualTo(\"fake-content-B-A-C\");\n })\n .verifyComplete();\n }\n\n static class PageContentHandlerA implements ReactiveSinglePageContentHandler {\n\n @Override\n public Mono handle(\n @NonNull SinglePageContentContext pageContent) {\n pageContent.setContent(pageContent.getContent() + \"-A\");\n return Mono.just(pageContent);\n }\n }\n\n static class PageContentHandlerB implements ReactiveSinglePageContentHandler {\n\n @Override\n public Mono handle(\n @NonNull SinglePageContentContext pageContent) {\n pageContent.setContent(pageContent.getContent() + \"-B\");\n return Mono.just(pageContent);\n }\n }\n\n static class PageContentHandlerC implements ReactiveSinglePageContentHandler {\n\n @Override\n public Mono handle(\n @NonNull SinglePageContentContext pageContent) {\n pageContent.setContent(pageContent.getContent() + \"-C\");\n return Mono.just(pageContent);\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/SinglePageFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.theme.finders.SinglePageConversionService;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * Tests for {@link SinglePageFinderImpl}.\n *\n * @author guqing\n * @since 2.0.1\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageFinderImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private SinglePageConversionService singlePageConversionService;\n\n @InjectMocks\n private SinglePageFinderImpl singlePageFinder;\n\n @Test\n void getByName() {\n // fix gh-2992\n String fakePageName = \"fake-page\";\n SinglePage singlePage = new SinglePage();\n singlePage.setMetadata(new Metadata());\n singlePage.getMetadata().setName(fakePageName);\n singlePage.getMetadata().setLabels(Map.of(SinglePage.PUBLISHED_LABEL, \"true\"));\n singlePage.setSpec(new SinglePage.SinglePageSpec());\n singlePage.getSpec().setOwner(\"fake-owner\");\n singlePage.getSpec().setReleaseSnapshot(\"fake-release\");\n singlePage.getSpec().setPublish(true);\n singlePage.getSpec().setDeleted(false);\n singlePage.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n singlePage.setStatus(new SinglePage.SinglePageStatus());\n when(client.get(eq(SinglePage.class), eq(fakePageName)))\n .thenReturn(Mono.just(singlePage));\n\n when(singlePageConversionService.convertToVo(eq(singlePage)))\n .thenReturn(Mono.just(mock(SinglePageVo.class)));\n\n singlePageFinder.getByName(fakePageName)\n .as(StepVerifier::create)\n .consumeNextWith(page -> assertThat(page).isNotNull())\n .verifyComplete();\n\n verify(client).get(SinglePage.class, fakePageName);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/TagFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.time.Instant;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.stream.Collectors;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.data.domain.Sort;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ListOptions;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.utils.JsonUtils;\nimport run.halo.app.theme.finders.vo.TagVo;\n\n/**\n * Tests for {@link TagFinderImpl}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass TagFinderImplTest {\n\n @Mock\n private ReactiveExtensionClient client;\n\n private TagFinderImpl tagFinder;\n\n @BeforeEach\n void setUp() {\n tagFinder = new TagFinderImpl(client);\n }\n\n @Test\n void getByName() throws JSONException {\n when(client.fetch(eq(Tag.class), eq(\"t1\")))\n .thenReturn(Mono.just(tag(1)));\n TagVo tagVo = tagFinder.getByName(\"t1\").block();\n tagVo.getMetadata().setCreationTimestamp(null);\n JSONAssert.assertEquals(\"\"\"\n {\n \"metadata\": {\n \"name\": \"t1\",\n \"annotations\": {\n \"K1\": \"V1\"\n }\n },\n \"spec\": {\n \"displayName\": \"displayName-1\",\n \"slug\": \"slug-1\",\n \"color\": \"color-1\",\n \"cover\": \"cover-1\"\n },\n \"status\": {\n \"permalink\": \"permalink-1\",\n \"postCount\": 2,\n \"visiblePostCount\": 1\n },\n \"postCount\": 1\n }\n \"\"\",\n JsonUtils.objectToJson(tagVo),\n true);\n }\n\n @Test\n void listAll() {\n when(client.listAll(eq(Tag.class), any(ListOptions.class), any(Sort.class)))\n .thenReturn(Flux.fromIterable(\n tags().stream().sorted(TagFinderImpl.DEFAULT_COMPARATOR.reversed()).toList()\n )\n );\n List tags = tagFinder.listAll().collectList().block();\n assertThat(tags).hasSize(3);\n assertThat(tags.stream()\n .map(tag -> tag.getMetadata().getName())\n .collect(Collectors.toList()))\n .isEqualTo(List.of(\"t3\", \"t2\", \"t1\"));\n }\n\n List tags() {\n Tag tag1 = tag(1);\n\n Tag tag2 = tag(2);\n tag2.getMetadata().setCreationTimestamp(Instant.now().plusSeconds(1));\n\n Tag tag3 = tag(3);\n tag3.getMetadata().setCreationTimestamp(Instant.now().plusSeconds(2));\n // sorted: 3, 2, 1\n return List.of(tag2, tag1, tag3);\n }\n\n Tag tag(int i) {\n final Tag tag = new Tag();\n Metadata metadata = new Metadata();\n metadata.setName(\"t\" + i);\n metadata.setAnnotations(Map.of(\"K1\", \"V1\"));\n metadata.setCreationTimestamp(Instant.now());\n tag.setMetadata(metadata);\n\n Tag.TagSpec tagSpec = new Tag.TagSpec();\n tagSpec.setDisplayName(\"displayName-\" + i);\n tagSpec.setSlug(\"slug-\" + i);\n tagSpec.setColor(\"color-\" + i);\n tagSpec.setCover(\"cover-\" + i);\n tag.setSpec(tagSpec);\n\n Tag.TagStatus tagStatus = new Tag.TagStatus();\n tagStatus.setPermalink(\"permalink-\" + i);\n tagStatus.setPostCount(2);\n tagStatus.setVisiblePostCount(1);\n tag.setStatus(tagStatus);\n return tag;\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/finders/impl/ThumbnailFinderImplTest.java", "content": "package run.halo.app.theme.finders.impl;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.attachment.thumbnail.ThumbnailService;\n\n/**\n * Tests for {@link ThumbnailFinderImpl}.\n *\n * @author guqing\n * @since 2.20.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ThumbnailFinderImplTest {\n\n @Mock\n ThumbnailService thumbnailService;\n\n @InjectMocks\n ThumbnailFinderImpl thumbnailFinder;\n\n @Test\n void shouldNotGenWhenUriIsInvalid() {\n thumbnailFinder.gen(\"invalid uri\", \"l\")\n .as(StepVerifier::create)\n .expectNext(\"invalid uri\")\n .verifyComplete();\n\n verify(thumbnailService, never()).get(any(), any());\n }\n\n @Test\n void shouldGenWhenUriIsValid() {\n when(thumbnailService.get(any(), any()))\n .thenReturn(Mono.just(URI.create(\"/test-thumb.jpg\")));\n thumbnailFinder.gen(\"/test.jpg\", \"l\")\n .as(StepVerifier::create)\n .expectNext(\"/test-thumb.jpg\")\n .verifyComplete();\n\n verify(thumbnailService).get(any(), any());\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/finders/vo/UserVoTest.java", "content": "package run.halo.app.theme.finders.vo;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.time.Instant;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.Test;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.infra.utils.JsonUtils;\n\n/**\n * Tests for {@link UserVo}.\n *\n * @author guqing\n * @since 2.0.1\n */\nclass UserVoTest {\n\n @Test\n void from() throws JSONException {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-user\");\n user.setSpec(new User.UserSpec());\n user.getSpec().setPassword(\"123456\");\n user.getSpec().setEmail(\"example@example.com\");\n user.getSpec().setAvatar(\"avatar\");\n user.getSpec().setDisplayName(\"fake-user-display-name\");\n user.getSpec().setBio(\"user bio\");\n user.getSpec().setDisabled(false);\n user.getSpec().setPhone(\"123456789\");\n user.getSpec().setRegisteredAt(Instant.parse(\"2022-01-01T00:00:00.00Z\"));\n user.getSpec().setLoginHistoryLimit(5);\n user.getSpec().setTwoFactorAuthEnabled(false);\n\n user.setStatus(new User.UserStatus());\n\n UserVo userVo = UserVo.from(user);\n JSONAssert.assertEquals(\"\"\"\n {\n \"metadata\": {\n \"name\": \"fake-user\"\n },\n \"spec\": {\n \"displayName\": \"fake-user-display-name\",\n \"avatar\": \"avatar\",\n \"email\": \"example@example.com\",\n \"emailVerified\": false,\n \"phone\": \"123456789\",\n \"password\": \"[PROTECTED]\",\n \"bio\": \"user bio\",\n \"registeredAt\": \"2022-01-01T00:00:00Z\",\n \"twoFactorAuthEnabled\": false,\n \"disabled\": false,\n \"loginHistoryLimit\": 5\n },\n \"status\": {\n }\n }\n \"\"\",\n JsonUtils.objectToJson(userVo),\n true);\n }\n\n @Test\n void fromWhenStatusIsNull() {\n User user = new User();\n user.setMetadata(new Metadata());\n user.getMetadata().setName(\"fake-user\");\n user.setSpec(new User.UserSpec());\n UserVo userVo = UserVo.from(user);\n\n assertThat(userVo).isNotNull();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/message/ThemeMessageResolutionUtilsTest.java", "content": "package run.halo.app.theme.message;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport java.io.FileNotFoundException;\nimport java.net.URISyntaxException;\nimport java.net.URL;\nimport java.nio.file.Path;\nimport java.util.Locale;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.util.ResourceUtils;\nimport run.halo.app.theme.ThemeContext;\n\n/**\n * @author guqing\n * @since 2.0.0\n */\nclass ThemeMessageResolutionUtilsTest {\n private URL defaultThemeUrl;\n\n @BeforeEach\n void setUp() throws FileNotFoundException {\n defaultThemeUrl = ResourceUtils.getURL(\"classpath:themes/default\");\n }\n\n @Test\n void resolveMessagesForTemplateForDefault() throws URISyntaxException {\n Map properties =\n ThemeMessageResolutionUtils.resolveMessagesForTemplate(Locale.CHINESE, getTheme());\n assertThat(properties).isEqualTo(Map.of(\"index.welcome\", \"欢迎来到首页\",\n \"title\", \"来自 i18n/zh.properties 的标题\"));\n }\n\n @Test\n void resolveMessagesForTemplateForEnglish() throws URISyntaxException {\n Map properties =\n ThemeMessageResolutionUtils.resolveMessagesForTemplate(Locale.ENGLISH, getTheme());\n assertThat(properties).isEqualTo(Map.of(\"index.welcome\", \"Welcome to the index\",\n \"title\", \"这是来自 i18n/default.properties 的标题\"));\n }\n\n ThemeContext getTheme() throws URISyntaxException {\n return ThemeContext.builder()\n .name(\"default\")\n .path(Path.of(defaultThemeUrl.toURI()))\n .active(true)\n .build();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/message/ThemeMessageResolverIntegrationTest.java", "content": "package run.halo.app.theme.message;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.Mockito.when;\n\nimport java.io.FileNotFoundException;\nimport java.net.URISyntaxException;\nimport java.net.URL;\nimport java.nio.file.Path;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.boot.test.context.TestConfiguration;\nimport org.springframework.boot.webtestclient.autoconfigure.AutoConfigureWebTestClient;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.context.bean.override.mockito.MockitoSpyBean;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.util.ResourceUtils;\nimport org.springframework.web.reactive.function.server.RequestPredicates;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.InitializationStateGetter;\nimport run.halo.app.theme.ThemeContext;\nimport run.halo.app.theme.ThemeResolver;\n\n/**\n * Tests for {@link ThemeMessageResolver}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@SpringBootTest\n@AutoConfigureWebTestClient\npublic class ThemeMessageResolverIntegrationTest {\n\n @MockitoSpyBean\n private ThemeResolver themeResolver;\n\n private URL defaultThemeUrl;\n\n private URL otherThemeUrl;\n\n @MockitoSpyBean\n private InitializationStateGetter initializationStateGetter;\n\n @Autowired\n private WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() throws FileNotFoundException, URISyntaxException {\n when(initializationStateGetter.userInitialized()).thenReturn(Mono.just(true));\n defaultThemeUrl = ResourceUtils.getURL(\"classpath:themes/default\");\n otherThemeUrl = ResourceUtils.getURL(\"classpath:themes/other\");\n\n when(themeResolver.getTheme(any(ServerWebExchange.class)))\n .thenReturn(Mono.just(createDefaultContext()));\n }\n\n @Test\n void messageResolverWhenDefaultTheme() {\n webTestClient.get()\n .uri(\"/?language=zh\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody()\n .xpath(\"/html/body/div[1]\").isEqualTo(\"zh\")\n .xpath(\"/html/body/div[2]\").isEqualTo(\"欢迎来到首页\");\n }\n\n @Test\n void messageResolverForEnLanguageWhenDefaultTheme() {\n webTestClient.get()\n .uri(\"/?language=en\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody()\n .xpath(\"/html/body/div[1]\").isEqualTo(\"en\")\n .xpath(\"/html/body/div[2]\").isEqualTo(\"Welcome to the index\");\n }\n\n @Test\n void shouldUseDefaultWhenLanguageNotSupport() {\n webTestClient.get()\n .uri(\"/index?language=foo\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody()\n // make sure the \"templates/index.properties\" file is precedence over the\n // \"i18n/default.properties\".\n .xpath(\"/html/head/title\").isEqualTo(\"Title from index.properties\")\n .xpath(\"/html/body/div[1]\").isEqualTo(\"foo\")\n .xpath(\"/html/body/div[2]\").isEqualTo(\"欢迎来到首页\");\n }\n\n @Test\n void switchTheme() throws URISyntaxException {\n webTestClient.get()\n .uri(\"/index?language=zh\")\n .exchange()\n .expectStatus()\n .isOk()\n .expectBody()\n .xpath(\"/html/head/title\").isEqualTo(\"来自 index_zh.properties 的标题\")\n .xpath(\"/html/body/div[1]\").isEqualTo(\"zh\")\n .xpath(\"/html/body/div[2]\").isEqualTo(\"欢迎来到首页\")\n ;\n\n // For other theme\n when(themeResolver.getTheme(any(ServerWebExchange.class)))\n .thenReturn(Mono.just(createOtherContext()));\n webTestClient.get()\n .uri(\"/index?language=zh\")\n .exchange()\n .expectBody()\n .xpath(\"/html/head/title\").isEqualTo(\"Other theme title\")\n .xpath(\"/html/body/p\").isEqualTo(\"Other 首页\");\n\n webTestClient.get()\n .uri(\"/index?language=en\")\n .exchange()\n .expectBody()\n .xpath(\"/html/head/title\").isEqualTo(\"Other theme title\")\n .xpath(\"/html/body/p\").isEqualTo(\"other index\");\n }\n\n ThemeContext createDefaultContext() throws URISyntaxException {\n return ThemeContext.builder()\n .name(\"default\")\n .path(Path.of(defaultThemeUrl.toURI()))\n .active(true)\n .build();\n }\n\n ThemeContext createOtherContext() throws URISyntaxException {\n return ThemeContext.builder()\n .name(\"other\")\n .path(Path.of(otherThemeUrl.toURI()))\n .active(false)\n .build();\n }\n\n @TestConfiguration\n static class MessageResolverConfig {\n @Bean\n RouterFunction routeTestIndex() {\n return RouterFunctions\n .route(RequestPredicates.GET(\"/\").or(RequestPredicates.GET(\"/index\"))\n .and(RequestPredicates.accept(MediaType.TEXT_HTML)),\n request -> ServerResponse.ok().render(\"index\"));\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/router/EmptyView.java", "content": "package run.halo.app.theme.router;\n\nimport java.util.Map;\nimport org.springframework.http.MediaType;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.thymeleaf.spring6.view.reactive.ThymeleafReactiveView;\nimport reactor.core.publisher.Mono;\n\n/**\n * Empty view for test.\n *\n * @author guqing\n * @since 2.0.0\n */\npublic class EmptyView extends ThymeleafReactiveView {\n public EmptyView() {\n }\n\n @Override\n public Mono render(Map model, MediaType contentType,\n ServerWebExchange exchange) {\n return Mono.empty();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/router/PageUrlUtilsTest.java", "content": "package run.halo.app.theme.router;\n\nimport static org.assertj.core.api.Assertions.assertThat;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Tests for {@link PageUrlUtils}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass PageUrlUtilsTest {\n static String s = \"/tags\";\n static String s1 = \"/tags/page/1\";\n static String s2 = \"/tags/page/2\";\n static String s3 = \"/tags/y/m/page/2\";\n static String s4 = \"/tags/y/m\";\n static String s5 = \"/tags/y/m/page/3\";\n\n @Test\n void nextPageUrl() {\n long totalPage = 10;\n assertThat(PageUrlUtils.nextPageUrl(s, totalPage))\n .isEqualTo(\"/tags/page/2\");\n assertThat(PageUrlUtils.nextPageUrl(s2, totalPage))\n .isEqualTo(\"/tags/page/3\");\n assertThat(PageUrlUtils.nextPageUrl(s3, totalPage))\n .isEqualTo(\"/tags/y/m/page/3\");\n assertThat(PageUrlUtils.nextPageUrl(s4, totalPage))\n .isEqualTo(\"/tags/y/m/page/2\");\n assertThat(PageUrlUtils.nextPageUrl(s5, totalPage))\n .isEqualTo(\"/tags/y/m/page/4\");\n\n // The number of pages does not exceed the total number of pages\n totalPage = 1;\n assertThat(PageUrlUtils.nextPageUrl(\"/tags/page/1\", totalPage))\n .isEqualTo(\"/tags/page/1\");\n\n totalPage = 0;\n assertThat(PageUrlUtils.nextPageUrl(\"/tags\", totalPage))\n .isEqualTo(\"/tags/page/1\");\n }\n\n @Test\n void prevPageUrl() {\n assertThat(PageUrlUtils.prevPageUrl(s))\n .isEqualTo(\"/tags\");\n assertThat(PageUrlUtils.prevPageUrl(s1))\n .isEqualTo(\"/tags\");\n assertThat(PageUrlUtils.prevPageUrl(s2))\n .isEqualTo(\"/tags\");\n assertThat(PageUrlUtils.prevPageUrl(s3))\n .isEqualTo(\"/tags/y/m\");\n assertThat(PageUrlUtils.prevPageUrl(s4))\n .isEqualTo(\"/tags/y/m\");\n assertThat(PageUrlUtils.prevPageUrl(s5))\n .isEqualTo(\"/tags/y/m/page/2\");\n\n assertThat(PageUrlUtils.prevPageUrl(\"/page/2\"))\n .isEqualTo(\"/\");\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/PreviewRouterFunctionTest.java", "content": "package run.halo.app.theme.router;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.MediaType;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.HandlerStrategies;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.result.view.ViewResolver;\nimport org.springframework.web.server.ServerWebExchange;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.PostService;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.infra.AnonymousUserConst;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.PostPublicQueryService;\nimport run.halo.app.theme.finders.SinglePageConversionService;\nimport run.halo.app.theme.finders.vo.ContributorVo;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\n\n/**\n * Tests for {@link PreviewRouterFunction}.\n *\n * @author guqing\n * @since 2.6.x\n */\n@ExtendWith({SpringExtension.class, MockitoExtension.class})\nclass PreviewRouterFunctionTest {\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n PostPublicQueryService postPublicQueryService;\n\n @Mock\n ViewNameResolver viewNameResolver;\n\n @Mock\n ViewResolver viewResolver;\n\n @Mock\n PostService postService;\n\n @Mock\n SinglePageConversionService singlePageConversionService;\n\n @InjectMocks\n PreviewRouterFunction previewRouterFunction;\n\n WebTestClient webTestClient;\n\n @BeforeEach\n void setUp() {\n webTestClient = WebTestClient.bindToRouterFunction(previewRouterFunction.previewRouter())\n .handlerStrategies(HandlerStrategies.builder()\n .viewResolver(viewResolver)\n .build())\n .build();\n }\n\n @Test\n @WithMockUser(username = \"testuser\")\n void previewPost() {\n when(viewResolver.resolveViewName(any(), any()))\n .thenReturn(Mono.just(new EmptyView() {\n @Override\n public Mono render(Map model, MediaType contentType,\n ServerWebExchange exchange) {\n return super.render(model, contentType, exchange);\n }\n }));\n\n Post post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"post1\");\n post.setSpec(new Post.PostSpec());\n post.getSpec().setOwner(\"testuser\");\n post.getSpec().setHeadSnapshot(\"snapshot1\");\n post.getSpec().setBaseSnapshot(\"snapshot2\");\n post.getSpec().setTemplate(\"postTemplate\");\n when(client.fetch(eq(Post.class), eq(\"post1\"))).thenReturn(Mono.just(post));\n\n PostVo postVo = PostVo.from(post);\n postVo.setContributors(contributorVos());\n when(postPublicQueryService.convertToVo(eq(post), eq(post.getSpec().getHeadSnapshot())))\n .thenReturn(Mono.just(postVo));\n\n when(viewNameResolver.resolveViewNameOrDefault(any(ServerRequest.class),\n eq(\"postTemplate\"), eq(\"post\"))).thenReturn(Mono.just(\"postView\"));\n\n webTestClient.get().uri(\"/preview/posts/post1\")\n .exchange()\n .expectStatus().isOk();\n\n verify(viewResolver).resolveViewName(any(), any());\n verify(postPublicQueryService).convertToVo(eq(post), eq(post.getSpec().getHeadSnapshot()));\n verify(client).fetch(eq(Post.class), eq(\"post1\"));\n }\n\n @Test\n public void previewPostWhenUnAuthenticated() {\n webTestClient.get().uri(\"/preview/posts/post1\")\n .exchange()\n .expectStatus().isEqualTo(404);\n }\n\n @Test\n @WithMockUser(username = \"testuser\")\n public void previewSinglePage() {\n when(viewResolver.resolveViewName(any(), any()))\n .thenReturn(Mono.just(new EmptyView() {\n @Override\n public Mono render(Map model, MediaType contentType,\n ServerWebExchange exchange) {\n return super.render(model, contentType, exchange);\n }\n }));\n\n SinglePage singlePage = new SinglePage();\n singlePage.setMetadata(new Metadata());\n singlePage.getMetadata().setName(\"page1\");\n singlePage.setSpec(new SinglePage.SinglePageSpec());\n singlePage.getSpec().setOwner(\"testuser\");\n singlePage.getSpec().setHeadSnapshot(\"snapshot1\");\n singlePage.getSpec().setTemplate(\"pageTemplate\");\n when(client.fetch(SinglePage.class, \"page1\")).thenReturn(Mono.just(singlePage));\n\n SinglePageVo singlePageVo = SinglePageVo.from(singlePage);\n singlePageVo.setContributors(contributorVos());\n when(singlePageConversionService.convertToVo(singlePage, \"snapshot1\"))\n .thenReturn(Mono.just(singlePageVo));\n\n when(viewNameResolver.resolveViewNameOrDefault(any(ServerRequest.class),\n eq(\"pageTemplate\"), eq(\"page\"))).thenReturn(Mono.just(\"pageView\"));\n\n webTestClient.get().uri(\"/preview/singlepages/page1\")\n .exchange()\n .expectStatus().isOk();\n\n verify(viewResolver).resolveViewName(any(), any());\n verify(client).fetch(eq(SinglePage.class), eq(\"page1\"));\n }\n\n @Test\n public void previewSinglePageWhenUnAuthenticated() {\n webTestClient.get().uri(\"/preview/singlepages/page1\")\n .exchange()\n .expectStatus().isEqualTo(404);\n }\n\n @Test\n @WithMockUser(username = AnonymousUserConst.PRINCIPAL)\n public void previewWithAnonymousUser() {\n webTestClient.get().uri(\"/preview/singlepages/page1\")\n .exchange()\n .expectStatus().isEqualTo(404);\n }\n\n List contributorVos() {\n ContributorVo contributorA = ContributorVo.builder()\n .name(\"fake-user\")\n .build();\n ContributorVo contributorB = ContributorVo.builder()\n .name(\"testuser\")\n .build();\n return List.of(contributorA, contributorB);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/ReactiveQueryPostPredicateResolverTest.java", "content": "package run.halo.app.theme.router;\n\nimport static org.assertj.core.api.AssertionsForInterfaceTypes.assertThat;\n\nimport java.util.Map;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.springframework.security.test.context.support.WithMockUser;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.Metadata;\n\n/**\n * Tests for {@link ReactiveQueryPostPredicateResolver}.\n *\n * @author guqing\n * @since 2.9.0\n */\n@ExtendWith(SpringExtension.class)\nclass ReactiveQueryPostPredicateResolverTest {\n\n private ReactiveQueryPostPredicateResolver postPredicateResolver;\n\n @BeforeEach\n void setUp() {\n postPredicateResolver = new DefaultQueryPostPredicateResolver();\n }\n\n @Test\n void getPredicateWithoutAuth() {\n postPredicateResolver.getPredicate()\n .as(StepVerifier::create)\n .consumeNextWith(predicate -> {\n Post post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"fake-post\");\n\n post.setSpec(new Post.PostSpec());\n post.getSpec().setDeleted(false);\n post.getMetadata().setLabels(Map.of(Post.PUBLISHED_LABEL, \"true\"));\n post.getSpec().setVisible(Post.VisibleEnum.PRIVATE);\n assertThat(predicate.test(post)).isFalse();\n\n post.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n assertThat(predicate.test(post)).isTrue();\n\n post.getMetadata().setLabels(Map.of(Post.PUBLISHED_LABEL, \"false\"));\n assertThat(predicate.test(post)).isFalse();\n })\n .verifyComplete();\n }\n\n @Test\n @WithMockUser(username = \"halo\")\n void getPredicateWithAuth() {\n postPredicateResolver.getPredicate()\n .as(StepVerifier::create)\n .consumeNextWith(predicate -> {\n Post post = new Post();\n post.setMetadata(new Metadata());\n post.getMetadata().setName(\"fake-post\");\n\n post.setSpec(new Post.PostSpec());\n post.getSpec().setDeleted(false);\n post.getSpec().setOwner(\"halo\");\n post.getMetadata().setLabels(Map.of(Post.PUBLISHED_LABEL, \"true\"));\n post.getSpec().setVisible(Post.VisibleEnum.PRIVATE);\n assertThat(predicate.test(post)).isTrue();\n\n post.getSpec().setOwner(\"guqing\");\n assertThat(predicate.test(post)).isFalse();\n\n post.getSpec().setOwner(\"halo\");\n post.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n assertThat(predicate.test(post)).isTrue();\n\n post.getSpec().setDeleted(true);\n assertThat(predicate.test(post)).isFalse();\n\n post.getSpec().setVisible(Post.VisibleEnum.INTERNAL);\n assertThat(predicate.test(post)).isFalse();\n })\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/SinglePageRouteTest.java", "content": "package run.halo.app.theme.router;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\n\nimport java.net.URI;\nimport java.time.Instant;\nimport java.util.HashMap;\nimport java.util.Locale;\nimport java.util.Map;\nimport java.util.Optional;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.Mockito;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.i18n.SimpleLocaleContext;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.http.HttpMethod;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.reactive.function.server.MockServerRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.HandlerFunction;\nimport org.springframework.web.reactive.function.server.HandlerStrategies;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.RouterFunctions;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.reactive.result.view.ViewResolver;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport org.springframework.web.util.UriUtils;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.content.SinglePage;\nimport run.halo.app.extension.ExtensionClient;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.controller.Reconciler;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.SinglePageFinder;\nimport run.halo.app.theme.finders.vo.SinglePageVo;\nimport run.halo.app.theme.router.SinglePageRoute.NameSlugPair;\n\n/**\n * Tests for {@link SinglePageRoute}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass SinglePageRouteTest {\n\n @Mock\n ViewNameResolver viewNameResolver;\n\n @Mock\n SinglePageFinder singlePageFinder;\n\n @Mock\n ViewResolver viewResolver;\n\n @Mock\n ExtensionClient client;\n\n @Mock\n LocaleContextResolver localeContextResolver;\n\n @Mock\n TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n @InjectMocks\n SinglePageRoute singlePageRoute;\n\n @Test\n void handlerFunction() {\n // fix gh-3448\n when(viewNameResolver.resolveViewNameOrDefault(any(ServerRequest.class), any(), any()))\n .thenReturn(Mono.just(DefaultTemplateEnum.POST.getValue()));\n\n String pageName = \"fake-page\";\n when(viewResolver.resolveViewName(any(), any()))\n .thenReturn(Mono.just(new EmptyView() {\n @Override\n public Mono render(Map model, MediaType contentType,\n ServerWebExchange exchange) {\n assertThat(model).containsKey(ModelConst.TEMPLATE_ID);\n assertThat(model.get(ModelConst.TEMPLATE_ID))\n .isEqualTo(DefaultTemplateEnum.SINGLE_PAGE.getValue());\n assertThat(model.get(\"name\"))\n .isEqualTo(pageName);\n assertThat(model.get(\"plural\")).isEqualTo(\"singlepages\");\n assertThat(model.get(\"singlePage\")).isNotNull();\n assertThat(model.get(\"groupVersionKind\"))\n .isEqualTo(GroupVersionKind.fromExtension(SinglePage.class));\n return super.render(model, contentType, exchange);\n }\n }));\n\n SinglePage singlePage = new SinglePage();\n singlePage.setMetadata(new Metadata());\n singlePage.getMetadata().setName(pageName);\n singlePage.setSpec(new SinglePage.SinglePageSpec());\n when(singlePageFinder.getByName(eq(pageName)))\n .thenReturn(Mono.just(SinglePageVo.from(singlePage)));\n\n HandlerFunction handlerFunction =\n singlePageRoute.handlerFunction(pageName);\n RouterFunction routerFunction =\n RouterFunctions.route().GET(\"/archives/{name}\", handlerFunction).build();\n\n WebTestClient webTestClient = WebTestClient.bindToRouterFunction(routerFunction)\n .handlerStrategies(HandlerStrategies.builder()\n .viewResolver(viewResolver)\n .build())\n .build();\n\n when(localeContextResolver.resolveLocaleContext(any()))\n .thenReturn(new SimpleLocaleContext(Locale.getDefault()));\n webTestClient.get()\n .uri(\"/archives/fake-name\")\n .exchange()\n .expectStatus().isOk();\n }\n\n @Test\n void shouldNotThrowErrorIfSlugNameContainsSpecialChars() {\n var specialChars = \"/with-special-chars-{}-[]-{{}}-{[]}-[{}]\";\n var specialCharsUri =\n URI.create(UriUtils.encodePath(specialChars, UTF_8));\n var mockHttpRequest = MockServerHttpRequest.get(specialCharsUri.toString())\n .accept(MediaType.TEXT_HTML)\n .build();\n var mockExchange = MockServerWebExchange.from(mockHttpRequest);\n var request = MockServerRequest.builder()\n .exchange(mockExchange)\n .uri(specialCharsUri)\n .method(HttpMethod.GET)\n .header(HttpHeaders.ACCEPT, MediaType.TEXT_HTML_VALUE)\n .build();\n var nameSlugPair = new NameSlugPair(\"fake-single-page\", specialChars);\n singlePageRoute.setQuickRouteMap(Map.of(nameSlugPair, r -> ServerResponse.ok().build()));\n StepVerifier.create(singlePageRoute.route(request))\n .expectNextCount(1)\n .verifyComplete();\n }\n\n @Nested\n class SinglePageReconcilerTest {\n\n @Test\n void shouldRemoveRouteIfSinglePageUnpublished() {\n var name = \"fake-single-page\";\n var page = newSinglePage(name, false);\n when(client.fetch(SinglePage.class, name)).thenReturn(\n Optional.of(page));\n\n var routeMap = Mockito.>>mock(\n invocation -> new HashMap>());\n singlePageRoute.setQuickRouteMap(routeMap);\n var result = singlePageRoute.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n verify(client).fetch(SinglePage.class, name);\n verify(routeMap).remove(NameSlugPair.from(page));\n }\n\n @Test\n void shouldAddRouteIfSinglePagePublished() {\n var name = \"fake-single-page\";\n var page = newSinglePage(name, true);\n when(client.fetch(SinglePage.class, name)).thenReturn(\n Optional.of(page));\n\n var routeMap = Mockito.>>mock(\n invocation -> new HashMap>());\n singlePageRoute.setQuickRouteMap(routeMap);\n var result = singlePageRoute.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n verify(client).fetch(SinglePage.class, name);\n verify(routeMap).put(eq(NameSlugPair.from(page)), any());\n }\n\n @Test\n void shouldRemoveRouteIfSinglePageDeleted() {\n var name = \"fake-single-page\";\n var page = newDeletedSinglePage(name);\n when(client.fetch(SinglePage.class, name)).thenReturn(\n Optional.of(page));\n\n var routeMap = Mockito.>>mock(\n invocation -> new HashMap>());\n singlePageRoute.setQuickRouteMap(routeMap);\n var result = singlePageRoute.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n verify(client).fetch(SinglePage.class, name);\n verify(routeMap).remove(NameSlugPair.from(page));\n }\n\n @Test\n void shouldRemoveRouteIfSinglePageRecycled() {\n var name = \"fake-single-page\";\n var page = newRecycledSinglePage(name);\n when(client.fetch(SinglePage.class, name)).thenReturn(\n Optional.of(page));\n\n var routeMap = Mockito.>>mock(\n invocation -> new HashMap>());\n singlePageRoute.setQuickRouteMap(routeMap);\n var result = singlePageRoute.reconcile(new Reconciler.Request(name));\n assertNotNull(result);\n assertFalse(result.reEnqueue());\n verify(client).fetch(SinglePage.class, name);\n verify(routeMap).remove(NameSlugPair.from(page));\n }\n\n\n SinglePage newSinglePage(String name, boolean published) {\n var metadata = new Metadata();\n metadata.setName(name);\n var page = new SinglePage();\n page.setMetadata(metadata);\n var spec = new SinglePage.SinglePageSpec();\n spec.setSlug(\"/fake-slug\");\n page.setSpec(spec);\n var status = new SinglePage.SinglePageStatus();\n page.setStatus(status);\n SinglePage.changePublishedState(page, published);\n return page;\n }\n\n SinglePage newDeletedSinglePage(String name) {\n var page = newSinglePage(name, true);\n page.getMetadata().setDeletionTimestamp(Instant.now());\n return page;\n }\n\n SinglePage newRecycledSinglePage(String name) {\n var page = newSinglePage(name, true);\n page.getSpec().setDeleted(true);\n return page;\n }\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/ArchiveRouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.http.HttpStatus;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.theme.finders.PostFinder;\n\n/**\n * Tests for {@link ArchiveRouteFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass ArchiveRouteFactoryTest extends RouteFactoryTestSuite {\n @Mock\n private PostFinder postFinder;\n\n @InjectMocks\n private ArchiveRouteFactory archiveRouteFactory;\n\n @Test\n void create() {\n String prefix = \"/new-archives\";\n RouterFunction routerFunction = archiveRouteFactory.create(prefix);\n WebTestClient client = getWebTestClient(routerFunction);\n\n client.get()\n .uri(prefix)\n .exchange()\n .expectStatus().isOk();\n\n client.get()\n .uri(prefix + \"/page/1\")\n .exchange()\n .expectStatus().isOk();\n\n client.get()\n .uri(prefix + \"/2022/09\")\n .exchange()\n .expectStatus().isOk();\n\n client.get()\n .uri(prefix + \"/2022/08/page/1\")\n .exchange()\n .expectStatus().isOk();\n\n client.get()\n .uri(prefix + \"/2022/8/page/1\")\n .exchange()\n .expectStatus()\n .isEqualTo(HttpStatus.NOT_FOUND);\n\n client.get()\n .uri(\"/nothing\")\n .exchange()\n .expectStatus()\n .isEqualTo(HttpStatus.NOT_FOUND);\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/AuthorPostsRouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.doReturn;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.User;\nimport run.halo.app.extension.ReactiveExtensionClient;\n\n/**\n * Tests for {@link AuthorPostsRouteFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass AuthorPostsRouteFactoryTest extends RouteFactoryTestSuite {\n @Mock\n ReactiveExtensionClient client;\n @InjectMocks\n AuthorPostsRouteFactory authorPostsRouteFactory;\n\n @Test\n void create() {\n var spyAuthorRoute = spy(authorPostsRouteFactory);\n doReturn(Mono.just(true)).when(spyAuthorRoute).hasPostManageRole(anyString());\n\n RouterFunction routerFunction = spyAuthorRoute.create(null);\n WebTestClient webClient = getWebTestClient(routerFunction);\n\n when(client.fetch(eq(User.class), eq(\"fake-user\")))\n .thenReturn(Mono.just(new User()));\n webClient.get()\n .uri(\"/authors/fake-user\")\n .exchange()\n .expectStatus().isOk();\n\n webClient.get()\n .uri(\"/authors/fake-user/page/p\")\n .exchange()\n .expectStatus().isNotFound();\n\n webClient.get()\n .uri(\"/authors/fake-user/page/abc\")\n .exchange()\n .expectStatus().isNotFound();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/CategoriesRouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Flux;\nimport run.halo.app.theme.finders.CategoryFinder;\n\n/**\n * Tests for {@link CategoriesRouteFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\nclass CategoriesRouteFactoryTest extends RouteFactoryTestSuite {\n\n @Mock\n private CategoryFinder categoryFinder;\n\n @InjectMocks\n private CategoriesRouteFactory categoriesRouteFactory;\n\n @Test\n void create() {\n String prefix = \"/topics\";\n RouterFunction routerFunction = categoriesRouteFactory.create(prefix);\n WebTestClient webClient = getWebTestClient(routerFunction);\n\n when(categoryFinder.listAsTree())\n .thenReturn(Flux.empty());\n webClient.get()\n .uri(prefix)\n .exchange()\n .expectStatus().isOk();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/IndexRouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport run.halo.app.theme.finders.PostFinder;\n\n/**\n * Tests for {@link IndexRouteFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass IndexRouteFactoryTest extends RouteFactoryTestSuite {\n @Mock\n private PostFinder postFinder;\n\n @InjectMocks\n private IndexRouteFactory indexRouteFactory;\n\n @Test\n void create() {\n RouterFunction routerFunction = indexRouteFactory.create(\"/\");\n WebTestClient webTestClient = getWebTestClient(routerFunction);\n\n webTestClient.get()\n .uri(\"/\")\n .exchange()\n .expectStatus().isOk();\n\n webTestClient.get()\n .uri(\"/page/1\")\n .exchange()\n .expectStatus().isOk();\n\n webTestClient.get()\n .uri(\"/page/abc\")\n .exchange()\n .expectStatus().isNotFound();\n\n webTestClient.get()\n .uri(\"/page/2f\")\n .exchange()\n .expectStatus().isNotFound();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/PostRouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.util.Locale;\nimport java.util.Map;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.context.i18n.SimpleLocaleContext;\nimport org.springframework.http.MediaType;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerRequest;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.i18n.LocaleContextResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.content.TestPost;\nimport run.halo.app.core.extension.content.Post;\nimport run.halo.app.extension.GroupVersionKind;\nimport run.halo.app.extension.MetadataUtil;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.theme.DefaultTemplateEnum;\nimport run.halo.app.theme.ViewNameResolver;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.vo.PostVo;\nimport run.halo.app.theme.router.DefaultQueryPostPredicateResolver;\nimport run.halo.app.theme.router.EmptyView;\nimport run.halo.app.theme.router.ModelConst;\nimport run.halo.app.theme.router.ReactiveQueryPostPredicateResolver;\nimport run.halo.app.theme.router.TitleVisibilityIdentifyCalculator;\n\n/**\n * Tests for {@link PostRouteFactory}.\n *\n * @author guqing\n * @since 2.3.0\n */\n@ExtendWith(MockitoExtension.class)\nclass PostRouteFactoryTest extends RouteFactoryTestSuite {\n\n @Mock\n private PostFinder postFinder;\n\n @Mock\n private ViewNameResolver viewNameResolver;\n\n @Mock\n private ReactiveExtensionClient client;\n\n @Mock\n private ReactiveQueryPostPredicateResolver predicateResolver;\n\n @Mock\n private LocaleContextResolver localeContextResolver;\n\n @Mock\n private TitleVisibilityIdentifyCalculator titleVisibilityIdentifyCalculator;\n\n @InjectMocks\n private PostRouteFactory postRouteFactory;\n\n @Test\n void shouldBeSameResultWhenParsePattenMultiply() {\n var parser = new PostRouteFactory.PatternParser(\"/?p={slug}\");\n Assertions.assertTrue(parser.isQueryParamPattern());\n parser = new PostRouteFactory.PatternParser(\"/?p={slug}\");\n Assertions.assertTrue(parser.isQueryParamPattern());\n }\n\n @Test\n void create() {\n Post post = TestPost.postV1();\n Map labels = MetadataUtil.nullSafeLabels(post);\n labels.put(Post.PUBLISHED_LABEL, \"true\");\n post.getMetadata().setName(\"fake-name\");\n post.getSpec().setDeleted(false);\n post.getSpec().setVisible(Post.VisibleEnum.PUBLIC);\n when(postFinder.getByName(eq(\"fake-name\"))).thenReturn(Mono.just(PostVo.from(post)));\n\n when(client.fetch(eq(Post.class), eq(\"fake-name\"))).thenReturn(Mono.just(post));\n\n when(viewNameResolver.resolveViewNameOrDefault(any(ServerRequest.class), any(), any()))\n .thenReturn(Mono.just(DefaultTemplateEnum.POST.getValue()));\n when(predicateResolver.getPredicate())\n .thenReturn(new DefaultQueryPostPredicateResolver().getPredicate());\n\n RouterFunction routerFunction = postRouteFactory.create(\"/archives/{name}\");\n WebTestClient webTestClient = getWebTestClient(routerFunction);\n\n when(localeContextResolver.resolveLocaleContext(any()))\n .thenReturn(new SimpleLocaleContext(Locale.getDefault()));\n when(viewResolver.resolveViewName(any(), any()))\n .thenReturn(Mono.just(new EmptyView() {\n @Override\n public Mono render(Map model, MediaType contentType,\n ServerWebExchange exchange) {\n assertThat(model).containsKey(ModelConst.TEMPLATE_ID);\n assertThat(model.get(ModelConst.TEMPLATE_ID))\n .isEqualTo(DefaultTemplateEnum.POST.getValue());\n assertThat(model.get(\"name\"))\n .isEqualTo(post.getMetadata().getName());\n assertThat(model.get(\"plural\")).isEqualTo(\"posts\");\n assertThat(model.get(\"post\")).isNotNull();\n assertThat(model.get(\"groupVersionKind\"))\n .isEqualTo(GroupVersionKind.fromExtension(Post.class));\n return super.render(model, contentType, exchange);\n }\n }));\n webTestClient.get()\n .uri(\"/archives/fake-name\")\n .exchange()\n .expectStatus().isOk();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/RouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.mockito.Mockito.when;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.router.ModelConst;\n\n/**\n * Tests for {@link RouteFactory}.\n *\n * @author guqing\n * @since 2.3.0\n */\n@ExtendWith(MockitoExtension.class)\nclass RouteFactoryTest extends RouteFactoryTestSuite {\n\n @Test\n void configuredPageSize() {\n SystemSetting.Post post = new SystemSetting.Post();\n post.setPostPageSize(1);\n post.setArchivePageSize(2);\n post.setCategoryPageSize(3);\n post.setTagPageSize(null);\n post.setAuthorPageSize(4);\n when(environmentFetcher.fetchPost()).thenReturn(Mono.just(post));\n\n TestRouteFactory routeFactory = new TestRouteFactory();\n assertThat(\n routeFactory.configuredPageSize(environmentFetcher, SystemSetting.Post::getTagPageSize)\n .block()).isEqualTo(ModelConst.DEFAULT_PAGE_SIZE);\n\n assertThat(\n routeFactory.configuredPageSize(environmentFetcher, SystemSetting.Post::getPostPageSize)\n .block()).isEqualTo(post.getPostPageSize());\n\n assertThat(\n routeFactory.configuredPageSize(environmentFetcher,\n SystemSetting.Post::getCategoryPageSize).block())\n .isEqualTo(post.getCategoryPageSize());\n\n assertThat(\n routeFactory.configuredPageSize(environmentFetcher,\n SystemSetting.Post::getArchivePageSize).block())\n .isEqualTo(post.getArchivePageSize());\n \n assertThat(\n routeFactory.configuredPageSize(environmentFetcher,\n SystemSetting.Post::getAuthorPageSize).block())\n .isEqualTo(post.getAuthorPageSize());\n }\n\n static class TestRouteFactory implements RouteFactory {\n\n @Override\n public RouterFunction create(String pattern) {\n return null;\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/RouteFactoryTestSuite.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.lenient;\n\nimport java.net.URISyntaxException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport org.springframework.web.reactive.function.server.HandlerStrategies;\nimport org.springframework.web.reactive.function.server.RouterFunction;\nimport org.springframework.web.reactive.function.server.ServerResponse;\nimport org.springframework.web.reactive.result.view.ViewResolver;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.theme.router.EmptyView;\n\n/**\n * Abstract test for {@link RouteFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nabstract class RouteFactoryTestSuite {\n @Mock\n protected SystemConfigFetcher environmentFetcher;\n @Mock\n protected ViewResolver viewResolver;\n\n @BeforeEach\n final void setUpParent() throws URISyntaxException {\n lenient().when(environmentFetcher.fetchPost())\n .thenReturn(Mono.just(new SystemSetting.Post()));\n lenient().when(environmentFetcher.fetch(eq(SystemSetting.ThemeRouteRules.GROUP),\n eq(SystemSetting.ThemeRouteRules.class))).thenReturn(Mono.just(getThemeRouteRules()));\n lenient().when(viewResolver.resolveViewName(any(), any()))\n .thenReturn(Mono.just(new EmptyView()));\n setUp();\n }\n\n public void setUp() {\n\n }\n\n public SystemSetting.ThemeRouteRules getThemeRouteRules() {\n SystemSetting.ThemeRouteRules themeRouteRules = new SystemSetting.ThemeRouteRules();\n themeRouteRules.setArchives(\"archives\");\n themeRouteRules.setPost(\"/archives/{slug}\");\n themeRouteRules.setTags(\"tags\");\n themeRouteRules.setCategories(\"categories\");\n return themeRouteRules;\n }\n\n public WebTestClient getWebTestClient(RouterFunction routeFunction) {\n return WebTestClient.bindToRouterFunction(routeFunction)\n .handlerStrategies(HandlerStrategies.builder()\n .viewResolver(viewResolver)\n .build())\n .build();\n }\n}\n" }, { "path": "application/src/test/java/run/halo/app/theme/router/factories/TagPostRouteFactoryTest.java", "content": "package run.halo.app.theme.router.factories;\n\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.when;\n\nimport java.util.List;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.springframework.test.web.reactive.server.WebTestClient;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.core.extension.content.Tag;\nimport run.halo.app.extension.ListResult;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.PageRequest;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.theme.finders.PostFinder;\nimport run.halo.app.theme.finders.TagFinder;\nimport run.halo.app.theme.finders.vo.TagVo;\n\n/**\n * Tests for @link TagPostRouteFactory}.\n *\n * @author guqing\n * @since 2.0.0\n */\n@ExtendWith(MockitoExtension.class)\nclass TagPostRouteFactoryTest extends RouteFactoryTestSuite {\n @Mock\n private ReactiveExtensionClient client;\n @Mock\n private TagFinder tagFinder;\n @Mock\n private PostFinder postFinder;\n\n @InjectMocks\n TagPostRouteFactory tagPostRouteFactory;\n\n @Test\n void create() {\n when(client.listBy(eq(Tag.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(ListResult.emptyResult()));\n WebTestClient webTestClient = getWebTestClient(tagPostRouteFactory.create(\"/new-tags\"));\n\n webTestClient.get()\n .uri(\"/new-tags/tag-slug-1\")\n .exchange()\n .expectStatus().isNotFound();\n\n Tag tag = new Tag();\n tag.setMetadata(new Metadata());\n tag.getMetadata().setName(\"fake-tag-name\");\n tag.setSpec(new Tag.TagSpec());\n tag.getSpec().setSlug(\"tag-slug-2\");\n when(client.listBy(eq(Tag.class), any(), any(PageRequest.class)))\n .thenReturn(Mono.just(new ListResult<>(List.of(tag))));\n when(tagFinder.getByName(eq(tag.getMetadata().getName())))\n .thenReturn(Mono.just(TagVo.from(tag)));\n webTestClient.get()\n .uri(\"/new-tags/tag-slug-2\")\n .exchange()\n .expectStatus().isOk();\n\n webTestClient.get()\n .uri(\"/new-tags/tag-slug-2/page/1\")\n .exchange()\n .expectStatus().isOk();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/service/ThemeServiceImplTest.java", "content": "package run.halo.app.theme.service;\n\nimport static java.nio.file.Files.createTempDirectory;\nimport static org.assertj.core.api.Assertions.assertThat;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.ArgumentMatchers.any;\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.ArgumentMatchers.isA;\nimport static org.mockito.Mockito.lenient;\nimport static org.mockito.Mockito.never;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.when;\nimport static run.halo.app.infra.utils.FileUtils.deleteRecursivelyAndSilently;\nimport static run.halo.app.infra.utils.FileUtils.zip;\n\nimport com.github.zafarkhaja.semver.Version;\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Consumer;\nimport org.json.JSONException;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.mockito.InjectMocks;\nimport org.mockito.Mock;\nimport org.mockito.junit.jupiter.MockitoExtension;\nimport org.mockito.stubbing.Answer;\nimport org.skyscreamer.jsonassert.JSONAssert;\nimport org.springframework.core.io.buffer.DataBuffer;\nimport org.springframework.core.io.buffer.DataBufferUtils;\nimport org.springframework.core.io.buffer.DefaultDataBufferFactory;\nimport org.springframework.util.ResourceUtils;\nimport org.springframework.util.StreamUtils;\nimport org.springframework.web.server.ServerWebInputException;\nimport reactor.core.publisher.Flux;\nimport reactor.core.publisher.Mono;\nimport reactor.test.StepVerifier;\nimport run.halo.app.core.extension.AnnotationSetting;\nimport run.halo.app.core.extension.Setting;\nimport run.halo.app.core.extension.Theme;\nimport run.halo.app.extension.ConfigMap;\nimport run.halo.app.extension.Metadata;\nimport run.halo.app.extension.ReactiveExtensionClient;\nimport run.halo.app.extension.Unstructured;\nimport run.halo.app.extension.exception.ExtensionException;\nimport run.halo.app.infra.SystemConfigFetcher;\nimport run.halo.app.infra.SystemSetting;\nimport run.halo.app.infra.SystemVersionSupplier;\nimport run.halo.app.infra.ThemeRootGetter;\nimport run.halo.app.infra.exception.ThemeInstallationException;\nimport run.halo.app.infra.utils.JsonUtils;\n\n@ExtendWith(MockitoExtension.class)\nclass ThemeServiceImplTest {\n\n @Mock\n ReactiveExtensionClient client;\n\n @Mock\n ThemeRootGetter themeRoot;\n\n @Mock\n SystemVersionSupplier systemVersionSupplier;\n\n @Mock\n SystemConfigFetcher systemConfigFetcher;\n\n @InjectMocks\n ThemeServiceImpl themeService;\n\n Path tmpDir;\n\n @BeforeEach\n void setUp() throws IOException {\n tmpDir = createTempDirectory(\"halo-theme-service-test-\");\n lenient().when(themeRoot.get()).thenReturn(tmpDir.resolve(\"themes\"));\n // init the folder\n Files.createDirectory(themeRoot.get());\n\n lenient().when(systemVersionSupplier.get()).thenReturn(Version.parse(\"0.0.0\"));\n }\n\n @AfterEach\n void cleanUp() {\n deleteRecursivelyAndSilently(tmpDir);\n }\n\n Path prepareTheme(String themeFilename) throws IOException, URISyntaxException {\n var defaultThemeUri = ResourceUtils.getURL(\"classpath:themes/\" + themeFilename).toURI();\n var defaultThemeZipPath = tmpDir.resolve(\"default.zip\");\n zip(Path.of(defaultThemeUri), defaultThemeZipPath);\n return defaultThemeZipPath;\n }\n\n Theme createTheme() {\n return createTheme(theme -> {\n });\n }\n\n Theme createTheme(Consumer customizer) {\n var metadata = new Metadata();\n metadata.setName(\"default\");\n\n var spec = new Theme.ThemeSpec();\n spec.setDisplayName(\"Default\");\n\n var theme = new Theme();\n theme.setMetadata(metadata);\n theme.setSpec(spec);\n customizer.accept(theme);\n return theme;\n }\n\n Unstructured convert(Theme theme) {\n return Unstructured.OBJECT_MAPPER.convertValue(theme, Unstructured.class);\n }\n\n Flux content(Path path) {\n return DataBufferUtils.read(\n path,\n DefaultDataBufferFactory.sharedInstance,\n StreamUtils.BUFFER_SIZE);\n }\n\n @Nested\n class UpgradeTest {\n\n @Test\n void shouldFailIfThemeNotInstalledBefore() throws IOException, URISyntaxException {\n var themeZipPath = prepareTheme(\"other\");\n when(client.fetch(Theme.class, \"default\")).thenReturn(Mono.empty());\n StepVerifier.create(themeService.upgrade(\"default\", content(themeZipPath)))\n .verifyError(ServerWebInputException.class);\n\n verify(client).fetch(Theme.class, \"default\");\n }\n\n @Test\n void shouldUpgradeSuccessfully() throws IOException, URISyntaxException {\n var themeZipPath = prepareTheme(\"other\");\n\n var oldTheme = createTheme();\n when(client.fetch(Theme.class, \"default\"))\n // for old theme check\n .thenReturn(Mono.just(oldTheme))\n // for theme deletion\n .thenReturn(Mono.just(oldTheme))\n // for theme deleted check\n .thenReturn(Mono.empty());\n\n when(client.get(Theme.class, \"default\")).thenReturn(Mono.just(oldTheme));\n when(client.update(oldTheme)).thenReturn(Mono.just(createTheme(t -> {\n t.getSpec().setDisplayName(\"New fake theme\");\n })));\n\n StepVerifier.create(themeService.upgrade(\"default\", content(themeZipPath)))\n .consumeNextWith(newTheme -> {\n assertEquals(\"default\", newTheme.getMetadata().getName());\n assertEquals(\"New fake theme\", newTheme.getSpec().getDisplayName());\n })\n .verifyComplete();\n\n verify(client).fetch(Theme.class, \"default\");\n verify(client, never()).delete(oldTheme);\n }\n }\n\n @Nested\n class InstallTest {\n\n\n @Test\n void shouldInstallSuccessfully() throws IOException, URISyntaxException {\n var defaultThemeZipPath = prepareTheme(\"default\");\n when(client.create(isA(Theme.class))).thenReturn(Mono.just(createTheme()));\n StepVerifier.create(themeService.install(content(defaultThemeZipPath)))\n .consumeNextWith(theme -> {\n assertEquals(\"default\", theme.getMetadata().getName());\n assertEquals(\"Default\", theme.getSpec().getDisplayName());\n })\n .verifyComplete();\n }\n\n @Test\n void shouldFailWhenPersistentError() throws IOException, URISyntaxException {\n var defaultThemeZipPath = prepareTheme(\"default\");\n when(client.create(isA(Theme.class))).thenReturn(\n Mono.error(() -> new ExtensionException(\"Failed to create the extension\")));\n StepVerifier.create(themeService.install(content(defaultThemeZipPath)))\n .verifyError(ExtensionException.class);\n }\n\n @Test\n void shouldFailWhenThemeManifestIsInvalid() throws IOException, URISyntaxException {\n var defaultThemeZipPath = prepareTheme(\"invalid-missing-manifest\");\n StepVerifier.create(themeService.install(content(defaultThemeZipPath)))\n .verifyError(ThemeInstallationException.class);\n }\n }\n\n @Test\n void reloadThemeWhenSettingNameSetBeforeThenDeleteSetting() throws IOException {\n Theme theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.getMetadata().setName(\"fake-theme\");\n theme.setSpec(new Theme.ThemeSpec());\n theme.getSpec().setDisplayName(\"Hello\");\n theme.getSpec().setSettingName(\"fake-setting\");\n when(client.fetch(Theme.class, \"fake-theme\"))\n .thenReturn(Mono.just(theme));\n when(client.delete(any(Setting.class))).thenReturn(Mono.empty());\n Setting setting = new Setting();\n setting.setMetadata(new Metadata());\n setting.setSpec(new Setting.SettingSpec());\n setting.getSpec().setForms(List.of());\n when(client.fetch(Setting.class, \"fake-setting\"))\n .thenReturn(Mono.just(setting));\n\n Path themeWorkDir = themeRoot.get().resolve(theme.getMetadata().getName());\n if (!Files.exists(themeWorkDir)) {\n Files.createDirectories(themeWorkDir);\n }\n Files.writeString(themeWorkDir.resolve(\"settings.yaml\"), \"\"\"\n apiVersion: v1alpha1\n kind: Setting\n metadata:\n name: fake-setting\n spec:\n forms:\n - group: sns\n label: 社交资料\n formSchema:\n - $el: h1\n children: Register\n \"\"\");\n\n Files.writeString(themeWorkDir.resolve(\"theme.yaml\"), \"\"\"\n apiVersion: v1alpha1\n kind: Theme\n metadata:\n name: fake-theme\n spec:\n displayName: Fake Theme\n \"\"\");\n when(client.update(any(Theme.class)))\n .thenAnswer((Answer>) invocation -> {\n Theme argument = invocation.getArgument(0);\n return Mono.just(argument);\n });\n\n when(client.list(eq(AnnotationSetting.class), any(), eq(null))).thenReturn(Flux.empty());\n\n themeService.reloadTheme(\"fake-theme\")\n .as(StepVerifier::create)\n .consumeNextWith(themeUpdated -> {\n try {\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"displayName\": \"Fake Theme\",\n \"version\": \"*\",\n \"requires\": \"*\"\n },\n \"apiVersion\": \"theme.halo.run/v1alpha1\",\n \"kind\": \"Theme\",\n \"metadata\": {\n \"name\": \"fake-theme\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(themeUpdated),\n true);\n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n // delete fake-setting\n verify(client, times(1)).delete(any(Setting.class));\n // Will not be created\n verify(client, times(0)).create(any(Setting.class));\n }\n\n @Test\n void reloadThemeWhenSettingNameNotSetBefore() throws IOException {\n Theme theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.getMetadata().setName(\"fake-theme\");\n theme.setSpec(new Theme.ThemeSpec());\n theme.getSpec().setDisplayName(\"Hello\");\n when(client.fetch(Theme.class, \"fake-theme\"))\n .thenReturn(Mono.just(theme));\n Setting setting = new Setting();\n setting.setMetadata(new Metadata());\n setting.setSpec(new Setting.SettingSpec());\n setting.getSpec().setForms(List.of());\n\n when(client.fetch(eq(Setting.class), eq(null))).thenReturn(Mono.empty());\n\n Path themeWorkDir = themeRoot.get().resolve(theme.getMetadata().getName());\n if (!Files.exists(themeWorkDir)) {\n Files.createDirectories(themeWorkDir);\n }\n Files.writeString(themeWorkDir.resolve(\"settings.yaml\"), \"\"\"\n apiVersion: v1alpha1\n kind: Setting\n metadata:\n name: fake-setting\n spec:\n forms:\n - group: sns\n label: 社交资料\n formSchema:\n - $el: h1\n children: Register\n \"\"\");\n\n Files.writeString(themeWorkDir.resolve(\"theme.yaml\"), \"\"\"\n apiVersion: v1alpha1\n kind: Theme\n metadata:\n name: fake-theme\n spec:\n displayName: Fake Theme\n settingName: fake-setting\n \"\"\");\n when(client.update(any(Theme.class)))\n .thenAnswer((Answer>) invocation -> {\n Theme argument = invocation.getArgument(0);\n return Mono.just(argument);\n });\n\n when(client.create(any(Unstructured.class)))\n .thenAnswer((Answer>) invocation -> {\n Unstructured argument = invocation.getArgument(0);\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"forms\": [\n {\n \"group\": \"sns\",\n \"label\": \"社交资料\",\n \"formSchema\": [\n {\n \"$el\": \"h1\",\n \"children\": \"Register\"\n }\n ]\n }\n ]\n },\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Setting\",\n \"metadata\": {\n \"name\": \"fake-setting\",\n \"labels\": {\n \"theme.halo.run/theme-name\": \"fake-theme\"\n }\n }\n }\n \"\"\",\n JsonUtils.objectToJson(argument),\n true);\n return Mono.just(invocation.getArgument(0));\n });\n\n when(client.list(eq(AnnotationSetting.class), any(), eq(null))).thenReturn(Flux.empty());\n\n when(client.fetch(eq(Setting.GVK), eq(\"fake-setting\")))\n .thenReturn(Mono.empty());\n themeService.reloadTheme(\"fake-theme\")\n .as(StepVerifier::create)\n .consumeNextWith(themeUpdated -> {\n try {\n JSONAssert.assertEquals(\"\"\"\n {\n \"spec\": {\n \"settingName\": \"fake-setting\",\n \"displayName\": \"Fake Theme\",\n \"version\": \"*\",\n \"requires\": \"*\"\n },\n \"apiVersion\": \"theme.halo.run/v1alpha1\",\n \"kind\": \"Theme\",\n \"metadata\": {\n \"name\": \"fake-theme\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(themeUpdated),\n true);\n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n })\n .verifyComplete();\n }\n\n @Test\n void resetSettingConfig() {\n Theme theme = new Theme();\n theme.setMetadata(new Metadata());\n theme.getMetadata().setName(\"fake-theme\");\n theme.setSpec(new Theme.ThemeSpec());\n theme.getSpec().setSettingName(\"fake-setting\");\n theme.getSpec().setConfigMapName(\"fake-config\");\n theme.getSpec().setDisplayName(\"Hello\");\n when(client.fetch(Theme.class, \"fake-theme\"))\n .thenReturn(Mono.just(theme));\n\n Setting setting = new Setting();\n setting.setMetadata(new Metadata());\n setting.getMetadata().setName(\"fake-setting\");\n setting.setSpec(new Setting.SettingSpec());\n var formSchemaItem = Map.of(\"name\", \"email\", \"value\", \"example@exmple.com\");\n Setting.SettingForm settingForm = new Setting.SettingForm();\n settingForm.setGroup(\"basic\");\n settingForm.setFormSchema(List.of(formSchemaItem));\n setting.getSpec().setForms(List.of(settingForm));\n when(client.fetch(eq(Setting.class), eq(\"fake-setting\")))\n .thenReturn(Mono.just(setting));\n\n ConfigMap configMap = new ConfigMap();\n configMap.setMetadata(new Metadata());\n configMap.getMetadata().setName(\"fake-config\");\n when(client.fetch(eq(ConfigMap.class), eq(\"fake-config\")))\n .thenReturn(Mono.just(configMap));\n\n when(client.update(any(ConfigMap.class)))\n .thenAnswer((Answer>) invocation -> {\n ConfigMap argument = invocation.getArgument(0);\n JSONAssert.assertEquals(\"\"\"\n {\n \"data\": {\n \"basic\": \"{\\\\\"email\\\\\":\\\\\"example@exmple.com\\\\\"}\"\n },\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"ConfigMap\",\n \"metadata\": {\n \"name\": \"fake-config\"\n }\n }\n \"\"\",\n JsonUtils.objectToJson(argument),\n true);\n return Mono.just(invocation.getArgument(0));\n });\n\n themeService.resetSettingConfig(\"fake-theme\")\n .as(StepVerifier::create)\n .consumeNextWith(next -> {\n assertThat(next).isNotNull();\n })\n .verifyComplete();\n\n verify(client, times(1))\n .fetch(eq(Setting.class), eq(setting.getMetadata().getName()));\n\n verify(client, times(1)).fetch(eq(ConfigMap.class), eq(\"fake-config\"));\n\n verify(client, times(1)).update(any(ConfigMap.class));\n }\n\n @Test\n void shouldFetchSystemSetting() {\n var themeSetting = new SystemSetting.Theme();\n themeSetting.setActive(\"fake-theme\");\n when(systemConfigFetcher.fetch(SystemSetting.Theme.GROUP, SystemSetting.Theme.class))\n .thenReturn(Mono.just(themeSetting));\n\n StepVerifier.create(themeService.fetchSystemSetting())\n .expectNext(themeSetting)\n .verifyComplete();\n }\n\n @Test\n void shouldFetchActivatedTheme() {\n var themeSetting = new SystemSetting.Theme();\n themeSetting.setActive(\"fake-theme\");\n when(systemConfigFetcher.fetch(SystemSetting.Theme.GROUP, SystemSetting.Theme.class))\n .thenReturn(Mono.just(themeSetting));\n\n var theme = createTheme();\n when(client.fetch(Theme.class, \"fake-theme\")).thenReturn(Mono.just(theme));\n\n StepVerifier.create(themeService.fetchActivatedTheme())\n .expectNext(theme)\n .verifyComplete();\n }\n\n @Test\n void shouldFetchActivatedThemeName() {\n var themeSetting = new SystemSetting.Theme();\n themeSetting.setActive(\"fake-theme\");\n when(systemConfigFetcher.fetch(SystemSetting.Theme.GROUP, SystemSetting.Theme.class))\n .thenReturn(Mono.just(themeSetting));\n\n StepVerifier.create(themeService.fetchActivatedThemeName())\n .expectNext(\"fake-theme\")\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/theme/utils/PatternUtilsTest.java", "content": "package run.halo.app.theme.utils;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\n\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.CsvSource;\nimport org.junit.jupiter.params.provider.ValueSource;\nimport run.halo.app.infra.SystemSetting.ThemeRouteRules;\n\nclass PatternUtilsTest {\n\n @ParameterizedTest\n @CsvSource({\n \"test, /test\",\n \"/test/, /test\",\n \"/test, /test\",\n \"test/, /test\",\n \"path/to/resource/, /path/to/resource\"\n })\n void normalizePatternTest(String pattern, String expected) {\n assertEquals(expected, PatternUtils.normalizePattern(pattern));\n }\n\n @ParameterizedTest\n @ValueSource(strings = {\n \"\",\n \" \",\n \"/\",\n \" /\",\n \"/ \"\n })\n void shouldThrowExceptionWhen(String pattern) {\n assertThrows(IllegalArgumentException.class, () -> PatternUtils.normalizePattern(pattern));\n }\n\n @ParameterizedTest\n @CsvSource({\n \"/posts/{slug}, /archives, /categories, /posts/{slug}\",\n \"/archives/{slug}, /blog/archives, /categories, /blog/archives/{slug}\",\n \"/categories/{slug}, /archives, /blog/categories, /blog/categories/{slug}\",\n \"archives/{slug}, blog/archives, /categories, /blog/archives/{slug}\",\n \"categories/{slug}, /archives, blog/categories, /blog/categories/{slug}\",\n \"\"\"\n /archives/{year}/{month}/{slug}/, /blog/archives/, /categories, \\\n /blog/archives/{year}/{month}/{slug}\"\"\",\n \"\"\"\n /categories/{category}/{slug}/, /archives, /blog/categories/, \\\n /blog/categories/{category}/{slug}\"\"\",\n \"\"\"\n /archives/categories/{slug}, /blog/archives, /blog/categories, \\\n /blog/archives/categories/{slug}\"\"\",\n })\n void normalizePostPatternTest(\n String postPattern, String archivesPattern, String categoriesPattern, String expected\n ) {\n var rules = new ThemeRouteRules();\n rules.setPost(postPattern);\n rules.setArchives(archivesPattern);\n rules.setCategories(categoriesPattern);\n var result = PatternUtils.normalizePostPattern(rules);\n assertEquals(expected, result);\n }\n\n\n}" }, { "path": "application/src/test/java/run/halo/app/ui/WebSocketServerWebExchangeMatcherTest.java", "content": "package run.halo.app.ui;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.HttpHeaders;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport reactor.test.StepVerifier;\nimport run.halo.app.infra.ui.WebSocketServerWebExchangeMatcher;\n\nclass WebSocketServerWebExchangeMatcherTest {\n\n @Test\n void shouldMatchIfWebSocketProtocol() {\n var httpRequest = MockServerHttpRequest.get(\"\")\n .header(HttpHeaders.CONNECTION, HttpHeaders.UPGRADE)\n .header(HttpHeaders.UPGRADE, \"websocket\")\n .build();\n var wsExchange = MockServerWebExchange.from(httpRequest);\n var wsMatcher = new WebSocketServerWebExchangeMatcher();\n StepVerifier.create(wsMatcher.matches(wsExchange))\n .consumeNextWith(result -> assertTrue(result.isMatch()))\n .verifyComplete();\n }\n\n @Test\n void shouldNotMatchIfNotWebSocketProtocol() {\n var httpRequest = MockServerHttpRequest.get(\"\")\n .header(HttpHeaders.CONNECTION, HttpHeaders.UPGRADE)\n .header(HttpHeaders.UPGRADE, \"not-a-websocket\")\n .build();\n var wsExchange = MockServerWebExchange.from(httpRequest);\n var wsMatcher = new WebSocketServerWebExchangeMatcher();\n StepVerifier.create(wsMatcher.matches(wsExchange))\n .consumeNextWith(result -> assertFalse(result.isMatch()))\n .verifyComplete();\n }\n}" }, { "path": "application/src/test/java/run/halo/app/ui/WebSocketUtilsTest.java", "content": "package run.halo.app.ui;\n\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Nested;\nimport org.junit.jupiter.api.Test;\nimport org.springframework.http.HttpHeaders;\nimport run.halo.app.infra.ui.WebSocketUtils;\n\nclass WebSocketUtilsTest {\n\n @Nested\n class IsWebSocketTest {\n\n @Test\n void shouldBeWebSocketIfHeadersContaining() {\n var headers = new HttpHeaders();\n headers.add(\"Connection\", \"Upgrade\");\n headers.add(\"Upgrade\", \"websocket\");\n assertTrue(WebSocketUtils.isWebSocketUpgrade(headers));\n }\n\n @Test\n void shouldNotBeWebSocketIfHeaderValuesAreIncorrect() {\n var headers = new HttpHeaders();\n headers.add(\"Connection\", \"keep-alive\");\n headers.add(\"Upgrade\", \"websocket\");\n assertFalse(WebSocketUtils.isWebSocketUpgrade(headers));\n }\n\n @Test\n void shouldNotBeWebSocketIfMissingUpgradeHeader() {\n var headers = new HttpHeaders();\n headers.add(\"Connection\", \"Upgrade\");\n assertFalse(WebSocketUtils.isWebSocketUpgrade(headers));\n }\n\n @Test\n void shouldNotBeWebSocketIfMissingConnectionHeader() {\n var headers = new HttpHeaders();\n headers.add(\"Connection\", \"Upgrade\");\n assertFalse(WebSocketUtils.isWebSocketUpgrade(headers));\n }\n\n @Test\n void shouldNotBeWebSocketIfMissingHeaders() {\n var headers = new HttpHeaders();\n assertFalse(WebSocketUtils.isWebSocketUpgrade(headers));\n }\n }\n}" }, { "path": "application/src/test/java/run/halo/app/webfilter/LocaleChangeWebFilterTest.java", "content": "package run.halo.app.webfilter;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertNull;\n\nimport java.util.stream.Stream;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.params.ParameterizedTest;\nimport org.junit.jupiter.params.provider.MethodSource;\nimport org.springframework.http.HttpCookie;\nimport org.springframework.http.MediaType;\nimport org.springframework.mock.http.server.reactive.MockServerHttpRequest;\nimport org.springframework.mock.web.server.MockServerWebExchange;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.infra.webfilter.LocaleChangeWebFilter;\nimport run.halo.app.theme.ThemeLocaleContextResolver;\n\nclass LocaleChangeWebFilterTest {\n\n LocaleChangeWebFilter filter;\n\n @BeforeEach\n void setUp() {\n var themeLocaleContextResolver = new ThemeLocaleContextResolver();\n filter = new LocaleChangeWebFilter(themeLocaleContextResolver);\n }\n\n @Test\n void shouldRespondLanguageCookie() {\n WebFilterChain webFilterChain = filterExchange -> {\n var languageCookie = filterExchange.getResponse().getCookies().getFirst(\"language\");\n assertNotNull(languageCookie);\n assertEquals(\"zh-CN\", languageCookie.getValue());\n return Mono.empty();\n };\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.TEXT_HTML)\n .queryParam(\"language\", \"zh-CN\")\n .build()\n );\n this.filter.filter(exchange, webFilterChain).block();\n }\n\n @Test\n void shouldNotRespondLanguageCookieIfChanged() {\n WebFilterChain webFilterChain = filterExchange -> {\n var languageCookie = filterExchange.getResponse().getCookies().getFirst(\"language\");\n assertNotNull(languageCookie);\n assertEquals(\"zh-CN\", languageCookie.getValue());\n return Mono.empty();\n };\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.TEXT_HTML)\n .cookie(new HttpCookie(\"language\", \"zh-HK\"))\n .queryParam(\"language\", \"zh-CN\")\n .build()\n );\n this.filter.filter(exchange, webFilterChain).block();\n }\n\n @Test\n void shouldNotRespondLanguageCookieIfNotChanged() {\n WebFilterChain webFilterChain = filterExchange -> {\n var languageCookie = filterExchange.getResponse().getCookies().getFirst(\"language\");\n assertNull(languageCookie);\n return Mono.empty();\n };\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.TEXT_HTML)\n .cookie(new HttpCookie(\"language\", \"zh-CN\"))\n .queryParam(\"language\", \"zh-CN\")\n .build()\n );\n this.filter.filter(exchange, webFilterChain).block();\n }\n\n @Test\n void shouldNotRespondLanguageCookieWithUndeterminedLanguageTag() {\n WebFilterChain webFilterChain = filterExchange -> {\n var languageCookie = filterExchange.getResponse().getCookies().getFirst(\"language\");\n assertNull(languageCookie);\n return Mono.empty();\n };\n var exchange = MockServerWebExchange.from(MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.TEXT_HTML)\n .queryParam(\"language\", \"invalid_language_tag\")\n .build()\n );\n this.filter.filter(exchange, webFilterChain).block();\n }\n\n @ParameterizedTest\n @MethodSource(\"provideInvalidRequest\")\n void shouldNotRespondLanguageCookieIfRequestNotMatch(MockServerHttpRequest mockRequest) {\n WebFilterChain webFilterChain = filterExchange -> {\n var languageCookie = filterExchange.getResponse().getCookies().getFirst(\"language\");\n assertNull(languageCookie);\n return Mono.empty();\n };\n var exchange = MockServerWebExchange.from(mockRequest);\n this.filter.filter(exchange, webFilterChain).block();\n }\n\n static Stream provideInvalidRequest() {\n return Stream.of(\n MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.ALL)\n .queryParam(\"language\", \"zh-CN\")\n .build(),\n MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.APPLICATION_JSON)\n .queryParam(\"language\", \"zh-CN\")\n .build(),\n MockServerHttpRequest.post(\"/home\")\n .accept(MediaType.TEXT_HTML)\n .queryParam(\"language\", \"zh-CN\")\n .build(),\n MockServerHttpRequest.get(\"/home\")\n .accept(MediaType.TEXT_HTML)\n .build()\n );\n }\n}" }, { "path": "application/src/test/resources/apiToken.salt", "content": "bySwF9ZxJ2JpQYs830+eA3Fw6O7F/ULDvyYGEPaZKwY=" }, { "path": "application/src/test/resources/app.key", "content": "-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDOjnDY1K1lrOrK\nETfKfDlVGVbPCiy+TDmTaXg4SWjdHUpXfqbXMkSX/j2dJ/ECqb/FtsvVxiSwRieG\n3MWDKWlNRz0C0QKrsoDYbcvLf68uc7L5eKFZhu0AkXP4T5BIbdMXH8V0+5e+6R+n\neHahFhMyaiYoHVrPMrW2Jn9iWIXuNTDpg9VFhejN4jG1wQqIu1puKeGYPQvtfNO5\nEf5cQdEFCvFfuDQvNhLgI1f798qY6EVFfRo2S3LLCut3wfDzRZiUN4Kz8qYz42Zv\n97GS1gW/lfcEsmBApov9xiIaUzUECN35XbZYMK5Y4gfhAseZ+tlj+YarEiPjAtL1\nJPUehCmRAgMBAAECggEAKmaI+ammsoFtbO9d4X3gkvxxmmx/RM0G4KC84ekH0qPp\nl85S10flVsIEydbiHWbVC/P7IbXb4Cd2g7OcA9GjYQ6nkoVvI+mvkz3uoKZkQofT\njGxbyrHswroY8Tb76jJJK60E7n+a5cCbE9ihmW2boTSzAncMJg5FyM9cRMbhL0Vz\nh90/gE2U8awQ8Ug47BN1Dk/awxB9f5zVqI+LCGC0Py0/oQudjSaqPihydTsuqkhV\nxNu3NMcL/POt9WxmYyJFDJRW3+EYraPumdUsIWw8p4JJDt1jkyNpSbjGhu8vzRYX\n0QSo1pa3VrDY4guEMk4RdJsKJDqQPTvCTTgDYBzFlQKBgQDq98CRLTwqHSEWyVKN\n0KRujhVAVEmLDvPxZ2tVaMM37RanCHYSfHLiYCD54rUv7BFWjQ+hfq3iHUpgrefN\nKRS9e01mT0f24sAsWfhrFzrhlHaQStFgOw4uvwIDCfzrBeQQsqcAvWSjNr8CqSMX\nUIGz9oB6EP39PT3QxT3oYf3ItwKBgQDhC6WN78+0sf2zlptQ7V02eWaRfePtQfmb\now3c9aF8V7sSwDzjInqV5Bva4RyftYRTYZttBiANjGZ1pSNPi/2p7b+0hxJ1pPf8\n6VcFDJBGLbFYNDWOux13KRJToMY0ckzSeBXgkWLVFSfESuoXzy+8bj5eMavJLg6L\n2Ek6q6mH9wKBgBZmmE0+6sV5EXaCqwQqKAMCOLRxVLGVM1yIZ4s0+aeTSt2RyO/q\nPWmnkH1CR9PRxbVirWLQGPO9pyGgcsD0ca2+25otZMb8xyVzTmOnS03GQadv+pYa\nCzgZra9sfFhLr3qIDbPcWoPU7FDsnxPR8QufLJB2nkBOXl5Q753/+ZnxAoGBAI47\nGisWwaNmSv3R1d/T5PGk0Jprgj5VUDh5WS2pYKKBoA49yT2UcP2C6cfwNnMJ+dPp\nAJ5rHJ7zeV4pPKPtyig3xs2GALixxrnlj8X1Jsnz3v3sIV1QDVNedeK83ggPpVXv\n54PC3z/k2vlIj6L0oyroUiqeIgBIR5FC5SVbkQ4JAoGBAOEGQkqw1xR3fd27J6/R\ns9hOhItPnjExf5yqeg0nbZYIGd+6PiaVBBWUefZDDS79KUwTiqiHGP7iEVghJr9C\nxJI9odzY8WQJ+Q9ZQy1VQfP5mkRUTTkABhykXfWsHckO7yP6c3kwNIOOki8QPrmY\n3GKNb5HtQVpazCvrB5PFh65g\n-----END PRIVATE KEY-----" }, { "path": "application/src/test/resources/app.pub", "content": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzo5w2NStZazqyhE3ynw5\nVRlWzwosvkw5k2l4OElo3R1KV36m1zJEl/49nSfxAqm/xbbL1cYksEYnhtzFgylp\nTUc9AtECq7KA2G3Ly3+vLnOy+XihWYbtAJFz+E+QSG3TFx/FdPuXvukfp3h2oRYT\nMmomKB1azzK1tiZ/YliF7jUw6YPVRYXozeIxtcEKiLtabinhmD0L7XzTuRH+XEHR\nBQrxX7g0LzYS4CNX+/fKmOhFRX0aNktyywrrd8Hw80WYlDeCs/KmM+Nmb/exktYF\nv5X3BLJgQKaL/cYiGlM1BAjd+V22WDCuWOIH4QLHmfrZY/mGqxIj4wLS9ST1HoQp\nkQIDAQAB\n-----END PUBLIC KEY-----" }, { "path": "application/src/test/resources/application.yaml", "content": "server:\n port: 8090\nspring:\n output:\n ansi:\n enabled: detect\n r2dbc:\n name: halo-test\n generate-unique-name: true\n sql:\n init:\n mode: always\n platform: h2\n messages:\n basename: config.i18n.messages\n\nhalo:\n work-dir: ${user.home}/halo-next-test\n external-url: \"http://${server.address:localhost}:${server.port}\"\n security:\n initializer:\n disabled: true\n oauth2:\n jwt:\n public-key-location: classpath:app.pub\n private-key-location: classpath:app.key\n extension:\n controller:\n disabled: true\n search-engine:\n lucene:\n enabled: false\n\nspringdoc:\n api-docs:\n enabled: false\nlogging:\n level:\n run.halo.app: debug\n org.springframework.r2dbc: DEBUG\n" }, { "path": "application/src/test/resources/backups/backup-for-restoration/extensions.data", "content": "[{\"name\":\"fake-extension-store\",\"data\":\"ZmFrZS1kYXRh\",\"version\":1024}]" }, { "path": "application/src/test/resources/backups/backup-for-restoration/workdir/fake-file", "content": "halo" }, { "path": "application/src/test/resources/categories/independent-post-count.json", "content": "[\n {\n \"spec\": {\n \"displayName\": \"全部\",\n \"children\": [\"FIT2CLOUD\", \"AnotherRootChild\"]\n },\n \"status\": {\n \"visiblePostCount\": 35\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"全部\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"FIT2CLOUD\",\n \"children\": [\"DataEase\", \"IndependentNode\"]\n },\n \"status\": {\n \"visiblePostCount\": 15\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"FIT2CLOUD\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DataEase\",\n \"children\": [\"SubNode1\", \"SubNode2\"]\n },\n \"status\": {\n \"visiblePostCount\": 10\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DataEase\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"SubNode1\",\n \"children\": [\"Leaf1\", \"Leaf2\"]\n },\n \"status\": {\n \"visiblePostCount\": 4\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"SubNode1\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"Leaf1\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 2\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"Leaf1\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"Leaf2\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 2\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"Leaf2\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"SubNode2\",\n \"preventParentPostCascadeQuery\": true,\n \"children\": [\"IndependentChild1\", \"IndependentChild2\"]\n },\n \"status\": {\n \"visiblePostCount\": 6\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"SubNode2\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"IndependentChild1\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 3\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"IndependentChild1\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"IndependentChild2\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 3\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"IndependentChild2\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"IndependentNode\",\n \"preventParentPostCascadeQuery\": true,\n \"children\": [\"IndependentChild3\", \"IndependentChild4\"]\n },\n \"status\": {\n \"visiblePostCount\": 5\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"IndependentNode\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"IndependentChild3\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 2\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"IndependentChild3\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"IndependentChild4\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 3\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"IndependentChild4\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"AnotherRootChild\",\n \"children\": [\"Child1\", \"Child2\"]\n },\n \"status\": {\n \"visiblePostCount\": 20\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"AnotherRootChild\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"Child1\",\n \"children\": [\"SubChild1\", \"SubChild2\"]\n },\n \"status\": {\n \"visiblePostCount\": 8\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"Child1\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"SubChild1\",\n \"children\": [\"DeepNode1\", \"DeepNode2\"]\n },\n \"status\": {\n \"visiblePostCount\": 3\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"SubChild1\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DeepNode1\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 1\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DeepNode1\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DeepNode2\",\n \"children\": [\"DeeperNode\"]\n },\n \"status\": {\n \"visiblePostCount\": 1\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DeepNode2\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DeeperNode\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 1\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DeeperNode\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"SubChild2\",\n \"children\": [\"DeepNode3\"]\n },\n \"status\": {\n \"visiblePostCount\": 5\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"SubChild2\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DeepNode3\",\n \"preventParentPostCascadeQuery\": true,\n \"children\": [\"DeepNode4\", \"DeepNode5\"]\n },\n \"status\": {\n \"visiblePostCount\": 2\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DeepNode3\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DeepNode4\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 1\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DeepNode4\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"DeepNode5\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 1\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"DeepNode5\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"Child2\",\n \"children\": [\"IndependentSubNode\"]\n },\n \"status\": {\n \"visiblePostCount\": 12\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"Child2\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"IndependentSubNode\",\n \"preventParentPostCascadeQuery\": true,\n \"children\": [\"SubNode3\", \"SubNode4\"]\n },\n \"status\": {\n \"visiblePostCount\": 12\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"IndependentSubNode\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"SubNode3\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 6\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"SubNode3\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n },\n {\n \"spec\": {\n \"displayName\": \"SubNode4\",\n \"children\": []\n },\n \"status\": {\n \"visiblePostCount\": 6\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Category\",\n \"metadata\": {\n \"name\": \"SubNode4\",\n \"version\": 0,\n \"creationTimestamp\": \"2024-06-14T06:17:47.589181Z\"\n }\n }\n]\n" }, { "path": "application/src/test/resources/config/i18n/messages.properties", "content": "problemDetail.title.run.halo.app.infra.exception.handlers.I18nExceptionTest$ErrorResponseException=Error Response\nproblemDetail.internalServerError=Something went wrong, please try again later.\n\nproblemDetail.run.halo.app.infra.exception.handlers.I18nExceptionTest$ErrorResponseException=Message argument is {0}.\nerror.somethingWentWrong=Something went wrong, argument is {0}.\nproblemDetail.title.internalServerError=Internal Server Error\n\nproblemDetail.title.conflict=Conflict\nproblemDetail.conflict=Conflict detected.\n" }, { "path": "application/src/test/resources/config/i18n/messages_zh.properties", "content": "problemDetail.title.run.halo.app.infra.exception.handlers.I18nExceptionTest$ErrorResponseException=发生错误\nproblemDetail.run.halo.app.infra.exception.handlers.I18nExceptionTest$ErrorResponseException=参数：{0}。\nerror.somethingWentWrong=发生了一些错误，参数：{0}。\n" }, { "path": "application/src/test/resources/console/assets/fake.txt", "content": "fake.\n" }, { "path": "application/src/test/resources/console/index.html", "content": "console index\n" }, { "path": "application/src/test/resources/file-type-detect/index.html", "content": "" }, { "path": "application/src/test/resources/file-type-detect/index.js", "content": "" }, { "path": "application/src/test/resources/file-type-detect/test.json", "content": "" }, { "path": "application/src/test/resources/folder-to-zip/examplefile", "content": "Here is an example file.\n" }, { "path": "application/src/test/resources/plugin/plugin-0.0.1/extensions/reverseProxy.yaml", "content": "apiVersion: plugin.halo.run/v1alpha1\nkind: ReverseProxy\nmetadata:\n name: reverse-proxy-template\n labels:\n plugin.halo.run/pluginName: io.github.guqing.apples\nrules:\n - path: /static/**\n file:\n directory: static\n - path: /admin/**\n file:\n directory: admin\n" }, { "path": "application/src/test/resources/plugin/plugin-0.0.1/extensions/roles.yaml", "content": "apiVersion: v1alpha1\nkind: Role\nmetadata:\n name: role-template-view-apples\n labels:\n halo.run/role-template: \"true\"\n annotations:\n halo.run/module: \"Apples Management\"\n halo.run/alias-name: \"Apples View\"\nrules:\n - apiGroups: [ \"apples.guqing.github.com\" ]\n resources: [ \"apples\" ]\n verbs: [ \"get\", \"list\" ]\n" }, { "path": "application/src/test/resources/plugin/plugin-0.0.1/extensions/setting.yaml", "content": "apiVersion: v1alpha1\nkind: Setting\nmetadata:\n name: fake-setting\nspec:\n forms: [ ]" }, { "path": "application/src/test/resources/plugin/plugin-0.0.1/extensions/test.yml", "content": "apiVersion: plugin.halo.run/v1alpha1\nkind: ReverseProxy\nmetadata:\n name: reverse-proxy-template\n labels:\n plugin.halo.run/pluginName: io.github.guqing.apples\nrules:\n - path: /static/**\n file:\n directory: static\n - path: /admin/**\n file:\n directory: admin\n" }, { "path": "application/src/test/resources/plugin/plugin-0.0.1/plugin.yaml", "content": "apiVersion: v1\nkind: Plugin\nmetadata:\n name: plugin-1\nspec:\n # 'version' is a valid semantic version string (see semver.org).\n version: 0.0.1\n requires: \">=2.0.0\"\n author:\n name: guqing\n logo: https://guqing.xyz/avatar\n pluginDependencies:\n \"banana\": \"0.0.1\"\n homepage: https://github.com/guqing/halo-plugin-1\n displayName: \"a name to show\"\n description: \"Tell me more about this plugin.\"\n license:\n - name: MIT" }, { "path": "application/src/test/resources/plugin/plugin-0.0.2/plugin.yaml", "content": "apiVersion: v1\nkind: Plugin\nmetadata:\n name: fake-plugin\nspec:\n # 'version' is a valid semantic version string (see semver.org).\n version: 0.0.2\n requires: \">=2.0.0\"\n author:\n name: johnniang\n logo: https://halo.run/avatar\n homepage: https://github.com/halo-sigs/halo-plugin-1\n displayName: \"Fake Display Name\"\n description: \"Fake description\"\n license:\n - name: GPLv3\n" }, { "path": "application/src/test/resources/plugin/plugin-for-finder/META-INF/plugin-components.idx", "content": "# Generated by Halo\nrun.halo.fake.FakePlugin\n" }, { "path": "application/src/test/resources/plugin/plugin-for-reverseproxy/static/test.txt", "content": "Fake content." }, { "path": "application/src/test/resources/plugin/plugin.yaml", "content": "apiVersion: v1\nkind: Plugin\nmetadata:\n name: plugin-1\nspec:\n # 'version' is a valid semantic version string (see semver.org).\n version: 0.0.1\n requires: \">=2.0.0\"\n author:\n name: guqing\n logo: https://guqing.xyz/avatar\n pluginDependencies:\n \"banana\": \"0.0.1\"\n homepage: https://github.com/guqing/halo-plugin-1\n displayName: \"a name to show\"\n description: \"Tell me more about this plugin.\"\n license:\n - name: MIT" }, { "path": "application/src/test/resources/themes/default/i18n/default.properties", "content": "index.welcome=欢迎来到首页\ntitle=这是来自 i18n/default.properties 的标题\n" }, { "path": "application/src/test/resources/themes/default/i18n/en.properties", "content": "index.welcome=Welcome to the index" }, { "path": "application/src/test/resources/themes/default/i18n/zh.properties", "content": "title=来自 i18n/zh.properties 的标题\n" }, { "path": "application/src/test/resources/themes/default/templates/index.html", "content": "\n\n\n \n Title\n\n\nindex\n
\n
\n\n\n" }, { "path": "application/src/test/resources/themes/default/templates/index.properties", "content": "title=Title from index.properties\n" }, { "path": "application/src/test/resources/themes/default/templates/index_zh.properties", "content": "title=来自 index_zh.properties 的标题\n" }, { "path": "application/src/test/resources/themes/default/templates/timezone.html", "content": "

\n" }, { "path": "application/src/test/resources/themes/default/theme.yaml", "content": "apiVersion: theme.halo.run/v1alpha1\nkind: Theme\nmetadata:\n name: default\nspec:\n displayName: Default\n author:\n name: halo-dev\n website: https://halo.run\n description: Default theme for Halo 2.0\n logo: https://halo.run/logo\n website: https://github.com/halo-sigs/theme-default\n repo: https://github.com/halo-sigs/theme-default.git\n version: 1.0.0\n require: 2.0.0\n" }, { "path": "application/src/test/resources/themes/invalid-missing-manifest/i18n/default.properties", "content": "index.welcome=\\u6B22\\u8FCE\\u6765\\u5230\\u9996\\u9875" }, { "path": "application/src/test/resources/themes/invalid-missing-manifest/i18n/en.properties", "content": "index.welcome=Welcome to the index" }, { "path": "application/src/test/resources/themes/invalid-missing-manifest/templates/index.html", "content": "\n\n\n \n Title\n\n\nindex\n
\n
\n\n\n" }, { "path": "application/src/test/resources/themes/invalid-missing-manifest/templates/timezone.html", "content": "

\n" }, { "path": "application/src/test/resources/themes/other/i18n/default.properties", "content": "index.welcome=Other \\u9996\\u9875" }, { "path": "application/src/test/resources/themes/other/i18n/en.properties", "content": "index.welcome=other index" }, { "path": "application/src/test/resources/themes/other/templates/index.html", "content": "\n\n\n \n Other theme title\n\n\n

\n\n\n" }, { "path": "application/src/test/resources/themes/other/theme.yaml", "content": "apiVersion: theme.halo.run/v1alpha1\nkind: Theme\nmetadata:\n name: default\nspec:\n displayName: Default\n author:\n name: halo-dev\n website: https://halo.run\n description: Default theme for Halo 2.0\n logo: https://halo.run/logo\n website: https://github.com/halo-sigs/theme-default\n repo: https://github.com/halo-sigs/theme-default.git\n version: 1.0.1\n require: 2.0.0\n" }, { "path": "application/src/test/resources/ui/console.html", "content": "console index\n" }, { "path": "application/src/test/resources/ui/uc.html", "content": "uc index\n" }, { "path": "application/src/test/resources/ui/ui-assets/fake.txt", "content": "fake.\n" }, { "path": "buildSrc/build.gradle", "content": "plugins {\n id 'groovy-gradle-plugin'\n}\n" }, { "path": "buildSrc/src/main/groovy/UploadBundleTask.groovy", "content": "import groovy.json.JsonSlurper\nimport org.gradle.api.DefaultTask\nimport org.gradle.api.artifacts.repositories.PasswordCredentials\nimport org.gradle.api.file.RegularFileProperty\nimport org.gradle.api.provider.Property\nimport org.gradle.api.tasks.*\n\nimport java.net.http.HttpClient\nimport java.net.http.HttpRequest\nimport java.net.http.HttpResponse\nimport java.time.Duration\nimport java.util.zip.ZipEntry\nimport java.util.zip.ZipInputStream\n\nimport static java.net.http.HttpRequest.BodyPublishers.ofFile\nimport static java.net.http.HttpRequest.BodyPublishers.ofString\nimport static java.nio.charset.StandardCharsets.UTF_8\n\n/**\n * Task to upload a bundle to Sonatype Central Repository.\n * @author JohnNiang\n */\nabstract class UploadBundleTask extends DefaultTask {\n\n @InputFile\n abstract RegularFileProperty getBundleFile();\n\n @Input\n @Optional\n abstract Property getPublishingType();\n\n @Input\n abstract Property getCredentials();\n\n UploadBundleTask() {\n getPublishingType().convention(PublishingType.AUTOMATIC)\n }\n\n @TaskAction\n void upload() {\n if (project.version.toString().endsWith(\"-SNAPSHOT\")) {\n logger.lifecycle(\"Detected SNAPSHOT version, uploading to maven-snapshots repository...\")\n uploadSnapshotBundle()\n logger.lifecycle(\"Snapshot bundle uploaded successfully.\")\n return\n }\n if (checkIfPublished()) {\n logger.lifecycle(\"The component ${project.group}:${project.name}:${project.version} is already published, skipping upload.\")\n return\n }\n\n def deploymentId = uploadReleaseBundle()\n def maxWait = Duration.ofMinutes(12)\n def pollingInterval = Duration.ofSeconds(10)\n def maxRetry = (int) (maxWait.toMillis() / pollingInterval.toMillis())\n def retry = 0\n logger.lifecycle(\"Preparing to check deployment state for deployment ID: ${deploymentId}, max retries: ${maxRetry}, polling interval: ${pollingInterval.toSeconds()} seconds\")\n while (retry++ <= maxRetry) {\n def state = checkDeploymentState(deploymentId)\n if (state == null) {\n throw new RuntimeException(\"Failed to check deployment state for deployment ID: ${deploymentId}\")\n }\n if (state == DeploymentState.PUBLISHED) {\n println(\"Bundle published successfully with deployment ID: ${deploymentId}\")\n break\n }\n if (state == DeploymentState.VALIDATED) {\n println(\"Bundle validated successfully with deployment ID: ${deploymentId}\")\n break\n }\n if (state == DeploymentState.FAILED) {\n throw new RuntimeException(\"Bundle deployment failed with deployment ID: ${deploymentId}\")\n }\n if (state == DeploymentState.VALIDATING) {\n logger.lifecycle('Bundle is being validated, please wait...')\n } else if (state == DeploymentState.PENDING) {\n logger.lifecycle('Bundle is pending, please wait...')\n }\n println(\"Deployment state: ${state}, retrying(${retry}) in ${pollingInterval.toSeconds()} seconds...\")\n sleep(pollingInterval.toMillis())\n }\n }\n\n boolean checkIfPublished() {\n createHttpClient().withCloseable { client ->\n def endpoint = \"https://central.sonatype.com/api/v1/publisher/published?namespace=${project.group}&name=${project.name}&version=${project.version}\";\n logger.debug(\"Checking if published at endpoint: ${endpoint}\")\n def request = HttpRequest.newBuilder(URI.create(endpoint))\n .header(\"Authorization\", bearerAuthorizationHeader)\n .GET()\n .build()\n def response = client.send(request, HttpResponse.BodyHandlers.ofString(UTF_8))\n if (response.statusCode() != 200) {\n throw new RuntimeException(\"Failed to check if published: status: ${response.statusCode()} - body: ${response.body()}\")\n }\n logger.debug(\"Response body: ${response.body()}\")\n def result = new JsonSlurper().parseText(response.body())\n logger.debug(\"Check if published result: ${result}\")\n return result.published as boolean\n }\n }\n\n DeploymentState checkDeploymentState(String deploymentId) {\n createHttpClient().withCloseable { client ->\n def endpoint = \"https://central.sonatype.com/api/v1/publisher/status?id=${deploymentId}\"\n\n def request = HttpRequest.newBuilder(URI.create(endpoint))\n .header(\"Authorization\", bearerAuthorizationHeader)\n .POST(HttpRequest.BodyPublishers.noBody())\n .build()\n def response = client.send(request, HttpResponse.BodyHandlers.ofString(UTF_8))\n if (response.statusCode() != 200) {\n throw new RuntimeException(\"Failed to check deployment status: status: ${response.statusCode()} - body: ${response.body()}\")\n }\n logger.debug(\"Response body: ${response.body()}\")\n def status = new JsonSlurper().parseText(response.body())\n logger.debug(\"Deployment status: ${status}\")\n return status.deploymentState as DeploymentState\n }\n }\n\n void uploadSnapshotBundle() {\n logger.lifecycle('Starting to upload snapshot bundle: {}', bundleFile.asFile.get())\n createHttpClient().withCloseable { client ->\n new ZipInputStream(bundleFile.asFile.get().newInputStream()).withCloseable { zis ->\n ZipEntry entry\n while ((entry = zis.nextEntry) != null) {\n if (entry.directory) {\n continue\n }\n def relativePath = entry.name\n def endpoint = \"https://central.sonatype.com/repository/maven-snapshots/$relativePath\"\n def request = HttpRequest.newBuilder(URI.create(endpoint))\n .header(\"Authorization\", basicAuthorizationHeader)\n .header(\"Content-Type\", \"application/octet-stream\")\n .PUT(HttpRequest.BodyPublishers.ofByteArray(zis.readAllBytes()))\n .build()\n def response = client.send(request, HttpResponse.BodyHandlers.ofString(UTF_8))\n logger.debug('Response status code: {}, body: {}', response.statusCode(), response.body())\n if (response.statusCode() != 200 && response.statusCode() != 201) {\n throw new RuntimeException(\"Failed to upload snapshot bundle: status: ${response.statusCode()} - entry: ${relativePath} - body : ${response.body()}\")\n }\n logger.lifecycle('Uploaded snapshot entry: {}, status: {}', relativePath, response.statusCode())\n }\n }\n }\n }\n\n String uploadReleaseBundle() {\n logger.lifecycle('Starting to upload release bundle: {}', bundleFile.asFile.get())\n createHttpClient().withCloseable { client ->\n // See https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html for more\n def boundary = \"------haloformboundary${UUID.randomUUID().toString().replace('-', '')}\"\n def crlf = \"\\r\\n\"\n def delimiter = \"${crlf}--${boundary}\"\n def endpoint = \"https://central.sonatype.com/api/v1/publisher/upload?publishingType=${publishingType.get()}\"\n\n def publishers = new ArrayList()\n publishers.add(ofString(\"${delimiter}${crlf}\"))\n publishers.add(ofString(\"\"\"\\\nContent-Disposition: form-data; name=\"bundle\"; filename=\"${bundleFile.get().asFile.name}\"\\\n${crlf}\\\n\"\"\"))\n publishers.add(ofString(\"Content-Type: application/octet-stream${crlf}${crlf}\"))\n publishers.add(ofFile(bundleFile.get().asFile.toPath()))\n publishers.add(ofString(\"${delimiter}--${crlf}\"))\n\n def request = HttpRequest.newBuilder(URI.create(endpoint))\n .header(\"Authorization\", bearerAuthorizationHeader)\n .header(\"Content-Type\", \"multipart/form-data; boundary=${boundary}\")\n .POST(HttpRequest.BodyPublishers.concat(publishers.toArray(HttpRequest.BodyPublisher[]::new)))\n .build()\n def response = client.send(request, HttpResponse.BodyHandlers.ofString(UTF_8))\n if (logger.debugEnabled) {\n logger.debug('Response status code: {}, body: {}', response.statusCode(), response.body())\n }\n if (response.statusCode() != 201 && response.statusCode() != 200) {\n throw new RuntimeException(\"Failed to upload bundle: status: ${response.statusCode()} - body: ${response.body()}\")\n }\n def deploymentId = response.body().trim()\n logger.lifecycle('Uploaded release bundle successfully, deployment ID: {}', deploymentId)\n return deploymentId\n }\n }\n\n @Internal\n String getBearerAuthorizationHeader() {\n def encoded = Base64.encoder.encodeToString(\"${credentials.get().username}:${credentials.get().password}\".getBytes(UTF_8))\n return \"Bearer ${encoded}\"\n }\n\n @Internal\n String getBasicAuthorizationHeader() {\n def encoded = Base64.encoder.encodeToString(\"${credentials.get().username}:${credentials.get().password}\".getBytes(UTF_8))\n return \"Basic ${encoded}\"\n }\n\n static HttpClient createHttpClient() {\n return HttpClient.newBuilder()\n .connectTimeout(Duration.ofMinutes(1))\n .build()\n }\n\n enum PublishingType {\n AUTOMATIC,\n USER_MANAGED,\n ;\n }\n\n enum DeploymentState {\n PENDING,\n VALIDATING,\n VALIDATED,\n PUBLISHING,\n PUBLISHED,\n FAILED,\n ;\n }\n\n}\n" }, { "path": "buildSrc/src/main/groovy/halo.publish.gradle", "content": "plugins {\n id 'maven-publish'\n id 'signing'\n}\n\ndef internalRepo = layout.buildDirectory.dir('repos/internal')\n\npublishing {\n publications.register('mavenJava', MavenPublication) {\n pom {\n url = 'https://github.com/halo-dev/halo'\n licenses {\n license {\n name = 'The GNU General Public License v3.0'\n url = 'https://www.gnu.org/licenses/gpl-3.0.en.html'\n }\n }\n developers {\n developer {\n id = 'johnniang'\n name = 'JohnNiang'\n email = 'johnniang@foxmail.com'\n }\n }\n scm {\n connection = 'scm:git:https://github.com/halo-dev/halo.git'\n developerConnection = 'scm:git:ssh://git@github.com:halo-dev/halo.git'\n url = 'https://github.com/halo-dev/halo'\n }\n }\n }\n\n repositories {\n maven {\n name = 'internal'\n url = internalRepo\n }\n }\n}\n\nsigning {\n sign publishing.publications.mavenJava\n}\n\ntasks.register('createBundle', Zip) {\n group = PublishingPlugin.PUBLISH_TASK_GROUP\n dependsOn tasks.named('publishAllPublicationsToInternalRepository')\n from(internalRepo)\n archiveBaseName = \"${project.group}.${project.name}\"\n}\n\ntasks.register('uploadBundle', UploadBundleTask) {\n group = PublishingPlugin.PUBLISH_TASK_GROUP\n credentials = providers.credentials(PasswordCredentials, \"portal\")\n bundleFile = tasks.named('createBundle', Zip).map { it.archiveFile }.get()\n}\n\ntasks.register('cleanInternalRepo', Delete) {\n group = PublishingPlugin.PUBLISH_TASK_GROUP\n delete internalRepo\n}\n\ntasks.named('publishAllPublicationsToInternalRepository') {\n dependsOn tasks.named('cleanInternalRepo')\n}\n\ntasks.named('publish') {\n dependsOn tasks.named('uploadBundle')\n}\n" }, { "path": "config/checkstyle/checkstyle.xml", "content": "\n\n\n\n\n\n \n\n \n\n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n" }, { "path": "docs/authentication/README.md", "content": "# Halo 认证方式\n\n目前 Halo 支持的认证方式有：\n\n- 基本认证（Basic Auth）\n- 表单登录（Form Login）\n\n计划支持的认证方式有：\n\n- [个人令牌认证（Personal Access Token）](https://github.com/halo-dev/halo/issues/1309)\n- [OAuth2](https://oauth.net/2/)\n\n## 基本认证\n\n这是最简单的一种认证方式，通过简单设置 HTTP 请求头 `Authorization: Basic xxxyyyzzz==` 即可实现认证，访问 Halo API，例如：\n\n```bash\n╰─❯ curl -u \"admin:P@88w0rd\" -H \"Accept: application/json\" http://localhost:8090/api/v1alpha1/users\n\n或者\n╰─❯ echo -n \"admin:P@88w0rd\" | base64\nYWRtaW46UEA4OHcwcmQ=\n╰─❯ curl -H \"Authorization: Basic YWRtaW46UEA4OHcwcmQ=\" -H \"Accept: application/json\" http://localhost:8090/api/v1alpha1/users\n```\n\n## 表单认证\n\n这是一种比较常用的认证方式，只需提供用户名和密码以及 `CSRF 令牌`（用于防止重复提交和跨站请求伪造）。\n\n- 表单参数\n\n | 参数名 | 类型 | 说明 |\n | ---------- | ------ | ------------------------------------- |\n | username | form | 用户名 |\n | password | form | 密码 |\n | _csrf | form | `CSRF` 令牌。由客户端随机生成。 |\n | XSRF-TOKEN | cookie | 跨站请求伪造令牌，和 `_csrf` 的值一致 |\n\n- HTTP 200 响应\n\n 仅在请求头 `Accept` 中包含 `application/json` 时发生，响应示例如下所示：\n\n ```bash\n ╰─❯ curl 'http://localhost:8090/login' \\\n -H 'Accept: application/json' \\\n -H 'Cookie: XSRF-TOKEN=1ff67e0c-6f2c-4cf9-afb5-81bc1015b8e5' \\\n -H 'Content-Type: application/x-www-form-urlencoded' \\\n --data-raw '_csrf=1ff67e0c-6f2c-4cf9-afb5-81bc1015b8e5&username=admin&password=P@88w0rd'\n ```\n\n ```bash\n < HTTP/1.1 200 OK\n < Vary: Origin\n < Vary: Access-Control-Request-Method\n < Vary: Access-Control-Request-Headers\n < Content-Type: application/json\n < Content-Length: 161\n < Cache-Control: no-cache, no-store, max-age=0, must-revalidate\n < Pragma: no-cache\n < Expires: 0\n < X-Content-Type-Options: nosniff\n < X-Frame-Options: DENY\n < X-XSS-Protection: 1 ; mode=block\n < Referrer-Policy: no-referrer\n < Set-Cookie: SESSION=d04db9f7-d2a6-4b7c-9845-ef790eb4a980; Path=/; HttpOnly; SameSite=Lax\n ```\n\n ```json\n {\n \"username\": \"admin\",\n \"authorities\": [\n {\n \"authority\": \"ROLE_super-role\"\n }\n ],\n \"accountNonExpired\": true,\n \"accountNonLocked\": true,\n \"credentialsNonExpired\": true,\n \"enabled\": true\n }\n ```\n\n- HTTP 302 响应\n\n 仅在请求头 `Accept` 中不包含 `application/json`才会发生，响应示例如下所示：\n\n ```bash\n ╰─❯ curl 'http://localhost:8090/login' \\\n -H 'Accept: */*' \\\n -H 'Cookie: XSRF-TOKEN=1ff67e0c-6f2c-4cf9-afb5-81bc1015b8e5' \\\n -H 'Content-Type: application/x-www-form-urlencoded' \\\n --data-raw '_csrf=1ff67e0c-6f2c-4cf9-afb5-81bc1015b8e5&username=admin&password=P@88w0rd'\n ```\n\n ```bash\n < HTTP/1.1 302 Found\n < Vary: Origin\n < Vary: Access-Control-Request-Method\n < Vary: Access-Control-Request-Headers\n < Location: /console/\n < Cache-Control: no-cache, no-store, max-age=0, must-revalidate\n < Pragma: no-cache\n < Expires: 0\n < X-Content-Type-Options: nosniff\n < X-Frame-Options: DENY\n < X-XSS-Protection: 1 ; mode=block\n < Referrer-Policy: no-referrer\n < Set-Cookie: SESSION=9ce6ad3f-7eba-4de5-abca-650b4721c7ac; Path=/; HttpOnly; SameSite=Lax\n < content-length: 0\n ```\n\n未来计划支持“记住我（Remember Me）”功能。\n\n## Personal Access Token\n\n### 背景\n\nHalo 是一款现代化的开源 CMS / 建站系统，为了便于开发者和用户利用 API 访问网站数据，Halo 支持了 Personal Access Token（以下简称\nPAT）功能。\n用户可以在 Halo 的后台生成 PAT，它是一个随机字符串，用于在 API 请求头里提供验证身份用。Halo 后端在接收请求时会校验 PAT\n的值，如果匹配就会允许访问相应的 API 数据。\n这种 PAT 机制避免了直接使用用户名密码的安全隐患，开发者可以为每个 PAT 设置访问范围、过期时间等。同时使用随机 PAT\n也增加了安全性。这为开发 Halo 插件和应用提供了更安全简便的认证方式。\n相比直接暴露服务端 API，这种 PAT 机制也更标准化和安全可控。Halo 在参考业内主流做法的基础上，引入了 PAT，以便于生态系统的开放与丰富。\n\n### 设计\n\nPAT 以 `pat_` 开头，剩余部分为随机字符串，随机字符串可以是 [JWT](https://datatracker.ietf.org/doc/html/rfc7519)、UUID\n或其他经过加密的随机字符串。目前，Halo 的实现是 `pat_` + `JWT` 的形式，例如：\n\n```text\npat_eyJraWQiOiJabUNtcWhJX2FuaFlWQW5aRlVTS0lOckxXRFhqaEp1Nk9ZRGRtcW13Rno4IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJhZG1pbiIsInJvbGVzIjpbInN1cGVyLXJvbGUiXSwicGF0X25hbWUiOiJwYXQtYWRtaW4tSVdvbFEiLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjgwOTAvIiwiZXhwIjoxNjk0NjcyMDc5LCJpYXQiOjE2OTQ1ODU3MjAsImp0aSI6IjE3ZWFkNzlkLTRkMjctYjg4NS02YjAzLTM4Y2JlYzQxMmFlMyJ9.xiq36NZIM3_ynBx-l0scGdfX-89aJi6uV7HJz_kNnuT78CFmxD-XTpncK1E-hqPdQSrSwyG4gT1pVO17UmUCoyoAkZKKKVk_seFwxdbygIueo2UJA5kVw1Naf_6iLtNkAXxAiYUpd8ihIwvVedhmOMQ9UUfd4QKZDR1XnTW4EAteWBi7b0pWqSa4h5lv7TpmAECY_KDAGrBRGGhc9AxsrGYPNZo68n2QGJ5BjH29vfdQaZz4vwsgKxG1WJ9Y7c8cQI9JN8EyQD_n560NWAaoFnRi1qL3nexvhjq8EVyGVyM48aKA02UcyvI9cxZFk6ZgnzmUsMjyA6ZL7wuexkujVqmc3iO5plBDCjW7oMe1zPQq-gEJXJU6gdr_SHcGG1BjamoekCkOeNT3CPzA_-5j3AVlj7FTFQkbn_h-kV07mfNO45BVVKsMb08HrN6iEk7TOX7SxN0s2gFc3xYVcXBMveLtftOfXs04SvSFCfTDeJH_Jy-3lYb_GLOji7xSc6FgRbuAwmzHLlsgBT4NJhR_0dZ-jNsCDIQCIC3iDc0qbcNTJYYocT77YaQzIkleFIXyPiV0RsNPmSTEDGiDlctsZ-AmcGCDQ-UmW8SIFBrA93OHncvb47o0-uBwZLdF_we4S90hJlNiAPVhhrBMtCoTJotyrODMEzwbLIukvewFXp8\n```\n\n示例 Token 中 JWT 部分所对应的 Header 如下：\n\n```json\n{\n \"kid\": \"ZmCmqhI_anhYVAnZFUSKINrLWDXjhJu6OYDdmqmwFz8\",\n \"alg\": \"RS256\"\n}\n```\n\nPayload 如下：\n\n```json\n{\n \"sub\": \"admin\",\n \"roles\": [\n \"super-role\"\n ],\n \"pat_name\": \"pat-admin-IWolQ\",\n \"iss\": \"http://localhost:8090/\",\n \"exp\": 1694672079,\n \"iat\": 1694585720,\n \"jti\": \"17ead79d-4d27-b885-6b03-38cbec412ae3\"\n}\n```\n\n### 使用方式\n\n#### 生成 PAT\n\nHalo 专门提供了生成 PAT 的端口：`/apis/api.console.security.halo.run/v1alpha1/users/-/personalaccesstokens`。创建 PAT\n请求示例如下：\n\n```shell\ncurl -u admin:admin -X 'POST' \\\n 'http://localhost:8090/apis/api.console.security.halo.run/v1alpha1/users/-/personalaccesstokens' \\\n -H 'accept: application/json' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"spec\": {\n \"name\": \"My PAT\",\n \"description\": \"This is my first PAT.\",\n \"expiresAt\": \"2023-09-15T02:42:35.136Z\"\n \"roles\": [\"\"]\n }\n}'\n```\n\n```json\n{\n \"spec\": {\n \"description\": \"This is my first PAT.\",\n \"expiresAt\": \"2023-09-16T02:42:35.136Z\",\n \"roles\": [],\n \"username\": \"admin\",\n \"revoked\": false,\n \"tokenId\": \"0b897d9c-56d7-5541-2662-110b70e3f9fd\"\n },\n \"apiVersion\": \"security.halo.run/v1alpha1\",\n \"kind\": \"PersonalAccessToken\",\n \"metadata\": {\n \"generateName\": \"pat-admin-\",\n \"name\": \"pat-admin-lobkm\",\n \"annotations\": {\n \"security.halo.run/access-token\": \"pat_eyJraWQiOiJabUNtcWhJX2FuaFlWQW5aRlVTS0lOckxXRFhqaEp1Nk9ZRGRtcW13Rno4IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJhZG1pbiIsInJvbGVzIjpbXSwicGF0X25hbWUiOiJwYXQtYWRtaW4tbG9ia20iLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjgwOTAvIiwiZXhwIjoxNjk0ODMyMTU1LCJpYXQiOjE2OTQ3NDcyOTgsImp0aSI6IjBiODk3ZDljLTU2ZDctNTU0MS0yNjYyLTExMGI3MGUzZjlmZCJ9.UVFYzKmz3bUk7fV6xh_CpuNJA-BR8bci-DIJ7o0fk-hayHXFHr_-7HMrVn7iZcphryqmk0RLv7Zsu_AjY9Qn9iCYybBJBycU0tUJzhDexRtj1ViJtlsraoYxLNSYpJK1hcPngeJuiMa9FZrYGp0k_7GX1NddoXLUBI9orN9DbdKmmJXtvigaxPCp52Mu7fBtVsTmO5fk_y2CglqRl_tkLRpFSgUbERKOqKItctDFRg-WUALBYEpXbhZIXBMuTCsJwhniBMpc1Uu_a1Dqa3K5hDgfHTeUADY2BuhEdYJCODPCzmdfWMNqxYSKQT5JFYoDv-ed6cRqNjKeNvd1IPT3RDkVt_fbo8KPrzvkgIjIzni-Wlwe-pXXQbj_n8iax-jkeK526iu8q2CLptxYxLGD0j8htKZramrov4UkK_eIsotEZZfqig9sYVU5_b442WhOWatdB_pbKj7h-YK1Cb2ueg5kl73bcbBu63b8edJZClp6xr72az343SfBZdwrT_JJ5HR0hJmckAMR_U4qvGWrJ-dobXDgY9Oz-qObfiyglzn0Wrz4HRPlmqDFr2o6TMV7UVjQiV77tDzaNbaXVevXGPS5MaZr313dia7XLpIV3QopXma7rDR6Xnqg7ftDQb5vAvsjwN-JsVabAsdFeCo6ejE1slAD9ZQrD88kgfAIuX4\"\n },\n \"version\": 0,\n \"creationTimestamp\": \"2023-09-15T03:08:18.875350Z\"\n }\n}\n```\n\n请求体说明如下表所示：\n\n| 属性名 | 描述 |\n|-------------|----------------------------------------------------------------------------------------------------|\n| name | PAT 名称。必填。 |\n| description | PAT 描述。非必填。 |\n| expiresAt | PAT 过期时间，一旦创建不可修改，或修改无效。如果不填写，则表示 PAT 无过期时间。 |\n| roles | 授权给 PAT 的角色，必须包含在当前用户所拥有的角色内。如果设置为 `null` 或者 `[]`，则表示当前 PAT 仅会拥有 `anonymous` 和 `authenticated` 角色。 |\n\n响应体说明如下所示：\n\n| 属性路径 | 描述 |\n|-----------------------------------------------------|----------------------------------------------|\n| security.halo.run/access-token | 生成好的 PAT。需要注意的是，这个 PAT 不会保存在数据库中，所以仅有一次保存机会。 |\n\n#### 使用 PAT\n\n向 Halo 发送请求时，携带 Header：`Authorization: Bearer $PAT` 即可。示例如下：\n\n```shell\ncurl http://localhost:8090/apis/api.console.halo.run/v1alpha1/users/- \\\n -H \"Authorization: Bearer pat_eyJraWQiOiJabUNtcWhJX2FuaFlWQW5aRlVTS0lOckxXRFhqaEp1Nk9ZRGRtcW13Rno4IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJhZG1pbiIsInJvbGVzIjpbXSwicGF0X25hbWUiOiJwYXQtYWRtaW4tbG9ia20iLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjgwOTAvIiwiZXhwIjoxNjk0ODMyMTU1LCJpYXQiOjE2OTQ3NDcyOTgsImp0aSI6IjBiODk3ZDljLTU2ZDctNTU0MS0yNjYyLTExMGI3MGUzZjlmZCJ9.UVFYzKmz3bUk7fV6xh_CpuNJA-BR8bci-DIJ7o0fk-hayHXFHr_-7HMrVn7iZcphryqmk0RLv7Zsu_AjY9Qn9iCYybBJBycU0tUJzhDexRtj1ViJtlsraoYxLNSYpJK1hcPngeJuiMa9FZrYGp0k_7GX1NddoXLUBI9orN9DbdKmmJXtvigaxPCp52Mu7fBtVsTmO5fk_y2CglqRl_tkLRpFSgUbERKOqKItctDFRg-WUALBYEpXbhZIXBMuTCsJwhniBMpc1Uu_a1Dqa3K5hDgfHTeUADY2BuhEdYJCODPCzmdfWMNqxYSKQT5JFYoDv-ed6cRqNjKeNvd1IPT3RDkVt_fbo8KPrzvkgIjIzni-Wlwe-pXXQbj_n8iax-jkeK526iu8q2CLptxYxLGD0j8htKZramrov4UkK_eIsotEZZfqig9sYVU5_b442WhOWatdB_pbKj7h-YK1Cb2ueg5kl73bcbBu63b8edJZClp6xr72az343SfBZdwrT_JJ5HR0hJmckAMR_U4qvGWrJ-dobXDgY9Oz-qObfiyglzn0Wrz4HRPlmqDFr2o6TMV7UVjQiV77tDzaNbaXVevXGPS5MaZr313dia7XLpIV3QopXma7rDR6Xnqg7ftDQb5vAvsjwN-JsVabAsdFeCo6ejE1slAD9ZQrD88kgfAIuX4\"\n```\n" }, { "path": "docs/backup-and-restore.md", "content": "# 备份和恢复 Proposal\n\n## Motivation\n\n目前，Halo 2.x 支持多种数据库：H2、MySQL、MariaDB、Microsoft SQL Server、Oracle 和\nPostgreSQL，虽然数据库有备份和恢复的功能，但是仍然缺少应用级别的备份和恢复功能。Halo\n的数据不仅限于数据库中的数据，还包含工作目录下的数据，例如主题、插件和日志等。\n\n## Goals\n\n- 全站备份，包括数据库中的数据和工作目录的数据。\n- 全站恢复，包括恢复数据库中的数据和工作目录的数据。\n- 用户可控制备份文件存储的时间。\n- 对于工作目录的数据，用户可选择性备份和恢复。\n- 用户可指定备份权限到任意用户。\n\n## Non-Goals\n\n- 仅备份部分自定义资源。\n- 仅备份和恢复文章 Markdown。\n- 定时备份。\n- 加密备份文件。\n- 备份文件自动上传至对象存储。\n\n## Use Cases\n\n- 从某种数据库（例如：H2）迁移至另外的数据库（例如：MySQL），不会因为 SQL 的兼容性而影响迁移。\n- 定时完整备份 Halo，并存储至对象存储，一旦发生意外可随时恢复。\n\n## Requirements\n\n- 仅支持 2.8.x 及以上的 Halo。\n- 恢复的数据的 creationTimestamp 可能会被当前时间覆盖。\n\n## Draft\n\n恢复数据之前需要完整备份当前 Halo，以便恢复过程中发生错误导致无法回滚。\n\n备份文件将存储在 `${halo.work-dir}/backups/halo-full-backup-2023.07.03-17:52:59.zip`。\n\n备份整站可能需要大量的时间，所以我们需要创建自定义模型（Backup）用于保存用户创建备份的请求，并异步执行备份操作，最终将结果反馈至自定义模型数据中。\n\nBackup 模型样例如下：\n\n- 备份成功样例\n\n```yaml\napiVersion: migration.halo.run/v1alpha1\nkind: Backup\nmetadata:\n name: halo-full-backup-xyz\n creationTimestamp: 2023.07.04-10:25:30\nspec:\n format: zip\n autoDeleteWhen: 2023.07.10-00:00:00Z\nstatus:\n phase: Succeeded\n startTimestamp: 2023.07.04-10:25:31\n completionTimestamp: 2023.07.04-10:26:30\n filename: halo-full-backup-2023-07-04-10-25-30.zip\n size: 1024 # data unit: bytes\n```\n\n- 备份失败样例\n\n```yaml\napiVersion: migration.halo.run/v1alpha1\nkind: Backup\nmetadata:\n name: halo-full-backup-xyz\n creationTimestamp: 2023.07.04-10:25:30\nspec:\n compressionFormat: zip | 7z | tar | tar.gz # 压缩格式\nstatus:\n startTimestamp: 2023.07.04-10:25:31\n # Pending: 刚刚创建好 Backup 资源，等待 Reconciler reconcile。\n # Running: Reconciler 正在备份 Halo。\n # Succeeded: Reconciler 成功执行备份 Halo 操作。\n # Failed: 备份 Halo 失败。\n phase: Failed\n failureReason: DatabaseConnectionReset | UnsupportedCompression # 机器可识别的信息\n failureMessage: The database connection reset. # 人类可阅读的信息\n```\n\n同时，BackupReconciler 将负责备份操作，并更新 Backup 数据。\n\n请求示例如下：\n\n```text\nPOST /apis/migration.halo.run/v1alpha1/backups\nContent-Type: application/json\n```\n\n### 备份\n\n准备好所有的备份内容后，需要计算摘要并保存，以便后期恢复校验备份文件完整性使用。\n\n#### 数据库备份和恢复\n\n因为 Halo 的 [Extension 设计](https://github.com/halo-dev/rfcs/tree/main/extension)，所以 Halo 的在数据库中的数据备份相对比较简单，只需要简单备份\nExtensionStore 即可。恢复同理。\n\n#### 工作目录备份和恢复\n\nHalo 工作目录样例如下所示：\n\n```text\n├── application.yaml\n├── attachments\n│   └── upload\n│   └── image_2023-06-09_16-24-41.png\n├── db\n│   └── halo-next.mv.db\n├── indices\n│   └── posts\n│   ├── _a.cfe\n│   ├── _a.cfs\n│   ├── _a.si\n│   ├── segments_h\n│   └── write.lock\n├── keys\n│   ├── id_rsa\n│   └── id_rsa.pub\n├── logs\n│   ├── halo.log\n│   ├── halo.log.2023-06-01.0.gz\n│   ├── halo.log.2023-06-02.0.gz\n│   ├── halo.log.2023-06-05.0.gz\n│   └── halo.log.2023-06-26.0.gz\n├── plugins\n│   ├── PluginCommentWidget-1.5.0.jar\n│   ├── PluginFeed-1.1.1.jar\n│   ├── PluginSearchWidget-1.0.0.jar\n│   ├── PluginSitemap-1.0.2.jar\n│   └── configs\n└── themes\n ├── theme-earth\n │   ├── README.md\n │   ├── settings.yaml\n │   ├── templates\n │   │   ├── archives.html\n │   │   ├── assets\n │   │   │   ├── dist\n │   │   │   │   ├── main.iife.js\n │   │   │   │   └── style.css\n │   │   │   └── images\n │   │   │   ├── default-avatar.svg\n │   │   │   └── default-background.png\n │   │   ├── author.html\n │   │   ├── category.html\n │   │   ├── error\n │   │   │   └── error.html\n │   │   ├── index.html\n │   │   ├── links.html\n │   │   ├── modules\n │   │   │   ├── category-filter.html\n │   │   │   ├── category-tree.html\n │   │   │   ├── featured-post-card.html\n │   │   │   ├── footer.html\n │   │   │   ├── header.html\n │   │   │   ├── hero.html\n │   │   │   ├── layout.html\n │   │   │   ├── post-card.html\n │   │   │   ├── sidebar.html\n │   │   │   ├── tag-filter.html\n │   │   │   └── widgets\n │   │   │   ├── categories.html\n │   │   │   ├── latest-comments.html\n │   │   │   ├── popular-posts.html\n │   │   │   ├── profile.html\n │   │   │   └── tags.html\n │   │   ├── page.html\n │   │   ├── post.html\n │   │   ├── tag.html\n │   │   └── tags.html\n │   └── theme.yaml\n```\n\n备份时需要过滤 `db`、backups` 和 `indices` 目录。\n\n#### 备份文件结构\n\n备份文件主要包含自定义资源（`extensions.data`）和工作目录（`workdir.data`）的数据。\n\n- `extensions.data`\n\n前期可考虑使用 JSON 来存储所有的 ExtensionStore 数据。\n\n- `workdir.data`\n\n对工作目录进行 `ZIP` 压缩。\n\n- config.yaml（备份配置）\n\n主要用于描述 `extensions.data` 和 `workdir.data` 压缩格式，后续可扩展备份与恢复相关的配置。例如：\n\n```yaml\ncompressions:\n extensions: json | others\n workdir: zip | others\n```\n\n前期可不实现该功能。\n\n### 恢复\n\n用户通过上传备份文件的方式进行恢复。当且仅当博客未初始化阶段才能进行恢复操作，否则可能会造成数据不一致。\n\n请求示例如下：\n\n```text\nPOST /apis/migration.halo.run/v1alpha1/restorations\nContent-Type: multipart/form-data; boundary=\"boundary\"\n\n'''\n--boundary\nContent-Disposition: form-data; name=\"backupfile\"; filename=\"halo-full-backup.zip\"\nContent-Type: application/zip\n'''\n```\n\n恢复步骤如下：\n\n1. 解压缩备份文件。\n2. 校验备份文件的完整性。\n2. 恢复所有 ExtensionStore。\n3. 覆盖当前工作目录。\n4. 备份完成。\n\n> 需要注意内存占用问题。\n\n## TBDs\n\n- 数据备份期间可能会存在数据的创建、更新和删除。\n\n我们将忽略这些数据变化。\n\n- 是否支持在初始化博客后恢复数据？\n\n支持。不过可能会覆盖掉已有的数据。\n" }, { "path": "docs/cache/page.md", "content": "# 缓存\n\n缓存在各个领域用得非常广泛，例如 CPU 的三级缓存，可加速从主内存中获取数据到处理器。Halo 的主要应用以博客为主，页面更新不会特别频繁，大多数情况下，实时渲染的结果都是没有变化的。如果能够缓存这些不经常变更的页面，可减少数据库访问，加快访问速度。\n\nHalo 采用由 Spring 框架提供的 Caching 作为缓存框架。该缓存框架面对各种缓存实现，提供了统一的访问入口，后续更换缓存仅需修改少量代码和配置。\n\nHalo 默认提供了 CacheProperties 用于启用/禁用缓存，示例如下：\n\n```yaml\nhalo:\n caches:\n page:\n disabled: true\n others:\n disabled: false\n```\n\n# 页面缓存\n\n页面缓存包括缓存响应体、响应头和响应状态。页面缓存规则如下：\n\n1. 仅缓存模板引擎所渲染的页面。\n2. 仅缓存 `Content-Type` 为 `text/html` 的页面。\n3. 仅缓存响应状态为 `HTTP 200（OK）`。\n4. 请求访问为 `GET`。\n\n缓存详情见下表：\n\n| 术语 | 值 |\n|------|----------------|\n| 名称 | `page` |\n| 失效时间 | 距最近一次访问 `1` 小时 |\n| 缓存数量 | `10,000` 个 |\n" }, { "path": "docs/developer-guide/custom-endpoint.md", "content": "# 系统自定义 API\n\n系统自定义 API 是一组特殊的 API，因为自定义模型 API 无法满足要求，需要开发者自己实现。\n\n但是系统自定义 API 有一个统一的前缀：`/apis/api.console.halo.run/v1alpha1/`，剩余的部分可随意定义。\n\n## 如何在系统中创建一个系统自定义 API\n\n1. 实现 `run.halo.app.core.extension.endpoint.CustomEndpoint` 接口\n2. 将实现类设置为 Spring Bean\n\n关于用户的自定义 API 实现类如下：\n\n```java\n\n@Component\npublic class UserEndpoint implements CustomEndpoint {\n\n private final ExtensionClient client;\n\n public UserEndpoint(ExtensionClient client) {\n this.client = client;\n }\n\n Mono me(ServerRequest request) {\n return ReactiveSecurityContextHolder.getContext()\n .map(ctx -> {\n var name = ctx.getAuthentication().getName();\n return client.fetch(User.class, name)\n .orElseThrow(() -> new ExtensionNotFoundException(name));\n })\n .flatMap(user -> ServerResponse.ok()\n .contentType(MediaType.APPLICATION_JSON)\n .bodyValue(user));\n }\n\n @Override\n public RouterFunction endpoint() {\n return SpringdocRouteBuilder.route()\n .GET(\"/users/-\", this::me, builder -> builder.operationId(\"GetCurrentUserDetail\")\n .description(\"Get current user detail\")\n .tag(\"api.console.halo.run/v1alpha1/User\")\n .response(responseBuilder().implementation(User.class)))\n // 这里可添加其他自定义 API\n .build();\n }\n}\n```\n\n这样我们就可以启动 Halo，访问 Swagger UI 文档地址，并进行测试。\n" }, { "path": "docs/developer-guide/plugin-configuration-properties.md", "content": "# 插件外部配置\n\n插件外部配置功能允许用户在特定目录添加插件相关的配置，插件启动的时候能够自动读取到该配置。\n\n## 配置优先级\n\n> 优先级从上到下由高到低。\n\n1. `${halo.work-dir}/plugins/configs/${plugin-id}.{yaml|yml}`\n2. `classpath:/config.{yaml|yml}`\n\n插件开发者可在 `Class Path` 下 添加 `config.{yaml|yml}` 作为默认配置。当 `.yaml` 和 `.yml` 同时出现时，以 `.yml` 的配置将会被忽略。\n\n## 插件中定义配置并使用\n\n- `src/main/java/my/plugin/MyPluginProperties.java`\n\n ```java\n @Data\n @ConfigurationProperties\n public class MyPluginProperties {\n \n private String encryptKey;\n \n private String certPath;\n }\n ```\n\n- `src/main/java/my/plugin/MyPluginConfiguration.java`\n\n ```java\n @EnableConfigurationProperties(MyPluginProperties.class)\n @Configuration\n public class MyPluginConfiguration {\n \n }\n ```\n\n- `src/main/java/my/plugin/MyPlugin.java`\n\n ```java\n @Component\n @Slf4j\n public class MyPlugin extends BasePlugin {\n \n private final MyPluginProperties storeProperties;\n \n public MyPlugin(PluginWrapper wrapper, MyPluginProperties storeProperties) {\n super(wrapper);\n this.storeProperties = storeProperties;\n }\n \n @Override\n public void start() {\n log.info(\"My plugin properties: {}\", storeProperties);\n }\n }\n ```\n\n- `src/main/resources/config.yaml`\n\n ```yaml\n encryptKey: encrytkey==\n certPath: /path/to/cert\n ```\n\n## 插件使用者配置\n\n- `${halo.work-dir}/plugins/configs/${plugin-id}.{yaml|yml}`\n\n ```yaml\n encryptKey: override encrytkey==\n certPath: /another/path/to/cert\n ```\n\n## 可能存在的问题\n\n- 增加未来实现\"集群\"架构的难度。\n" }, { "path": "docs/email-verification/README.md", "content": "## 背景\n\n在 Halo 中，邮箱作为用户主要的身份识别和通信方式，不仅有助于确保用户提供的邮箱地址的有效性和所有权，还对于减少滥用行为、提高账户安全性以及确保用户可以接收重要通知（如密码重置、注册新账户、确认重要操作等）至关重要。\n\n邮箱验证是用户管理过程中的一个关键组成部分，可以帮助维护了一个健康、可靠的用户基础，并且为系统管理员提供了一个额外的安全和管理手段，因此实现一个高效、安全且用户友好的邮箱验证功能至关重要。\n\n## 需求\n\n1. **用户注册验证**：确保新用户在注册过程中提供有效的邮箱地址。邮箱验证作为新用户激活其账户的必要步骤，有助于减少虚假账户和提升用户的整体质量。\n2. **密码重置和安全操作**：在用户忘记密码或需要重置密码时，向已验证的邮箱地址发送密码重置链接来确保安全性。\n3. **用户通知**：验证邮箱地址有助于确保用户可以接收到重要通知，如文章被评论、有新回复等。\n\n## 目标\n\n- 支持用户在修改邮箱后支持重新进行邮箱验证。\n- 允许用户在未收到邮件或邮件过期时重新请求发送验证邮件。\n- 避免邮件通知被滥用，如频繁发送验证邮件，需要添加限制。\n- 验证码过期机制，以确保验证邮件的有效性和安全性。\n\n## 非目标\n\n- 不考虑用户多邮箱地址的验证。\n\n## 方案\n\n### EmailVerificationManager\n\n通过使用 guava 提供的 Cache 来实现一个 EmailVerificationManager 来管理邮箱验证的缓存。\n\n```java\nclass EmailVerificationManager {\n private final Cache emailVerificationCodeCache =\n CacheBuilder.newBuilder()\n .expireAfterWrite(CODE_EXPIRATION_MINUTES, TimeUnit.MINUTES)\n .maximumSize(10000)\n .build();\n\n private final Cache blackListCache = CacheBuilder.newBuilder()\n .expireAfterWrite(Duration.ofHours(1))\n .maximumSize(1000)\n .build();\n\n record UsernameEmail(String username, String email) {\n }\n\n @Data\n @Accessors(chain = true)\n static class Verification {\n private String code;\n private AtomicInteger attempts;\n }\n}\n```\n\n当用户请求发送验证邮件时，会生成一个随机的验证码，并将其存储在缓存中，默认有效期为 10 分钟，当十分钟内用户未验证成功，验证码会自动过期被缓存清除。\n\n用户可以在十分钟内重新请求发送验证邮件，此时会生成一个新的验证码有效期依然为 10 分钟。但会限制用户发送频率，同一个用户的邮箱发送验证邮件的时间间隔不得小于\n1 分钟，以防止滥用。\n\n当用户请求验证邮箱时，会从缓存中获取验证码，如果验证码不存在或已过期，会提示验证码无效或已过期，如果验证码存在且未过期，会进行验证码的比对，如果验证码不正确，会提示验证码无效，如果验证码正确，会将用户邮箱地址标记为已验证，并从缓存中清除验证码。\n\n如果用户反复使用 code 验证邮箱，会记录失败次数，如果达到了默认的最大尝试次数（默认为 5 次），将被加入黑名单，需要 1\n小时后才能重新验证邮件。\n\n根据上述规则：\n\n- 每个验证码有10分钟的有效期。\n- 在这10分钟内，如果失败次数超过5次，用户会被加入黑名单，禁止验证1小时。\n- 如果在10分钟内尝试了5次且失败，然后请求重新发送验证码，可以再次尝试5次。\n\n那么：\n\n- 在不触发黑名单的情况下，每10分钟可以尝试5次。\n- 一小时内，可以尝试 (60/10) * 5 = 30 次，前提是每10分钟都请求一次新的验证码。\n- 但是，如果在任何10分钟内尝试超过5次，则会被禁止1小时。\n\n因此，为了最大化尝试次数而不触发黑名单，每小时可以尝试 30 次，预计一天内（24h）最多可以尝试 720 次验证码。\n验证码的组成为随机的 6 为数字，可能组合总数：一个 6 位数字的验证码可以从 000000 到 999999，总共有 10 6 种可能的组合。\n10 6 / 720 = 1388，因此，预计最坏情况下需要 1388 天可以破解验证码。这个时间足够长，可以认为非常安全的。\n\n### 提供 APIs 用于处理验证请求\n\n- `POST /apis/v1alpha1/users/-/send-verification-email`：用于请求发送验证邮件来验证邮箱地址。\n- `POST /apis/v1alpha1/users/-/verify-email`：用于根据邮箱验证码来验证邮箱地址。\n\n以上两个 APIs 认证用户都可以访问，但会对请求进行限制，请求间隔不得小于 1 分钟，以防止滥用。\n\n并且会在用户个人资料 API 中添加 emailVerified 字段，用于标识用户邮箱是否已验证。\n\n### 验证码邮件通知\n\n只会通过用户请求验证的邮箱地址发送验证邮件，并且提供了以下变量用户自定义通知模板：\n\n- **username**: 请求验证邮件地址的用户名。\n- **code**: 验证码。\n- **expirationAtMinutes**: 验证码过期时间（分钟）。\n\n验证邮件默认模板示例内容如下:\n\n```markdown\nguqing 你好：\n\n使用下面的动态验证码（OTP）验证您的电子邮件地址。\n\n277436\n\n动态验证码的有效期为 10 分钟。如果您没有尝试验证您的电子邮件地址，请忽略此电子邮件。\n\nguqing's blog\n```\n\n### 安全和异常处理\n\n- 确保所有敏感数据安全传输，当验证码不正确或过期时，只应该提示一个通用的错误信息防止用户猜测或爆破验证码。\n- 异常提示多语言支持。\n\n## 结论\n\n通过实施上述方案，考虑到了以下情况：\n\n1. 新邮箱验证请求\n2. 用户邮箱地址更新\n3. 用户请求重新发送验证邮件\n4. 邮件发送失败\n5. 验证码有效期\n6. 发送频率限制\n7. 验证状态的指示和反馈\n\n我们将能够提供一个安全、可靠且用户友好的邮箱验证功能。\n" }, { "path": "docs/extension-points/authentication.md", "content": "# Halo 认证扩展点\n\n此前，Halo 提供了 AdditionalWebFilter 作为扩展点供插件扩展认证相关的功能。但是近期我们明确了 AdditionalWebFilter\n的使用用途，故不再作为认证的扩展点。\n\n目前，Halo 提供了三种认证扩展点：表单登录认证、普通认证和匿名认证。\n\n## 表单登录（FormLogin）\n\n示例如下：\n\n```java\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.FormLoginSecurityWebFilter;\n\n@Component\npublic class MyFormLoginSecurityWebFilter implements FormLoginSecurityWebFilter {\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n // Do your logic here\n return chain.filter(exchange);\n }\n}\n\n```\n\n## 普通认证（Authentication）\n\n示例如下：\n\n```java\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.AuthenticationSecurityWebFilter;\n\n@Component\npublic class MyAuthenticationSecurityWebFilter implements AuthenticationSecurityWebFilter {\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n // Do your logic here\n return chain.filter(exchange);\n }\n}\n```\n\n## 匿名认证（Anonymous Authentication\n\n示例如下：\n\n```java\nimport org.springframework.stereotype.Component;\nimport org.springframework.web.server.ServerWebExchange;\nimport org.springframework.web.server.WebFilterChain;\nimport reactor.core.publisher.Mono;\nimport run.halo.app.security.AnonymousAuthenticationSecurityWebFilter;\n\n@Component\npublic class MyAnonymousAuthenticationSecurityWebFilter\n implements AnonymousAuthenticationSecurityWebFilter {\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n // Do your logic here\n return chain.filter(exchange);\n }\n}\n```\n\n## 前置过滤器（BeforeSecurityWebFilter）\n\n主要用于在进行认证之前的一些处理。需要注意的是，当前过滤器中无法直接通过 ReactiveSecurityContextHolder 获取\nSecurityContext。示例如下：\n\n```java\npublic class MyBeforeSecurityWebFilter implements BeforeSecurityWebFilter {\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n // Do your logic here\n return chain.filter(exchange);\n }\n}\n```\n\n## 后置过滤器（AfterSecurityWebFilter）\n\n主要用于进行认证之后的一些处理。在当前过滤器中，可以通过 ReactiveSecurityContextHolder 获取 SecurityContext。示例如下：\n\n```java\npublic class MyAfterSecurityWebFilter implements AfterSecurityWebFilter {\n\n @Override\n public Mono filter(ServerWebExchange exchange, WebFilterChain chain) {\n return ReactiveSecurityContextHolder.getContext()\n .switchIfEmpty(Mono.defer(() -> {\n // do something...\n return chain.filter(exchange).then(Mono.empty());\n }))\n .flatMap(securityContext -> {\n // do something...\n return chain.filter(exchange);\n });\n }\n}\n```\n\n---\n\n我们在实现扩展点的时候需要注意：如果当前请求不满足认证条件，请一定要调用 `chain.filter(exchange)`，给其他 filter 留下机会。\n\n后续会根据需求实现其他认证相关的扩展点。" }, { "path": "docs/extension-points/content.md", "content": "# 内容扩展点\n\n## 文章内容扩展点\n\n文章内容扩展点用于在主题端文章内容渲染之前对文章内容进行修改，比如添加广告、添加版权声明、插入脚本等。\n\n## 使用方式\n\n在插件中通过实现 `run.halo.app.theme.ReactivePostContentHandler` 接口来实现文章内容扩展。\n\n以下是一个扩展文章内容支持 Katex 的示例：\n\n```javascript\nString katexScript=\"\"\"\n \n \n \n \n \"\"\";\n```\n\n然后在 `handle` 方法中将 Katex 的脚本字符串插入到内容前面：\n\n```java\n\n@Component\npublic class KatexPostContentHandler implements ReactivePostContentHandler {\n\n @Override\n public Mono handle(PostContentContext postContent) {\n postContent.setContent(katexScript + \"\\n\" + postContent.getContent());\n return Mono.just(postContent);\n }\n}\n```\n\n定义了扩展点实现（扩展），还需要在插件的 `resources/extensions` 目录下添加对扩展的声明：\n\n```yaml\n# resources/extensions/extension-definitions.yml\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: ext-def-katex-post-content\nspec:\n className: run.halo.katex.KatexPostContentHandler\n # 文章内容扩展点的名称，固定值\n extensionPointName: reactive-post-content-handler\n displayName: \"KatexPostContentHandler\"\n description: \"Katex support for post content.\"\n```\n\n## 自定义页面内容扩展点\n\n自定义页面（SinglePage）内容扩展点用于在主题端自定义页面内容渲染之前对内容进行修改，比如添加广告、添加版权声明、插入脚本等。\n\n## 使用方式\n\n在插件中通过实现 `run.halo.app.theme.ReactiveSinglePageContentHandler` 接口来实现内容扩展。\n\n以下是一个扩展内容支持 Katex 的示例：\n\n```java\n\n@Component\npublic class KatexSinglePageContentHandler implements ReactiveSinglePageContentHandler {\n\n @Override\n public Mono handle(SinglePageContentContext pageContent) {\n\n String katexScript = \"\"; // 参考文章内容扩展点的示例脚本块\n pageContent.setContent(katexScript + \"\\n\" + pageContent.getContent());\n return Mono.just(pageContent);\n }\n}\n```\n\n在插件的 `resources/extensions` 目录下添加对自定义页面内容扩展的声明：\n\n```yaml\n# resources/extensions/extension-definitions.yml\napiVersion: plugin.halo.run/v1alpha1\nkind: ExtensionDefinition\nmetadata:\n name: ext-def-katex-singlepage-content\nspec:\n className: run.halo.katex.KatexSinglePageContentHandler\n # 自定义页面内容扩展点的名称，固定值\n extensionPointName: reactive-post-content-handler\n displayName: \"KatexSinglePageContentHandler\"\n description: \"Katex support for single page content.\"\n```\n" }, { "path": "docs/extension-points/search-engine.md", "content": "# 搜索引擎扩展点\n\n随着 Halo 的不断发展，搜索引擎模块也逐渐完善。搜索引擎模块是 Halo 的核心模块之一，它负责为 Halo\n提供全文搜索功能。搜索引擎模块目前仅支持本地全文搜索引擎 [Lucene](https://lucene.apache.org/)，其他搜索引擎的支持，如\nSolr、MeiliSearch 或 ElasticSearch，需要通过插件来实现。\n\n搜索引擎模块包含两个扩展点，分别是搜索引擎扩展和搜索文档扩展。搜索引擎扩展主要负责索引文档的添加、更新、删除和重建，搜索文档扩展则主要用于扩展文档类型，不仅限于文章类型。\n\n从 Halo 2.17 开始，Halo 利用事件机制收集来自核心和插件中所发布的文档，其中也包含了文档类型用于区分。所以插件中可以通过发布事件的方式来控制文档的添加、更新、删除和重建，重建操作所需要的数据则由搜索文档扩展提供。\n\n## 搜索引擎扩展（`run.halo.app.search.SearchEngine`）\n\n如果插件想要扩展搜索引擎，如 Solr、MeiliSearch 或者 ElasticSearch，可以通过实现 `SearchEngine` 接口来实现。\n\n具体实现可参考 Halo 的 Lucene 搜索引擎实现：`run.halo.app.search.LuceneSearchEngine`。\n\n## 搜索文档扩展（`run.halo.app.search.HaloDocumentsProvider`）\n\n如果插件想要扩展搜索文档类型，可以通过实现 `HaloDocumentsProvider` 接口来实现。具体实现可参考 Halo\n的默认实现：`run.halo.app.search.post.PostHaloDocumentsProvider`。\n\n- 添加文档示例如下所示\n\n ```java\n class HaloDocumentAddExample {\n\n private final ApplicationEventPublisher eventPublisher;\n\n void addDocuments() {\n // concrete Halo documents\n List documents = ...;\n eventPublisher.publishEvent(new HaloDocumentAddRequestEvent(this, documents));\n }\n }\n ```\n\n- 删除文档示例如下所示\n\n ```java\n class HaloDocumentDeleteExample {\n\n private final ApplicationEventPublisher eventPublisher;\n\n void deleteDocuments() {\n Set docIds = ...;\n eventPublisher.publishEvent(new HaloDocumentDeleteRequestEvent(this, docIds));\n }\n }\n ```\n\n- 重建索引示例如下所示：\n\n ```java\n class HaloDocumentRebuildExample {\n\n private final ApplicationEventPublisher eventPublisher;\n\n void rebuildDocument() {\n eventPublisher.publishEvent(new HaloDocumentRebuildRequestEvent(this));\n }\n\n }\n ```\n " }, { "path": "docs/full-text-search/README.md", "content": "# 在 Halo 中实践全文搜索\n\n主题端需全文搜索接口用于模糊搜索文章，且对效率要求极高。已经有对应的 Issue\n提出，可参考：。\n\n实现全文搜索的本地方案最好的就是 Apache 旗下开源的 [Lucene](https://lucene.apache.org/)\n，不过 [Hibernate Search](https://hibernate.org/search/) 也基于 Lucene 实现了全文搜索。Halo 2.0 的自定义模型并不是直接在\nHibernate 上构建的，也就是说 Hibernate 在 Halo 2.0 只是一个可选项，故我们最终可能并不会采用 Hibernate Search，即使它有很多优势。\n\nHalo 也可以学习 Hibernate 适配多种搜索引擎，如 Lucene、ElasticSearch、MeiliSearch 等。默认实现为 Lucene，对于用户来说，这种实现方式部署成本最低。\n\n## 搜索接口设计\n\n### 搜索参数\n\n字段如下所示：\n\n- keyword: string. 关键字\n- sort: string[]. 搜索字段和排序方式\n- offset: number. 本次查询结果偏移数\n- limit: number. 本次查询的结果最大条数\n\n例如：\n\n```bash\nhttp://localhost:8090/apis/api.halo.run/v1alpha1/posts?keyword=halo&sort=title.asc&sort=publishTimestamp,desc&offset=20&limit=10\n```\n\n### 搜索结果\n\n```yaml\nhits:\n - name: halo01\n title: Halo 01\n permalink: /posts/halo01\n categories:\n - a\n - b\n tags:\n - c\n - d\n - name: halo02\n title: Halo 02\n permalink: /posts/halo02\n categories:\n - a\n - b\n tags:\n - c\n - d\nquery: \"halo\"\ntotal: 100\nlimit: 20\noffset: 10\nprocessingTimeMills: 2\n```\n\n#### 搜索结果分页问题\n\n目前，大多数搜索引擎为了性能问题，并没有直接提供分页功能，或者不推荐分页。\n\n请参考：\n\n- \n- \n- \n- \n\n综合以上讨论，我们暂定不支持分页。不过允许设置单次查询的记录数（limit <= max_limit）。\n\n#### 中文搜索优化\n\nLucene 默认的分析器，对中文的分词不够友好，我们需要借助外部依赖或者外部整理好的词库帮助我们更好的对中文句子分词，以便优化中文搜索结果。\n\n以下是关于中文分析器的 Java 库：\n\n- \n- \n- \n- \n- \n\n### 搜索引擎样例\n\n#### MeiliSearch\n\n```bash\ncurl 'http://localhost:7700/indexes/movies/search' \\\n -H 'Accept: */*' \\\n -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6,zh-TW;q=0.5' \\\n -H 'Authorization: Bearer MASTER_KEY' \\\n -H 'Connection: keep-alive' \\\n -H 'Content-Type: application/json' \\\n -H 'Cookie: logged_in=yes; adminer_permanent=; XSRF-TOKEN=75995791-980a-4f3e-81fb-2e199d8f3934' \\\n -H 'Origin: http://localhost:7700' \\\n -H 'Referer: http://localhost:7700/' \\\n -H 'Sec-Fetch-Dest: empty' \\\n -H 'Sec-Fetch-Mode: cors' \\\n -H 'Sec-Fetch-Site: same-origin' \\\n -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36 Edg/107.0.1418.26' \\\n -H 'X-Meilisearch-Client: Meilisearch mini-dashboard (v0.2.2) ; Meilisearch instant-meilisearch (v0.8.2) ; Meilisearch JavaScript (v0.27.0)' \\\n -H 'sec-ch-ua: \"Microsoft Edge\";v=\"107\", \"Chromium\";v=\"107\", \"Not=A?Brand\";v=\"24\"' \\\n -H 'sec-ch-ua-mobile: ?0' \\\n -H 'sec-ch-ua-platform: \"Windows\"' \\\n --data-raw '{\"q\":\"halo\",\"attributesToHighlight\":[\"*\"],\"highlightPreTag\":\"\",\"highlightPostTag\":\"\",\"limit\":21}' \\\n --compressed\n```\n\n```json\n{\n \"hits\": [\n {\n \"id\": 108761,\n \"title\": \"I Am... Yours: An Intimate Performance at Wynn Las Vegas\",\n \"overview\": \"Filmed at the Encore Theater at Wynn Las Vegas, this extraordinary concert features performances of over 30 songs from Beyoncé’s three multi-platinum solo releases, Destiny’s Child catalog and a few surprises. This amazing concert includes the #1 hits, “Single Ladies (Put A Ring On It),” “If I Were A Boy,” “Halo,” “Sweet Dreams” and showcases a gut-wrenching performance of “That’s Why You’re Beautiful.” Included on \\\"I AM... YOURS An Intimate Performance At Wynn Las Vegas,\\\" is a biographical storytelling woven between many songs and exclusive behind-the-scenes footage.\",\n \"genres\": [\"Music\", \"Documentary\"],\n \"poster\": \"https://image.tmdb.org/t/p/w500/j8n1XQNfw874Ka7SS3HQLCVNBxb.jpg\",\n \"release_date\": 1258934400,\n \"_formatted\": {\n \"id\": \"108761\",\n \"title\": \"I Am... Yours: An Intimate Performance at Wynn Las Vegas\",\n \"overview\": \"Filmed at the Encore Theater at Wynn Las Vegas, this extraordinary concert features performances of over 30 songs from Beyoncé’s three multi-platinum solo releases, Destiny’s Child catalog and a few surprises. This amazing concert includes the #1 hits, “Single Ladies (Put A Ring On It),” “If I Were A Boy,” “Halo,” “Sweet Dreams” and showcases a gut-wrenching performance of “That’s Why You’re Beautiful.” Included on \\\"I AM... YOURS An Intimate Performance At Wynn Las Vegas,\\\" is a biographical storytelling woven between many songs and exclusive behind-the-scenes footage.\",\n \"genres\": [\"Music\", \"Documentary\"],\n \"poster\": \"https://image.tmdb.org/t/p/w500/j8n1XQNfw874Ka7SS3HQLCVNBxb.jpg\",\n \"release_date\": \"1258934400\"\n }\n }\n ],\n \"estimatedTotalHits\": 10,\n \"query\": \"halo\",\n \"limit\": 21,\n \"offset\": 0,\n \"processingTimeMs\": 2\n}\n```\n\n![MeiliSearch UI](./meilisearch.jpg)\n\n#### Algolia\n\n```bash\ncurl 'https://og53ly1oqh-dsn.algolia.net/1/indexes/*/queries?x-algolia-agent=Algolia%20for%20JavaScript%20(4.14.2)%3B%20Browser%20(lite)%3B%20docsearch%20(3.2.1)%3B%20docsearch-react%20(3.2.1)%3B%20docusaurus%20(2.1.0)&x-algolia-api-key=739f2a55c6d13d93af146c22a4885669&x-algolia-application-id=OG53LY1OQH' \\\n -H 'Accept: */*' \\\n -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6,zh-TW;q=0.5' \\\n -H 'Connection: keep-alive' \\\n -H 'Origin: https://docs.halo.run' \\\n -H 'Referer: https://docs.halo.run/' \\\n -H 'Sec-Fetch-Dest: empty' \\\n -H 'Sec-Fetch-Mode: cors' \\\n -H 'Sec-Fetch-Site: cross-site' \\\n -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36 Edg/107.0.1418.26' \\\n -H 'content-type: application/x-www-form-urlencoded' \\\n -H 'sec-ch-ua: \"Microsoft Edge\";v=\"107\", \"Chromium\";v=\"107\", \"Not=A?Brand\";v=\"24\"' \\\n -H 'sec-ch-ua-mobile: ?0' \\\n -H 'sec-ch-ua-platform: \"Windows\"' \\\n --data-raw '{\"requests\":[{\"query\":\"halo\",\"indexName\":\"docs\",\"params\":\"attributesToRetrieve=%5B%22hierarchy.lvl0%22%2C%22hierarchy.lvl1%22%2C%22hierarchy.lvl2%22%2C%22hierarchy.lvl3%22%2C%22hierarchy.lvl4%22%2C%22hierarchy.lvl5%22%2C%22hierarchy.lvl6%22%2C%22content%22%2C%22type%22%2C%22url%22%5D&attributesToSnippet=%5B%22hierarchy.lvl1%3A5%22%2C%22hierarchy.lvl2%3A5%22%2C%22hierarchy.lvl3%3A5%22%2C%22hierarchy.lvl4%3A5%22%2C%22hierarchy.lvl5%3A5%22%2C%22hierarchy.lvl6%3A5%22%2C%22content%3A5%22%5D&snippetEllipsisText=%E2%80%A6&highlightPreTag=%3Cmark%3E&highlightPostTag=%3C%2Fmark%3E&hitsPerPage=20&facetFilters=%5B%22language%3Azh-Hans%22%2C%5B%22docusaurus_tag%3Adefault%22%2C%22docusaurus_tag%3Adocs-default-1.6%22%5D%5D\"}]}' \\\n --compressed\n```\n\n```json\n{\n \"results\": [\n {\n \"hits\": [\n {\n \"content\": null,\n \"hierarchy\": {\n \"lvl0\": \"Documentation\",\n \"lvl1\": \"使用 Docker Compose 部署 Halo\",\n \"lvl2\": \"更新容器组 ​\",\n \"lvl3\": null,\n \"lvl4\": null,\n \"lvl5\": null,\n \"lvl6\": null\n },\n \"type\": \"lvl2\",\n \"url\": \"https://docs.halo.run/getting-started/install/other/docker-compose/#更新容器组\",\n \"objectID\": \"4ccfa93009143feb6e423274a4944496267beea8\",\n \"_snippetResult\": {\n \"hierarchy\": {\n \"lvl1\": {\n \"value\": \"… Docker Compose 部署 Halo\",\n \"matchLevel\": \"full\"\n },\n \"lvl2\": {\n \"value\": \"更新容器组 ​\",\n \"matchLevel\": \"none\"\n }\n }\n },\n \"_highlightResult\": {\n \"hierarchy\": {\n \"lvl0\": {\n \"value\": \"Documentation\",\n \"matchLevel\": \"none\",\n \"matchedWords\": []\n },\n \"lvl1\": {\n \"value\": \"使用 Docker Compose 部署 Halo\",\n \"matchLevel\": \"full\",\n \"fullyHighlighted\": false,\n \"matchedWords\": [\"halo\"]\n },\n \"lvl2\": {\n \"value\": \"更新容器组 ​\",\n \"matchLevel\": \"none\",\n \"matchedWords\": []\n }\n },\n \"hierarchy_camel\": [\n {\n \"lvl0\": {\n \"value\": \"Documentation\",\n \"matchLevel\": \"none\",\n \"matchedWords\": []\n },\n \"lvl1\": {\n \"value\": \"使用 Docker Compose 部署 Halo\",\n \"matchLevel\": \"full\",\n \"fullyHighlighted\": false,\n \"matchedWords\": [\"halo\"]\n },\n \"lvl2\": {\n \"value\": \"更新容器组 ​\",\n \"matchLevel\": \"none\",\n \"matchedWords\": []\n }\n }\n ]\n }\n }\n ],\n \"nbHits\": 113,\n \"page\": 0,\n \"nbPages\": 6,\n \"hitsPerPage\": 20,\n \"exhaustiveNbHits\": true,\n \"exhaustiveTypo\": true,\n \"exhaustive\": {\n \"nbHits\": true,\n \"typo\": true\n },\n \"query\": \"halo\",\n \"params\": \"query=halo&attributesToRetrieve=%5B%22hierarchy.lvl0%22%2C%22hierarchy.lvl1%22%2C%22hierarchy.lvl2%22%2C%22hierarchy.lvl3%22%2C%22hierarchy.lvl4%22%2C%22hierarchy.lvl5%22%2C%22hierarchy.lvl6%22%2C%22content%22%2C%22type%22%2C%22url%22%5D&attributesToSnippet=%5B%22hierarchy.lvl1%3A5%22%2C%22hierarchy.lvl2%3A5%22%2C%22hierarchy.lvl3%3A5%22%2C%22hierarchy.lvl4%3A5%22%2C%22hierarchy.lvl5%3A5%22%2C%22hierarchy.lvl6%3A5%22%2C%22content%3A5%22%5D&snippetEllipsisText=%E2%80%A6&highlightPreTag=%3Cmark%3E&highlightPostTag=%3C%2Fmark%3E&hitsPerPage=20&facetFilters=%5B%22language%3Azh-Hans%22%2C%5B%22docusaurus_tag%3Adefault%22%2C%22docusaurus_tag%3Adocs-default-1.6%22%5D%5D\",\n \"index\": \"docs\",\n \"renderingContent\": {},\n \"processingTimeMS\": 1,\n \"processingTimingsMS\": {\n \"total\": 1\n }\n }\n ]\n}\n```\n\n![Algolia UI](./algolia.png)\n\n#### Wiki\n\n```bash\ncurl 'https://wiki.fit2cloud.com/rest/api/search?cql=siteSearch%20~%20%22halo%22%20AND%20type%20in%20(%22space%22%2C%22user%22%2C%22com.atlassian.confluence.extra.team-calendars%3Acalendar-content-type%22%2C%22attachment%22%2C%22page%22%2C%22com.atlassian.confluence.extra.team-calendars%3Aspace-calendars-view-content-type%22%2C%22blogpost%22)&start=20&limit=20&excerpt=highlight&expand=space.icon&includeArchivedSpaces=false&src=next.ui.search' \\\n -H 'authority: wiki.fit2cloud.com' \\\n -H 'accept: */*' \\\n -H 'accept-language: zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6,zh-TW;q=0.5' \\\n -H 'cache-control: no-cache, no-store, must-revalidate' \\\n -H 'cookie: _ga=GA1.2.1720479041.1657188862; seraph.confluence=89915546%3A6fc1394f8d537ffa08fb679e6e4dd64993448051; mywork.tab.tasks=false; JSESSIONID=5347D8618AC5883DE9B702E77152170D' \\\n -H 'expires: 0' \\\n -H 'pragma: no-cache' \\\n -H 'referer: https://wiki.fit2cloud.com/' \\\n -H 'sec-ch-ua: \"Microsoft Edge\";v=\"107\", \"Chromium\";v=\"107\", \"Not=A?Brand\";v=\"24\"' \\\n -H 'sec-ch-ua-mobile: ?0' \\\n -H 'sec-ch-ua-platform: \"Windows\"' \\\n -H 'sec-fetch-dest: empty' \\\n -H 'sec-fetch-mode: cors' \\\n -H 'sec-fetch-site: same-origin' \\\n -H 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36 Edg/107.0.1418.26' \\\n --compressed\n```\n\n```json\n{\n \"results\": [\n {\n \"content\": {\n \"id\": \"76722\",\n \"type\": \"page\",\n \"status\": \"current\",\n \"title\": \"2.3 测试 - 接口\",\n \"restrictions\": {},\n \"_links\": {\n \"webui\": \"/pages/viewpage.action?pageId=721\",\n \"tinyui\": \"/x/8K_SB\",\n \"self\": \"https://wiki.halo.run/rest/api/content/76720\"\n },\n \"_expandable\": {\n \"container\": \"\",\n \"metadata\": \"\",\n \"extensions\": \"\",\n \"operations\": \"\",\n \"children\": \"\",\n \"history\": \"/rest/api/content/7670/history\",\n \"ancestors\": \"\",\n \"body\": \"\",\n \"version\": \"\",\n \"descendants\": \"\",\n \"space\": \"/rest/api/space/IT\"\n }\n },\n \"title\": \"2.3 接口 - 接口\",\n \"excerpt\": \"另存为新用例\",\n \"url\": \"/pages/viewpage.action?pageId=7672\",\n \"resultGlobalContainer\": {\n \"title\": \"IT 客户\",\n \"displayUrl\": \"/display/IT\"\n },\n \"entityType\": \"content\",\n \"iconCssClass\": \"aui-icon content-type-page\",\n \"lastModified\": \"2022-05-11T22:40:53.000+08:00\",\n \"friendlyLastModified\": \"五月 11, 2022\",\n \"timestamp\": 1652280053000\n }\n ],\n \"start\": 20,\n \"limit\": 20,\n \"size\": 20,\n \"totalSize\": 70,\n \"cqlQuery\": \"siteSearch ~ \\\"halo\\\" AND type in (\\\"space\\\",\\\"user\\\",\\\"com.atlassian.confluence.extra.team-calendars:calendar-content-type\\\",\\\"attachment\\\",\\\"page\\\",\\\"com.atlassian.confluence.extra.team-calendars:space-calendars-view-content-type\\\",\\\"blogpost\\\")\",\n \"searchDuration\": 36,\n \"_links\": {\n \"base\": \"https://wiki.halo.run\",\n \"context\": \"\"\n }\n}\n```\n\n### FAQ\n\n#### 是否需要统一参数和响应体结构？\n\n以下是关于统一参数和响应体结构的优缺点分析：\n\n优点：\n\n- 主题端搜索结果 UI 更加一致，不会因为使用不同搜索引擎导致 UI 上的变动\n\n缺点：\n\n- 无法完全发挥出对应的搜索引擎的实力。比如某个搜索引擎有很实用的功能，而某些搜索引擎没有。\n- Halo Core 需要适配不同的搜索引擎，比较繁琐\n\n#### 是否需要提供扩展点集成其他搜索引擎？\n\n既然 Lucene 非常强大，且暂时已经能够满足我们的要求，我们为什么还需要集成其他搜索引擎呢？\n\n- Lucene 目前是作为 Halo 的依赖使用的，也就意味着只支持 Halo 单实例部署，阻碍未来 Halo 无状态化的趋势。\n- 相反，其他搜索引擎（例如 Solr、MeiliSearch、ElasticSearch 等）都可以独立部署，Halo 只需要利用对应的 SDK 和搜索引擎沟通即可，无论 Halo 是否是多实例部署。\n" }, { "path": "docs/index/README.md", "content": "# 索引机制 RFC\n\n## 背景\n\n目前 Halo 使用 Extension 机制来存储和获取数据以便支持更好的扩展性，所以设计之初就存在查询数据时会将对应 Extension 的所有数据查询到内存中处理的问题，这会导致当分页查询和条件查询时也会有大批量无效数据被加载到内存中，随着 Halo 用户的数据量的增长，如果没有一个方案来解决这样的数据查询问题会对 Halo 用户的服务器内存资源有较高的要求，因此本篇提出使用索引机制来解决数据查询问题，以便提高查询效率和减少内存开销。\n\n## 目标\n\n- **提高查询效率**：加快数据检索速度。通过使用索引，数据库可以快速定位到数据行的位置，从而减少必须读取的数据量。\n- **减少网络和内存开销：** 没有索引前查询数据会将 Extension 的所有数据都传输到应用对网络和内存开销都很大，通过索引定位确切的数据来减少不必要的消耗。\n- **优化排序操作**：通过索引加速排序操作，因此需要索引本身有序。\n- **索引存储可扩展**：索引虽然能提高查询效率，但它会占用额外的存储空间，如果过大可以考虑在磁盘上读写等方式来减少对内存的占用。\n\n## 非目标\n\n- 索引的持久化存储，前期只考虑在内存中存储索引，如果后续索引过大可以考虑在磁盘上读写等方式来减少对内存的占用。\n- 索引的自动维护，索引的维护需要考虑到索引的数据是否改变，如果改变则需要更新索引，这个改变的判断不好界定，所以先不考虑索引的自动维护。\n- 索引的前置验证，比如在启动时验证索引的完整性和正确性，但目前每次启动都会重新构建索引，所以先不考虑索引的前置验证。\n- 多线程构建索引，目前索引的构建是单线程的，如果后续索引过大可以考虑多线程构建索引。\n\n## 方案\n\n索引是一种存储数据结构，可提供对数据集中字段的高效查找。索引将 Extension 中的字段映射到 Extension 的名称，以便在查询特定字段时不需要完整的扫描。\n\n### 索引结构\n\n每个 Extension 声明的索引都会被创建为一个 keySpace 与索引信息的映射，\n类如对附件分组的一个对名称的索引示例如下：\n\n```javascript\n{\n \"/registry/storage.halo.run/groups\": [{\n name: \"specName\",\n spec: {\n // a function that returns the value of the index key\n indexFunc: function(doc) {\n return doc.spec.name;\n },\n order: 'asc',\n unique: false\n },\n v: 1,\n ready: false\n },\n {\n name: \"metadata.labels\",\n spec: {\n indexFunc: function(doc) {\n var labels = obj.getMetadata().getLabels();\n if (labels == null) {\n return Set.of();\n }\n return labels.entrySet()\n .stream()\n .map(entry -> entry.getKey() + \"=\" + entry.getValue())\n .collect(Collectors.toSet());\n },\n order: 'asc',\n unique: false\n },\n v: 1,\n ready: true,\n }]\n}\n```\n\n- `name: specName` 表示索引的名称，每个 Extension 声明的索引名称不能重复，通常为字段路径如 `metadata.name`。\n- `spec.indexFunc` 用于生成索引键，索引键是一个字符串数组，每个字符串都是一个索引键值，索引键值是一个字符串。\n- `spec.order` 用于记录索引键的排序方式，可选值为 `asc` 或 `desc`，`asc` 表示升序，`desc` 表示降序。\n- `spec.unique` 用于标识是否为唯一索引以在添加索引时进行唯一性检查。\n- `v` 用于记录索引结构的版本以防止后续为优化导致索引结构改变时便于检查重建索引。\n- `ready` 用于记录该索引是否构建完成，当开始构建该索引键索引记录时为 false，如果构建完成则修改为 true，如果因为断电等导致索引构建不完整则 ready 会是 false，下次启动时需要重新开始构建。\n\n对于每个 Extension 都有一个默认的唯一索引 `metadata.name` 其 entries 与 Extension 每一条记录唯一对应。\n\n### 索引构建\n\n索引是通过对 Extension 数据执行完整扫描来构建的。\n\n1. **针对特定 Extension 数据集的操作**: 当构建索引时，操作是针对特定的 Extension 数据进行的。将 `ready` 置为 `false`\n2. **扫描 Extension 数据集**: 构建索引的关键步骤是扫描 Extension 数据集中的每一条记录。这个扫描过程并不是基于数据库中所有数据的顺序，而是专注于该 Extension 数据集内的数据。当构建索引时会锁定对该 Extension 的写操作。\n3. **生成索引键（KeyString键）**:对于 Extension 数据集中的每个 Extension，会根据其索引字段生成 KeyString 键。String 为 Extension 的 `metadata.name` 用于定位 Extension 在数据库中的位置。\n4. **排序和插入操作**: 生成的键会被插入到一个外部排序器中，以确保它们的顺序。排序后，这些键按顺序批量加载到索引中。\n5. 释放对该 Extension 写操作的锁定完成了索引构建。\n\n对于后续 Extension 和索引的更新需要在同一个事务中以确保一致性。\n\n```json\n{\n \"metadata.name\": {\n \"group-1\": []\n },\n \"specName\": {\n \"zhangsan\": [\n \"metadata-name-1\"\n ],\n \"lisi\": [\n \"metadata-name-2\"\n ]\n },\n \"halo.run/hidden\": {\n \"true\": [\n \"metadata-name-3\"\n ],\n \"false\": [\n \"metadata-name-4\"\n ]\n }\n}\n```\n\n### 索引前置验证\n\n1. 每次启动后先检查索引是否 ready\n2. `metadata.name` 索引条目的数量始终与数据库中记录的 Extension 数量一致\n3. 如果排序顺序为升序，则索引条目按递增顺序排列。\n4. 如果排序顺序为降序，则索引条目按降序排列。\n5. 每个索引的索引条目数量不超过数据库中记录的对应 Extension 数量。\n\n### 索引在 Extension 的声明\n\n手动注册索引\n\n```java\npublic class IndexSpec {\n private String name;\n\n private IndexAttribute indexFunc;\n\n private OrderType order;\n\n private boolean unique;\n\n public enum OrderType {\n ASC,\n DESC\n }\n\n // Getters and other methods...\n}\n\nIndexSpecs indexSpecs = indexSpecRegistry.indexFor(Person.class);\nindexSpecs.add(new IndexSpec()\n .setName(\"spec.name\")\n .setOrder(IndexSpec.OrderType.DESC)\n .setIndexFunc(IndexAttributeFactory.simpleAttribute(Person.class,\n e -> e.getSpec().getName())\n )\n .setUnique(false));\n```\n\n用于普通索引的注解\n\n```java\n@Retention(RetentionPolicy.RUNTIME)\n@Target({ElementType.TYPE, ElementType.ANNOTATION_TYPE}) // 用于类和注解的注解\npublic @interface Index {\n String name(); // 索引名称\n String field(); // 需要索引的字段\n}\n```\n\nIndexes 注解用于声明多个索引\n\n```java\n@Retention(RetentionPolicy.RUNTIME)\n@Target(ElementType.TYPE)\npublic @interface Indexes {\n Index[] value() default {}; // Index注解数组\n}\n```\n\n```java\n@Data\n@Indexes({\n @Index(name = \"specName\", field = \"spec.name\"),\n @Index(name = \"creationTimestamp\", field = \"metadata.creationTimestamp\"),\n})\n@EqualsAndHashCode(callSuper = true)\n@ToString(callSuper = true)\n@GVK(group = \"my-plugin.guqing.io\",\n version = \"v1alpha1\",\n kind = \"Person\",\n plural = \"persons\",\n singular = \"person\")\npublic class Person extends Extension {\n\n @Schema(description = \"The description on name field\", maxLength = 100)\n private String name;\n\n @Schema(description = \"The description on age field\", maximum = \"150\", minimum = \"0\")\n private Integer age;\n\n @Schema(description = \"The description on gender field\")\n private Gender gender;\n\n public enum Gender {\n MALE, FEMALE,\n }\n}\n```\n\n不论是手动注册索引还是通过注解注册索引都由 IndexSpecRegistry 管理。\n\n```java\npublic interface IndexSpecRegistry {\n /**\n *

Create a new {@link IndexSpecs} for the given {@link Extension} type.

\n *

The returned {@link IndexSpecs} is always includes some default {@link IndexSpec} that\n * does not need to be registered again:

\n *
    \n *
  • {@link Metadata#getName()} for unique primary index spec named metadata_name
    • \n *
  • {@link Metadata#getCreationTimestamp()} for creation_timestamp index spec
    • \n *
  • {@link Metadata#getDeletionTimestamp()} for deletion_timestamp index spec
    • \n *
  • {@link Metadata#getLabels()} for labels index spec
    • \n *
\n *\n * @param extensionType must not be {@literal null}.\n * @param the extension type\n * @return the {@link IndexSpecs} for the given {@link Extension} type.\n */\n IndexSpecs indexFor(Class extensionType);\n\n /**\n * Get {@link IndexSpecs} for the given {@link Extension} type registered before.\n *\n * @param extensionType must not be {@literal null}.\n * @param the extension type\n * @return the {@link IndexSpecs} for the given {@link Extension} type.\n * @throws IllegalArgumentException if no {@link IndexSpecs} found for the given\n * {@link Extension} type.\n */\n IndexSpecs getIndexSpecs(Class extensionType);\n\n boolean contains(Class extensionType);\n\n void removeIndexSpecs(Class extensionType);\n\n /**\n * Get key space for an extension type.\n *\n * @param scheme is a scheme of an Extension.\n * @return key space(never null)\n */\n @NonNull\n String getKeySpace(Scheme scheme);\n}\n```\n\n对于添加了索引的 Extension 可以使用 `IndexedQueryEngine` 来查询数据：\n\n```java\npublic interface IndexedQueryEngine {\n /**\n * Page retrieve the object records by the given {@link GroupVersionKind} and\n * {@link ListOptions}.\n *\n * @param type the type of the object must exist in\n * {@link run.halo.app.extension.SchemeManager}.\n * @param options the list options to use for retrieving the object records.\n * @param page which page to retrieve and how large the page should be.\n * @return a collection of {@link Metadata#getName()} for the given page.\n */\n ListResult retrieve(GroupVersionKind type, ListOptions options, PageRequest page);\n\n /**\n * Retrieve all the object records by the given {@link GroupVersionKind} and\n * {@link ListOptions}.\n *\n * @param type the type of the object must exist in {@link run.halo.app.extension.SchemeManager}\n * @param options the list options to use for retrieving the object records\n * @return a collection of {@link Metadata#getName()}\n */\n List retrieveAll(GroupVersionKind type, ListOptions options);\n}\n```\n\n但为了简便起见，会在 ReactiveExtensionClient 中提供一个 `listBy` 方法来查询数据：\n\n```java\npublic interface ReactiveExtensionClient {\n //...\n Mono> listBy(Class type, ListOptions options,\n PageRequest pageable);\n}\n```\n\n其中 `ListOptions` 包含两部分，`LabelSelector` 和 `FieldSelector`，一个常见的手动构建的 `ListOptions` 示例：\n\n```java\nvar listOptions = new ListOptions();\nlistOptions.setLabelSelector(LabelSelector.builder()\n .eq(\"key1\", \"value1\").build());\nlistOptions.setFieldSelector(FieldSelector.builder()\n .eq(\"slug\", \"slug1\").build());\n```\n\n为了兼容以前的写法，对于 APIs 中可以继续使用 `run.halo.app.extension.router.IListRequest`，然后使用工具类转换即可得到 `ListOptions` 和 `PageRequest`。\n\n```java\nclass QueryListRequest implements IListRequest {\n public ListOptions toListOptions() {\n return labelAndFieldSelectorToListOptions(getLabelSelector(), getFieldSelector());\n }\n\n public PageRequest toPageRequest() {\n return PageRequestImpl.of(getPage(), getSize(), getSort());\n }\n}\n```\n\n### Reconciler\n\n对于 Reconciler 来说，之前每次由 DefaultController 启动对于需要 `syncAllOnStart` 的 Reconciler 都是获取所有对应的 Extension 数据，然后再进行 Reconcile，这样会导致每次都将所有的 Extension 数据加载到内存中，随着数据量的增加导致内存占用过大，当有了索引后只获取所有 Extension 的 `metadata.name` 来触发 reconcile 即可。\n\nGcReconciler 也从索引中获取 `metadata.deletionTimestamp` 不为空的 Extension 的 `metadata.name` 来触发 reconcile 以减少全量加载数据的操作。\n" }, { "path": "docs/notification/README.md", "content": "## 背景\n\n在 Halo 系统中，具有用户协作属性，如当用户发布文章后被访客评论而访客希望在作者回复评论时被提醒以此完成进一步互动，而在没有通知功能的情况下无法满足诸如以下描述的使用场景：\n\n1. 访客只能在评论后一段时间内访问被评论的文章查看是否被回复。\n2. Halo 的用户注册功能无法让用户验证邮箱地址让恶意注册变的更容易。\n\n在这些场景下，为了让用户收到通知或验证消息以及管理和处理这些通知，我们需要设计一个通知功能，以实现根据用户的订阅和偏好推送通知并管理通知。\n\n## 已有需求\n\n- 访客评论文章后希望收到被回复的通知，而文章作者也希望收到文章被评论的通知。\n- 用户注册功能希望验证注册者填写的邮箱实现一个邮箱只能注册一个账号，防止占用别人邮箱，在一定程度上减少恶意注册问题。\n- 关于应用市场插件，管理员希望在用户下单后能收到新订单通知。\n- 付费订阅插件场景，希望给付费订阅用户推送付费文章的浏览链接。\n\n## 目标\n\n设计一个通知功能，可以根据以下目标，实现订阅和推送通知：\n\n- 支持扩展多种通知方式，例如邮件、短信、Slack 等。\n- 支持通知条件并可扩展，例如 Halo\n 有新文章发布事件如果用户订阅了新文章发布事件但付费订阅插件决定了此文章只有付费用户才可收到通知、按照付费等级不同决定是否发送新文章通知给对应用户等需要通过实现通知条件的扩展点来满足对应需求。\n- 支持定制化选项，例如是否开启通知、通知时段等。\n- 支持通知流程，例如通知的发送、接收、查看、标记等。\n- 通知内容支持多语言。\n- 事件类型可扩展，插件可能需要定义自己的事件以通知到订阅事件的用户，如应用市场插件。\n\n## 非目标\n\n- Halo 只会实现站内消息和邮件通知，更多通知方式需要插件去扩展。\n- 定时通知、通知频率或摘要通知功能属于非必要功能，可由插件去扩展。\n- 多语言支持，目前只会支持中文和英文两种，更多语言支持不是此阶段的目标。\n- 可定制的通知模板：通知默认模板由事件定义者提供，如需修改可考虑使用特定的 Notifier 去适配事件。\n\n## 方案\n\n为了实现上述目标，我们设计了以下方案：\n\n### 通知数据模型\n\n#### 通知事件类别和事件\n\n首先通过定义事件来声明此通知事件包含的数据和发送此事件时默认使用的模板。\n\n`ReasonType` 是一个自定义模型，用于定义事件类别，一个事件类别由多个事件表示。\n\n```yaml\napiVersion: notification.halo.run/v1alpha1\nkind: ReasonType\nmetadata:\n name: comment\nspec:\n displayName: \"Comment Received\"\n description: \"The user has received a comment on an post.\"\n properties:\n - name: postName\n type: string\n description: \"The name of the post.\"\n optional: false\n - name: postTitle\n type: string\n optional: true\n - name: commenter\n type: string\n description: \"The email address of the user who has left the comment.\"\n optional: false\n - name: comment\n type: string\n description: \"The content of the comment.\"\n optional: false\n```\n\n`Reason` 是一个自定义模型，用于定义通知原因，它属于 `ReasonType` 的实例。\n\n当有事件触发时，创建 `Reason` 资源来触发通知，如当文章收到一个新评论时：\n\n```yaml\napiVersion: notification.halo.run/v1alpha1\nkind: Reason\nmetadata:\n name: comment-axgu\nspec:\n # a name of ReasonType\n reasonType: comment\n author: 'guqing'\n subject:\n apiVersion: 'content.halo.run/v1alpha1'\n kind: Post\n name: 'post-axgu'\n title: 'Hello World'\n url: 'https://guqing.xyz/archives/1'\n attributes:\n postName: \"post-fadp\"\n commenter: \"guqing\"\n comment: \"Hello! This is your first notification.\"\n```\n\n#### Subscription\n\n`Subscription` 自定义模型，定义了特定事件时与要被通知的订阅者之间的关系, 其中 `subscriber`\n表示订阅者用户, `unsubscribeToken` 表示退订时的身份验证 token, `reason` 订阅者感兴趣的事件。\n\n用户可以通过 `Subscription` 来订阅自己感兴趣的事件，当事件触发时会收到通知：\n\n```yaml\napiVersion: notification.halo.run/v1alpha1\nkind: Subscription\nmetadata:\n name: user-a-sub\nspec:\n subscriber:\n name: guqing\n unsubscribeToken: xxxxxxxxxxxx\n reason:\n reasonType: new-comment-on-post\n subject:\n apiVersion: content.halo.run/v1alpha1\n kind: Post\n name: 'post-axgu'\n # expression: 'props.owner == \"guqing\"'\n```\n\n- `spec.reason.subject`：用于根据事件的主体的匹配感兴趣的事件，如果不指定 name 则表示匹配主体与 kind 和 apiVersion\n 相同的一类事件。\n- `spec.expression`：根据表达式匹配感兴趣的事件，例如 `props.owner == \"guqing\"` 表示只有当事件的属性（reason attributes）的\n owner 等于 guqing 时才会触发通知。表达式符合 SpEL\n 表达式语法，但结果只能是布尔值。参考：[增强 Subscription 模型以支持表达式匹配](https://github.com/halo-dev/halo/issues/5632)\n\n> 当 `spec.expression` 和 `spec.reason.subject` 同时存在时，以 `spec.reason.subject` 的结果为准，不建议同时使用。\n\n订阅退订链接 API\n规则：`/apis/api.notification.halo.run/v1alpha1/subscriptions/{name}/unsubscribe?token={unsubscribeToken}`。\n\n#### 用户通知偏好设置\n\n通过在用户偏好设置的 ConfigMap 中存储一个 `notification` key 用于保存事件类型与通知方式的关系设置，当用户订阅了如 '\nnew-comment-on-post' 事件时会获取对应的通知方式来给用户发送通知。\n\n```yaml\napiVersion: v1alpha1\nkind: ConfigMap\nmetadata:\n name: user-preferences-guqing\ndata:\n notification: |\n {\n reasonTypeNotification: {\n 'new-comment-on-post': {\n enabled: true,\n notifiers: [\n email-notifier,\n sms-notifier\n ]\n },\n new-post: {\n enabled: true,\n notifiers: [\n email-notifier,\n webhook-router-notifier\n ]\n }\n },\n }\n```\n\n#### Notification 站内通知\n\n当用户订阅到事件后会创建 `Notification`, 它与通知方式（notifier）无关，`recipient` 为用户名，类似站内通知，如用户 `guqing`\n订阅了评论事件那么当监听到评论事件时会创建一条记录可以在个人中心的通知列表看到一条通知消息。\n\n```yaml\napiVersion: notification.halo.run/v1alpha1\nkind: Notification\nmetadata:\n name: notification-abc\nspec:\n # username\n recipient: \"guqing\"\n reason: 'comment-axgu'\n title: 'notification-title'\n rawContent: 'notification-raw-body'\n htmlContent: 'notification-html'\n unread: true\n lastReadAt: '2023-08-04T17:01:45Z'\n```\n\n个人中心通知自定义 APIs:\n\n1. 获取个人中心获取用户通知列表的 APIs 规则：\n `GET /apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications`\n2. 将通知标记为已读：`PUT /apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/mark-as-read`\n3.\n\n批量将通知标记为已读：`PUT /apis/api.notification.halo.run/v1alpha1/userspaces/{username}/notifications/mark-specified-as-read`\n\n#### 通知模板\n\n`NotificationTemplate` 自定义模型用于定义事件的通知模板，当事件触发时会根据事件的通知模板来渲染通知内容。\n它通过定义 `reasonSelector` 来引用事件类别，当事件触发时会根据用户的语言偏好和触发事件的类别来选择一个最佳的通知模板。\n选择通知模板的规则为：\n\n1. 根据用户设置的语言，选择从通知模板中定义的 `spec.reasonSelector.language` 的值从更具体到不太具体的顺序（例如，gl_ES 的值将比\n gl 的值具有更高的优先级）。\n2. 当通过语言成功匹配到模板时，匹配到的结果可能不止一个，如 `language` 为 `zh_CN`\n 的模板有三个那么会根据 `NotificationTemplate` 的 `metadata.creationTimestamp` 字段来选择一个最新的模板。\n\n这样的规则有助于用户可以个性化定制某些事件的模板内容。\n\n模板语法使用 ThymeleafEngine 渲染，纯文本模板使用 `textual`\n模板模式，语法参考: [usingthymeleaf.html#textual-syntax](https://www.thymeleaf.org/doc/tutorials/3.1/usingthymeleaf.html#textual-syntax)\n\n`HTML`\n则使用标准表达式语法在标签属性中取值，语法参考：[standard-expression-syntax](https://www.thymeleaf.org/doc/tutorials/3.1/usingthymeleaf.html#standard-expression-syntax)\n\n在通知中心渲染模板时会在 `ReasonAttributes` 中提供额外属性包括：\n\n- site.title: 站点标题\n- site.subtitle: 站点副标题\n- site.logo: 站点 LOGO\n- site.url: 站点访问地址\n- subscriber.id: 如果是用户则为用户名, 如果是匿名用户则为 `annoymousUser#email`\n- subscriber.displayName: 邮箱地址或`@username`\n- unsubscribeUrl: 退订链接，用于取消订阅\n\n因此，任何模板都可以使用这几个属性，但事件定义者需要注意避免使用这些保留属性。\n\n```yaml\napiVersion: notification.halo.run/v1alpha1\nkind: NotificationTemplate\nmetadata:\n name: template-new-comment-on-post\nspec:\n reasonSelector:\n reasonType: new-comment-on-post\n language: zh_CN\n template:\n title: \"你的文章 [(${postTitle})] 收到了一条新评论\"\n body: |\n [(${commenter})] 评论了你的文章 [(${postTitle})]，内容如下：\n [(${comment})]\n```\n\n#### 通知器声明及扩展\n\n`NotifierDescriptor` 自定义模型用于声明通知器，通过它来描述通知器的名称、描述和关联的 `ExtensionDefinition`\n名称，让用户可以在用户界面知道通知器是什么以及它可以做什么,\n还让 NotificationCenter 知道如何加载通知器和准备通知器需要的设置以发送通知。\n\n```yaml\napiVersion: notification.halo.run/v1alpha1\nkind: NotifierDescriptor\nmetadata:\n name: email-notifier\nspec:\n displayName: '邮件通知器'\n description: '支持通过邮件的方式发送通知。'\n notifierExtName: '通知对应的扩展名称'\n senderSettingRef:\n name: 'email-notifier'\n group: 'sender'\n receiverSettingRef:\n name: 'email-notifier'\n group: 'receiver'\n```\n\n通知器声明了 senderSettingRef 和 receiverSettingRef 后，对应用户端可以通过以下 APIs 获取和保存配置：\n\n管理员获取和保存通知器发送配置的 APIs:\n\n1. 获取通知器发送方配置：`GET /apis/api.console.halo.run/v1alpha1/notifiers/{name}/sender-config`\n2. 保存通知器发送方配置：`POST /apis/api.console.halo.run/v1alpha1/notifiers/{name}/sender-config`\n\n个人中心用户获取和保存对应通知器接收消息配置的 APIs:\n\n1. 获取通知器接收消息配置：`GET /apis/api.notification.halo.run/v1alpha1/notifiers/{name}/receiver-config`\n2. 获取通知器接收消息配置：`POST /apis/api.notification.halo.run/v1alpha1/notifiers/{name}/receiver-config`\n\n通知器扩展点用于实现发送通知的方式：\n\n```java\npublic interface ReactiveNotifier extends ExtensionPoint {\n\n /**\n * Notify user.\n *\n * @param context notification context must not be null\n */\n Mono notify(NotificationContext context);\n}\n\n@Data\npublic class NotificationContext {\n private Message message;\n\n private ObjectNode receiverConfig;\n\n private ObjectNode senderConfig;\n\n @Data\n static class Message {\n private MessagePayload payload;\n\n private Subject subject;\n\n private String recipient;\n\n private Instant timestamp;\n }\n\n @Data\n public static class Subject {\n private String apiVersion;\n private String kind;\n private String name;\n private String title;\n private String url;\n }\n\n @Data\n static class MessagePayload {\n private String title;\n\n private String rawBody;\n\n private String htmlBody;\n\n private ReasonAttributes attributes;\n }\n}\n```\n\n通知数据结构交互图\n\n![Notification datastructures interaction](./image-knhw.png)\n\n通知功能 UI 设计\n![notification-ui.png](notification-ui.png)\n\n### 通知模块功能\n\n- 发送通知：当触发通知事件时，系统会根据 subscriber 的偏好设置获取到事件对应的通知方式再根据偏好设置自动发送通知。\n- 接收通知：用户可以选择接收通知的方式，例如邮件、短信、自定义路由通知等。\n- 查看通知：用户可以在 Halo 中查看所有的通知，包括已读和未读的通知。\n- 标记通知：用户可以标记通知为已读或未读状态，以便更好地管理和处理通知。\n\n### 通知管理列表条件筛选\n\n我们支持以下通知条件筛选策略：\n\n- 按事件类型：列出特定类型的事件通知，例如新文章，新评论、状态更新等。\n- 按已读状态：根据通知是否已读列出，方便用户查看未读通知。\n- 按关键词：列出通知中包含特定关键词的事件通知，例如包含用户名称、标题等关键词的通知。\n- 按时间：列出在特定时间段内发生的事件通知，例如最近一周、最近一个月等时间段内的通知。\n\n### 定制化选项\n\n如果后续有足够的使用场景，可以考虑支持以下定制化选项：\n\n- 通知时间段：用户可以设置通知的时间段，例如只在工作时间内推送通知。\n- 通知频率：用户可以设置通知的频率，例如每天、每周、每月等。\n- 摘要通知：用户可以设置接收每周摘要，总结一周内的通知合并为一条通知并通过如邮件等方式接收。\n\n## 结论\n\n通过以上方案和实现，我们设计了一个通知功能，可以根据用户的需求和偏好，自动筛选和推送通知。同时，为了支持更多的事件类型、通知方式和通知条件筛选策略，系统具有良好的可扩展性。\n" }, { "path": "docs/plugin/shared-event.md", "content": "# 插件中如何发送共享事件（SharedEvent）\n\n在插件中，可以通过共享事件（SharedEvent）来发送消息。 共享事件是一种特殊的事件，它可以被核心和所有插件订阅。\n\n## 订阅共享事件\n\n目前，核心中已经提供了不少的共享事件，例如 `run.halo.app.event.post.PostPublishedEvent`、`run.halo.app.event.post.PostUpdatedEvent`\n，这些事件由核心发布，核心和插件均可订阅。请看下面的示例：\n\n```java\n\n@Component\npublic class PostPublishedEventListener implements ApplicationListener {\n\n @Override\n public void onApplicationEvent(PostPublishedEvent event) {\n // Do something\n }\n\n}\n```\n\n或者通过 `@EventListener` 注解实现，\n\n```java\n\n@Component\npublic class PostPublishedEventListener {\n\n @EventListener\n // @Async // 如果需要异步处理，可以添加此注解\n public void onPostPublished(PostPublishedEvent event) {\n // Do something\n }\n\n}\n```\n\n> 需要注意的是，只有被 `@SharedEvent` 注解标记的事件才能够被其他插件或者核心订阅。\n\n## 发送共享事件\n\n在插件中，我们可以通过 `ApplicationEventPublisher` 来发送共享事件，请看下面的示例：\n\n```java\n\n@Service\npublic class PostService {\n\n private final ApplicationEventPublisher eventPublisher;\n\n public PostService(ApplicationEventPublisher eventPublisher) {\n this.eventPublisher = eventPublisher;\n }\n\n public void publishPost(Post post) {\n // Do something\n eventPublisher.publishEvent(new PostPublishedEvent(post));\n }\n\n}\n```\n\n## 创建共享事件\n\n在插件中，我们可以创建自定义的共享事件，供其他插件订阅，示例如下：\n\n```java\n\n@SharedEvent\npublic class MySharedEvent extends ApplicationEvent {\n\n public MySharedEvent(Object source) {\n super(source);\n }\n\n}\n```\n\n> 需要注意的是：\n> 1. 共享事件必须继承 `ApplicationEvent`。\n> 2. 共享事件必须被 `@SharedEvent` 注解标记。\n> 3. 如果想要被其他插件订阅，则需要将该事件类发布到 Maven 仓库中，供其他插件引用。\n" }, { "path": "docs/plugin/websocket.md", "content": "# 插件中如何实现 WebSocket\n\n## 背景\n\n> https://github.com/halo-dev/halo/issues/5285\n\n越来越多的开发者在开发插件过程中需要及时高效获取某些资源的最新状态，但是因为在插件中不支持 WebSocket，故只能选择定时轮训的方式来解决。\n\n在插件中支持 WebSocket 的功能需要 Halo Core 来适配并制定规则以方便插件实现 WebSocket。\n\n## 实现\n\n插件中实现 WebSocket 的代码样例如下所示：\n\n```java\n@Component\npublic class MyWebSocketEndpoint implements WebSocketEndpoint {\n\n @Override\n public GroupVersion groupVersion() {\n return GroupVersion.parseApiVersion(\"my-plugin.halowrite.com/v1alpha1\");\n }\n\n @Override\n public String urlPath() {\n return \"/resources\";\n }\n\n @Override\n public WebSocketHandler handler() {\n return session -> {\n var messages = session.receive()\n .map(message -> {\n var payload = message.getPayloadAsText();\n return session.textMessage(payload.toUpperCase());\n });\n return session.send(messages);\n };\n }\n}\n```\n\n插件安装成功后，可以通过 `/apis/my-plugin.halowrite.com/v1alpha1/resources` 进行访问。 示例如下所示：\n\n```bash\nwebsocat --basic-auth admin:admin ws://127.0.0.1:8090/apis/my-plugin.halowrite.com/v1alpha1/resources\n```\n\n同样地，WebSocket 相关的 API 仍然受当前权限系统管理。\n" }, { "path": "e2e/Dockerfile", "content": "FROM ghcr.io/linuxsuren/api-testing:v0.0.17\nWORKDIR /workspace\nCOPY testsuite.yaml .\nCMD [ \"atest\", \"run\", \"-p\", \"testsuite.yaml\", \"--level=trace\", \"--request-ignore-error\", \"--report=md\" ]\n" }, { "path": "e2e/Makefile", "content": "all:\n\t./start.sh\n\t./start.sh compose-postgres.yaml\n\t./start.sh compose-mysql.yaml\ndemo:\n\tdocker-compose up halo\n" }, { "path": "e2e/README.md", "content": "Please add the corresponding e2e (aka end-to-end) test cases if you add or update APIs.\n\n## How to work\n* Start and watch the [docker-compose](https://docs.docker.com/compose/) via [the script](start.sh)\n * It has three containers: database, Halo, and testing\n* Run the e2e testing via [api-testing](https://github.com/LinuxSuRen/api-testing)\n * It will run the test cases from top to bottom\n * You can add the necessary asserts to it\n\n## Run locally\nPlease follow these steps if you want to run the e2e testing locally.\n\n> Please make sure you have installed docker-compose v2\n\n* Build project via `./gradlew clean build -x check` in root directory of this repository\n* Build image via `docker build . -t ghcr.io/halo-dev/halo-dev:main`\n* Change the directory to `e2e`, then execute `./start.sh`\n\n## Run Halo only\nPlease run the following command if you only want to run Halo.\n\n```shell\ndocker-compose up halo\n```\n" }, { "path": "e2e/compose-mysql.yaml", "content": "version: '3.1'\nservices:\n testing:\n build:\n context: .\n dockerfile: Dockerfile\n links:\n - halo\n depends_on:\n halo:\n condition: service_healthy\n halo:\n image: ghcr.io/halo-dev/halo-dev:${TAG:-main}\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:8090/actuator/health/readiness\"]\n interval: 30s\n timeout: 5s\n retries: 5\n start_period: 30s\n command:\n - --spring.r2dbc.url=r2dbc:pool:mysql://mysql:3306/halo\n - --spring.r2dbc.username=root\n - --spring.r2dbc.password=halo\n - --spring.sql.init.platform=mysql\n links:\n - mysql\n depends_on:\n mysql:\n condition: service_healthy\n mysql:\n image: mysql:8.1.0\n container_name: mysql\n restart: on-failure:3\n command: \n - --default-authentication-plugin=caching_sha2_password\n - --character-set-server=utf8mb4\n - --collation-server=utf8mb4_general_ci\n - --explicit_defaults_for_timestamp=true\n healthcheck:\n test: [\"CMD\", \"mysqladmin\", \"ping\", \"-h\", \"127.0.0.1\", \"--silent\"]\n interval: 10s\n timeout: 5s\n retries: 5\n environment:\n - MYSQL_ROOT_PASSWORD=halo\n - MYSQL_DATABASE=halo\n" }, { "path": "e2e/compose-postgres.yaml", "content": "version: '3.1'\nservices:\n testing:\n build:\n context: .\n dockerfile: Dockerfile\n links:\n - halo\n depends_on:\n halo:\n condition: service_healthy\n halo:\n image: ghcr.io/halo-dev/halo-dev:${TAG:-main}\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:8090/actuator/health/readiness\"]\n interval: 30s\n timeout: 5s\n retries: 5\n start_period: 30s\n command:\n - --spring.r2dbc.url=r2dbc:pool:postgresql://postgres/halo\n - --spring.r2dbc.username=halo\n # PostgreSQL 的密码，请保证与下方 POSTGRES_PASSWORD 的变量值一致。\n - --spring.r2dbc.password=openpostgresql\n - --spring.sql.init.platform=postgresql\n # 外部访问地址，请根据实际需要修改\n # - --halo.external-url=http://localhost:8090/\n ports:\n - 8090:8090\n links:\n - postgres\n depends_on:\n postgres:\n condition: service_healthy\n postgres:\n image: postgres:15.4\n container_name: postgres\n restart: on-failure:3\n healthcheck:\n test: [ \"CMD\", \"pg_isready\" ]\n interval: 10s\n timeout: 5s\n retries: 5\n environment:\n - POSTGRES_PASSWORD=openpostgresql\n - POSTGRES_USER=halo\n - POSTGRES_DB=halo\n - PGUSER=halo\n" }, { "path": "e2e/compose.yaml", "content": "version: '3.1'\nservices:\n testing:\n build:\n context: .\n dockerfile: Dockerfile\n links:\n - halo\n depends_on:\n halo:\n condition: service_healthy\n halo:\n image: ghcr.io/halo-dev/halo-dev:${TAG:-main}\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:8090/actuator/health/readiness\"]\n interval: 30s\n timeout: 5s\n retries: 5\n start_period: 30s\n ports:\n - 8090:8090\n" }, { "path": "e2e/start.sh", "content": "#!/bin/bash\n\nfile=$1\nif [ \"$file\" == \"\" ]\nthen\n file=compose.yaml\nfi\n\ndocker-compose -f \"$file\" down\ndocker-compose -f \"$file\" up --build testing --exit-code-from testing --remove-orphans\n" }, { "path": "e2e/testsuite.yaml", "content": "name: halo\napi: |\n {{default \"http://halo:8090\" (env \"SERVER\")}}/apis\nparam:\n postName: \"{{randAlpha 6}}\"\n userName: \"{{randAlpha 6}}\"\n roleName: \"{{randAlpha 6}}\"\n notificationName: \"{{randAlpha 6}}\"\n auth: \"Basic YWRtaW46MTIzNDU2\"\nitems:\n- name: setup\n request:\n api: |\n {{default \"http://halo:8090\" (env \"SERVER\")}}/system/setup\n method: POST\n header:\n Content-Type: application/x-www-form-urlencoded\n Accept: application/json\n body: |\n siteTitle=testing&username={{.param.userName}}&password=123456&email=testing@halo.run\n expect:\n statusCode: 204\n- name: createPost\n request:\n api: /api.console.halo.run/v1alpha1/posts\n method: POST\n header:\n Authorization: \"{{.param.auth}}\"\n Content-Type: application/json\n body: |\n {\n \"post\": {\n \"spec\": {\n \"title\": \"{{.param.postName}}\",\n \"slug\": \"{{.param.postName}}\",\n \"template\": \"\",\n \"cover\": \"\",\n \"deleted\": false,\n \"publish\": false,\n \"pinned\": false,\n \"allowComment\": true,\n \"visible\": \"PUBLIC\",\n \"priority\": 0,\n \"excerpt\": {\n \"autoGenerate\": true,\n \"raw\": \"\"\n },\n \"categories\": [],\n \"tags\": [],\n \"htmlMetas\": []\n },\n \"apiVersion\": \"content.halo.run/v1alpha1\",\n \"kind\": \"Post\",\n \"metadata\": {\n \"name\": \"c31f2192-c992-47b9-86b4-f3fc0605360e\",\n \"annotations\": {\n \"content.halo.run/preferred-editor\": \"default\"\n }\n }\n },\n \"content\": {\n \"raw\": \"

{{.param.postName}}

\",\n \"content\": \"

{{.param.postName}}

\",\n \"rawType\": \"HTML\"\n }\n }\n- name: listPosts\n request:\n api: /api.console.halo.run/v1alpha1/posts?keyword={{.param.postName}}\n expect:\n verify:\n - data.total == 1\n- name: recyclePost\n request:\n api: /api.console.halo.run/v1alpha1/posts/{{(index .listPosts.items 0).post.metadata.name}}/recycle\n method: PUT\n- name: recover\n request:\n api: /content.halo.run/v1alpha1/posts/{{(index .listPosts.items 0).post.metadata.name}}\n method: DELETE\n\n## Users\n- name: createUser\n request:\n api: /api.console.halo.run/v1alpha1/users\n method: POST\n header:\n Content-Type: application/json\n body: |\n {\n \"avatar\": \"\",\n \"bio\": \"{{randAlpha 6}}\",\n \"displayName\": \"{{randAlpha 6}}\",\n \"email\": \"test@halo.com\",\n \"name\": \"{{.param.userName}}\",\n \"password\": \"{{randAlpha 6}}\",\n \"phone\": \"\",\n \"roles\": []\n }\n- name: updateUserPass\n request:\n api: /api.console.halo.run/v1alpha1/users/{{.param.userName}}/password\n method: PUT\n header:\n Content-Type: application/json\n body: |\n {\n \"password\": \"{{randAlpha 3}}\"\n }\n- name: grantPermission\n request:\n api: /api.console.halo.run/v1alpha1/users/{{.param.userName}}/permissions\n method: POST\n header:\n Content-Type: application/json\n body: |\n {\n \"roles\": [\n \"guest\"\n ]\n }\n- name: sendPasswordResetEmail\n request:\n api: |\n /api.halo.run/v1alpha1/users/-/send-password-reset-email\n method: POST\n header:\n Content-Type: application/json\n body: |\n {\n \"username\": \"{{.param.userName}}\",\n \"email\": \"{{.param.email}}\"\n }\n expect:\n statusCode: 204\n- name: resetPasswordByToken\n request:\n api: |\n /api.halo.run/v1alpha1/users/{{.param.userName}}/reset-password\n method: PUT\n header:\n Content-Type: application/json\n body: |\n {\n \"newPassword\": \"{{randAlpha 6}}\",\n \"token\": \"{{randAlpha 6}}\"\n }\n expect:\n statusCode: 403\n## Roles\n- name: createRole\n request:\n api: |\n {{default \"http://halo:8090\" (env \"SERVER\")}}/api/v1alpha1/roles\n method: POST\n header:\n Content-Type: application/json\n body: |\n {\n \"apiVersion\": \"v1alpha1\",\n \"kind\": \"Role\",\n \"metadata\": {\n \"name\": \"\",\n \"generateName\": \"role-\",\n \"labels\": {},\n \"annotations\": {\n \"rbac.authorization.halo.run/dependencies\": \"[\\\"role-template-manage-appstore\\\"]\",\n \"rbac.authorization.halo.run/display-name\": \"{{.param.roleName}}\"\n }\n },\n \"rules\": []\n }\n expect:\n statusCode: 201\n- name: listRoles\n request:\n api: |\n {{default \"http://halo:8090\" (env \"SERVER\")}}/api/v1alpha1/roles\n expect:\n verify:\n - data.total >= 3\n- name: deleteRole\n request:\n api: |\n {{default \"http://halo:8090\" (env \"SERVER\")}}/api/v1alpha1/roles/{{(index .listRoles.items 0).metadata.name}}\n method: DELETE\n\n## Plugins\n- name: installPlugin\n request:\n api: /api.console.halo.run/v1alpha1/plugins/-/install-from-uri\n method: POST\n header:\n Content-Type: application/json\n body: |\n {\n \"uri\": \"https://github.com/Stonewuu/halo-plugin-sitepush/releases/download/1.3.1/halo-plugin-sitepush-1.3.1.jar\"\n }\n- name: pluginList\n request:\n api: /api.console.halo.run/v1alpha1/plugins\n expect:\n verify:\n - data.total >= 1\n- name: inActivePlugins\n request:\n api: /api.console.halo.run/v1alpha1/plugins?enabled=false&keyword=&page=0&size=0\n expect:\n verify:\n - data.total == 1\n- name: disablePlugin\n request:\n api: /api.console.halo.run/v1alpha1/plugins/PluginSitePush/plugin-state\n method: PUT\n header:\n Content-Type: application/json\n body: |\n {\n \"enable\": false\n }\n- name: enablePlugin\n request:\n api: /api.console.halo.run/v1alpha1/plugins/PluginSitePush/plugin-state\n method: PUT\n header:\n Content-Type: application/json\n body: |\n {\n \"enable\": true\n }\n- name: resetPlugin\n request:\n api: /api.console.halo.run/v1alpha1/plugins/PluginSitePush/reset-config\n method: PUT\n header:\n Content-Type: application/json\n- name: uninstallPlugin\n request:\n api: /plugin.halo.run/v1alpha1/plugins/PluginSitePush\n method: DELETE\n\n # Notifications\n- name: createNotification\n request:\n api: /notification.halo.run/v1alpha1/notifications\n method: POST\n body: |\n {\n \"spec\": {\n \"recipient\": \"admin\",\n \"reason\": \"fake-reason\",\n \"title\": \"test 评论了你的页面《关于我》\",\n \"rawContent\": \"Fake raw content\",\n \"htmlContent\": \"

Fake html content

\",\n \"unread\": true\n },\n \"apiVersion\": \"notification.halo.run/v1alpha1\",\n \"kind\": \"Notification\",\n \"metadata\": {\n \"name\": \"{{.param.notificationName}}\"\n }\n }\n header:\n Content-Type: application/json\n expect:\n statusCode: 201\n- name: getNotificationByName\n request:\n api: /notification.halo.run/v1alpha1/notifications/{{.param.notificationName}}\n method: GET\n expect:\n statusCode: 200\n verify:\n - data.spec.reason == \"fake-reason\"\n - data.spec.title == \"test 评论了你的页面《关于我》\"\n- name: deleteUserNotification\n request:\n api: |\n /api.notification.halo.run/v1alpha1/userspaces/admin/notifications/{{.param.notificationName}}\n method: DELETE\n\n- name: deleteUser\n request:\n api: |\n {{default \"http://halo:8090\" (env \"SERVER\")}}/api/v1alpha1/users/{{.param.userName}}\n method: DELETE\n" }, { "path": "gradle/libs.versions.toml", "content": "[versions]\nlucene = '10.3.2'\nresilience4j = '2.3.0'\ntherapi = '0.15.0'\ncheckstyle = \"12.1.0\"\n\n[libraries]\nlucene-core = { module = 'org.apache.lucene:lucene-core', version.ref = 'lucene' }\nlucene-queryparser = { module = 'org.apache.lucene:lucene-queryparser', version.ref = 'lucene' }\nlucene-highlighter = { module = 'org.apache.lucene:lucene-highlighter', version.ref = 'lucene' }\nlucene-backward-codecs = { module = 'org.apache.lucene:lucene-backward-codecs', version.ref = 'lucene' }\nlucene-analyzers-common = { module = 'org.apache.lucene:lucene-analysis-common', version.ref = 'lucene' }\n\ntherapi-runtime-javadoc = { module = 'com.github.therapi:therapi-runtime-javadoc', version.ref = 'therapi' }\ntherapi-runtime-javadoc-scribe = { module = 'com.github.therapi:therapi-runtime-javadoc-scribe', version.ref = 'therapi' }\n\nresilience4j-springboot3 = { module = 'io.github.resilience4j:resilience4j-spring-boot3', version.ref = 'resilience4j' }\nresilience4j-reactor = { module = 'io.github.resilience4j:resilience4j-reactor', version.ref = 'resilience4j' }\n\napache-commons-lang3 = 'org.apache.commons:commons-lang3:3.20.0'\napache-tika-core = 'org.apache.tika:tika-core:3.2.3'\n\nencoding-base62 = 'io.seruco.encoding:base62:0.1.3'\npf4j = 'org.pf4j:pf4j:3.15.0'\nguava = 'com.google.guava:guava:33.5.0-jre'\njava-diff-utils = 'io.github.java-diff-utils:java-diff-utils:4.16'\njsoup = 'org.jsoup:jsoup:1.22.1'\njson-patch = 'com.github.java-json-tools:json-patch:1.13'\nspringdoc-openapi = 'org.springdoc:springdoc-openapi-starter-webflux-ui:3.0.1'\nopenapi-schema-validator = 'org.openapi4j:openapi-schema-validator:1.0.7'\nbouncycastle-bcpkix = 'org.bouncycastle:bcpkix-jdk18on:1.83'\ntwofactor-auth = 'com.j256.two-factor-auth:two-factor-auth:1.3'\nthumbnailator = 'net.coobird:thumbnailator:0.4.21'\nr2dbc-migrate-starter = 'name.nkonev.r2dbc-migrate:r2dbc-migrate-spring-boot-starter:4.0.1'\n\n[bundles]\nlucene = ['lucene-core', 'lucene-queryparser', 'lucene-highlighter', 'lucene-backward-codecs', 'lucene-analyzers-common']\nresilience4j = ['resilience4j-springboot3', 'resilience4j-reactor']\napache = ['apache-commons-lang3', 'apache-tika-core']\ntherapi = ['therapi-runtime-javadoc', 'therapi-runtime-javadoc-scribe']\n\n[plugins]\nspring-boot = 'org.springframework.boot:4.0.3'\nspring-dependency-management = 'io.spring.dependency-management:1.1.7'\ngit-properties = 'com.gorylenko.gradle-git-properties:2.5.2'\nundercouch-download = 'de.undercouch.download:5.6.0'\nlombok = 'io.freefair.lombok:9.2.0'\nchecksum = 'org.gradle.crypto.checksum:1.4.0'\nnode = 'com.github.node-gradle.node:7.1.0'\nopenapi-generator = 'org.openapi.generator:7.12.0'\nspringdoc-openapi = 'org.springdoc.openapi-gradle-plugin:1.9.0'\nversions = 'com.github.ben-manes.versions:0.53.0'\n" }, { "path": "gradle/wrapper/gradle-wrapper.properties", "content": "distributionBase=GRADLE_USER_HOME\ndistributionPath=wrapper/dists\ndistributionUrl=https\\://services.gradle.org/distributions/gradle-9.4.0-bin.zip\nnetworkTimeout=10000\nvalidateDistributionUrl=true\nzipStoreBase=GRADLE_USER_HOME\nzipStorePath=wrapper/dists\n" }, { "path": "gradle.properties", "content": "version=2.23.0-SNAPSHOT\njsonassert.version=2.0-rc1\nr2dbc-mariadb.version=1.4.0\n" }, { "path": "gradlew", "content": "#!/bin/sh\n\n#\n# Copyright © 2015 the original authors.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# https://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n#\n# SPDX-License-Identifier: Apache-2.0\n#\n\n##############################################################################\n#\n# Gradle start up script for POSIX generated by Gradle.\n#\n# Important for running:\n#\n# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is\n# noncompliant, but you have some other compliant shell such as ksh or\n# bash, then to run this script, type that shell name before the whole\n# command line, like:\n#\n# ksh Gradle\n#\n# Busybox and similar reduced shells will NOT work, because this script\n# requires all of these POSIX shell features:\n# * functions;\n# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,\n# «${var#prefix}», «${var%suffix}», and «$( cmd )»;\n# * compound commands having a testable exit status, especially «case»;\n# * various built-in commands including «command», «set», and «ulimit».\n#\n# Important for patching:\n#\n# (2) This script targets any POSIX shell, so it avoids extensions provided\n# by Bash, Ksh, etc; in particular arrays are avoided.\n#\n# The \"traditional\" practice of packing multiple parameters into a\n# space-separated string is a well documented source of bugs and security\n# problems, so this is (mostly) avoided, by progressively accumulating\n# options in \"$@\", and eventually passing that to Java.\n#\n# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,\n# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;\n# see the in-line comments for details.\n#\n# There are tweaks for specific operating systems such as AIX, CygWin,\n# Darwin, MinGW, and NonStop.\n#\n# (3) This script is generated from the Groovy template\n# https://github.com/gradle/gradle/blob/b631911858264c0b6e4d6603d677ff5218766cee/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt\n# within the Gradle project.\n#\n# You can find Gradle at https://github.com/gradle/gradle/.\n#\n##############################################################################\n\n# Attempt to set APP_HOME\n\n# Resolve links: $0 may be a link\napp_path=$0\n\n# Need this for daisy-chained symlinks.\nwhile\n APP_HOME=${app_path%\"${app_path##*/}\"} # leaves a trailing /; empty if no leading path\n [ -h \"$app_path\" ]\ndo\n ls=$( ls -ld \"$app_path\" )\n link=${ls#*' -> '}\n case $link in #(\n /*) app_path=$link ;; #(\n *) app_path=$APP_HOME$link ;;\n esac\ndone\n\n# This is normally unused\n# shellcheck disable=SC2034\nAPP_BASE_NAME=${0##*/}\n# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)\nAPP_HOME=$( cd -P \"${APP_HOME:-./}\" > /dev/null && printf '%s\\n' \"$PWD\" ) || exit\n\n# Use the maximum available, or set MAX_FD != -1 to use that value.\nMAX_FD=maximum\n\nwarn () {\n echo \"$*\"\n} >&2\n\ndie () {\n echo\n echo \"$*\"\n echo\n exit 1\n} >&2\n\n# OS specific support (must be 'true' or 'false').\ncygwin=false\nmsys=false\ndarwin=false\nnonstop=false\ncase \"$( uname )\" in #(\n CYGWIN* ) cygwin=true ;; #(\n Darwin* ) darwin=true ;; #(\n MSYS* | MINGW* ) msys=true ;; #(\n NONSTOP* ) nonstop=true ;;\nesac\n\n\n\n# Determine the Java command to use to start the JVM.\nif [ -n \"$JAVA_HOME\" ] ; then\n if [ -x \"$JAVA_HOME/jre/sh/java\" ] ; then\n # IBM's JDK on AIX uses strange locations for the executables\n JAVACMD=$JAVA_HOME/jre/sh/java\n else\n JAVACMD=$JAVA_HOME/bin/java\n fi\n if [ ! -x \"$JAVACMD\" ] ; then\n die \"ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME\n\nPlease set the JAVA_HOME variable in your environment to match the\nlocation of your Java installation.\"\n fi\nelse\n JAVACMD=java\n if ! command -v java >/dev/null 2>&1\n then\n die \"ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.\n\nPlease set the JAVA_HOME variable in your environment to match the\nlocation of your Java installation.\"\n fi\nfi\n\n# Increase the maximum file descriptors if we can.\nif ! \"$cygwin\" && ! \"$darwin\" && ! \"$nonstop\" ; then\n case $MAX_FD in #(\n max*)\n # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.\n # shellcheck disable=SC2039,SC3045\n MAX_FD=$( ulimit -H -n ) ||\n warn \"Could not query maximum file descriptor limit\"\n esac\n case $MAX_FD in #(\n '' | soft) :;; #(\n *)\n # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.\n # shellcheck disable=SC2039,SC3045\n ulimit -n \"$MAX_FD\" ||\n warn \"Could not set maximum file descriptor limit to $MAX_FD\"\n esac\nfi\n\n# Collect all arguments for the java command, stacking in reverse order:\n# * args from the command line\n# * the main class name\n# * -classpath\n# * -D...appname settings\n# * --module-path (only if needed)\n# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.\n\n# For Cygwin or MSYS, switch paths to Windows format before running java\nif \"$cygwin\" || \"$msys\" ; then\n APP_HOME=$( cygpath --path --mixed \"$APP_HOME\" )\n\n JAVACMD=$( cygpath --unix \"$JAVACMD\" )\n\n # Now convert the arguments - kludge to limit ourselves to /bin/sh\n for arg do\n if\n case $arg in #(\n -*) false ;; # don't mess with options #(\n /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath\n [ -e \"$t\" ] ;; #(\n *) false ;;\n esac\n then\n arg=$( cygpath --path --ignore --mixed \"$arg\" )\n fi\n # Roll the args list around exactly as many times as the number of\n # args, so each arg winds up back in the position where it started, but\n # possibly modified.\n #\n # NB: a `for` loop captures its iteration list before it begins, so\n # changing the positional parameters here affects neither the number of\n # iterations, nor the values presented in `arg`.\n shift # remove old arg\n set -- \"$@\" \"$arg\" # push replacement arg\n done\nfi\n\n\n# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.\nDEFAULT_JVM_OPTS='\"-Xmx64m\" \"-Xms64m\"'\n\n# Collect all arguments for the java command:\n# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,\n# and any embedded shellness will be escaped.\n# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be\n# treated as '${Hostname}' itself on the command line.\n\nset -- \\\n \"-Dorg.gradle.appname=$APP_BASE_NAME\" \\\n -jar \"$APP_HOME/gradle/wrapper/gradle-wrapper.jar\" \\\n \"$@\"\n\n# Stop when \"xargs\" is not available.\nif ! command -v xargs >/dev/null 2>&1\nthen\n die \"xargs is not available\"\nfi\n\n# Use \"xargs\" to parse quoted args.\n#\n# With -n1 it outputs one arg per line, with the quotes and backslashes removed.\n#\n# In Bash we could simply go:\n#\n# readarray ARGS < <( xargs -n1 <<<\"$var\" ) &&\n# set -- \"${ARGS[@]}\" \"$@\"\n#\n# but POSIX shell has neither arrays nor command substitution, so instead we\n# post-process each arg (as a line of input to sed) to backslash-escape any\n# character that might be a shell metacharacter, then use eval to reverse\n# that process (while maintaining the separation between arguments), and wrap\n# the whole thing up as a single \"set\" statement.\n#\n# This will of course break if any of these variables contains a newline or\n# an unmatched quote.\n#\n\neval \"set -- $(\n printf '%s\\n' \"$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS\" |\n xargs -n1 |\n sed ' s~[^-[:alnum:]+,./:=@_]~\\\\&~g; ' |\n tr '\\n' ' '\n )\" '\"$@\"'\n\nexec \"$JAVACMD\" \"$@\"\n" }, { "path": "gradlew.bat", "content": "@rem\r\n@rem Copyright 2015 the original author or authors.\r\n@rem\r\n@rem Licensed under the Apache License, Version 2.0 (the \"License\");\r\n@rem you may not use this file except in compliance with the License.\r\n@rem You may obtain a copy of the License at\r\n@rem\r\n@rem https://www.apache.org/licenses/LICENSE-2.0\r\n@rem\r\n@rem Unless required by applicable law or agreed to in writing, software\r\n@rem distributed under the License is distributed on an \"AS IS\" BASIS,\r\n@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n@rem See the License for the specific language governing permissions and\r\n@rem limitations under the License.\r\n@rem\r\n@rem SPDX-License-Identifier: Apache-2.0\r\n@rem\r\n\r\n@if \"%DEBUG%\"==\"\" @echo off\r\n@rem ##########################################################################\r\n@rem\r\n@rem Gradle startup script for Windows\r\n@rem\r\n@rem ##########################################################################\r\n\r\n@rem Set local scope for the variables with windows NT shell\r\nif \"%OS%\"==\"Windows_NT\" setlocal\r\n\r\nset DIRNAME=%~dp0\r\nif \"%DIRNAME%\"==\"\" set DIRNAME=.\r\n@rem This is normally unused\r\nset APP_BASE_NAME=%~n0\r\nset APP_HOME=%DIRNAME%\r\n\r\n@rem Resolve any \".\" and \"..\" in APP_HOME to make it shorter.\r\nfor %%i in (\"%APP_HOME%\") do set APP_HOME=%%~fi\r\n\r\n@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.\r\nset DEFAULT_JVM_OPTS=\"-Xmx64m\" \"-Xms64m\"\r\n\r\n@rem Find java.exe\r\nif defined JAVA_HOME goto findJavaFromJavaHome\r\n\r\nset JAVA_EXE=java.exe\r\n%JAVA_EXE% -version >NUL 2>&1\r\nif %ERRORLEVEL% equ 0 goto execute\r\n\r\necho. 1>&2\r\necho ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2\r\necho. 1>&2\r\necho Please set the JAVA_HOME variable in your environment to match the 1>&2\r\necho location of your Java installation. 1>&2\r\n\r\ngoto fail\r\n\r\n:findJavaFromJavaHome\r\nset JAVA_HOME=%JAVA_HOME:\"=%\r\nset JAVA_EXE=%JAVA_HOME%/bin/java.exe\r\n\r\nif exist \"%JAVA_EXE%\" goto execute\r\n\r\necho. 1>&2\r\necho ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2\r\necho. 1>&2\r\necho Please set the JAVA_HOME variable in your environment to match the 1>&2\r\necho location of your Java installation. 1>&2\r\n\r\ngoto fail\r\n\r\n:execute\r\n@rem Setup the command line\r\n\r\n\r\n\r\n@rem Execute Gradle\r\n\"%JAVA_EXE%\" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% \"-Dorg.gradle.appname=%APP_BASE_NAME%\" -jar \"%APP_HOME%\\gradle\\wrapper\\gradle-wrapper.jar\" %*\r\n\r\n:end\r\n@rem End local scope for the variables with windows NT shell\r\nif %ERRORLEVEL% equ 0 goto mainEnd\r\n\r\n:fail\r\nrem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of\r\nrem the _cmd.exe /c_ return code!\r\nset EXIT_CODE=%ERRORLEVEL%\r\nif %EXIT_CODE% equ 0 set EXIT_CODE=1\r\nif not \"\"==\"%GRADLE_EXIT_CONSOLE%\" exit %EXIT_CODE%\r\nexit /b %EXIT_CODE%\r\n\r\n:mainEnd\r\nif \"%OS%\"==\"Windows_NT\" endlocal\r\n\r\n:omega\r\n" }, { "path": "hack/cherry_pick_pull.sh", "content": "#!/usr/bin/env bash\n\n# Copyright 2015 The Kubernetes Authors.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n# Usage Instructions: https://git.k8s.io/community/contributors/devel/sig-release/cherry-picks.md\n\n# Checkout a PR from GitHub. (Yes, this is sitting in a Git tree. How\n# meta.) Assumes you care about pulls from remote \"upstream\" and\n# checks them out to a branch named:\n# automated-cherry-pick-of---\n\nset -o errexit\nset -o nounset\nset -o pipefail\n\nREPO_ROOT=\"$(git rev-parse --show-toplevel)\"\ndeclare -r REPO_ROOT\ncd \"${REPO_ROOT}\"\n\nSTARTINGBRANCH=$(git symbolic-ref --short HEAD)\ndeclare -r STARTINGBRANCH\ndeclare -r REBASEMAGIC=\"${REPO_ROOT}/.git/rebase-apply\"\nDRY_RUN=${DRY_RUN:-\"\"}\nREGENERATE_DOCS=${REGENERATE_DOCS:-\"\"}\nUPSTREAM_REMOTE=${UPSTREAM_REMOTE:-upstream}\nFORK_REMOTE=${FORK_REMOTE:-origin}\nMAIN_REPO_ORG=${MAIN_REPO_ORG:-$(git remote get-url \"$UPSTREAM_REMOTE\" | awk '{gsub(/http[s]:\\/\\/|git@/,\"\")}1' | awk -F'[@:./]' 'NR==1{print $3}')}\nMAIN_REPO_NAME=${MAIN_REPO_NAME:-$(git remote get-url \"$UPSTREAM_REMOTE\" | awk '{gsub(/http[s]:\\/\\/|git@/,\"\")}1' | awk -F'[@:./]' 'NR==1{print $4}')}\n\nif [[ -z ${GITHUB_USER:-} ]]; then\n echo \"Please export GITHUB_USER= (or GH organization, if that's where your fork lives)\"\n exit 1\nfi\n\nif ! command -v gh > /dev/null; then\n echo \"Can't find 'gh' tool in PATH, please install from https://github.com/cli/cli\"\n exit 1\nfi\n\nif [[ \"$#\" -lt 2 ]]; then\n echo \"${0} ...: cherry pick one or more onto and leave instructions for proposing pull request\"\n echo\n echo \" Checks out and handles the cherry-pick of (possibly multiple) for you.\"\n echo \" Examples:\"\n echo \" $0 upstream/release-3.14 12345 # Cherry-picks PR 12345 onto upstream/release-3.14 and proposes that as a PR.\"\n echo \" $0 upstream/release-3.14 12345 56789 # Cherry-picks PR 12345, then 56789 and proposes the combination as a single PR.\"\n echo\n echo \" Set the DRY_RUN environment var to skip git push and creating PR.\"\n echo \" This is useful for creating patches to a release branch without making a PR.\"\n echo \" When DRY_RUN is set the script will leave you in a branch containing the commits you cherry-picked.\"\n echo\n echo \" Set the REGENERATE_DOCS environment var to regenerate documentation for the target branch after picking the specified commits.\"\n echo \" This is useful when picking commits containing changes to API documentation.\"\n echo\n echo \" Set UPSTREAM_REMOTE (default: upstream) and FORK_REMOTE (default: origin)\"\n echo \" to override the default remote names to what you have locally.\"\n echo\n echo \" For merge process info, see https://git.k8s.io/community/contributors/devel/sig-release/cherry-picks.md\"\n exit 2\nfi\n\n# Checks if you are logged in. Will error/bail if you are not.\ngh auth status\n\nif git_status=$(git status --porcelain --untracked=no 2>/dev/null) && [[ -n \"${git_status}\" ]]; then\n echo \"!!! Dirty tree. Clean up and try again.\"\n exit 1\nfi\n\nif [[ -e \"${REBASEMAGIC}\" ]]; then\n echo \"!!! 'git rebase' or 'git am' in progress. Clean up and try again.\"\n exit 1\nfi\n\ndeclare -r BRANCH=\"$1\"\nshift 1\ndeclare -r PULLS=( \"$@\" )\n\nfunction join { local IFS=\"$1\"; shift; echo \"$*\"; }\nPULLDASH=$(join - \"${PULLS[@]/#/#}\") # Generates something like \"#12345-#56789\"\ndeclare -r PULLDASH\nPULLSUBJ=$(join \" \" \"${PULLS[@]/#/#}\") # Generates something like \"#12345 #56789\"\ndeclare -r PULLSUBJ\n\necho \"+++ Updating remotes...\"\ngit remote update \"${UPSTREAM_REMOTE}\" \"${FORK_REMOTE}\"\n\nif ! git log -n1 --format=%H \"${BRANCH}\" >/dev/null 2>&1; then\n echo \"!!! '${BRANCH}' not found. The second argument should be something like ${UPSTREAM_REMOTE}/release-0.21.\"\n echo \" (In particular, it needs to be a valid, existing remote branch that I can 'git checkout'.)\"\n exit 1\nfi\n\nNEWBRANCHREQ=\"automated-cherry-pick-of-${PULLDASH}\" # \"Required\" portion for tools.\ndeclare -r NEWBRANCHREQ\nNEWBRANCH=\"$(echo \"${NEWBRANCHREQ}-${BRANCH}\" | sed 's/\\//-/g')\"\ndeclare -r NEWBRANCH\nNEWBRANCHUNIQ=\"${NEWBRANCH}-$(date +%s)\"\ndeclare -r NEWBRANCHUNIQ\necho \"+++ Creating local branch ${NEWBRANCHUNIQ}\"\n\ncleanbranch=\"\"\ngitamcleanup=false\nfunction return_to_kansas {\n if [[ \"${gitamcleanup}\" == \"true\" ]]; then\n echo\n echo \"+++ Aborting in-progress git am.\"\n git am --abort >/dev/null 2>&1 || true\n fi\n\n # return to the starting branch and delete the PR text file\n if [[ -z \"${DRY_RUN}\" ]]; then\n echo\n echo \"+++ Returning you to the ${STARTINGBRANCH} branch and cleaning up.\"\n git checkout -f \"${STARTINGBRANCH}\" >/dev/null 2>&1 || true\n if [[ -n \"${cleanbranch}\" ]]; then\n git branch -D \"${cleanbranch}\" >/dev/null 2>&1 || true\n fi\n fi\n}\ntrap return_to_kansas EXIT\n\nSUBJECTS=()\nfunction make-a-pr() {\n local rel\n rel=\"$(basename \"${BRANCH}\")\"\n echo\n echo \"+++ Creating a pull request on GitHub at ${GITHUB_USER}:${NEWBRANCH}\"\n\n local numandtitle\n numandtitle=$(printf '%s\\n' \"${SUBJECTS[@]}\")\n prtext=$(cat <&2\n exit 1\n fi\n done\n\n if [[ \"${conflicts}\" != \"true\" ]]; then\n echo \"!!! git am failed, likely because of an in-progress 'git am' or 'git rebase'\"\n exit 1\n fi\n }\n\n # set the subject\n subject=$(grep -m 1 \"^Subject\" \"/tmp/${pull}.patch\" | sed -e 's/Subject: \\[PATCH//g' | sed 's/.*] //')\n SUBJECTS+=(\"#${pull}: ${subject}\")\n\n # remove the patch file from /tmp\n rm -f \"/tmp/${pull}.patch\"\ndone\ngitamcleanup=false\n\n# Re-generate docs (if needed)\nif [[ -n \"${REGENERATE_DOCS}\" ]]; then\n echo\n echo \"Regenerating docs...\"\n if ! hack/generate-docs.sh; then\n echo\n echo \"hack/generate-docs.sh FAILED to complete.\"\n exit 1\n fi\nfi\n\nif [[ -n \"${DRY_RUN}\" ]]; then\n echo \"!!! Skipping git push and PR creation because you set DRY_RUN.\"\n echo \"To return to the branch you were in when you invoked this script:\"\n echo\n echo \" git checkout ${STARTINGBRANCH}\"\n echo\n echo \"To delete this branch:\"\n echo\n echo \" git branch -D ${NEWBRANCHUNIQ}\"\n exit 0\nfi\n\nif git remote -v | grep ^\"${FORK_REMOTE}\" | grep \"${MAIN_REPO_ORG}/${MAIN_REPO_NAME}.git\"; then\n echo \"!!! You have ${FORK_REMOTE} configured as your ${MAIN_REPO_ORG}/${MAIN_REPO_NAME}.git\"\n echo \"This isn't normal. Leaving you with push instructions:\"\n echo\n echo \"+++ First manually push the branch this script created:\"\n echo\n echo \" git push REMOTE ${NEWBRANCHUNIQ}:${NEWBRANCH}\"\n echo\n echo \"where REMOTE is your personal fork (maybe ${UPSTREAM_REMOTE}? Consider swapping those.).\"\n echo \"OR consider setting UPSTREAM_REMOTE and FORK_REMOTE to different values.\"\n echo\n make-a-pr\n cleanbranch=\"\"\n exit 0\nfi\n\necho\necho \"+++ I'm about to do the following to push to GitHub (and I'm assuming ${FORK_REMOTE} is your personal fork):\"\necho\necho \" git push ${FORK_REMOTE} ${NEWBRANCHUNIQ}:${NEWBRANCH}\"\necho\nread -p \"+++ Proceed (anything but 'y' aborts the cherry-pick)? [y/n] \" -r\nif ! [[ \"${REPLY}\" =~ ^[yY]$ ]]; then\n echo \"Aborting.\" >&2\n exit 1\nfi\n\ngit push \"${FORK_REMOTE}\" -f \"${NEWBRANCHUNIQ}:${NEWBRANCH}\"\nmake-a-pr\n" }, { "path": "platform/application/build.gradle", "content": "import org.springframework.boot.gradle.plugin.SpringBootPlugin\n\nplugins {\n id 'java-platform'\n id 'halo.publish'\n alias(libs.plugins.spring.boot) apply false\n}\n\ngroup = 'run.halo.tools.platform'\ndescription = 'Platform of application.'\n\njavaPlatform {\n allowDependencies()\n}\n\ndependencies {\n api platform(SpringBootPlugin.BOM_COORDINATES)\n\n constraints {\n api libs.bundles.lucene\n api libs.bundles.apache\n api libs.bundles.therapi\n api libs.springdoc.openapi\n api libs.openapi.schema.validator\n api libs.bouncycastle.bcpkix\n api libs.encoding.base62\n api libs.pf4j\n api libs.guava\n api libs.java.diff.utils\n api libs.jsoup\n api libs.json.patch\n api libs.bundles.resilience4j\n api libs.twofactor.auth\n api libs.thumbnailator\n api \"org.springframework.integration:spring-integration-core\"\n api \"org.thymeleaf.extras:thymeleaf-extras-springsecurity6\"\n }\n\n}\n\npublishing {\n publications.named('mavenJava', MavenPublication) {\n from components.javaPlatform\n pom {\n name = 'Application platform.'\n description = \"$project.description\"\n }\n }\n}\n" }, { "path": "platform/plugin/build.gradle", "content": "plugins {\n id 'java-platform'\n id 'halo.publish'\n}\n\ngroup = 'run.halo.tools.platform'\ndescription = 'This is the platform that other plugins depend on. ' +\n 'We can put the plugin API as a dependency at here.'\n\njavaPlatform {\n allowDependencies()\n}\n\ndependencies {\n api platform(project(':platform:application'))\n constraints {\n api project(':api')\n // TODO other plugin API dependencies\n // e.g.: api 'halo.run.plugin:links-api:1.1.0'\n }\n}\n\npublishing {\n publications.named('mavenJava', MavenPublication) {\n from components.javaPlatform\n pom {\n name = 'Plugin platform'\n description = \"$project.description\"\n }\n }\n}\n" }, { "path": "settings.gradle", "content": "pluginManagement {\n repositories {\n maven { url = 'https://repo.spring.io/milestone' }\n gradlePluginPortal()\n }\n}\n\nrootProject.name = 'halo'\ninclude 'api', 'application', 'platform:application', 'platform:plugin', 'ui'\n" }, { "path": "ui/.editorconfig", "content": "root=true\n\n[*.{js,jsx,mjs,cjs,ts,tsx,mts,cts,vue,css,scss,sass,less,styl}]\nindent_style = space\nindent_size = 2\nend_of_line = lf\ncharset = utf-8\ntrim_trailing_whitespace = false\ninsert_final_newline = true\n" }, { "path": "ui/.husky/pre-commit", "content": "cd ui && pnpm exec lint-staged\n" }, { "path": "ui/.npmrc", "content": "strict-peer-dependencies=false\nauto-install-peers=true\n" }, { "path": "ui/.oxfmtrc.json", "content": "{\n \"$schema\": \"./node_modules/oxfmt/configuration_schema.json\",\n \"sortTailwindcss\": {},\n \"sortImports\": {\n \"newlinesBetween\": false\n },\n \"trailingComma\": \"es5\",\n \"printWidth\": 80,\n \"sortPackageJson\": true,\n \"tabWidth\": 2,\n \"useTabs\": false,\n \"insertFinalNewline\": true,\n \"ignorePatterns\": [\n \"packages/api-client/src\",\n \"docs\",\n \"**/dist/**\",\n \"build/**\",\n \"storybook-static\",\n \".idea\"\n ],\n \"overrides\": [\n {\n \"files\": [\"**/*.html\"],\n \"options\": {\n \"printWidth\": 120\n }\n }\n ]\n}\n" }, { "path": "ui/Makefile", "content": "SHELL := /usr/bin/env bash -o errexit -o pipefail -o nounset\n\ninstall: ## Install console\n\tpnpm install\n\nbuild-packages: install ## Build packages of console\n\tpnpm build:packages\n\nbuild: build-packages ## Build console\n\tpnpm build\n\nlint: build-packages ## Lint console\n\tpnpm lint\n\tpnpm typecheck\n\ntest: build-packages ## Test console\n\tpnpm test:unit\n\ncheck: lint test ## Check console\n\ndev: build-packages ## Run console with development environment\n\tpnpm dev\n\napi-client-gen: install ## Generate API client\n\tpnpm api-client:gen\n\nhelp: ## print this help\n\t@awk 'BEGIN {FS = \":.*?## \"} /^[a-zA-Z0-9_-]+:.*?## / {gsub(\"\\\\\\\\n\",sprintf(\"\\n%22c\",\"\"), $$2);printf \"\\033[36m%-20s\\033[0m %s\\n\", $$1, $$2}' $(MAKEFILE_LIST)\n" }, { "path": "ui/build.gradle", "content": "plugins {\n id 'idea'\n id 'base'\n alias(libs.plugins.node)\n alias(libs.plugins.openapi.generator)\n}\n\nidea {\n module {\n excludeDirs += file('node_modules/')\n excludeDirs += file('packages').listFiles().collect {\n file(it.path + '/node_modules/')\n }\n excludeDirs += file('packages').listFiles().collect {\n file(it.path + '/dist/')\n }\n }\n}\n\npnpmInstall {\n nodeModulesOutputFilter {\n exclude('**')\n }\n}\n\ntasks.named('clean') {\n dependsOn tasks.named('doClean')\n}\n\ntasks.register('doClean', Delete) {\n delete layout.buildDirectory\n delete fileTree('packages') {\n include '*/dist/**'\n }\n}\n\ntasks.named('assemble') {\n dependsOn tasks.named('doBuild')\n}\n\ntasks.register('doBuild', PnpmTask) {\n dependsOn tasks.named('buildPackages')\n pnpmCommand = ['run', 'build']\n inputs.files(fileTree(layout.projectDirectory) {\n include 'console-src/**', 'uc-src/**', 'src/**', 'public/**', '*.js', '*.json', '*.yaml', '*.html'\n exclude '**/node_modules/**', '**/build/**', '**/dist/**'\n })\n outputs.dir(layout.buildDirectory.dir('dist'))\n}\n\ntasks.register('buildPackages', PnpmTask) {\n dependsOn tasks.named('pnpmInstall')\n inputs.files(fileTree('packages') {\n exclude '**/node_modules/**', '**/dist/**'\n })\n inputs.file('package.json')\n pnpmCommand = ['run', 'build:packages']\n outputs.files(fileTree('packages') {\n include '*/dist/**'\n })\n}\n\ntasks.register('test', PnpmTask) {\n dependsOn tasks.named('buildPackages')\n pnpmCommand = ['run', 'test:unit']\n shouldRunAfter tasks.named('lint'), tasks.named('typecheck')\n}\n\ntasks.register('lint', PnpmTask) {\n dependsOn tasks.named('buildPackages')\n pnpmCommand = ['run', 'lint']\n}\n\ntasks.register('typecheck', PnpmTask) {\n dependsOn tasks.named('buildPackages')\n pnpmCommand = ['run', 'typecheck']\n}\n\ntasks.named('check') {\n dependsOn tasks.named('lint'), tasks.named('typecheck'), tasks.named('test')\n}\n\ntasks.register('dev', PnpmTask) {\n dependsOn tasks.named('buildPackages')\n pnpmCommand = ['run', 'dev']\n}\n" }, { "path": "ui/console-src/App.vue", "content": "\n\n\n" }, { "path": "ui/console-src/components/snapshots/BaseSnapshots.vue", "content": "\n\n\n" }, { "path": "ui/console-src/components/snapshots/SnapshotContent.vue", "content": "\n\n\n\n" }, { "path": "ui/console-src/components/snapshots/SnapshotDiffContent.vue", "content": "\n\n\n\n" }, { "path": "ui/console-src/components/snapshots/SnapshotListItem.vue", "content": "\n\n" }, { "path": "ui/console-src/components/snapshots/query-keys.ts", "content": "import type { Ref } from \"vue\";\n\nexport const SNAPSHOTS_QUERY_KEY = (\n cacheKey: Ref,\n name?: Ref\n) => [`core:${cacheKey}:snapshots`, name];\n\nexport const SNAPSHOT_QUERY_KEY = (\n cacheKey: Ref,\n name?: Ref,\n snapshotNames?: Ref\n) => [`core:${cacheKey}:snapshot`, name, snapshotNames];\n\nexport const SNAPSHOT_DIFF_QUERY_KEY = (\n cacheKey: Ref,\n name?: Ref,\n snapshotNames?: Ref\n) => [`core:${cacheKey}:snapshot-diff`, name, snapshotNames];\n" }, { "path": "ui/console-src/composables/use-content-snapshot.ts", "content": "import { coreApiClient } from \"@halo-dev/api-client\";\nimport { nextTick, ref, watch, type Ref } from \"vue\";\n\ninterface SnapshotContent {\n version: Ref;\n handleFetchSnapshot: () => Promise;\n}\n\nexport function useContentSnapshot(\n snapshotName: Ref\n): SnapshotContent {\n const version = ref(0);\n watch(snapshotName, () => {\n nextTick(() => {\n handleFetchSnapshot();\n });\n });\n\n const handleFetchSnapshot = async () => {\n if (!snapshotName.value) {\n return;\n }\n const { data } = await coreApiClient.content.snapshot.getSnapshot({\n name: snapshotName.value,\n });\n version.value = data.metadata.version || 0;\n };\n\n return {\n version,\n handleFetchSnapshot,\n };\n}\n" }, { "path": "ui/console-src/composables/use-dashboard-stats.ts", "content": "import { consoleApiClient } from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\n\nexport function useDashboardStats() {\n const { data } = useQuery({\n queryKey: [\"dashboard-stats\"],\n queryFn: async () => {\n const { data } = await consoleApiClient.system.getStats();\n return data;\n },\n });\n return { data };\n}\n" }, { "path": "ui/console-src/composables/use-entity-extension-points.ts", "content": "import type { EntityFieldItem } from \"@halo-dev/ui-shared\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { computed, toValue, type ComputedRef, type Ref } from \"vue\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\n\nexport function useEntityFieldItemExtensionPoint(\n extensionPointName: string,\n entity: Ref,\n presets: ComputedRef\n) {\n const { pluginModules } = usePluginModuleStore();\n\n return useQuery({\n queryKey: computed(() => [\n \"core:extension-points:list-item:fields\",\n extensionPointName,\n toValue(entity),\n ]),\n queryFn: async () => {\n const itemsFromPlugins: EntityFieldItem[] = [];\n\n for (const pluginModule of pluginModules) {\n const { extensionPoints } = pluginModule;\n if (!extensionPoints?.[extensionPointName]) {\n continue;\n }\n const items = extensionPoints[extensionPointName](\n entity\n ) as EntityFieldItem[];\n itemsFromPlugins.push(...items);\n }\n\n const allItems = [...presets.value, ...itemsFromPlugins].sort(\n (a, b) => a.priority - b.priority\n );\n\n const start: EntityFieldItem[] = [];\n const end: EntityFieldItem[] = [];\n\n for (const item of allItems) {\n if (item.position === \"start\") {\n start.push(item);\n } else if (item.position === \"end\") {\n end.push(item);\n }\n }\n\n return {\n start,\n end,\n };\n },\n enabled: computed(() => !!presets.value && !!entity.value),\n });\n}\n" }, { "path": "ui/console-src/composables/use-operation-extension-points.ts", "content": "import type { OperationItem } from \"@halo-dev/ui-shared\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { computed, toValue, type ComputedRef, type Ref } from \"vue\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\n\nexport function useOperationItemExtensionPoint(\n extensionPointName: string,\n entity: Ref,\n presets: ComputedRef[]>\n) {\n const { pluginModules } = usePluginModuleStore();\n\n return useQuery({\n queryKey: computed(() => [\n \"core:extension-points:operation-items\",\n extensionPointName,\n toValue(entity),\n ]),\n queryFn: async () => {\n const itemsFromPlugins: OperationItem[] = [];\n for (const pluginModule of pluginModules) {\n const { extensionPoints } = pluginModule;\n if (!extensionPoints?.[extensionPointName]) {\n continue;\n }\n\n const items = extensionPoints[extensionPointName](\n entity\n ) as OperationItem[];\n\n itemsFromPlugins.push(...items);\n }\n\n return [...presets.value, ...itemsFromPlugins].sort(\n (a, b) => a.priority - b.priority\n );\n },\n enabled: computed(() => !!presets.value && !!entity.value),\n });\n}\n" }, { "path": "ui/console-src/composables/use-save-keybinding.ts", "content": "import { useEventListener } from \"@vueuse/core\";\nimport { useDebounceFn } from \"@vueuse/shared\";\nimport { nextTick } from \"vue\";\nimport { isMac } from \"@/utils/device\";\n\nexport function useSaveKeybinding(fn: () => void) {\n const debouncedFn = useDebounceFn(() => {\n fn();\n }, 300);\n\n useEventListener(window, \"keydown\", (e: KeyboardEvent) => {\n if (isMac ? e.metaKey : e.ctrlKey) {\n if (e.key === \"s\") {\n e.preventDefault();\n nextTick(() => {\n debouncedFn();\n });\n }\n }\n });\n}\n" }, { "path": "ui/console-src/composables/use-slugify.ts", "content": "import { FormType, stores, utils } from \"@halo-dev/ui-shared\";\nimport ShortUniqueId from \"short-unique-id\";\nimport { slugify } from \"transliteration\";\nimport { computed, watch, type Ref } from \"vue\";\n\nconst uid = new ShortUniqueId();\n\ntype SlugStrategy = (value?: string) => string;\n\nconst strategies: Record = {\n generateByTitle: (value?: string) => slugify(value || \"\", { trim: true }),\n shortUUID: () => uid.randomUUID(8),\n UUID: () => utils.id.uuid(),\n timestamp: () => new Date().getTime().toString(),\n};\n\nconst onceStrategies = new Set([\"shortUUID\", \"UUID\", \"timestamp\"]);\n\nexport default function useSlugify(\n source: Ref,\n target: Ref,\n auto: Ref,\n formType: FormType\n) {\n const globalInfoStore = stores.globalInfo();\n\n const currentStrategy = computed(\n () =>\n globalInfoStore.globalInfo?.postSlugGenerationStrategy ||\n \"generateByTitle\"\n );\n\n const generateSlug = (value: string): string => {\n const strategy =\n formType === FormType.POST\n ? strategies[currentStrategy.value]\n : strategies.generateByTitle;\n\n return strategy(value);\n };\n\n const handleGenerateSlug = (forceUpdate = false) => {\n if (\n !forceUpdate &&\n onceStrategies.has(currentStrategy.value) &&\n target.value\n ) {\n return;\n }\n\n target.value = generateSlug(source.value);\n };\n\n watch(\n source,\n () => {\n if (auto.value) {\n handleGenerateSlug(true);\n }\n },\n { immediate: true }\n );\n\n return {\n handleGenerateSlug,\n };\n}\n" }, { "path": "ui/console-src/layouts/BasicLayout.vue", "content": "\n\n\n\n\n" }, { "path": "ui/console-src/layouts/BlankLayout.vue", "content": "\n\n\n" }, { "path": "ui/console-src/main.ts", "content": "import modules from \"@console/modules\";\nimport { useThemeStore } from \"@console/stores/theme\";\nimport { stores } from \"@halo-dev/ui-shared\";\nimport { createPinia } from \"pinia\";\nimport \"@/setup/setupStyles\";\nimport { createApp } from \"vue\";\nimport { setLanguage, setupI18n } from \"@/locales\";\nimport { setupApiClient } from \"@/setup/setupApiClient\";\nimport { setupComponents } from \"@/setup/setupComponents\";\nimport { setupCoreModules, setupPluginModules } from \"@/setup/setupModules\";\nimport \"core-js/es/object/has-own\";\nimport { setupUserPermissions } from \"@/setup/setupUserPermissions\";\nimport { setupVueQuery } from \"@/setup/setupVueQuery\";\nimport App from \"./App.vue\";\nimport router from \"./router\";\n\nconst app = createApp(App);\n\nsetupComponents(app);\nsetupI18n(app);\nsetupVueQuery(app);\nsetupApiClient();\n\napp.use(createPinia());\n\nasync function loadActivatedTheme() {\n const themeStore = useThemeStore();\n await themeStore.fetchActivatedTheme();\n}\n\nawait initApp();\n\nasync function initApp() {\n try {\n setupCoreModules({ app, router, platform: \"console\", modules });\n\n const currentUserStore = stores.currentUser();\n await currentUserStore.fetchCurrentUser();\n\n const globalInfoStore = stores.globalInfo();\n await globalInfoStore.fetchGlobalInfo();\n\n await setLanguage();\n\n if (currentUserStore.isAnonymous) {\n return;\n }\n\n await setupUserPermissions(app);\n\n try {\n await setupPluginModules({ app, router, platform: \"console\" });\n } catch (e) {\n console.error(\"Failed to load plugins\", e);\n }\n\n await loadActivatedTheme();\n } catch (e) {\n console.error(e);\n } finally {\n app.use(router);\n app.mount(\"#app\");\n }\n}\n" }, { "path": "ui/console-src/modules/contents/attachments/AttachmentList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentDetailModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentError.vue", "content": "\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentGroupBadge.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentGroupEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentGroupList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentListItem.vue", "content": "\n\n\n \n \n \n \n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentLoading.vue", "content": "\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentPoliciesListItem.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentPoliciesModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentPolicyBadge.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentPolicyEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentSelectorModal.vue", "content": "\n\n \n \n \n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentUploadArea.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/AttachmentUploadModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/DisplayNameEditForm.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/UploadFromUrl.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/selector-providers/CoreSelectorProvider.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/selector-providers/components/AttachmentSelectorListItem.vue", "content": "\n\n\n \n \n \n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/selector-providers/components/GroupFilter.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/components/selector-providers/components/PolicyFilter.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/attachments/composables/use-attachment-group.ts", "content": "import type {\n Group,\n GroupV1alpha1ApiListGroupRequest,\n} from \"@halo-dev/api-client\";\nimport { coreApiClient, paginate } from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport type { Ref } from \"vue\";\n\ninterface useFetchAttachmentGroupReturn {\n groups: Ref;\n isLoading: Ref;\n handleFetchGroups: () => void;\n}\n\nexport function useFetchAttachmentGroup(): useFetchAttachmentGroupReturn {\n const { data, isLoading, refetch } = useQuery({\n queryKey: [\"attachment-groups\"],\n queryFn: async () => {\n return await paginate(\n (params) => coreApiClient.storage.group.listGroup(params),\n {\n size: 1000,\n labelSelector: [\"!halo.run/hidden\"],\n sort: [\"metadata.creationTimestamp,asc\"],\n }\n );\n },\n refetchInterval(data) {\n const hasDeletingGroup = data?.some(\n (group) => !!group.metadata.deletionTimestamp\n );\n\n return hasDeletingGroup ? 1000 : false;\n },\n });\n\n return {\n groups: data,\n isLoading,\n handleFetchGroups: refetch,\n };\n}\n" }, { "path": "ui/console-src/modules/contents/attachments/composables/use-attachment-policy.ts", "content": "import type {\n Policy,\n PolicyTemplate,\n PolicyTemplateV1alpha1ApiListPolicyTemplateRequest,\n PolicyV1alpha1ApiListPolicyRequest,\n} from \"@halo-dev/api-client\";\nimport { coreApiClient, paginate } from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { attachmentPolicyLabels } from \"@/constants/labels\";\n\nexport function useFetchAttachmentPolicy() {\n return useQuery({\n queryKey: [\"attachment-policies\"],\n queryFn: async () => {\n const policies = await paginate<\n PolicyV1alpha1ApiListPolicyRequest,\n Policy\n >((params) => coreApiClient.storage.policy.listPolicy(params), {\n size: 1000,\n });\n return policies.sort((a, b) => {\n const priorityA = parseInt(\n a.metadata.labels?.[attachmentPolicyLabels.PRIORITY] || \"0\",\n 10\n );\n const priorityB = parseInt(\n b.metadata.labels?.[attachmentPolicyLabels.PRIORITY] || \"0\",\n 10\n );\n return priorityB - priorityA;\n });\n },\n refetchInterval(data) {\n const hasDeletingPolicy = data?.some(\n (policy) => !!policy.metadata.deletionTimestamp\n );\n return hasDeletingPolicy ? 1000 : false;\n },\n });\n}\n\nexport function useFetchAttachmentPolicyTemplate() {\n return useQuery({\n queryKey: [\"attachment-policy-templates\"],\n queryFn: async () => {\n return await paginate<\n PolicyTemplateV1alpha1ApiListPolicyTemplateRequest,\n PolicyTemplate\n >(\n (params) =>\n coreApiClient.storage.policyTemplate.listPolicyTemplate(params),\n {\n size: 1000,\n }\n );\n },\n });\n}\n" }, { "path": "ui/console-src/modules/contents/attachments/composables/use-attachment.ts", "content": "import type { Attachment } from \"@halo-dev/api-client\";\nimport { consoleApiClient, coreApiClient } from \"@halo-dev/api-client\";\nimport { Dialog, Toast } from \"@halo-dev/components\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport {\n computed,\n nextTick,\n ref,\n watch,\n type ComputedRef,\n type Ref,\n} from \"vue\";\nimport { useI18n } from \"vue-i18n\";\n\ninterface useAttachmentControlReturn {\n attachments: Ref;\n isLoading: Ref;\n isFetching: Ref;\n selectedAttachment: Ref;\n selectedAttachments: ComputedRef;\n selectedAttachmentNames: Ref>;\n checkedAll: Ref;\n total: Ref;\n handleFetchAttachments: () => void;\n handleSelectPrevious: () => void;\n handleSelectNext: () => void;\n handleDeleteInBatch: () => void;\n handleCheckAll: (checkAll: boolean) => void;\n handleSelect: (attachment: Attachment | undefined) => void;\n isChecked: (attachment: Attachment) => boolean;\n handleReset: () => void;\n}\n\nexport function useAttachmentControl(filterOptions: {\n policyName?: Ref;\n groupName?: Ref;\n user?: Ref;\n accepts?: Ref;\n keyword?: Ref;\n sort?: Ref;\n page: Ref;\n size: Ref;\n}): useAttachmentControlReturn {\n const { t } = useI18n();\n\n const { user, policyName, groupName, keyword, sort, page, size, accepts } =\n filterOptions;\n\n const selectedAttachment = ref();\n const selectedAttachmentNames = ref>(new Set());\n const checkedAll = ref(false);\n\n const total = ref(0);\n const hasPrevious = ref(false);\n const hasNext = ref(false);\n\n const { data, isLoading, isFetching, refetch } = useQuery({\n queryKey: [\n \"attachments\",\n policyName,\n keyword,\n groupName,\n user,\n accepts,\n page,\n size,\n sort,\n ],\n queryFn: async () => {\n const isUnGrouped = groupName?.value === \"ungrouped\";\n\n const fieldSelectorMap: Record = {\n \"spec.policyName\": policyName?.value,\n \"spec.ownerName\": user?.value,\n \"spec.groupName\": isUnGrouped ? undefined : groupName?.value,\n };\n\n const fieldSelector = Object.entries(fieldSelectorMap)\n .map(([key, value]) => {\n if (value) {\n return `${key}=${value}`;\n }\n })\n .filter(Boolean) as string[];\n\n const { data } =\n await consoleApiClient.storage.attachment.searchAttachments({\n fieldSelector,\n page: page.value,\n size: size.value,\n ungrouped: isUnGrouped,\n accepts: accepts?.value,\n keyword: keyword?.value,\n sort: [sort?.value as string].filter(Boolean),\n });\n\n total.value = data.total;\n hasPrevious.value = data.hasPrevious;\n hasNext.value = data.hasNext;\n\n return data.items;\n },\n refetchInterval(data) {\n const hasDeletingAttachment = data?.some(\n (attachment) => !!attachment.metadata.deletionTimestamp\n );\n return hasDeletingAttachment ? 1000 : false;\n },\n });\n\n const handleSelectPrevious = async () => {\n if (!data.value) return;\n\n const index = data.value?.findIndex(\n (attachment) =>\n attachment.metadata.name === selectedAttachment.value?.metadata.name\n );\n\n if (index === undefined) return;\n\n if (index > 0) {\n selectedAttachment.value = data.value[index - 1];\n return;\n }\n\n if (index === 0 && hasPrevious.value) {\n page.value--;\n await nextTick();\n await refetch();\n selectedAttachment.value = data.value[data.value.length - 1];\n }\n };\n\n const handleSelectNext = async () => {\n if (!data.value) return;\n\n const index = data.value?.findIndex(\n (attachment) =>\n attachment.metadata.name === selectedAttachment.value?.metadata.name\n );\n\n if (index === undefined) return;\n\n if (index < data.value?.length - 1) {\n selectedAttachment.value = data.value[index + 1];\n return;\n }\n\n if (index === data.value.length - 1 && hasNext.value) {\n page.value++;\n await nextTick();\n await refetch();\n selectedAttachment.value = data.value[0];\n }\n };\n\n const handleDeleteInBatch = () => {\n Dialog.warning({\n title: t(\"core.attachment.operations.delete_in_batch.title\"),\n description: t(\"core.common.dialog.descriptions.cannot_be_recovered\"),\n confirmType: \"danger\",\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n const promises = Array.from(selectedAttachmentNames.value).map(\n (name) => {\n return coreApiClient.storage.attachment.deleteAttachment({\n name,\n });\n }\n );\n await Promise.all(promises);\n selectedAttachmentNames.value.clear();\n\n Toast.success(t(\"core.common.toast.delete_success\"));\n } catch (e) {\n console.error(\"Failed to delete attachments\", e);\n } finally {\n await refetch();\n }\n },\n });\n };\n\n const handleCheckAll = (checkAll: boolean) => {\n if (checkAll) {\n data.value?.forEach((attachment) => {\n selectedAttachmentNames.value.add(attachment.metadata.name);\n });\n } else {\n selectedAttachmentNames.value.clear();\n }\n };\n\n const handleSelect = async (attachment: Attachment | undefined) => {\n if (!attachment) return;\n if (selectedAttachmentNames.value.has(attachment.metadata.name)) {\n selectedAttachmentNames.value.delete(attachment.metadata.name);\n return;\n }\n selectedAttachmentNames.value.add(attachment.metadata.name);\n };\n\n watch(\n () => selectedAttachmentNames.value.size,\n (newValue) => {\n checkedAll.value = newValue === data.value?.length;\n }\n );\n\n const isChecked = (attachment: Attachment) => {\n return selectedAttachmentNames.value.has(attachment.metadata.name);\n };\n\n const handleReset = () => {\n page.value = 1;\n selectedAttachment.value = undefined;\n selectedAttachmentNames.value.clear();\n checkedAll.value = false;\n };\n\n const selectedAttachments = computed(() => {\n return (\n data.value?.filter((attachment) =>\n selectedAttachmentNames.value.has(attachment.metadata.name)\n ) || []\n );\n });\n\n return {\n attachments: data,\n isLoading,\n isFetching,\n selectedAttachment,\n selectedAttachments,\n selectedAttachmentNames,\n checkedAll,\n total,\n handleFetchAttachments: refetch,\n handleSelectPrevious,\n handleSelectNext,\n handleDeleteInBatch,\n handleCheckAll,\n handleSelect,\n isChecked,\n handleReset,\n };\n}\n" }, { "path": "ui/console-src/modules/contents/attachments/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconFolder } from \"@halo-dev/components\";\nimport { definePlugin, utils } from \"@halo-dev/ui-shared\";\nimport { defineAsyncComponent, markRaw } from \"vue\";\n\ndeclare module \"vue\" {\n interface GlobalComponents {\n AttachmentSelectorModal:\n | (typeof import(\"@console/modules/contents/attachments/components/AttachmentSelectorModal.vue\"))[\"default\"]\n | (typeof import(\"@uc/modules/contents/attachments/components/AttachmentSelectorModal.vue\"))[\"default\"];\n }\n}\n\nexport default definePlugin({\n components: {\n AttachmentSelectorModal: defineAsyncComponent({\n loader: () => {\n if (utils.permission.has([\"system:attachments:manage\"])) {\n return import(\"@console/modules/contents/attachments/components/AttachmentSelectorModal.vue\");\n }\n return import(\"@uc/modules/contents/attachments/components/AttachmentSelectorModal.vue\");\n },\n }),\n },\n routes: [\n {\n path: \"/attachments\",\n name: \"AttachmentsRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.attachment.title\",\n permissions: [\"system:attachments:view\"],\n menu: {\n name: \"core.sidebar.menu.items.attachments\",\n group: \"content\",\n icon: markRaw(IconFolder),\n priority: 3,\n mobile: true,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Attachments\",\n component: () => import(\"./AttachmentList.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/contents/comments/CommentList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/CommentDetailModal.vue", "content": "\n\n\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/CommentEditor.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/CommentListItem.vue", "content": "\n\n\n \n \n \n \n \n\n \n \n\n" }, { "path": "ui/console-src/modules/contents/comments/components/DefaultCommentContent.vue", "content": "\n\n\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/DefaultCommentEditor.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/OwnerButton.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/ReplyCreationModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/ReplyDetailModal.vue", "content": "\n\n\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/ReplyListItem.vue", "content": "\n\n\n \n\n" }, { "path": "ui/console-src/modules/contents/comments/components/SubjectQueryCommentList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/comments/components/SubjectQueryCommentListModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/comments/composables/use-comment-last-readtime-mutate.ts", "content": "import { coreApiClient, type ListedComment } from \"@halo-dev/api-client\";\nimport { useMutation, useQueryClient } from \"@tanstack/vue-query\";\n\nexport const useCommentLastReadTimeMutate = (comment: ListedComment) => {\n const queryClient = useQueryClient();\n return useMutation({\n mutationKey: [\"update-comment-last-read-time\"],\n mutationFn: async () => {\n const { data } = await coreApiClient.content.comment.patchComment(\n {\n name: comment.comment.metadata.name,\n jsonPatchInner: [\n {\n op: \"add\",\n path: \"/spec/lastReadTime\",\n value: new Date().toISOString(),\n },\n ],\n },\n {\n mute: true,\n }\n );\n if (data.status?.unreadReplyCount) {\n throw new Error(\"Unread reply count is not 0, retry\");\n }\n return data;\n },\n retry: 5,\n onSuccess: () => {\n queryClient.invalidateQueries({ queryKey: [\"core:comments\"] });\n },\n });\n};\n" }, { "path": "ui/console-src/modules/contents/comments/composables/use-comments-fetch.ts", "content": "import { consoleApiClient, type ListedCommentList } from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport type { Ref } from \"vue\";\n\nexport default function useCommentsFetch(\n queryKey: string,\n page: Ref,\n size: Ref,\n approved: Ref,\n sort: Ref,\n user: Ref,\n keyword: Ref,\n subjectRefKey?: Ref\n) {\n return useQuery({\n queryKey: [\n queryKey,\n page,\n size,\n approved,\n sort,\n user,\n keyword,\n subjectRefKey,\n ],\n queryFn: async () => {\n const fieldSelectorMap: Record = {\n \"spec.approved\": approved.value,\n \"spec.subjectRef\": subjectRefKey?.value,\n };\n\n const fieldSelector = Object.entries(fieldSelectorMap)\n .map(([key, value]) => {\n if (value !== undefined) {\n return `${key}=${value}`;\n }\n })\n .filter(Boolean) as string[];\n\n const defaultSort = [\n \"metadata.creationTimestamp,desc\",\n \"status.lastReplyTime,desc\",\n ];\n\n const { data } = await consoleApiClient.content.comment.listComments({\n fieldSelector,\n page: page.value,\n size: size.value,\n sort: sort.value ? [sort.value] : defaultSort,\n keyword: keyword.value,\n ownerName: user.value,\n ownerKind: user.value ? \"User\" : undefined,\n });\n\n return data;\n },\n refetchInterval(data) {\n const hasDeletingData = data?.items.some(\n (comment) => !!comment.comment.metadata.deletionTimestamp\n );\n return hasDeletingData ? 1000 : false;\n },\n });\n}\n" }, { "path": "ui/console-src/modules/contents/comments/composables/use-content-provider-extension-point.ts", "content": "import type { CommentContentProvider } from \"@halo-dev/ui-shared\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { markRaw } from \"vue\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\nimport DefaultCommentContent from \"../components/DefaultCommentContent.vue\";\n\nexport function useContentProviderExtensionPoint() {\n const defaultProvider: CommentContentProvider = {\n component: markRaw(DefaultCommentContent),\n };\n\n const { pluginModules } = usePluginModuleStore();\n\n return useQuery({\n queryKey: [\"core:comment:list-item:content:provider\"],\n queryFn: async () => {\n const result: CommentContentProvider[] = [];\n for (const pluginModule of pluginModules) {\n const callbackFunction =\n pluginModule?.extensionPoints?.[\"comment:list-item:content:replace\"];\n\n if (typeof callbackFunction !== \"function\") {\n continue;\n }\n\n const item = await callbackFunction();\n\n result.push(item);\n }\n\n if (result.length) {\n return result[0];\n }\n\n return defaultProvider;\n },\n });\n}\n" }, { "path": "ui/console-src/modules/contents/comments/composables/use-subject-ref.ts", "content": "import type {\n Extension,\n ListedComment,\n Post,\n SinglePage,\n} from \"@halo-dev/api-client\";\nimport type {\n CommentSubjectRefProvider,\n CommentSubjectRefResult,\n} from \"@halo-dev/ui-shared\";\nimport { computed, onMounted, shallowRef } from \"vue\";\nimport { useI18n } from \"vue-i18n\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\n\nexport function useSubjectRef(comment: ListedComment) {\n const { t } = useI18n();\n\n const SubjectRefProviders = shallowRef([\n {\n kind: \"Post\",\n group: \"content.halo.run\",\n resolve: (subject: Extension): CommentSubjectRefResult => {\n const post = subject as Post;\n return {\n label: t(\"core.comment.subject_refs.post\"),\n title: post.spec.title,\n externalUrl: post.status?.permalink,\n route: {\n name: \"PostEditor\",\n query: {\n name: post.metadata.name,\n },\n },\n };\n },\n },\n {\n kind: \"SinglePage\",\n group: \"content.halo.run\",\n resolve: (subject: Extension): CommentSubjectRefResult => {\n const singlePage = subject as SinglePage;\n return {\n label: t(\"core.comment.subject_refs.page\"),\n title: singlePage.spec.title,\n externalUrl: singlePage.status?.permalink,\n route: {\n name: \"SinglePageEditor\",\n query: {\n name: singlePage.metadata.name,\n },\n },\n };\n },\n },\n ]);\n\n const { pluginModules } = usePluginModuleStore();\n\n onMounted(() => {\n for (const pluginModule of pluginModules) {\n const callbackFunction =\n pluginModule?.extensionPoints?.[\"comment:subject-ref:create\"];\n\n if (typeof callbackFunction !== \"function\") {\n continue;\n }\n\n const providers = callbackFunction();\n\n SubjectRefProviders.value = [...SubjectRefProviders.value, ...providers];\n }\n });\n\n const subjectRefResult = computed(() => {\n const { subject } = comment;\n if (!subject) {\n return {\n label: t(\"core.comment.subject_refs.unknown\"),\n title: t(\"core.comment.subject_refs.unknown\"),\n };\n }\n const subjectRef = SubjectRefProviders.value.find(\n (provider) =>\n provider.kind === subject.kind &&\n subject.apiVersion.startsWith(provider.group)\n );\n if (!subjectRef) {\n return {\n label: t(\"core.comment.subject_refs.unknown\"),\n title: t(\"core.comment.subject_refs.unknown\"),\n };\n }\n return subjectRef.resolve(subject);\n });\n\n return {\n subjectRefResult,\n };\n}\n" }, { "path": "ui/console-src/modules/contents/comments/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconMessage, VLoading } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { defineAsyncComponent, markRaw } from \"vue\";\nimport SubjectQueryCommentListModal from \"./components/SubjectQueryCommentListModal.vue\";\n\ndeclare module \"vue\" {\n interface GlobalComponents {\n SubjectQueryCommentList: (typeof import(\"./components/SubjectQueryCommentList.vue\"))[\"default\"];\n SubjectQueryCommentListModal: (typeof import(\"./components/SubjectQueryCommentListModal.vue\"))[\"default\"];\n }\n}\n\nexport default definePlugin({\n components: {\n SubjectQueryCommentList: defineAsyncComponent({\n loader: () => import(\"./components/SubjectQueryCommentList.vue\"),\n loadingComponent: VLoading,\n }),\n SubjectQueryCommentListModal,\n },\n routes: [\n {\n path: \"/comments\",\n name: \"CommentsRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.comment.title\",\n searchable: true,\n permissions: [\"system:comments:view\"],\n menu: {\n name: \"core.sidebar.menu.items.comments\",\n group: \"content\",\n icon: markRaw(IconMessage),\n priority: 2,\n mobile: true,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Comments\",\n component: () => import(\"./CommentList.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/contents/pages/DeletedSinglePageList.vue", "content": "\n\n\n \n \n \n \n {{ $t(\"core.common.buttons.delete_permanently\") }}\n \n \n {{ $t(\"core.common.buttons.restore\") }}\n \n \n \n \n \n\n \n \n \n\n" }, { "path": "ui/console-src/modules/contents/pages/SinglePageEditor.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/SinglePageList.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/SinglePageSnapshots.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/SinglePageListItem.vue", "content": "\n\n\n \n \n \n \n \n \n\n" }, { "path": "ui/console-src/modules/contents/pages/components/SinglePageSettingModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/entity-fields/ContributorsField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/entity-fields/CoverField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/entity-fields/PublishStatusField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/entity-fields/PublishTimeField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/entity-fields/TitleField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/components/entity-fields/VisibleField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/pages/composables/use-page-update-mutate.ts", "content": "import type { SinglePage } from \"@halo-dev/api-client\";\nimport { coreApiClient } from \"@halo-dev/api-client\";\nimport { Toast } from \"@halo-dev/components\";\nimport { useMutation } from \"@tanstack/vue-query\";\nimport { useI18n } from \"vue-i18n\";\n\nexport function usePageUpdateMutate() {\n const { t } = useI18n();\n return useMutation({\n mutationKey: [\"singlePage-update\"],\n mutationFn: async (page: SinglePage) => {\n const { data: latestSinglePage } =\n await coreApiClient.content.singlePage.getSinglePage({\n name: page.metadata.name,\n });\n\n return coreApiClient.content.singlePage.updateSinglePage(\n {\n name: page.metadata.name,\n singlePage: {\n ...latestSinglePage,\n spec: page.spec,\n metadata: {\n ...latestSinglePage.metadata,\n annotations: page.metadata.annotations,\n },\n },\n },\n {\n mute: true,\n }\n );\n },\n retry: 3,\n onError: (error) => {\n console.error(\"Failed to update singlePage\", error);\n Toast.error(t(\"core.common.toast.server_internal_error\"));\n },\n });\n}\n" }, { "path": "ui/console-src/modules/contents/pages/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconPages } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n routes: [\n {\n path: \"/single-pages\",\n name: \"SinglePagesRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.page.title\",\n searchable: true,\n permissions: [\"system:singlepages:view\"],\n menu: {\n name: \"core.sidebar.menu.items.single_pages\",\n group: \"content\",\n icon: markRaw(IconPages),\n priority: 1,\n },\n },\n children: [\n {\n path: \"\",\n name: \"SinglePages\",\n component: () => import(\"./SinglePageList.vue\"),\n },\n {\n path: \"deleted\",\n name: \"DeletedSinglePages\",\n component: () => import(\"./DeletedSinglePageList.vue\"),\n meta: {\n title: \"core.deleted_page.title\",\n searchable: true,\n permissions: [\"system:singlepages:view\"],\n },\n },\n {\n path: \"editor\",\n name: \"SinglePageEditor\",\n component: () => import(\"./SinglePageEditor.vue\"),\n meta: {\n title: \"core.page_editor.title\",\n searchable: true,\n hideFooter: true,\n permissions: [\"system:singlepages:manage\"],\n },\n },\n ],\n },\n {\n path: \"/single-pages/snapshots\",\n name: \"SinglePageSnapshots\",\n component: () => import(\"./SinglePageSnapshots.vue\"),\n meta: {\n title: \"core.page_snapshots.title\",\n searchable: false,\n hideFooter: true,\n permissions: [\"system:singlepages:manage\"],\n },\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/contents/posts/DeletedPostList.vue", "content": "\n\n \n \n \n \n {{ $t(\"core.common.buttons.delete_permanently\") }}\n \n \n {{ $t(\"core.common.buttons.restore\") }}\n \n \n \n \n \n\n \n \n \n\n" }, { "path": "ui/console-src/modules/contents/posts/PostEditor.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/PostList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/PostSnapshots.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/categories/CategoryList.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/categories/components/CategoryEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/categories/components/CategoryListItem.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/categories/components/__tests__/CategoryEditingModal.spec.ts", "content": "import messages from \"@intlify/unplugin-vue-i18n/messages\";\nimport { VueQueryPlugin } from \"@tanstack/vue-query\";\nimport { mount } from \"@vue/test-utils\";\nimport { createPinia, setActivePinia } from \"pinia\";\nimport { beforeEach, describe, expect, it } from \"vitest\";\nimport { createI18n } from \"vue-i18n\";\nimport CategoryEditingModal from \"../CategoryEditingModal.vue\";\n\ndescribe(\"CategoryEditingModal\", function () {\n beforeEach(() => {\n setActivePinia(createPinia());\n });\n\n it(\"should render\", function () {\n expect(\n mount(CategoryEditingModal, {\n global: {\n plugins: [\n createI18n({\n legacy: false,\n locale: \"en\",\n messages,\n }),\n VueQueryPlugin,\n ],\n },\n })\n ).toBeDefined();\n });\n});\n" }, { "path": "ui/console-src/modules/contents/posts/categories/composables/use-post-category.ts", "content": "import {\n coreApiClient,\n paginate,\n type Category,\n type CategoryV1alpha1ApiListCategoryRequest,\n} from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { ref } from \"vue\";\nimport { buildCategoriesTree, type CategoryTreeNode } from \"../utils\";\n\nexport function usePostCategory() {\n const categoriesTree = ref([] as CategoryTreeNode[]);\n\n const {\n data: categories,\n isLoading,\n refetch,\n } = useQuery({\n queryKey: [\"post-categories\"],\n queryFn: async () => {\n return await paginate(\n (params) => coreApiClient.content.category.listCategory(params),\n {\n size: 1000,\n sort: [\"metadata.creationTimestamp,desc\"],\n }\n );\n },\n refetchInterval(data) {\n const hasAbnormalCategory = data?.some(\n (category) =>\n !!category.metadata.deletionTimestamp || !category.status?.permalink\n );\n return hasAbnormalCategory ? 1000 : false;\n },\n onSuccess(data) {\n categoriesTree.value = buildCategoriesTree(data);\n },\n });\n\n return {\n categories,\n categoriesTree,\n isLoading,\n handleFetchCategories: refetch,\n };\n}\n" }, { "path": "ui/console-src/modules/contents/posts/categories/utils/__tests__/index.spec.ts", "content": "import type { Category } from \"@halo-dev/api-client\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n buildCategoriesTree,\n convertCategoryTreeToCategory,\n convertTreeToCategories,\n getCategoryPath,\n resetCategoriesTreePriority,\n sortCategoriesTree,\n type CategoryTreeNode,\n} from \"../index\";\n\nfunction createMockCategory(\n name: string,\n priority = 0,\n children: string[] = []\n): Category {\n return {\n metadata: {\n name,\n annotations: {},\n labels: {},\n version: 1,\n creationTimestamp: new Date().toISOString(),\n },\n apiVersion: \"content.halo.run/v1alpha1\",\n kind: \"Category\",\n spec: {\n displayName: `Category ${name}`,\n slug: name,\n description: `Description for ${name}`,\n cover: \"\",\n template: \"\",\n priority: priority,\n children: children,\n },\n };\n}\n\nfunction createMockCategoryTreeNode(\n name: string,\n priority = 0,\n children: CategoryTreeNode[] = []\n): CategoryTreeNode {\n return {\n metadata: {\n name,\n annotations: {},\n labels: {},\n version: 1,\n creationTimestamp: new Date().toISOString(),\n },\n apiVersion: \"content.halo.run/v1alpha1\",\n kind: \"Category\",\n spec: {\n displayName: `Category ${name}`,\n slug: name,\n description: `Description for ${name}`,\n cover: \"\",\n template: \"\",\n priority: priority,\n children: children.map((child) => child.metadata.name),\n },\n children: children,\n };\n}\n\ndescribe(\"buildCategoriesTree\", () => {\n it(\"should convert flat category array to tree structure\", () => {\n // Prepare test data\n const categories: Category[] = [\n createMockCategory(\"parent1\", 0, [\"child1\", \"child2\"]),\n createMockCategory(\"child1\", 0),\n createMockCategory(\"child2\", 1),\n createMockCategory(\"parent2\", 1, [\"child3\"]),\n createMockCategory(\"child3\", 0),\n ];\n\n // Execute test\n const result = buildCategoriesTree(categories);\n\n // Verify results\n expect(result.length).toBe(2); // Should have two root nodes\n expect(result[0].metadata.name).toBe(\"parent1\"); // First root node should be parent1\n expect(result[1].metadata.name).toBe(\"parent2\"); // Second root node should be parent2\n expect(result[0].children.length).toBe(2); // parent1 should have two children\n expect(result[1].children.length).toBe(1); // parent2 should have one child\n expect(result[0].children[0].metadata.name).toBe(\"child1\");\n expect(result[0].children[1].metadata.name).toBe(\"child2\");\n expect(result[1].children[0].metadata.name).toBe(\"child3\");\n });\n\n it(\"should handle empty array input\", () => {\n const result = buildCategoriesTree([]);\n expect(result).toEqual([]);\n });\n\n it(\"should handle categories without parent-child relationships\", () => {\n const categories: Category[] = [\n createMockCategory(\"category1\", 0),\n createMockCategory(\"category2\", 1),\n createMockCategory(\"category3\", 2),\n ];\n\n const result = buildCategoriesTree(categories);\n\n expect(result.length).toBe(3);\n expect(result.every((node) => node.children.length === 0)).toBe(true);\n });\n\n it(\"should handle multi-level nested category structure\", () => {\n const categories: Category[] = [\n createMockCategory(\"root\", 0, [\"level1\"]),\n createMockCategory(\"level1\", 0, [\"level2\"]),\n createMockCategory(\"level2\", 0, [\"level3\"]),\n createMockCategory(\"level3\", 0),\n ];\n\n const result = buildCategoriesTree(categories);\n\n expect(result.length).toBe(1);\n expect(result[0].metadata.name).toBe(\"root\");\n expect(result[0].children[0].metadata.name).toBe(\"level1\");\n expect(result[0].children[0].children[0].metadata.name).toBe(\"level2\");\n expect(result[0].children[0].children[0].children[0].metadata.name).toBe(\n \"level3\"\n );\n });\n});\n\ndescribe(\"sortCategoriesTree\", () => {\n it(\"should sort category tree by priority\", () => {\n const categoriesTree: CategoryTreeNode[] = [\n createMockCategoryTreeNode(\"node3\", 2),\n createMockCategoryTreeNode(\"node1\", 0),\n createMockCategoryTreeNode(\"node2\", 1),\n ];\n\n const result = sortCategoriesTree(categoriesTree);\n\n expect(result[0].metadata.name).toBe(\"node1\");\n expect(result[1].metadata.name).toBe(\"node2\");\n expect(result[2].metadata.name).toBe(\"node3\");\n });\n\n it(\"should recursively sort child nodes\", () => {\n const categoriesTree: CategoryTreeNode[] = [\n createMockCategoryTreeNode(\"parent1\", 0, [\n createMockCategoryTreeNode(\"child3\", 2),\n createMockCategoryTreeNode(\"child1\", 0),\n createMockCategoryTreeNode(\"child2\", 1),\n ]),\n ];\n\n const result = sortCategoriesTree(categoriesTree);\n\n expect(result[0].children[0].metadata.name).toBe(\"child1\");\n expect(result[0].children[1].metadata.name).toBe(\"child2\");\n expect(result[0].children[2].metadata.name).toBe(\"child3\");\n });\n\n it(\"should handle empty array input\", () => {\n const result = sortCategoriesTree([]);\n expect(result).toEqual([]);\n });\n});\n\ndescribe(\"resetCategoriesTreePriority\", () => {\n it(\"should reset priority values of all nodes in the tree\", () => {\n const categoriesTree: CategoryTreeNode[] = [\n createMockCategoryTreeNode(\"node1\", 5),\n createMockCategoryTreeNode(\"node2\", 10),\n createMockCategoryTreeNode(\"node3\", 15),\n ];\n\n const result = resetCategoriesTreePriority(categoriesTree);\n\n expect(result[0].spec.priority).toBe(0);\n expect(result[1].spec.priority).toBe(1);\n expect(result[2].spec.priority).toBe(2);\n });\n\n it(\"should recursively reset child node priorities\", () => {\n const categoriesTree: CategoryTreeNode[] = [\n createMockCategoryTreeNode(\"parent\", 5, [\n createMockCategoryTreeNode(\"child1\", 10),\n createMockCategoryTreeNode(\"child2\", 15),\n ]),\n ];\n\n const result = resetCategoriesTreePriority(categoriesTree);\n\n expect(result[0].spec.priority).toBe(0);\n expect(result[0].children[0].spec.priority).toBe(0);\n expect(result[0].children[1].spec.priority).toBe(1);\n });\n\n it(\"should handle empty array input\", () => {\n const result = resetCategoriesTreePriority([]);\n expect(result).toEqual([]);\n });\n});\n\ndescribe(\"convertTreeToCategories\", () => {\n it(\"should convert tree structure back to flat category array\", () => {\n const child1 = createMockCategoryTreeNode(\"child1\", 0);\n const child2 = createMockCategoryTreeNode(\"child2\", 1);\n const parent = createMockCategoryTreeNode(\"parent\", 0, [child1, child2]);\n const categoriesTree: CategoryTreeNode[] = [parent];\n\n const result = convertTreeToCategories(categoriesTree);\n\n expect(result.length).toBe(3);\n\n // Verify parent node\n const parentCategory = result.find((c) => c.metadata.name === \"parent\");\n expect(parentCategory).toBeDefined();\n expect(parentCategory?.spec.children).toContain(\"child1\");\n expect(parentCategory?.spec.children).toContain(\"child2\");\n\n // Verify child nodes\n const child1Category = result.find((c) => c.metadata.name === \"child1\");\n const child2Category = result.find((c) => c.metadata.name === \"child2\");\n expect(child1Category).toBeDefined();\n expect(child2Category).toBeDefined();\n expect(child1Category?.spec.children).toEqual([]);\n expect(child2Category?.spec.children).toEqual([]);\n });\n\n it(\"should handle multi-level nested structure\", () => {\n const level3 = createMockCategoryTreeNode(\"level3\", 0);\n const level2 = createMockCategoryTreeNode(\"level2\", 0, [level3]);\n const level1 = createMockCategoryTreeNode(\"level1\", 0, [level2]);\n const root = createMockCategoryTreeNode(\"root\", 0, [level1]);\n const categoriesTree: CategoryTreeNode[] = [root];\n\n const result = convertTreeToCategories(categoriesTree);\n\n expect(result.length).toBe(4);\n\n const rootCategory = result.find((c) => c.metadata.name === \"root\");\n const level1Category = result.find((c) => c.metadata.name === \"level1\");\n const level2Category = result.find((c) => c.metadata.name === \"level2\");\n const level3Category = result.find((c) => c.metadata.name === \"level3\");\n\n expect(rootCategory?.spec.children).toContain(\"level1\");\n expect(level1Category?.spec.children).toContain(\"level2\");\n expect(level2Category?.spec.children).toContain(\"level3\");\n expect(level3Category?.spec.children).toEqual([]);\n });\n\n it(\"should handle empty array input\", () => {\n const result = convertTreeToCategories([]);\n expect(result).toEqual([]);\n });\n});\n\ndescribe(\"convertCategoryTreeToCategory\", () => {\n it(\"should convert a single tree node to a category object\", () => {\n const child1 = createMockCategoryTreeNode(\"child1\", 0);\n const child2 = createMockCategoryTreeNode(\"child2\", 1);\n const parent = createMockCategoryTreeNode(\"parent\", 0, [child1, child2]);\n\n const result = convertCategoryTreeToCategory(parent);\n\n expect(result.metadata.name).toBe(\"parent\");\n expect(result.spec.children).toContain(\"child1\");\n expect(result.spec.children).toContain(\"child2\");\n expect(result.spec.children?.length).toBe(2);\n // eslint-disable-next-line\n expect((result as any).children).toBeUndefined();\n });\n\n it(\"should handle nodes without children\", () => {\n const node = createMockCategoryTreeNode(\"node\", 0);\n\n const result = convertCategoryTreeToCategory(node);\n\n expect(result.metadata.name).toBe(\"node\");\n expect(result.spec.children).toEqual([]);\n });\n});\n\ndescribe(\"getCategoryPath\", () => {\n it(\"should return path from root to specified category\", () => {\n const level3 = createMockCategoryTreeNode(\"level3\", 0);\n const level2 = createMockCategoryTreeNode(\"level2\", 0, [level3]);\n const level1 = createMockCategoryTreeNode(\"level1\", 0, [level2]);\n const root = createMockCategoryTreeNode(\"root\", 0, [level1]);\n const categoriesTree: CategoryTreeNode[] = [root];\n\n const result = getCategoryPath(categoriesTree, \"level3\");\n\n expect(result).toBeDefined();\n expect(result?.length).toBe(4);\n expect(result?.[0].metadata.name).toBe(\"root\");\n expect(result?.[1].metadata.name).toBe(\"level1\");\n expect(result?.[2].metadata.name).toBe(\"level2\");\n expect(result?.[3].metadata.name).toBe(\"level3\");\n });\n\n it(\"should handle case when category is not found\", () => {\n const categoriesTree: CategoryTreeNode[] = [\n createMockCategoryTreeNode(\"node1\", 0),\n createMockCategoryTreeNode(\"node2\", 1),\n ];\n\n const result = getCategoryPath(categoriesTree, \"nonexistent\");\n\n expect(result).toBeUndefined();\n });\n\n it(\"should handle multiple branches\", () => {\n const child1 = createMockCategoryTreeNode(\"child1\", 0);\n const child2 = createMockCategoryTreeNode(\"child2\", 1);\n const target = createMockCategoryTreeNode(\"target\", 0);\n const branch1 = createMockCategoryTreeNode(\"branch1\", 0, [child1, child2]);\n const branch2 = createMockCategoryTreeNode(\"branch2\", 1, [target]);\n const root = createMockCategoryTreeNode(\"root\", 0, [branch1, branch2]);\n const categoriesTree: CategoryTreeNode[] = [root];\n\n const result = getCategoryPath(categoriesTree, \"target\");\n\n expect(result).toBeDefined();\n expect(result?.length).toBe(3);\n expect(result?.[0].metadata.name).toBe(\"root\");\n expect(result?.[1].metadata.name).toBe(\"branch2\");\n expect(result?.[2].metadata.name).toBe(\"target\");\n });\n\n it(\"should handle empty array input\", () => {\n const result = getCategoryPath([], \"any\");\n expect(result).toBeUndefined();\n });\n});\n" }, { "path": "ui/console-src/modules/contents/posts/categories/utils/index.ts", "content": "import type { Category } from \"@halo-dev/api-client\";\nimport { cloneDeep } from \"es-toolkit\";\n\nexport interface CategoryTreeNode extends Category {\n children: CategoryTreeNode[];\n}\n\nexport function buildCategoriesTree(\n categories: Category[]\n): CategoryTreeNode[] {\n const categoriesToUpdate = cloneDeep(categories);\n\n const categoriesMap: Record = {};\n const parentMap: Record = {};\n\n categoriesToUpdate.forEach((category) => {\n categoriesMap[category.metadata.name] = {\n ...category,\n children: [],\n } as CategoryTreeNode;\n\n if (category.spec.children) {\n category.spec.children.forEach((child) => {\n parentMap[child] = category.metadata.name;\n });\n }\n });\n\n categoriesToUpdate.forEach((category) => {\n const parentName = parentMap[category.metadata.name];\n if (parentName && categoriesMap[parentName]) {\n categoriesMap[parentName].children.push(\n categoriesMap[category.metadata.name]\n );\n }\n });\n\n const categoriesTree = Object.values(categoriesMap).filter(\n (node) => parentMap[node.metadata.name] === undefined\n );\n\n return sortCategoriesTree(categoriesTree);\n}\n\nexport function sortCategoriesTree(\n categoriesTree: CategoryTreeNode[]\n): CategoryTreeNode[] {\n return categoriesTree\n .sort((a, b) => {\n if (a.spec.priority < b.spec.priority) {\n return -1;\n }\n if (a.spec.priority > b.spec.priority) {\n return 1;\n }\n return 0;\n })\n .map((category) => {\n if (category.children && category.children.length) {\n return {\n ...category,\n children: sortCategoriesTree(category.children),\n };\n }\n return category;\n });\n}\n\nexport function resetCategoriesTreePriority(\n categoriesTree: CategoryTreeNode[]\n): CategoryTreeNode[] {\n for (let i = 0; i < categoriesTree.length; i++) {\n categoriesTree[i].spec.priority = i;\n if (categoriesTree[i].children && categoriesTree[i].children.length) {\n resetCategoriesTreePriority(categoriesTree[i].children);\n }\n }\n return categoriesTree;\n}\n\nexport function convertTreeToCategories(categoriesTree: CategoryTreeNode[]) {\n const categories: Category[] = [];\n const categoriesMap = new Map();\n\n const convertCategory = (node: CategoryTreeNode | undefined) => {\n if (!node) {\n return;\n }\n\n const children = node.children || [];\n\n categoriesMap.set(node.metadata.name, {\n ...node,\n spec: {\n ...node.spec,\n children: children.map((child) => child.metadata.name),\n },\n });\n\n children.forEach((child) => {\n convertCategory(child);\n });\n };\n\n categoriesTree.forEach((node) => {\n convertCategory(node);\n });\n\n categoriesMap.forEach((node) => {\n categories.push(node);\n });\n\n return categories;\n}\n\nexport function convertCategoryTreeToCategory(\n categoryTree: CategoryTreeNode\n): Category {\n const childNames = categoryTree.children.map((child) => child.metadata.name);\n\n const { children: _, ...categoryWithoutChildren } = categoryTree;\n\n return {\n ...categoryWithoutChildren,\n spec: {\n ...categoryTree.spec,\n children: childNames,\n },\n };\n}\n\nexport const getCategoryPath = (\n categories: CategoryTreeNode[],\n name: string,\n path: CategoryTreeNode[] = []\n): CategoryTreeNode[] | undefined => {\n for (const category of categories) {\n if (category.metadata && category.metadata.name === name) {\n return path.concat([category]);\n }\n\n if (category.children && category.children.length) {\n const found = getCategoryPath(\n category.children,\n name,\n path.concat([category])\n );\n if (found) {\n return found;\n }\n }\n }\n};\n" }, { "path": "ui/console-src/modules/contents/posts/components/PostBatchSettingModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/PostListItem.vue", "content": "\n\n\n \n\n" }, { "path": "ui/console-src/modules/contents/posts/components/PostSettingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/__tests__/PostSettingModal.spec.ts", "content": "import messages from \"@intlify/unplugin-vue-i18n/messages\";\nimport { VueQueryPlugin } from \"@tanstack/vue-query\";\nimport { mount } from \"@vue/test-utils\";\nimport { createPinia, setActivePinia } from \"pinia\";\nimport { beforeEach, describe, expect, it } from \"vitest\";\nimport { createI18n } from \"vue-i18n\";\nimport PostSettingModal from \"../PostSettingModal.vue\";\n\ndescribe(\"PostSettingModal\", () => {\n beforeEach(() => {\n setActivePinia(createPinia());\n });\n\n it(\"should render\", () => {\n const wrapper = mount(\n {\n components: {\n PostSettingModal,\n },\n template: ``,\n },\n {\n global: {\n plugins: [\n VueQueryPlugin,\n createI18n({\n legacy: false,\n locale: \"en\",\n messages,\n }),\n ],\n },\n }\n );\n expect(wrapper).toBeDefined();\n });\n});\n" }, { "path": "ui/console-src/modules/contents/posts/components/entity-fields/ContributorsField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/entity-fields/CoverField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/entity-fields/PublishStatusField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/entity-fields/PublishTimeField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/entity-fields/TitleField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/components/entity-fields/VisibleField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/contents/posts/composables/use-post-update-mutate.ts", "content": "import type { Post } from \"@halo-dev/api-client\";\nimport { coreApiClient } from \"@halo-dev/api-client\";\nimport { Toast } from \"@halo-dev/components\";\nimport { useMutation } from \"@tanstack/vue-query\";\nimport { useI18n } from \"vue-i18n\";\n\nexport function usePostUpdateMutate() {\n const { t } = useI18n();\n\n return useMutation({\n mutationKey: [\"post-update\"],\n mutationFn: async (post: Post) => {\n const { data: latestPost } = await coreApiClient.content.post.getPost({\n name: post.metadata.name,\n });\n\n return await coreApiClient.content.post.updatePost(\n {\n name: post.metadata.name,\n post: {\n ...latestPost,\n spec: post.spec,\n metadata: {\n ...latestPost.metadata,\n annotations: post.metadata.annotations,\n },\n },\n },\n {\n mute: true,\n }\n );\n },\n retry: 3,\n onError: (error) => {\n console.error(\"Failed to update post\", error);\n Toast.error(t(\"core.common.toast.server_internal_error\"));\n },\n });\n}\n" }, { "path": "ui/console-src/modules/contents/posts/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport BlankLayout from \"@console/layouts/BlankLayout.vue\";\nimport { IconBookRead } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n routes: [\n {\n path: \"/posts\",\n name: \"PostsRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.post.title\",\n searchable: true,\n permissions: [\"system:posts:view\"],\n menu: {\n name: \"core.sidebar.menu.items.posts\",\n group: \"content\",\n icon: markRaw(IconBookRead),\n priority: 0,\n mobile: true,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Posts\",\n component: () => import(\"./PostList.vue\"),\n },\n {\n path: \"deleted\",\n name: \"DeletedPosts\",\n component: () => import(\"./DeletedPostList.vue\"),\n meta: {\n title: \"core.deleted_post.title\",\n searchable: true,\n permissions: [\"system:posts:view\"],\n },\n },\n {\n path: \"editor\",\n name: \"PostEditor\",\n component: () => import(\"./PostEditor.vue\"),\n meta: {\n title: \"core.post_editor.title\",\n searchable: true,\n hideFooter: true,\n permissions: [\"system:posts:manage\"],\n },\n },\n {\n path: \"categories\",\n component: BlankLayout,\n children: [\n {\n path: \"\",\n name: \"Categories\",\n component: () => import(\"./categories/CategoryList.vue\"),\n meta: {\n title: \"core.post_category.title\",\n searchable: true,\n permissions: [\"system:posts:view\"],\n },\n },\n ],\n },\n {\n path: \"tags\",\n component: BlankLayout,\n children: [\n {\n path: \"\",\n name: \"Tags\",\n component: () => import(\"./tags/TagList.vue\"),\n meta: {\n title: \"core.post_tag.title\",\n searchable: true,\n permissions: [\"system:posts:view\"],\n },\n },\n ],\n },\n ],\n },\n {\n path: \"/posts/snapshots\",\n name: \"PostSnapshots\",\n component: () => import(\"./PostSnapshots.vue\"),\n meta: {\n title: \"core.post_snapshots.title\",\n searchable: false,\n hideFooter: true,\n permissions: [\"system:posts:manage\"],\n },\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/contents/posts/tags/TagList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/tags/components/PostTag.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/tags/components/TagEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/tags/components/TagListItem.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/contents/posts/tags/composables/use-post-tag.ts", "content": "import type {\n Tag,\n TagV1alpha1ConsoleApiListPostTagsRequest,\n} from \"@halo-dev/api-client\";\nimport {\n consoleApiClient,\n coreApiClient,\n paginate,\n} from \"@halo-dev/api-client\";\nimport { Dialog, Toast } from \"@halo-dev/components\";\nimport { useQuery, type QueryObserverResult } from \"@tanstack/vue-query\";\nimport { ref, watch, type Ref } from \"vue\";\nimport { useI18n } from \"vue-i18n\";\n\ninterface usePostTagReturn {\n tags: Ref;\n total: Ref;\n hasPrevious: Ref;\n hasNext: Ref;\n isLoading: Ref;\n isFetching: Ref;\n handleFetchTags: () => Promise>;\n handleDelete: (tag: Tag) => void;\n handleDeleteInBatch: (tagNames: string[]) => Promise;\n}\n\nexport function usePostTag(filterOptions?: {\n sort?: Ref;\n page?: Ref;\n size?: Ref;\n keyword?: Ref;\n}): usePostTagReturn {\n const { t } = useI18n();\n\n const { sort, page, size, keyword } = filterOptions || {};\n\n const total = ref(0);\n const hasPrevious = ref(false);\n const hasNext = ref(false);\n\n const {\n data: tags,\n isLoading,\n isFetching,\n refetch,\n } = useQuery({\n queryKey: [\"post-tags\", sort, page, size, keyword],\n queryFn: async () => {\n const { data } = await consoleApiClient.content.tag.listPostTags({\n page: page?.value || 0,\n size: size?.value || 0,\n sort: [sort?.value as string].filter(Boolean) || [\n \"metadata.creationTimestamp,desc\",\n ],\n keyword: keyword?.value,\n });\n\n total.value = data.total;\n hasPrevious.value = data.hasPrevious;\n hasNext.value = data.hasNext;\n\n return data.items;\n },\n refetchInterval(data) {\n const hasAbnormalTag = data?.some(\n (tag) => !!tag.metadata.deletionTimestamp || !tag.status?.permalink\n );\n return hasAbnormalTag ? 1000 : false;\n },\n });\n\n const handleDelete = async (tag: Tag) => {\n Dialog.warning({\n title: t(\"core.post_tag.operations.delete.title\"),\n description: t(\"core.post_tag.operations.delete.description\"),\n confirmType: \"danger\",\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n await coreApiClient.content.tag.deleteTag({\n name: tag.metadata.name,\n });\n\n Toast.success(t(\"core.common.toast.delete_success\"));\n } catch (e) {\n console.error(\"Failed to delete tag\", e);\n } finally {\n await refetch();\n }\n },\n });\n };\n\n const handleDeleteInBatch = (tagNames: string[]) => {\n return new Promise((resolve) => {\n Dialog.warning({\n title: t(\"core.post_tag.operations.delete_in_batch.title\"),\n description: t(\"core.common.dialog.descriptions.cannot_be_recovered\"),\n confirmType: \"danger\",\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n await Promise.all(\n tagNames.map((tagName) => {\n coreApiClient.content.tag.deleteTag({\n name: tagName,\n });\n })\n );\n\n Toast.success(t(\"core.common.toast.delete_success\"));\n resolve();\n } catch (e) {\n console.error(\"Failed to delete tags in batch\", e);\n } finally {\n await refetch();\n }\n },\n });\n });\n };\n\n watch(\n () => [sort?.value, keyword?.value],\n () => {\n if (page?.value) {\n page.value = 1;\n }\n }\n );\n\n return {\n tags,\n total,\n hasPrevious,\n hasNext,\n isLoading,\n isFetching,\n handleFetchTags: refetch,\n handleDelete,\n handleDeleteInBatch,\n };\n}\n\nexport function useAllPostTagsQuery() {\n return useQuery({\n queryKey: [\"core:post-tags:all\"],\n queryFn: async () => {\n return await paginate(\n (params) => consoleApiClient.content.tag.listPostTags(params),\n {\n sort: [\"metadata.creationTimestamp,desc\"],\n size: 1000,\n }\n );\n },\n refetchInterval(data) {\n const hasAbnormalTag = data?.some(\n (tag) => !!tag.metadata.deletionTimestamp || !tag.status?.permalink\n );\n return hasAbnormalTag ? 1000 : false;\n },\n });\n}\n" }, { "path": "ui/console-src/modules/dashboard/Dashboard.vue", "content": "\n\n\n\n" }, { "path": "ui/console-src/modules/dashboard/DashboardDesigner.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/components/ActionButton.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/components/WidgetCard.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/components/WidgetConfigFormModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/components/WidgetEditableItem.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/components/WidgetHubModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/components/WidgetViewItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/composables/use-dashboard-extension-point.ts", "content": "import type { DashboardWidgetDefinition } from \"@halo-dev/ui-shared\";\nimport { onMounted, shallowRef } from \"vue\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\n\nconst EXTENSION_POINT_NAME = \"console:dashboard:widgets:create\";\n\nexport function useDashboardExtensionPoint() {\n const { pluginModuleMap } = usePluginModuleStore();\n\n const widgetDefinitions = shallowRef([]);\n\n onMounted(async () => {\n const finalDefinitions: DashboardWidgetDefinition[] = [];\n for (const [name, module] of Object.entries(pluginModuleMap)) {\n try {\n const callbackFunction =\n module?.extensionPoints?.[EXTENSION_POINT_NAME];\n\n if (typeof callbackFunction !== \"function\") {\n continue;\n }\n\n const definitions = await callbackFunction();\n\n // Reset id\n definitions.forEach((definition) => {\n definition.id = `${name}-${definition.id}`;\n });\n\n finalDefinitions.push(...definitions);\n } catch (error) {\n console.error(`Error processing plugin module:`, name, error);\n }\n }\n widgetDefinitions.value = finalDefinitions;\n });\n\n return { widgetDefinitions };\n}\n" }, { "path": "ui/console-src/modules/dashboard/composables/use-dashboard-widgets-fetch.ts", "content": "import { ucApiClient } from \"@halo-dev/api-client\";\nimport type {\n DashboardResponsiveLayout,\n DashboardWidget,\n} from \"@halo-dev/ui-shared\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { cloneDeep } from \"es-toolkit\";\nimport { computed, ref, type Ref } from \"vue\";\nimport { DefaultResponsiveLayouts } from \"../widgets/defaults\";\n\nexport function useDashboardWidgetsFetch(breakpoint: Ref) {\n const layouts = ref({});\n const layout = ref([]);\n const originalLayout = ref([]);\n\n const { isLoading } = useQuery({\n queryKey: [\"core:dashboard:widgets\", breakpoint],\n queryFn: async () => {\n const { data } = await ucApiClient.user.preference.getMyPreference({\n group: \"dashboard-widgets\",\n });\n if (!data) {\n return null;\n }\n return data as DashboardResponsiveLayout;\n },\n cacheTime: 0,\n onSuccess: (data) => {\n layouts.value = data || DefaultResponsiveLayouts;\n\n const layoutData =\n layouts.value[breakpoint.value] || layouts.value[\"lg\"] || [];\n\n layout.value = layoutData;\n originalLayout.value = cloneDeep(layoutData);\n },\n enabled: computed(() => !!breakpoint.value),\n });\n\n return {\n layouts,\n layout,\n originalLayout,\n isLoading,\n };\n}\n\nexport function useDashboardWidgetsViewFetch(breakpoint: Ref) {\n return useQuery({\n queryKey: [\"core:dashboard:widgets:view\", breakpoint],\n queryFn: async () => {\n const { data } = await ucApiClient.user.preference.getMyPreference({\n group: \"dashboard-widgets\",\n });\n\n const layouts = (data ||\n DefaultResponsiveLayouts) as DashboardResponsiveLayout;\n\n return {\n layouts,\n layout: layouts[breakpoint.value] || layouts.lg || [],\n };\n },\n enabled: computed(() => !!breakpoint.value),\n });\n}\n" }, { "path": "ui/console-src/modules/dashboard/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconDashboard } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport WidgetCard from \"./components/WidgetCard.vue\";\n\ndeclare module \"vue\" {\n interface GlobalComponents {\n WidgetCard: (typeof import(\"./components/WidgetCard.vue\"))[\"default\"];\n }\n}\n\nexport default definePlugin({\n components: {\n WidgetCard,\n },\n routes: [\n {\n path: \"/\",\n component: BasicLayout,\n name: \"Root\",\n redirect: \"/dashboard\",\n children: [\n {\n path: \"dashboard\",\n name: \"Dashboard\",\n component: () => import(\"./Dashboard.vue\"),\n meta: {\n title: \"core.dashboard.title\",\n searchable: true,\n menu: {\n name: \"core.sidebar.menu.items.dashboard\",\n group: \"dashboard\",\n icon: markRaw(IconDashboard),\n priority: 0,\n mobile: true,\n },\n },\n },\n {\n path: \"dashboard/designer\",\n name: \"DashboardDesigner\",\n component: () => import(\"./DashboardDesigner.vue\"),\n meta: {\n title: \"core.dashboard_designer.title\",\n searchable: false,\n },\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/dashboard/styles/dashboard.css", "content": ".vue-grid-layout {\n @apply -m-[10px];\n}\n\n.vue-grid-item {\n transition: none !important;\n}\n\n.vue-grid-item.vue-grid-placeholder {\n @apply bg-gray-200 !important;\n @apply opacity-100 !important;\n}\n" }, { "path": "ui/console-src/modules/dashboard/widgets/defaults.ts", "content": "import type { DashboardResponsiveLayout } from \"@halo-dev/ui-shared\";\n\nconst DefaultResponsiveLayouts: DashboardResponsiveLayout = {\n lg: [\n {\n i: \"79187a8d-1c35-497f-a55e-05c0a6258660\",\n x: 0,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:post:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"96a9ac85-ec47-4c4b-bd02-184ee047f6a5\",\n x: 6,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:comment:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"ee42743e-06d8-4106-9481-42443bb8b2f0\",\n x: 3,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:user:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"19a92835-c12d-486b-9546-f16bd7a7da98\",\n x: 9,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:view:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"e45cd079-a406-42de-a196-e11c64f6d893\",\n x: 0,\n y: 3,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:quick-action\",\n config: {\n enabled_items: [\n \"core:user-center\",\n \"core:theme-preview\",\n \"core:new-post\",\n \"core:new-page\",\n \"core:upload-attachment\",\n \"core:theme-manage\",\n \"core:plugin-manage\",\n \"core:new-user\",\n \"core:refresh-search-engine\",\n ],\n },\n },\n {\n i: \"3bcd12eb-44ee-48e8-a37f-3f5d73470e2d\",\n x: 6,\n y: 3,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:notifications\",\n config: {},\n },\n ],\n xs: [\n {\n i: \"2026e492-0832-4a27-b44b-ab076e31ec17\",\n x: 0,\n y: 0,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:post:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"7c868acd-10e8-4e92-99f3-ff00b4aa4ec4\",\n x: 2,\n y: 0,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:user:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"90b458dc-679e-4b59-b0a9-86b02cf6ae59\",\n x: 0,\n y: 3,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:comment:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"bb71aa3a-1170-4e1d-a0f3-290b4ca77ca1\",\n x: 2,\n y: 3,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:view:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"c3e467a7-9a15-4732-9ba1-45f36a49d25e\",\n x: 0,\n y: 6,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:quick-action\",\n config: {\n enabled_items: [\n \"core:user-center\",\n \"core:theme-preview\",\n \"core:new-post\",\n \"core:new-page\",\n \"core:upload-attachment\",\n \"core:theme-manage\",\n \"core:plugin-manage\",\n \"core:new-user\",\n \"core:refresh-search-engine\",\n ],\n },\n },\n {\n i: \"24005fc4-e725-4e6d-95ae-f83026ffc178\",\n x: 0,\n y: 18,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:notifications\",\n config: {},\n },\n ],\n xxs: [\n {\n i: \"2026e492-0832-4a27-b44b-ab076e31ec17\",\n x: 0,\n y: 0,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:post:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"7c868acd-10e8-4e92-99f3-ff00b4aa4ec4\",\n x: 2,\n y: 0,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:user:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"90b458dc-679e-4b59-b0a9-86b02cf6ae59\",\n x: 0,\n y: 3,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:comment:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"bb71aa3a-1170-4e1d-a0f3-290b4ca77ca1\",\n x: 2,\n y: 3,\n w: 2,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:view:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"c3e467a7-9a15-4732-9ba1-45f36a49d25e\",\n x: 0,\n y: 6,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:quick-action\",\n config: {\n enabled_items: [\n \"core:user-center\",\n \"core:theme-preview\",\n \"core:new-post\",\n \"core:new-page\",\n \"core:upload-attachment\",\n \"core:theme-manage\",\n \"core:plugin-manage\",\n \"core:new-user\",\n \"core:refresh-search-engine\",\n ],\n },\n },\n {\n i: \"24005fc4-e725-4e6d-95ae-f83026ffc178\",\n x: 0,\n y: 18,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:notifications\",\n config: {},\n },\n ],\n md: [\n {\n i: \"d86c4b16-9cf5-4d1e-9f46-fc79693c76f2\",\n x: 0,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:post:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"31a29ecc-e2d6-449c-9850-994e2fd6d9c6\",\n x: 6,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:comment:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"b3cc217f-5008-49bd-b6a3-b760c1afc4f9\",\n x: 3,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:user:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"b7afa21f-c24b-4fa2-9c98-de06e3c48687\",\n x: 9,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:view:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"1f329a9f-d1aa-4337-98b3-34d8732b9143\",\n x: 0,\n y: 3,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:quick-action\",\n config: {\n enabled_items: [\n \"core:user-center\",\n \"core:theme-preview\",\n \"core:new-post\",\n \"core:new-page\",\n \"core:upload-attachment\",\n \"core:theme-manage\",\n \"core:plugin-manage\",\n \"core:new-user\",\n \"core:refresh-search-engine\",\n ],\n },\n },\n {\n i: \"ac9a9984-da16-4d81-adc6-8c64ffcbde5e\",\n x: 6,\n y: 3,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:notifications\",\n config: {},\n },\n ],\n sm: [\n {\n i: \"61298416-1b09-426d-914c-ba7664825626\",\n x: 0,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:post:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"44932f76-7667-4b77-99e7-9778c8f54062\",\n x: 0,\n y: 3,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:comment:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"d6508199-b7a3-47dc-aabf-4e3634760b78\",\n x: 3,\n y: 0,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:user:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"3525a65d-2c69-4c0f-a378-6c9f1f06ad4c\",\n x: 3,\n y: 3,\n w: 3,\n h: 3,\n minW: 2,\n minH: 2,\n id: \"core:view:stats\",\n config: {\n enable_animation: true,\n },\n },\n {\n i: \"1bf7eba4-2805-495b-85cd-ebd9ecd9ab82\",\n x: 0,\n y: 6,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:quick-action\",\n config: {\n enabled_items: [\n \"core:user-center\",\n \"core:theme-preview\",\n \"core:new-post\",\n \"core:new-page\",\n \"core:upload-attachment\",\n \"core:theme-manage\",\n \"core:plugin-manage\",\n \"core:new-user\",\n \"core:refresh-search-engine\",\n ],\n },\n },\n {\n i: \"06dc350c-db0e-46ea-9718-cef1e5bca339\",\n x: 0,\n y: 18,\n w: 6,\n h: 12,\n minW: 3,\n minH: 6,\n id: \"core:notifications\",\n config: {},\n },\n ],\n};\n\nexport { DefaultResponsiveLayouts };\n" }, { "path": "ui/console-src/modules/dashboard/widgets/index.ts", "content": "import type { DashboardWidgetDefinition } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport { i18n } from \"@/locales\";\nimport CommentStatsWidget from \"./presets/comments/CommentStatsWidget.vue\";\nimport PendingCommentsWidget from \"./presets/comments/PendingCommentsWidget.vue\";\nimport IframeWidget from \"./presets/core/iframe/IframeWidget.vue\";\nimport QuickActionWidget from \"./presets/core/quick-action/QuickActionWidget.vue\";\nimport StackWidget from \"./presets/core/stack/StackWidget.vue\";\nimport UpvotesStatsWidget from \"./presets/core/upvotes-stats/UpvotesStatsWidget.vue\";\nimport ViewsStatsWidget from \"./presets/core/view-stats/ViewsStatsWidget.vue\";\nimport PostStatsWidget from \"./presets/posts/PostStatsWidget.vue\";\nimport RecentPublishedWidget from \"./presets/posts/RecentPublishedWidget.vue\";\nimport SinglePageStatsWidget from \"./presets/single-pages/SinglePageStatsWidget.vue\";\nimport NotificationWidget from \"./presets/users/NotificationWidget.vue\";\nimport UserStatsWidget from \"./presets/users/UserStatsWidget.vue\";\n\nexport const internalWidgetDefinitions: DashboardWidgetDefinition[] = [\n {\n id: \"core:post:stats\",\n component: markRaw(PostStatsWidget),\n group: \"core.dashboard.widgets.groups.post\",\n configFormKitSchema: () => [\n {\n $formkit: \"checkbox\",\n label: i18n.global.t(\n \"core.dashboard.widgets.common_form.fields.enable_animation.label\"\n ),\n name: \"enable_animation\",\n },\n ],\n defaultConfig: {\n enable_animation: true,\n },\n defaultSize: {\n w: 3,\n h: 3,\n minH: 2,\n minW: 2,\n },\n },\n {\n id: \"core:post:recent-published\",\n component: markRaw(RecentPublishedWidget),\n group: \"core.dashboard.widgets.groups.post\",\n defaultConfig: {},\n defaultSize: {\n w: 6,\n h: 12,\n minH: 6,\n minW: 3,\n },\n permissions: [\"system:posts:view\"],\n },\n {\n id: \"core:singlepage:stats\",\n component: markRaw(SinglePageStatsWidget),\n group: \"core.dashboard.widgets.groups.page\",\n configFormKitSchema: () => [\n {\n $formkit: \"checkbox\",\n label: i18n.global.t(\n \"core.dashboard.widgets.common_form.fields.enable_animation.label\"\n ),\n name: \"enable_animation\",\n },\n ],\n defaultConfig: {\n enable_animation: true,\n },\n defaultSize: {\n w: 3,\n h: 3,\n minH: 2,\n minW: 2,\n },\n permissions: [\"system:singlepages:view\"],\n },\n {\n id: \"core:comment:stats\",\n component: markRaw(CommentStatsWidget),\n group: \"core.dashboard.widgets.groups.comment\",\n configFormKitSchema: () => [\n {\n $formkit: \"checkbox\",\n label: i18n.global.t(\n \"core.dashboard.widgets.common_form.fields.enable_animation.label\"\n ),\n name: \"enable_animation\",\n },\n ],\n defaultConfig: {\n enable_animation: true,\n },\n defaultSize: {\n w: 3,\n h: 3,\n minH: 2,\n minW: 2,\n },\n permissions: [],\n },\n {\n id: \"core:comment:pending\",\n component: markRaw(PendingCommentsWidget),\n group: \"core.dashboard.widgets.groups.comment\",\n defaultConfig: {},\n defaultSize: {\n w: 6,\n h: 12,\n minH: 6,\n minW: 3,\n },\n permissions: [\"system:comments:view\"],\n },\n {\n id: \"core:user:stats\",\n component: markRaw(UserStatsWidget),\n group: \"core.dashboard.widgets.groups.user\",\n configFormKitSchema: () => [\n {\n $formkit: \"checkbox\",\n label: i18n.global.t(\n \"core.dashboard.widgets.common_form.fields.enable_animation.label\"\n ),\n name: \"enable_animation\",\n },\n ],\n defaultConfig: {\n enable_animation: true,\n },\n defaultSize: {\n w: 3,\n h: 3,\n minH: 2,\n minW: 2,\n },\n },\n {\n id: \"core:view:stats\",\n component: markRaw(ViewsStatsWidget),\n group: \"core.dashboard.widgets.groups.other\",\n configFormKitSchema: () => [\n {\n $formkit: \"checkbox\",\n label: i18n.global.t(\n \"core.dashboard.widgets.common_form.fields.enable_animation.label\"\n ),\n name: \"enable_animation\",\n },\n ],\n defaultConfig: {\n enable_animation: true,\n },\n defaultSize: {\n w: 3,\n h: 3,\n minH: 2,\n minW: 2,\n },\n },\n {\n id: \"core:upvotes:stats\",\n component: markRaw(UpvotesStatsWidget),\n group: \"core.dashboard.widgets.groups.other\",\n configFormKitSchema: () => [\n {\n $formkit: \"checkbox\",\n label: i18n.global.t(\n \"core.dashboard.widgets.common_form.fields.enable_animation.label\"\n ),\n name: \"enable_animation\",\n },\n ],\n defaultConfig: {\n enable_animation: true,\n },\n defaultSize: {\n w: 3,\n h: 3,\n minH: 2,\n minW: 2,\n },\n },\n {\n id: \"core:quick-action\",\n component: markRaw(QuickActionWidget),\n group: \"core.dashboard.widgets.groups.other\",\n defaultConfig: {\n enabled_items: [\n \"core:user-center\",\n \"core:theme-preview\",\n \"core:new-post\",\n \"core:new-page\",\n \"core:upload-attachment\",\n \"core:theme-manage\",\n \"core:plugin-manage\",\n \"core:new-user\",\n \"core:refresh-search-engine\",\n ],\n },\n defaultSize: {\n w: 6,\n h: 12,\n minH: 6,\n minW: 3,\n },\n },\n {\n id: \"core:notifications\",\n component: markRaw(NotificationWidget),\n group: \"core.dashboard.widgets.groups.other\",\n defaultConfig: {},\n defaultSize: {\n w: 6,\n h: 12,\n minH: 6,\n minW: 3,\n },\n },\n {\n id: \"core:stack\",\n component: markRaw(StackWidget),\n group: \"core.dashboard.widgets.groups.other\",\n defaultConfig: {},\n defaultSize: {\n w: 6,\n h: 12,\n minH: 1,\n minW: 1,\n },\n },\n {\n id: \"core:iframe\",\n component: markRaw(IframeWidget),\n group: \"core.dashboard.widgets.groups.other\",\n configFormKitSchema: () => [\n {\n $formkit: \"text\",\n label: i18n.global.t(\n \"core.dashboard.widgets.presets.iframe.config.fields.title.label\"\n ),\n name: \"title\",\n },\n {\n $formkit: \"url\",\n label: \"URL\",\n name: \"url\",\n validation: \"required|url\",\n },\n ],\n defaultConfig: {},\n defaultSize: {\n w: 6,\n h: 12,\n minH: 2,\n minW: 2,\n },\n },\n];\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/comments/CommentItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/comments/CommentStatsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/comments/PendingCommentsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/iframe/IframeWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/quick-action/QuickActionItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/quick-action/QuickActionWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/quick-action/ThemePreviewItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/quick-action/composables/use-dashboard-extension-point.ts", "content": "import type { DashboardWidgetQuickActionItem } from \"@halo-dev/ui-shared\";\nimport { onMounted, shallowRef } from \"vue\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\n\nconst EXTENSION_POINT_NAME =\n \"console:dashboard:widgets:internal:quick-action:item:create\";\n\nexport function useDashboardQuickActionExtensionPoint() {\n const { pluginModuleMap } = usePluginModuleStore();\n\n const quickActionItems = shallowRef([]);\n\n onMounted(async () => {\n const result: DashboardWidgetQuickActionItem[] = [];\n for (const [name, module] of Object.entries(pluginModuleMap)) {\n try {\n const callbackFunction =\n module?.extensionPoints?.[EXTENSION_POINT_NAME];\n\n if (typeof callbackFunction !== \"function\") {\n continue;\n }\n\n const definitions = await callbackFunction();\n\n // Reset id\n definitions.forEach((definition) => {\n definition.id = `${name}-${definition.id}`;\n });\n\n result.push(...definitions);\n } catch (error) {\n console.error(`Error processing plugin module:`, name, error);\n }\n }\n quickActionItems.value = result;\n });\n\n return { quickActionItems };\n}\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/stack/StackWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/stack/StackWidgetConfigModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/stack/components/IndexIndicator.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/stack/components/WidgetEditableItem.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/stack/components/WidgetViewItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/stack/types.ts", "content": "export interface SimpleWidget {\n i: string;\n id: string;\n config?: Record;\n}\n\nexport interface StackWidgetConfig {\n auto_play?: boolean;\n auto_play_interval?: number;\n widgets: SimpleWidget[];\n}\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/upvotes-stats/UpvotesStatsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/core/view-stats/ViewsStatsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/posts/PostStatsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/posts/RecentPublishedWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/posts/components/PostListItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/single-pages/SinglePageStatsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/users/NotificationWidget.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/dashboard/widgets/presets/users/UserStatsWidget.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/index.ts", "content": "import type { PluginModule } from \"@halo-dev/ui-shared\";\n\nconst modules = import.meta.glob(\"./**/module.ts\", {\n eager: true,\n import: \"default\",\n}) as Record;\n\nexport default modules;\n" }, { "path": "ui/console-src/modules/interface/menus/Menus.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/menus/components/MenuEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/interface/menus/components/MenuItemEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/interface/menus/components/MenuList.vue", "content": "\n\n \n \n \n \n \n\n" }, { "path": "ui/console-src/modules/interface/menus/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconListSettings } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/menus\",\n name: \"MenusRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.menu.title\",\n searchable: true,\n permissions: [\"system:menus:view\"],\n menu: {\n name: \"core.sidebar.menu.items.menus\",\n group: \"interface\",\n icon: markRaw(IconListSettings),\n priority: 1,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Menus\",\n component: () => import(\"./Menus.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/interface/menus/utils/__tests__/__snapshots__/index.spec.ts.snap", "content": "// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html\n\nexports[`buildMenuItemsTree > should match snapshot 1`] = `\n[\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"411a3639-bf0d-4266-9cfb-14184259dab5\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"首页\",\n \"href\": \"https://ryanc.cc/\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-07-28T06:50:32.777556Z\",\n \"name\": \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"version\": 4,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Halo\",\n \"href\": \"https://ryanc.cc/categories/halo\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ],\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 1,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:19:37.252228Z\",\n \"name\": \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n \"version\": 12,\n },\n \"spec\": {\n \"children\": [\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n ],\n \"displayName\": \"文章分类\",\n \"href\": \"https://ryanc.cc/categories\",\n \"priority\": 1,\n },\n },\n]\n`;\n\nexports[`convertMenuTreeItemToMenuItem > should handle node with empty children 1`] = `\n{\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-01-01T00:00:00Z\",\n \"name\": \"test\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"test\",\n \"href\": \"#\",\n \"priority\": 0,\n },\n}\n`;\n\nexports[`convertMenuTreeItemToMenuItem > should match snapshot 1`] = `\n{\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-07-28T06:50:32.777556Z\",\n \"name\": \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"version\": 4,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Halo\",\n \"href\": \"https://ryanc.cc/categories/halo\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ],\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 1,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:19:37.252228Z\",\n \"name\": \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n \"version\": 12,\n },\n \"spec\": {\n \"children\": [\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n ],\n \"displayName\": \"文章分类\",\n \"href\": \"https://ryanc.cc/categories\",\n \"priority\": 1,\n },\n}\n`;\n\nexports[`convertMenuTreeItemToMenuItem > should match snapshot 2`] = `\n{\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ],\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 1,\n },\n}\n`;\n\nexports[`convertTreeToMenuItems > will match snapshot 1`] = `\n[\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"411a3639-bf0d-4266-9cfb-14184259dab5\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"首页\",\n \"href\": \"https://ryanc.cc/\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-07-28T06:50:32.777556Z\",\n \"name\": \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"version\": 4,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Halo\",\n \"href\": \"https://ryanc.cc/categories/halo\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ],\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 1,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:19:37.252228Z\",\n \"name\": \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n \"version\": 12,\n },\n \"spec\": {\n \"children\": [\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n ],\n \"displayName\": \"文章分类\",\n \"href\": \"https://ryanc.cc/categories\",\n \"priority\": 1,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-07-28T06:50:32.777556Z\",\n \"name\": \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"version\": 4,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Halo\",\n \"href\": \"https://ryanc.cc/categories/halo\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ],\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 1,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n]\n`;\n\nexports[`resetMenuItemsTreePriority > should match snapshot 1`] = `\n[\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"411a3639-bf0d-4266-9cfb-14184259dab5\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"首页\",\n \"href\": \"https://ryanc.cc/\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-07-28T06:50:32.777556Z\",\n \"name\": \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"version\": 4,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Halo\",\n \"href\": \"https://ryanc.cc/categories/halo\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [],\n \"displayName\": \"Spring Boot\",\n \"href\": \"https://ryanc.cc/categories/spring-boot\",\n \"priority\": 0,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 1,\n },\n \"spec\": {\n \"children\": [\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ],\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 1,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:19:37.252228Z\",\n \"name\": \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n \"version\": 12,\n },\n \"spec\": {\n \"children\": [\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n ],\n \"displayName\": \"文章分类\",\n \"href\": \"https://ryanc.cc/categories\",\n \"priority\": 1,\n },\n },\n]\n`;\n\nexports[`sortMenuItemsTree > will match snapshot 1`] = `\n[\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:22:03.377364Z\",\n \"name\": \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"version\": 0,\n },\n \"spec\": {\n \"displayName\": \"Java\",\n \"href\": \"https://ryanc.cc/categories/java\",\n \"priority\": 0,\n },\n },\n {\n \"apiVersion\": \"v1alpha1\",\n \"children\": [],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-07-28T06:50:32.777556Z\",\n \"name\": \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"version\": 4,\n },\n \"spec\": {\n \"displayName\": \"Halo\",\n \"href\": \"https://ryanc.cc/categories/halo\",\n \"priority\": 1,\n },\n },\n ],\n \"kind\": \"MenuItem\",\n \"metadata\": {\n \"creationTimestamp\": \"2022-08-05T04:19:37.252228Z\",\n \"name\": \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n \"version\": 12,\n },\n \"spec\": {\n \"displayName\": \"文章分类\",\n \"href\": \"https://ryanc.cc/categories\",\n \"priority\": 0,\n },\n },\n]\n`;\n" }, { "path": "ui/console-src/modules/interface/menus/utils/__tests__/index.spec.ts", "content": "import type { MenuItem } from \"@halo-dev/api-client\";\nimport { describe, expect, it } from \"vitest\";\nimport type { MenuTreeItem } from \"../index\";\nimport {\n buildMenuItemsTree,\n convertMenuTreeItemToMenuItem,\n convertTreeToMenuItems,\n getChildrenNames,\n resetMenuItemsTreePriority,\n sortMenuItemsTree,\n} from \"../index\";\n\nconst rawMenuItems: MenuItem[] = [\n {\n spec: {\n displayName: \"文章分类\",\n href: \"https://ryanc.cc/categories\",\n children: [\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n ],\n priority: 1,\n },\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n version: 12,\n creationTimestamp: \"2022-08-05T04:19:37.252228Z\",\n },\n },\n {\n spec: {\n displayName: \"Halo\",\n href: \"https://ryanc.cc/categories/halo\",\n children: [],\n priority: 0,\n },\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n version: 4,\n creationTimestamp: \"2022-07-28T06:50:32.777556Z\",\n },\n },\n {\n spec: {\n displayName: \"Java\",\n href: \"https://ryanc.cc/categories/java\",\n children: [\"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\"],\n priority: 1,\n },\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n version: 1,\n creationTimestamp: \"2022-08-05T04:22:03.377364Z\",\n },\n },\n {\n spec: {\n displayName: \"Spring Boot\",\n href: \"https://ryanc.cc/categories/spring-boot\",\n children: [],\n priority: 0,\n },\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n version: 1,\n creationTimestamp: \"2022-08-05T04:22:03.377364Z\",\n },\n },\n {\n spec: {\n displayName: \"首页\",\n href: \"https://ryanc.cc/\",\n children: [],\n priority: 0,\n },\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"411a3639-bf0d-4266-9cfb-14184259dab5\",\n version: 1,\n creationTimestamp: \"2022-08-05T04:22:03.377364Z\",\n },\n },\n];\n\ndescribe(\"buildMenuItemsTree\", () => {\n it(\"should match snapshot\", () => {\n const tree = buildMenuItemsTree(rawMenuItems);\n expect(tree).toMatchSnapshot();\n });\n\n it(\"should be sorted correctly and children at top level\", () => {\n const menuItems = buildMenuItemsTree(rawMenuItems);\n expect(menuItems[0].spec.priority).toBe(0);\n expect(menuItems[1].spec.priority).toBe(1);\n expect(menuItems[1].children[0].spec.priority).toBe(0);\n expect(menuItems[1].children[1].spec.priority).toBe(1);\n expect(menuItems[1].children[1].children[0].spec.priority).toBe(0);\n expect(menuItems[0].spec.displayName).toBe(\"首页\");\n expect(menuItems[1].spec.displayName).toBe(\"文章分类\");\n expect(menuItems[1].children[0].spec.displayName).toBe(\"Halo\");\n expect(menuItems[1].children[1].spec.displayName).toBe(\"Java\");\n expect(menuItems[1].children[1].children[0].spec.displayName).toBe(\n \"Spring Boot\"\n );\n });\n\n it(\"should handle empty input\", () => {\n expect(buildMenuItemsTree([])).toEqual([]);\n });\n});\n\ndescribe(\"convertTreeToMenuItems\", () => {\n it(\"will match snapshot\", function () {\n const menuTreeItems = buildMenuItemsTree(rawMenuItems);\n expect(convertTreeToMenuItems(menuTreeItems)).toMatchSnapshot();\n });\n it(\"should handle empty input\", () => {\n expect(convertTreeToMenuItems([])).toEqual([]);\n });\n});\n\ndescribe(\"sortMenuItemsTree\", () => {\n it(\"will match snapshot\", () => {\n const tree: MenuTreeItem[] = [\n {\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n creationTimestamp: \"2022-08-05T04:19:37.252228Z\",\n name: \"40e4ba86-5c7e-43c2-b4c0-cee376d26564\",\n version: 12,\n },\n spec: {\n priority: 0,\n displayName: \"文章分类\",\n href: \"https://ryanc.cc/categories\",\n },\n children: [\n {\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n creationTimestamp: \"2022-07-28T06:50:32.777556Z\",\n name: \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n version: 4,\n },\n spec: {\n priority: 1,\n displayName: \"Halo\",\n href: \"https://ryanc.cc/categories/halo\",\n },\n children: [],\n },\n {\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n creationTimestamp: \"2022-08-05T04:22:03.377364Z\",\n name: \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n version: 0,\n },\n spec: {\n priority: 0,\n displayName: \"Java\",\n href: \"https://ryanc.cc/categories/java\",\n },\n children: [],\n },\n ],\n },\n ];\n expect(sortMenuItemsTree(tree)).toMatchSnapshot();\n });\n});\n\ndescribe(\"resetMenuItemsTreePriority\", () => {\n it(\"should match snapshot\", function () {\n expect(\n resetMenuItemsTreePriority(buildMenuItemsTree(rawMenuItems))\n ).toMatchSnapshot();\n });\n});\n\ndescribe(\"getChildrenNames\", () => {\n it(\"should return correct names\", () => {\n const menuTreeItems = buildMenuItemsTree(rawMenuItems);\n expect(getChildrenNames(menuTreeItems[0])).toEqual([]);\n expect(getChildrenNames(menuTreeItems[1])).toEqual([\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n \"96b636bb-3e4a-44d1-8ea7-f9da9e876f45\",\n ]);\n expect(getChildrenNames(menuTreeItems[1].children[0])).toEqual([]);\n });\n it(\"should handle empty children\", () => {\n const node: MenuTreeItem = {\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"test\",\n version: 1,\n creationTimestamp: \"2022-01-01T00:00:00Z\",\n },\n spec: {\n displayName: \"test\",\n href: \"#\",\n children: [],\n priority: 0,\n },\n children: [],\n };\n expect(getChildrenNames(node)).toEqual([]);\n });\n});\n\ndescribe(\"convertMenuTreeItemToMenuItem\", () => {\n it(\"should match snapshot\", () => {\n const menuTreeItems = buildMenuItemsTree(rawMenuItems);\n expect(convertMenuTreeItemToMenuItem(menuTreeItems[1])).toMatchSnapshot();\n expect(\n convertMenuTreeItemToMenuItem(menuTreeItems[1].children[1])\n ).toMatchSnapshot();\n });\n it(\"should return correct MenuItem\", () => {\n const menuTreeItems = buildMenuItemsTree(rawMenuItems);\n expect(\n convertMenuTreeItemToMenuItem(menuTreeItems[1]).spec.displayName\n ).toBe(\"文章分类\");\n expect(\n convertMenuTreeItemToMenuItem(menuTreeItems[1]).spec.children\n ).toStrictEqual([\n \"caeef383-3828-4039-9114-6f9ad3b4a37e\",\n \"ded1943d-9fdb-4563-83ee-2f04364872e0\",\n ]);\n });\n it(\"should handle node with empty children\", () => {\n const node: MenuTreeItem = {\n apiVersion: \"v1alpha1\",\n kind: \"MenuItem\",\n metadata: {\n name: \"test\",\n version: 1,\n creationTimestamp: \"2022-01-01T00:00:00Z\",\n },\n spec: {\n displayName: \"test\",\n href: \"#\",\n children: [],\n priority: 0,\n },\n children: [],\n };\n expect(convertMenuTreeItemToMenuItem(node)).toMatchSnapshot();\n });\n});\n" }, { "path": "ui/console-src/modules/interface/menus/utils/index.ts", "content": "import type { MenuItem } from \"@halo-dev/api-client\";\nimport { cloneDeep } from \"es-toolkit\";\n\nexport interface MenuTreeItem extends MenuItem {\n children: MenuTreeItem[];\n}\n\n/**\n * Convert a flat array of menu items into a menu tree with children at the top level.\n *\n * @param menuItems\n */\nexport function buildMenuItemsTree(menuItems: MenuItem[]): MenuTreeItem[] {\n const menuItemsToUpdate = cloneDeep(menuItems);\n\n const menuItemsMap: Record = {};\n const parentMap: Record = {};\n\n menuItemsToUpdate.forEach((menuItem) => {\n menuItemsMap[menuItem.metadata.name] = {\n ...menuItem,\n children: [],\n };\n (menuItem.spec.children as string[]).forEach((child) => {\n parentMap[child] = menuItem.metadata.name;\n });\n });\n\n Object.values(menuItemsMap).forEach((menuTreeItem) => {\n const parentName = parentMap[menuTreeItem.metadata.name];\n if (parentName && menuItemsMap[parentName]) {\n menuItemsMap[parentName].children.push(menuTreeItem);\n }\n });\n\n const menuTreeItems = Object.values(menuItemsMap).filter(\n (node) => parentMap[node.metadata.name] === undefined\n );\n\n return sortMenuItemsTree(menuTreeItems);\n}\n\n/**\n * Sort a menu tree by priority.\n *\n * @param menuTreeItems\n */\nexport function sortMenuItemsTree(\n menuTreeItems: MenuTreeItem[]\n): MenuTreeItem[] {\n return menuTreeItems\n .sort((a, b) => {\n const aPriority = a.spec.priority ?? 0;\n const bPriority = b.spec.priority ?? 0;\n if (aPriority < bPriority) {\n return -1;\n }\n if (aPriority > bPriority) {\n return 1;\n }\n return 0;\n })\n .map((menuTreeItem) => {\n if (menuTreeItem.children.length) {\n return {\n ...menuTreeItem,\n children: sortMenuItemsTree(menuTreeItem.children),\n };\n }\n return menuTreeItem;\n });\n}\n\n/**\n * Reset the menu tree item's priority.\n *\n * @param menuItems\n */\nexport function resetMenuItemsTreePriority(\n menuItems: MenuTreeItem[]\n): MenuTreeItem[] {\n for (let i = 0; i < menuItems.length; i++) {\n menuItems[i].spec.priority = i;\n if (menuItems[i].children) {\n resetMenuItemsTreePriority(menuItems[i].children);\n }\n }\n return menuItems;\n}\n\n/**\n * Convert a menu tree items into a flat array of menu.\n *\n * @param menuTreeItems\n */\nexport function convertTreeToMenuItems(menuTreeItems: MenuTreeItem[]) {\n const menuItems: MenuItem[] = [];\n const menuItemsMap = new Map();\n const convertMenuItem = (node: MenuTreeItem | undefined) => {\n if (!node) {\n return;\n }\n const children = node.children || [];\n const { ...rest } = node;\n menuItemsMap.set(node.metadata.name, {\n ...rest,\n spec: {\n ...node.spec,\n children: children.map((child) => child.metadata.name),\n },\n });\n children.forEach((child) => {\n convertMenuItem(child);\n });\n };\n menuTreeItems.forEach((node) => {\n convertMenuItem(node);\n });\n menuItemsMap.forEach((node) => {\n menuItems.push(node);\n });\n return menuItems;\n}\n\nexport function getChildrenNames(menuTreeItem: MenuTreeItem): string[] {\n const childrenNames: string[] = [];\n\n function getChildrenNamesRecursive(menuTreeItem: MenuTreeItem) {\n if (menuTreeItem.children) {\n menuTreeItem.children.forEach((child) => {\n childrenNames.push(child.metadata.name);\n getChildrenNamesRecursive(child);\n });\n }\n }\n\n getChildrenNamesRecursive(menuTreeItem);\n\n return childrenNames;\n}\n\n/**\n * Convert {@link MenuTreeItem} to {@link MenuItem} with flat children name array.\n *\n * @param menuTreeItem\n */\nexport function convertMenuTreeItemToMenuItem(\n menuTreeItem: MenuTreeItem\n): MenuItem {\n const childNames = (menuTreeItem.children || []).map(\n (child) => child.metadata.name\n );\n const { ...rest } = menuTreeItem;\n return {\n ...rest,\n spec: {\n ...menuTreeItem.spec,\n children: childNames,\n },\n };\n}\n" }, { "path": "ui/console-src/modules/interface/themes/ThemeDetail.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/ThemeSetting.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/ThemeListItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/ThemeListModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/list-tabs/InstalledThemes.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/list-tabs/LocalUpload.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/list-tabs/NotInstalledThemes.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/list-tabs/RemoteDownload.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/operation/MoreOperationItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/operation/UninstallOperationItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/preview/ThemePreviewListItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/interface/themes/components/preview/ThemePreviewModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/interface/themes/composables/use-theme.ts", "content": "import { useThemeStore } from \"@console/stores/theme\";\nimport type { Theme } from \"@halo-dev/api-client\";\nimport { consoleApiClient } from \"@halo-dev/api-client\";\nimport { Dialog, Toast } from \"@halo-dev/components\";\nimport { useFileDialog } from \"@vueuse/core\";\nimport { merge } from \"es-toolkit\";\nimport { storeToRefs } from \"pinia\";\nimport type { ComputedRef, Ref } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { useI18n } from \"vue-i18n\";\n\ninterface useThemeLifeCycleReturn {\n loading: Ref;\n isActivated: ComputedRef;\n getFailedMessage: () => string | undefined;\n handleActiveTheme: (reload?: boolean) => void;\n handleResetSettingConfig: () => void;\n}\n\nexport function useThemeLifeCycle(\n theme: Ref\n): useThemeLifeCycleReturn {\n const { t } = useI18n();\n\n const loading = ref(false);\n\n const themeStore = useThemeStore();\n\n const { activatedTheme } = storeToRefs(themeStore);\n\n const isActivated = computed(() => {\n return activatedTheme?.value?.metadata.name === theme.value?.metadata.name;\n });\n\n const getFailedMessage = (): string | undefined => {\n if (!(theme.value?.status?.phase === \"FAILED\")) {\n return;\n }\n\n const condition = theme.value.status.conditions?.[0];\n\n if (condition) {\n return [condition.type, condition.message].join(\"：\");\n }\n };\n\n const handleActiveTheme = async (reload?: boolean) => {\n Dialog.info({\n title: t(\"core.theme.operations.active.title\"),\n description: theme.value?.spec.displayName,\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n if (!theme.value) return;\n\n await consoleApiClient.theme.theme.activateTheme({\n name: theme.value?.metadata.name,\n });\n\n Toast.success(t(\"core.theme.operations.active.toast_success\"));\n\n if (reload) {\n window.location.reload();\n }\n } catch (e) {\n console.error(\"Failed to active theme\", e);\n } finally {\n themeStore.fetchActivatedTheme();\n }\n },\n });\n };\n\n const handleResetSettingConfig = async () => {\n Dialog.warning({\n title: t(\"core.theme.operations.reset.title\"),\n description: t(\"core.theme.operations.reset.description\"),\n confirmType: \"danger\",\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n if (!theme?.value) {\n return;\n }\n\n await consoleApiClient.theme.theme.resetThemeConfig({\n name: theme.value.metadata.name as string,\n });\n\n Toast.success(t(\"core.theme.operations.reset.toast_success\"));\n } catch (e) {\n console.error(\"Failed to reset theme setting config\", e);\n }\n },\n });\n };\n\n return {\n loading,\n isActivated,\n getFailedMessage,\n handleActiveTheme,\n handleResetSettingConfig,\n };\n}\n\nexport function useThemeCustomTemplates(type: \"post\" | \"page\" | \"category\") {\n const themeStore = useThemeStore();\n const { t } = useI18n();\n\n const templates = computed(() => {\n const defaultTemplate = [\n {\n label: t(\"core.theme.custom_templates.default\"),\n value: \"\",\n },\n ];\n\n if (!themeStore.activatedTheme) {\n return defaultTemplate;\n }\n const { customTemplates } = themeStore.activatedTheme.spec;\n if (!customTemplates?.[type]) {\n return defaultTemplate;\n }\n return [\n ...defaultTemplate,\n ...(customTemplates[type]?.map((template) => {\n return {\n value: template.file,\n label: template.name || template.file,\n };\n }) || []),\n ];\n });\n\n return {\n templates,\n };\n}\n\ninterface ExportData {\n themeName: string;\n version: string;\n settingName: string;\n configMapName: string;\n configs: Record;\n}\n\nexport function useThemeConfigFile(theme: Ref) {\n const { t } = useI18n();\n\n const handleExportThemeConfiguration = async () => {\n if (!theme.value) {\n console.error(\"No selected or activated theme\");\n return;\n }\n\n const { data } = await consoleApiClient.theme.theme.fetchThemeJsonConfig({\n name: theme?.value?.metadata.name as string,\n });\n\n if (!data) {\n console.error(\"Failed to fetch theme config\");\n return;\n }\n\n const themeName = theme.value.metadata.name;\n\n const exportData: ExportData = {\n themeName: themeName,\n version: theme.value.spec.version || \"\",\n settingName: theme.value.spec.settingName || \"\",\n configMapName: theme.value.spec.configMapName || \"\",\n configs: data as Record,\n };\n\n const exportStr = JSON.stringify(exportData, null, 2);\n const blob = new Blob([exportStr], { type: \"application/json\" });\n const temporaryExportUrl = URL.createObjectURL(blob);\n const temporaryLinkTag = document.createElement(\"a\");\n\n temporaryLinkTag.href = temporaryExportUrl;\n temporaryLinkTag.download = `export-${themeName}-config-${Date.now().toString()}.json`;\n\n document.body.appendChild(temporaryLinkTag);\n temporaryLinkTag.click();\n\n document.body.removeChild(temporaryLinkTag);\n URL.revokeObjectURL(temporaryExportUrl);\n };\n\n const {\n open: openSelectImportFileDialog,\n onChange: handleImportThemeConfiguration,\n } = useFileDialog({\n accept: \"application/json\",\n multiple: false,\n directory: false,\n reset: true,\n });\n\n handleImportThemeConfiguration(async (files) => {\n if (files === null || files.length === 0) {\n return;\n }\n const configText = await files[0].text();\n const configJson = JSON.parse(configText || \"{}\") as ExportData;\n if (!configJson.configs) {\n return;\n }\n if (!configJson.themeName || !configJson.version) {\n Toast.error(\n t(\"core.theme.operations.import_configuration.invalid_format\")\n );\n return;\n }\n if (!theme.value) {\n console.error(\"No selected or activated theme\");\n return;\n }\n if (configJson.themeName !== theme.value.metadata.name) {\n Toast.error(\n t(\"core.theme.operations.import_configuration.mismatched_theme\")\n );\n return;\n }\n\n if (configJson.version !== theme.value.spec.version) {\n Dialog.warning({\n title: t(\n \"core.theme.operations.import_configuration.version_mismatch.title\"\n ),\n description: t(\n \"core.theme.operations.import_configuration.version_mismatch.description\"\n ),\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: () => {\n handleSaveConfigMap(configJson.configs);\n },\n onCancel() {\n return;\n },\n });\n return;\n }\n handleSaveConfigMap(configJson.configs);\n });\n\n const handleSaveConfigMap = async (importData: Record) => {\n if (!theme.value) {\n return;\n }\n const { data: originalData } =\n await consoleApiClient.theme.theme.fetchThemeJsonConfig({\n name: theme.value.metadata.name as string,\n });\n\n if (!originalData) {\n return;\n }\n\n await consoleApiClient.theme.theme.updateThemeJsonConfig({\n name: theme.value.metadata.name,\n body: merge(originalData, importData),\n });\n\n Toast.success(t(\"core.common.toast.save_success\"));\n };\n\n return {\n handleExportThemeConfiguration,\n openSelectImportFileDialog,\n };\n}\n" }, { "path": "ui/console-src/modules/interface/themes/constants/index.ts", "content": "export const THEME_ALREADY_EXISTS_TYPE =\n \"https://halo.run/probs/theme-alreay-exists\";\n" }, { "path": "ui/console-src/modules/interface/themes/layouts/ThemeLayout.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/interface/themes/module.ts", "content": "import { IconPalette } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/theme\",\n name: \"ThemeRoot\",\n component: () => import(\"./layouts/ThemeLayout.vue\"),\n meta: {\n title: \"core.theme.title\",\n searchable: true,\n permissions: [\"system:themes:view\"],\n menu: {\n name: \"core.sidebar.menu.items.themes\",\n group: \"interface\",\n icon: markRaw(IconPalette),\n priority: 0,\n },\n },\n children: [\n {\n path: \"\",\n name: \"ThemeDetail\",\n component: () => import(\"./ThemeDetail.vue\"),\n },\n {\n path: \"settings/:group\",\n name: \"ThemeSetting\",\n component: () => import(\"./ThemeSetting.vue\"),\n meta: {\n title: \"core.theme.settings.title\",\n permissions: [\"system:themes:view\"],\n },\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/interface/themes/types/index.ts", "content": "export interface ThemeInstallationErrorResponse {\n detail: string;\n instance: string;\n themeName: string;\n requestId: string;\n status: number;\n timestamp: string;\n title: string;\n type: string;\n}\n" }, { "path": "ui/console-src/modules/system/auth-providers/AuthProviderDetail.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/auth-providers/AuthProviders.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/auth-providers/components/AuthProviderListItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/auth-providers/components/AuthProvidersSection.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/auth-providers/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\n\nexport default definePlugin({\n routes: [\n {\n path: \"/users/auth-providers\",\n component: BasicLayout,\n children: [\n {\n path: \"\",\n name: \"AuthProviders\",\n component: () => import(\"./AuthProviders.vue\"),\n meta: {\n title: \"core.identity_authentication.title\",\n searchable: true,\n permissions: [\"*\"],\n },\n },\n {\n path: \":name\",\n name: \"AuthProviderDetail\",\n component: () => import(\"./AuthProviderDetail.vue\"),\n meta: {\n title: \"core.identity_authentication.detail.title\",\n permissions: [\"*\"],\n },\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/backup/Backups.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/backup/components/BackupListItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/backup/composables/use-backup.ts", "content": "import {\n BackupStatusPhaseEnum,\n coreApiClient,\n paginate,\n type Backup,\n type BackupV1alpha1ApiListBackupRequest,\n} from \"@halo-dev/api-client\";\nimport { Dialog, Toast } from \"@halo-dev/components\";\nimport { utils } from \"@halo-dev/ui-shared\";\nimport { useQuery, useQueryClient } from \"@tanstack/vue-query\";\nimport { useI18n } from \"vue-i18n\";\n\nexport function useBackupFetch() {\n return useQuery({\n queryKey: [\"backups\"],\n queryFn: async () => {\n return await paginate(\n (params) => coreApiClient.migration.backup.listBackup(params),\n {\n size: 1000,\n }\n );\n },\n refetchInterval(data) {\n const deletingBackups = data?.filter((backup) => {\n return !!backup.metadata.deletionTimestamp;\n });\n\n if (deletingBackups?.length) {\n return 1000;\n }\n\n const pendingBackups = data?.filter((backup) => {\n return (\n backup.status?.phase === BackupStatusPhaseEnum.Pending ||\n backup.status?.phase === BackupStatusPhaseEnum.Running\n );\n });\n\n if (pendingBackups?.length) {\n return 3000;\n }\n\n return false;\n },\n });\n}\n\nexport function useBackup() {\n const { t } = useI18n();\n const queryClient = useQueryClient();\n\n const handleCreate = async () => {\n Dialog.info({\n title: t(\"core.backup.operations.create.title\"),\n description: t(\"core.backup.operations.create.description\"),\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n async onConfirm() {\n await coreApiClient.migration.backup.createBackup({\n backup: {\n apiVersion: \"migration.halo.run/v1alpha1\",\n kind: \"Backup\",\n metadata: {\n generateName: \"backup-\",\n name: \"\",\n },\n spec: {\n expiresAt: utils.date.dayjs().add(7, \"day\").toISOString(),\n },\n },\n });\n\n queryClient.invalidateQueries({ queryKey: [\"backups\"] });\n\n Toast.success(t(\"core.backup.operations.create.toast_success\"));\n },\n });\n };\n\n return { handleCreate };\n}\n" }, { "path": "ui/console-src/modules/system/backup/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconServerLine } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/backup\",\n name: \"BackupRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.backup.title\",\n searchable: true,\n permissions: [\"system:migrations:manage\"],\n menu: {\n name: \"core.sidebar.menu.items.backup\",\n group: \"system\",\n icon: markRaw(IconServerLine),\n priority: 4,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Backup\",\n component: () => import(\"./Backups.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/backup/tabs/List.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/backup/tabs/Restore.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/overview/Overview.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/overview/components/ExternalUrlForm.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/overview/components/ExternalUrlItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/overview/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconTerminalBoxLine } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/overview\",\n name: \"OverviewRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.overview.title\",\n searchable: true,\n permissions: [\"system:actuator:manage\"],\n menu: {\n name: \"core.sidebar.menu.items.overview\",\n group: \"system\",\n icon: markRaw(IconTerminalBoxLine),\n priority: 3,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Overview\",\n component: () => import(\"./Overview.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/plugins/PluginDetail.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/plugins/PluginExtensionPointSettings.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/PluginList.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/PluginConditionsModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/PluginDetailModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/PluginInstallationModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/PluginListItem.vue", "content": "\n\n \n\n \n\n" }, { "path": "ui/console-src/modules/system/plugins/components/entity-fields/AuthorField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/entity-fields/LogoField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/entity-fields/ReloadField.vue", "content": "\n\n\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/entity-fields/SwitchField.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/entity-fields/TitleField.vue", "content": "\n\n\n \n\n" }, { "path": "ui/console-src/modules/system/plugins/components/extension-points/ExtensionDefinitionListItem.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/extension-points/ExtensionDefinitionMultiInstanceView.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/extension-points/ExtensionDefinitionSingletonView.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/installation-tabs/LocalUpload.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/installation-tabs/RemoteDownload.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/tabs/Detail.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/plugins/components/tabs/Setting.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/plugins/composables/use-extension-definition-fetch.ts", "content": "import type {\n ExtensionDefinition,\n ExtensionDefinitionV1alpha1ApiListExtensionDefinitionRequest,\n ExtensionPointDefinition,\n} from \"@halo-dev/api-client\";\nimport { coreApiClient, paginate } from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { computed, type Ref } from \"vue\";\n\nexport function useExtensionDefinitionFetch(\n extensionPointDefinition: Ref\n) {\n return useQuery({\n queryKey: [\"extension-definitions\", extensionPointDefinition],\n queryFn: async () => {\n return await paginate<\n ExtensionDefinitionV1alpha1ApiListExtensionDefinitionRequest,\n ExtensionDefinition\n >(\n (params) =>\n coreApiClient.plugin.extensionDefinition.listExtensionDefinition(\n params\n ),\n {\n size: 1000,\n fieldSelector: [\n `spec.extensionPointName=${extensionPointDefinition.value?.metadata.name}`,\n ],\n }\n );\n },\n enabled: computed(() => !!extensionPointDefinition.value),\n });\n}\n" }, { "path": "ui/console-src/modules/system/plugins/composables/use-plugin.ts", "content": "import {\n PluginStatusPhaseEnum,\n consoleApiClient,\n coreApiClient,\n type Plugin,\n type SettingForm,\n} from \"@halo-dev/api-client\";\nimport { Dialog, Toast, VLoading } from \"@halo-dev/components\";\nimport { utils, type PluginTab } from \"@halo-dev/ui-shared\";\nimport { useMutation, useQuery } from \"@tanstack/vue-query\";\nimport { useRouteQuery } from \"@vueuse/router\";\nimport type { ComputedRef, Ref } from \"vue\";\nimport { computed, defineAsyncComponent, ref, shallowRef } from \"vue\";\nimport { useI18n } from \"vue-i18n\";\nimport { usePluginModuleStore } from \"@/stores/plugin\";\n\ninterface usePluginLifeCycleReturn {\n isStarted: ComputedRef;\n getStatusDotState: () => string;\n getStatusMessage: () => string | undefined;\n changeStatus: () => void;\n changingStatus: Ref;\n uninstall: (deleteExtensions?: boolean) => void;\n}\n\nexport function usePluginLifeCycle(\n plugin?: Ref\n): usePluginLifeCycleReturn {\n const { t } = useI18n();\n\n const isStarted = computed(() => {\n return (\n plugin?.value?.status?.phase === PluginStatusPhaseEnum.Started &&\n plugin.value?.spec.enabled\n );\n });\n\n const getStatusDotState = () => {\n const { phase } = plugin?.value?.status || {};\n const { enabled } = plugin?.value?.spec || {};\n\n if (enabled && phase === PluginStatusPhaseEnum.Failed) {\n return \"error\";\n }\n\n if (phase === PluginStatusPhaseEnum.Disabling) {\n return \"warning\";\n }\n\n return \"default\";\n };\n\n const getStatusMessage = () => {\n if (!plugin?.value) return;\n\n const { phase } = plugin.value.status || {};\n\n if (\n phase === PluginStatusPhaseEnum.Failed ||\n phase === PluginStatusPhaseEnum.Disabling\n ) {\n const lastCondition = plugin.value.status?.conditions?.[0];\n\n return (\n [lastCondition?.reason, lastCondition?.message]\n .filter(Boolean)\n .join(\": \") || \"Unknown\"\n );\n }\n\n // Starting up\n if (\n phase !== (PluginStatusPhaseEnum.Started || PluginStatusPhaseEnum.Failed)\n ) {\n return t(\"core.common.status.starting_up\");\n }\n };\n\n const { isLoading: changingStatus, mutate: changeStatus } = useMutation({\n mutationKey: [\"change-plugin-status\"],\n mutationFn: async () => {\n if (!plugin?.value) return;\n\n const { enabled } = plugin.value.spec;\n\n return await consoleApiClient.plugin.plugin.changePluginRunningState({\n name: plugin.value.metadata.name,\n pluginRunningStateRequest: {\n enable: !enabled,\n },\n });\n },\n retry: 3,\n retryDelay: 1000,\n onSuccess() {\n window.location.reload();\n },\n });\n\n const uninstall = (deleteExtensions?: boolean) => {\n if (!plugin?.value) return;\n\n const { enabled } = plugin.value.spec;\n\n Dialog.warning({\n title: `${\n deleteExtensions\n ? t(\"core.plugin.operations.uninstall_and_delete_config.title\")\n : t(\"core.plugin.operations.uninstall.title\")\n }`,\n description: `${\n enabled\n ? t(\"core.plugin.operations.uninstall_when_enabled.description\")\n : t(\"core.common.dialog.descriptions.cannot_be_recovered\")\n }`,\n confirmType: \"danger\",\n confirmText: `${\n enabled\n ? t(\"core.plugin.operations.uninstall_when_enabled.confirm_text\")\n : t(\"core.common.buttons.uninstall\")\n }`,\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n if (!plugin.value) return;\n\n try {\n await consoleApiClient.plugin.plugin.changePluginRunningState({\n name: plugin.value.metadata.name,\n pluginRunningStateRequest: {\n enable: false,\n },\n });\n\n await coreApiClient.plugin.plugin.deletePlugin({\n name: plugin.value.metadata.name,\n });\n\n // delete plugin setting and configMap\n if (deleteExtensions) {\n const { settingName, configMapName } = plugin.value.spec;\n\n if (settingName) {\n await coreApiClient.setting.deleteSetting(\n {\n name: settingName,\n },\n {\n mute: true,\n }\n );\n }\n\n if (configMapName) {\n await coreApiClient.configMap.deleteConfigMap(\n {\n name: configMapName,\n },\n {\n mute: true,\n }\n );\n }\n }\n\n Toast.success(t(\"core.common.toast.uninstall_success\"));\n } catch (e) {\n console.error(\"Failed to uninstall plugin\", e);\n } finally {\n window.location.reload();\n }\n },\n });\n };\n\n return {\n isStarted,\n getStatusDotState,\n getStatusMessage,\n changeStatus,\n changingStatus,\n uninstall,\n };\n}\n\nexport function usePluginBatchOperations(names: Ref) {\n const { t } = useI18n();\n\n function handleUninstallInBatch(deleteExtensions: boolean) {\n Dialog.warning({\n title: `${\n deleteExtensions\n ? t(\n \"core.plugin.operations.uninstall_and_delete_config_in_batch.title\"\n )\n : t(\"core.plugin.operations.uninstall_in_batch.title\")\n }`,\n description: t(\"core.common.dialog.descriptions.cannot_be_recovered\"),\n confirmType: \"danger\",\n confirmText: t(\"core.common.buttons.uninstall\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n for (let i = 0; i < names.value.length; i++) {\n await coreApiClient.plugin.plugin.deletePlugin({\n name: names.value[i],\n });\n\n if (deleteExtensions) {\n const { data: plugin } =\n await coreApiClient.plugin.plugin.getPlugin({\n name: names.value[i],\n });\n\n const { settingName, configMapName } = plugin.spec;\n\n if (settingName) {\n await coreApiClient.setting.deleteSetting(\n {\n name: settingName,\n },\n {\n mute: true,\n }\n );\n }\n\n if (configMapName) {\n await coreApiClient.configMap.deleteConfigMap(\n {\n name: configMapName,\n },\n {\n mute: true,\n }\n );\n }\n }\n }\n\n window.location.reload();\n } catch (e) {\n console.error(\"Failed to uninstall plugin in batch\", e);\n }\n },\n });\n }\n\n function handleChangeStatusInBatch(enabled: boolean) {\n Dialog.info({\n title: enabled\n ? t(\"core.plugin.operations.change_status_in_batch.activate_title\")\n : t(\"core.plugin.operations.change_status_in_batch.inactivate_title\"),\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n for (let i = 0; i < names.value.length; i++) {\n await consoleApiClient.plugin.plugin.changePluginRunningState({\n name: names.value[i],\n pluginRunningStateRequest: {\n enable: enabled,\n },\n });\n }\n\n window.location.reload();\n } catch (e) {\n console.error(\"Failed to change plugin status in batch\", e);\n }\n },\n });\n }\n\n return { handleUninstallInBatch, handleChangeStatusInBatch };\n}\n\nexport function usePluginDetailTabs(\n pluginName: Ref,\n recordsActiveTab: boolean\n) {\n const { t } = useI18n();\n\n const initialTabs = [\n {\n id: \"detail\",\n label: t(\"core.plugin.tabs.detail\"),\n component: defineAsyncComponent({\n loader: () => import(\"../components/tabs/Detail.vue\"),\n loadingComponent: VLoading,\n }),\n },\n ];\n\n const tabs = shallowRef(initialTabs);\n const activeTab = recordsActiveTab\n ? useRouteQuery(\"tab\", tabs.value[0].id)\n : ref(tabs.value[0].id);\n\n const { data: plugin } = useQuery({\n queryKey: [\"plugin\", pluginName],\n queryFn: async () => {\n const { data } = await coreApiClient.plugin.plugin.getPlugin({\n name: pluginName.value as string,\n });\n return data;\n },\n async onSuccess(data) {\n if (\n !data.spec.settingName ||\n !utils.permission.has([\"system:plugins:manage\"])\n ) {\n tabs.value = [...initialTabs, ...(await getTabsFromExtensions())];\n }\n },\n });\n\n const { data: setting } = useQuery({\n queryKey: [\"plugin-setting\", plugin],\n queryFn: async () => {\n const { data } = await consoleApiClient.plugin.plugin.fetchPluginSetting({\n name: plugin.value?.metadata.name as string,\n });\n return data;\n },\n enabled: computed(() => {\n return (\n !!plugin.value &&\n !!plugin.value.spec.settingName &&\n utils.permission.has([\"system:plugins:manage\"])\n );\n }),\n async onSuccess(data) {\n if (data) {\n const { forms } = data.spec;\n tabs.value = [\n ...initialTabs,\n ...(await getTabsFromExtensions()),\n ...forms.map((item: SettingForm) => {\n return {\n id: item.group,\n label: item.label || \"\",\n component: defineAsyncComponent({\n loader: () => import(\"../components/tabs/Setting.vue\"),\n loadingComponent: VLoading,\n }),\n };\n }),\n ] as PluginTab[];\n }\n },\n });\n\n async function getTabsFromExtensions() {\n const { pluginModuleMap } = usePluginModuleStore();\n\n const currentPluginModule = pluginModuleMap[pluginName.value as string];\n\n if (!currentPluginModule) {\n return [];\n }\n\n const callbackFunction =\n currentPluginModule?.extensionPoints?.[\"plugin:self:tabs:create\"];\n\n if (typeof callbackFunction !== \"function\") {\n return [];\n }\n\n const pluginTabs = await callbackFunction();\n\n return pluginTabs.filter((tab) => {\n return utils.permission.has(tab.permissions || []);\n });\n }\n\n return {\n plugin,\n setting,\n tabs,\n activeTab,\n };\n}\n" }, { "path": "ui/console-src/modules/system/plugins/constants/index.ts", "content": "export const PLUGIN_ALREADY_EXISTS_TYPE =\n \"https://halo.run/probs/plugin-alreay-exists\";\n" }, { "path": "ui/console-src/modules/system/plugins/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconPlug } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport type { RouteRecordRaw } from \"vue-router\";\nimport PluginDetailModal from \"./components/PluginDetailModal.vue\";\n\ndeclare module \"vue\" {\n interface GlobalComponents {\n PluginDetailModal: (typeof import(\"./components/PluginDetailModal.vue\"))[\"default\"];\n }\n}\n\nexport default definePlugin({\n components: {\n PluginDetailModal,\n },\n routes: [\n {\n path: \"/plugins\",\n name: \"PluginsRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.plugin.title\",\n searchable: true,\n permissions: [\"system:plugins:view\"],\n menu: {\n name: \"core.sidebar.menu.items.plugins\",\n group: \"system\",\n icon: markRaw(IconPlug),\n priority: 0,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Plugins\",\n component: () => import(\"./PluginList.vue\"),\n },\n {\n path: \"extension-point-settings\",\n name: \"PluginExtensionPointSettings\",\n component: () => import(\"./PluginExtensionPointSettings.vue\"),\n meta: {\n title: \"core.plugin.extension-settings.title\",\n hideFooter: true,\n permissions: [\"*\"],\n },\n },\n {\n path: \":name\",\n name: \"PluginDetail\",\n component: () => import(\"./PluginDetail.vue\"),\n meta: {\n title: \"core.plugin.detail.title\",\n permissions: [\"system:plugins:view\"],\n },\n },\n ],\n } as RouteRecordRaw,\n ],\n});\n" }, { "path": "ui/console-src/modules/system/plugins/types/index.ts", "content": "export interface PluginInstallationErrorResponse {\n detail: string;\n instance: string;\n pluginName: string;\n requestId: string;\n status: number;\n timestamp: string;\n title: string;\n type: string;\n}\n" }, { "path": "ui/console-src/modules/system/roles/RoleDetail.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/roles/RoleList.vue", "content": "\n\n \n \n \n \n \n\n" }, { "path": "ui/console-src/modules/system/roles/components/RoleEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/roles/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/users/roles\",\n component: BasicLayout,\n children: [\n {\n path: \"\",\n name: \"Roles\",\n component: () => import(\"./RoleList.vue\"),\n meta: {\n title: \"core.role.title\",\n searchable: true,\n permissions: [\"system:roles:view\"],\n },\n },\n {\n path: \":name\",\n name: \"RoleDetail\",\n component: () => import(\"./RoleDetail.vue\"),\n meta: {\n title: \"core.role.detail.title\",\n permissions: [\"system:roles:view\"],\n },\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/settings/SystemSettings.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/settings/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconSettings } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/settings\",\n name: \"SettingsRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.setting.title\",\n permissions: [\"system:settings:view\"],\n menu: {\n name: \"core.sidebar.menu.items.settings\",\n group: \"system\",\n icon: markRaw(IconSettings),\n priority: 2,\n },\n },\n children: [\n {\n path: \"\",\n name: \"SystemSetting\",\n component: () => import(\"./SystemSettings.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/settings/tabs/NotificationSetting.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/settings/tabs/Notifications.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/settings/tabs/Setting.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/tools/Tools.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/tools/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconToolsFill } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [\n {\n path: \"/tools\",\n name: \"ToolsRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.tool.title\",\n menu: {\n name: \"core.sidebar.menu.items.tools\",\n group: \"system\",\n icon: markRaw(IconToolsFill),\n priority: 5,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Tools\",\n component: () => import(\"./Tools.vue\"),\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/users/UserDetail.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/users/UserList.vue", "content": "\n\n \n \n \n\n \n \n \n\n" }, { "path": "ui/console-src/modules/system/users/components/GrantPermissionModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/users/components/RolesView.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/users/components/UserCreationModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/users/components/UserEditingModal.vue", "content": "\n\n" }, { "path": "ui/console-src/modules/system/users/components/UserListItem.vue", "content": "\n\n\n \n\n" }, { "path": "ui/console-src/modules/system/users/components/UserPasswordChangeModal.vue", "content": "\n\n\n" }, { "path": "ui/console-src/modules/system/users/composables/use-role.ts", "content": "import {\n coreApiClient,\n paginate,\n type Role,\n type RoleV1alpha1ApiListRoleRequest,\n} from \"@halo-dev/api-client\";\nimport { useQuery } from \"@tanstack/vue-query\";\nimport { roleLabels } from \"@/constants/labels\";\n\nexport function useFetchRoles() {\n return useQuery({\n queryKey: [\"core:roles\"],\n queryFn: async () => {\n return await paginate(\n (params) => coreApiClient.role.listRole(params),\n {\n size: 1000,\n labelSelector: [`!${roleLabels.TEMPLATE}`],\n }\n );\n },\n refetchInterval(data) {\n const hasDeletingRole = data?.some(\n (item) => !!item.metadata.deletionTimestamp\n );\n return hasDeletingRole ? 1000 : false;\n },\n });\n}\n\nexport function useFetchRoleTemplates() {\n return useQuery({\n queryKey: [\"core:role-templates\"],\n queryFn: async () => {\n return await paginate(\n (params) => coreApiClient.role.listRole(params),\n {\n size: 1000,\n labelSelector: [`${roleLabels.TEMPLATE}=true`, \"!halo.run/hidden\"],\n }\n );\n },\n });\n}\n" }, { "path": "ui/console-src/modules/system/users/composables/use-user.ts", "content": "import { consoleApiClient } from \"@halo-dev/api-client\";\nimport { Dialog, Toast } from \"@halo-dev/components\";\nimport { useI18n } from \"vue-i18n\";\n\nexport function useUserEnableDisable() {\n const { t } = useI18n();\n\n const handleEnableOrDisableUser = ({\n name,\n operation,\n onSuccess,\n }: {\n name: string;\n operation: \"enable\" | \"disable\";\n onSuccess?: () => void;\n }) => {\n const operations = {\n enable: {\n title: t(\"core.user.operations.enable.title\"),\n description: t(\"core.user.operations.enable.description\"),\n request: (name: string) =>\n consoleApiClient.user.enableUser({ username: name }),\n message: t(\"core.common.toast.enable_success\"),\n },\n disable: {\n title: t(\"core.user.operations.disable.title\"),\n description: t(\"core.user.operations.disable.description\"),\n request: (name: string) =>\n consoleApiClient.user.disableUser({ username: name }),\n message: t(\"core.common.toast.disable_success\"),\n },\n };\n\n const operationConfig = operations[operation];\n\n Dialog.warning({\n title: operationConfig.title,\n description: operationConfig.description,\n confirmType: \"danger\",\n confirmText: t(\"core.common.buttons.confirm\"),\n cancelText: t(\"core.common.buttons.cancel\"),\n onConfirm: async () => {\n try {\n await operationConfig.request(name);\n\n Toast.success(operationConfig.message);\n onSuccess?.();\n } catch (e) {\n console.error(\"Failed to enable or disable user\", e);\n }\n },\n });\n };\n\n return {\n handleEnableOrDisableUser,\n };\n}\n" }, { "path": "ui/console-src/modules/system/users/module.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport { IconUserSettings } from \"@halo-dev/components\";\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n routes: [\n {\n path: \"/users\",\n name: \"UsersRoot\",\n component: BasicLayout,\n meta: {\n title: \"core.user.title\",\n searchable: true,\n permissions: [\"system:users:view\"],\n menu: {\n name: \"core.sidebar.menu.items.users\",\n group: \"system\",\n icon: markRaw(IconUserSettings),\n priority: 1,\n mobile: true,\n },\n },\n children: [\n {\n path: \"\",\n name: \"Users\",\n component: () => import(\"./UserList.vue\"),\n },\n {\n path: \":name\",\n name: \"UserDetail\",\n component: () => import(\"./UserDetail.vue\"),\n meta: {\n title: \"core.user.detail.title\",\n },\n },\n ],\n },\n ],\n});\n" }, { "path": "ui/console-src/modules/system/users/tabs/Detail.vue", "content": "\n\n" }, { "path": "ui/console-src/router/constant.ts", "content": "import type { MenuGroupType } from \"@halo-dev/ui-shared\";\n\nexport const coreMenuGroups: MenuGroupType[] = [\n {\n id: \"dashboard\",\n name: undefined,\n priority: 0,\n },\n {\n id: \"content\",\n name: \"core.sidebar.menu.groups.content\",\n priority: 1,\n },\n {\n id: \"interface\",\n name: \"core.sidebar.menu.groups.interface\",\n priority: 2,\n },\n {\n id: \"system\",\n name: \"core.sidebar.menu.groups.system\",\n priority: 3,\n },\n {\n id: \"tool\",\n name: \"core.sidebar.menu.groups.tool\",\n priority: 4,\n },\n];\n" }, { "path": "ui/console-src/router/guards/auth-check.ts", "content": "import { stores } from \"@halo-dev/ui-shared\";\nimport type { Router } from \"vue-router\";\n\nexport function setupAuthCheckGuard(router: Router) {\n router.beforeEach((_to, _, next) => {\n const currentUserStore = stores.currentUser();\n\n if (currentUserStore.isAnonymous) {\n window.location.href = `/login?redirect_uri=${encodeURIComponent(\n window.location.href\n )}`;\n return;\n }\n\n next();\n });\n}\n" }, { "path": "ui/console-src/router/guards/permission.ts", "content": "import type { Role } from \"@halo-dev/api-client\";\nimport { stores, utils } from \"@halo-dev/ui-shared\";\nimport type { RouteLocationNormalized, Router } from \"vue-router\";\nimport { rbacAnnotations } from \"@/constants/annotations\";\nimport { SUPER_ROLE_NAME } from \"@/constants/constants\";\n\nexport function setupPermissionGuard(router: Router) {\n router.beforeEach(async (to, _, next) => {\n const currentUserStore = stores.currentUser();\n\n if (isConsoleAccessDisallowed(currentUserStore.currentUser?.roles)) {\n window.location.href = \"/uc\";\n return;\n }\n\n if (\n await checkRoutePermissions(\n to,\n utils.permission.getUserPermissions() || []\n )\n ) {\n next();\n } else {\n next({ name: \"Forbidden\" });\n }\n });\n}\n\nfunction isConsoleAccessDisallowed(currentRoles?: Role[]): boolean {\n if (currentRoles?.some((role) => role.metadata.name === SUPER_ROLE_NAME)) {\n return false;\n }\n\n return (\n currentRoles?.some(\n (role) =>\n role.metadata.annotations?.[rbacAnnotations.DISALLOW_ACCESS_CONSOLE] ===\n \"true\"\n ) || false\n );\n}\n\nasync function checkRoutePermissions(\n to: RouteLocationNormalized,\n uiPermissions: string[]\n): Promise {\n const { meta } = to;\n\n if (!meta?.permissions) {\n return true;\n }\n\n if (typeof meta.permissions === \"function\") {\n try {\n return await meta.permissions(uiPermissions);\n } catch (e) {\n console.error(\n `Error checking permissions for route ${String(to.name)}:`,\n e\n );\n return false;\n }\n }\n\n return utils.permission.has(meta.permissions as string[]);\n}\n" }, { "path": "ui/console-src/router/index.ts", "content": "import routesConfig from \"@console/router/routes.config\";\nimport {\n createRouter,\n createWebHistory,\n type RouteLocationNormalized,\n type RouteLocationNormalizedLoaded,\n} from \"vue-router\";\nimport { setupStopImplicitSubmission } from \"@/formkit/plugins/stop-implicit-submission\";\nimport { setupProcessBarGuard } from \"@/router/process-bar\";\nimport { setupAuthCheckGuard } from \"./guards/auth-check\";\nimport { setupPermissionGuard } from \"./guards/permission\";\n\nconst router = createRouter({\n history: createWebHistory(\"/console/\"),\n routes: routesConfig,\n scrollBehavior: (\n to: RouteLocationNormalized,\n from: RouteLocationNormalizedLoaded\n ) => {\n if (to.name !== from.name) {\n return { left: 0, top: 0 };\n }\n },\n});\n\nsetupAuthCheckGuard(router);\nsetupPermissionGuard(router);\nsetupProcessBarGuard(router);\nsetupStopImplicitSubmission(router);\n\nexport default router;\n" }, { "path": "ui/console-src/router/routes.config.ts", "content": "import BasicLayout from \"@console/layouts/BasicLayout.vue\";\nimport type { RouteRecordRaw } from \"vue-router\";\n\nexport const routes: Array = [\n {\n path: \"/:pathMatch(.*)*\",\n component: BasicLayout,\n children: [\n {\n path: \"\",\n name: \"NotFound\",\n component: () => import(\"@/views/exceptions/NotFound.vue\"),\n },\n ],\n },\n {\n path: \"/403\",\n component: BasicLayout,\n children: [\n {\n path: \"\",\n name: \"Forbidden\",\n component: () => import(\"@/views/exceptions/Forbidden.vue\"),\n },\n ],\n },\n];\n\nexport default routes;\n" }, { "path": "ui/console-src/stores/theme.ts", "content": "import type { Theme } from \"@halo-dev/api-client\";\nimport { consoleApiClient } from \"@halo-dev/api-client\";\nimport { utils } from \"@halo-dev/ui-shared\";\nimport { defineStore } from \"pinia\";\nimport { ref } from \"vue\";\n\nexport const useThemeStore = defineStore(\"theme\", () => {\n const activatedTheme = ref();\n\n async function fetchActivatedTheme() {\n if (!utils.permission.has([\"system:themes:view\"])) {\n return;\n }\n\n try {\n const { data } = await consoleApiClient.theme.theme.fetchActivatedTheme({\n mute: true,\n });\n\n if (data) {\n activatedTheme.value = data;\n }\n } catch (e) {\n console.error(\"Failed to fetch active theme\", e);\n }\n }\n\n return { activatedTheme, fetchActivatedTheme };\n});\n" }, { "path": "ui/console.html", "content": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n
\n
\n \n \n\n" }, { "path": "ui/docs/components/README.md", "content": "# Console 组件介绍\n\n目前 Console 的组件包含基础组件（`@halo-dev/components`）和 Console 端的业务组件，这两种组件都可以在插件中使用。\n\n## 业务组件\n\n### AnnotationsForm\n\n此组件用于为自定义模型设置 annotations 数据，同时支持自定义 key / value 和自定义表单，表单定义方式可以参考：\n\n使用方式：\n\n```vue\n\n\n\n```\n\n其中，kind 和 group 为必填项，分别表示模型的 kind 和 group。\n" }, { "path": "ui/docs/custom-formkit-input/README.md", "content": "# 自定义 FormKit 输入组件\n\n## 原由\n\n目前在 Console 端的所有表单都使用了 FormKit，但 FormKit 内置的 Input 组件并不满足所有的需求，因此需要自定义一些 Input 组件。此外，为了插件和主题能够更加方便的使用系统内的一些数据，所以同样需要自定义一些带数据的选择组件。\n\n## 使用方式\n\n目前已提供以下类型：\n\n- `code`: 代码编辑器\n - 参数\n 1. language: 目前支持 `yaml`, `html`, `css`, `javascript`, `json`\n 2. height: 编辑器高度，如：`100px`\n- `attachment`: 附件选择\n - 参数\n 1. accepts：允许上传的文件类型，如：`image/*`\n- `repeater`: 定义一个对象集合，可以让使用者可视化的操作集合。\n - 参数\n 1. min: 最小数量，默认为 `0`\n 2. max: 最大数量，默认为 `Infinity`，即无限制。\n 3. addLabel: 添加按钮的文本，默认为 `添加`\n 4. addButton: 是否显示添加按钮，默认为 `true`\n 5. upControl: 是否显示上移按钮，默认为 `true`\n 6. downControl: 是否显示下移按钮，默认为 `true`\n 7. insertControl: 是否显示插入按钮，默认为 `true`\n 8. removeControl: 是否显示删除按钮，默认为 `true`\n- `list`: 动态列表，定义一个数组列表。\n - 参数\n 1. itemType: 列表项的数据类型，用于初始化数据类型，可选参数 `string`, `number`, `boolean`, `object`，默认为 `string`\n 2. min: 最小数量，默认为 `0`\n 3. max: 最大数量，默认为 `Infinity`，即无限制。\n 4. addLabel: 添加按钮的文本，默认为 `添加`\n 5. addButton: 是否显示添加按钮，默认为 `true`\n 6. upControl: 是否显示上移按钮，默认为 `true`\n 7. downControl: 是否显示下移按钮，默认为 `true`\n 8. insertControl: 是否显示插入按钮，默认为 `true`\n 9. removeControl: 是否显示删除按钮，默认为 `true`\n- `menuCheckbox`：选择一组菜单\n- `menuRadio`：选择一个菜单\n- `menuSelect`: 通用菜单选择组件，支持单选、多选、排序\n- `menuItemSelect`：选择菜单项\n- `postSelect`：选择文章\n- `singlePageSelect`：选择自定义页面\n- `categorySelect`：选择分类\n - 参数\n 1. multiple: 是否多选，默认为 `false`\n- `categoryCheckbox`：选择多个分类\n- `tagSelect`：选择标签\n - 参数\n 1. multiple: 是否多选，默认为 `false`\n- `tagCheckbox`：选择多个标签\n- `verificationForm`: 远程验证一组数据是否符合某个规则\n - 参数\n 1. action: 对目标数据进行验证的接口地址\n 2. label: 验证按钮文本\n 3. buttonAttrs: 验证按钮的额外属性\n- `secret`: 用于选择或者管理密钥（Secret）\n - 参数\n 1. requiredKeys：用于确认所需密钥的字段名称，数组类型，每个元素包含 `key` 和 `help` 两个属性。\n- `select`: 自定义的选择器组件，用于在备选项中选择一个或多个选项\n - 参数\n 1. `options`：静态数据源。当 `action` 或 `remote` 存在时，此参数无效。\n 2. `action`：远程动态数据源的接口地址。\n 3. `requestOption`： 动态数据源的请求参数，可以通过此参数来指定如何获取数据，适配不同的接口。当 `action` 存在时，此参数有效。\n 4. `remote`：标识当前是否由用户自定义的远程数据源。\n 5. `remoteOption`：当 `remote` 为 `true` 时，此配置项必须存在，用于为 Select 组件提供处理搜索及查询键值对的方法。\n 6. `remoteOptimize`：是否开启远程数据源优化，默认为 `true`。开启后，将会对远程数据源进行优化，减少请求次数。仅在动态数据源下有效。\n 7. `allowCreate`：是否允许创建新选项，默认为 `false`。仅在静态数据源下有效，需要同时开启 `searchable`。\n 8. `clearable`：是否允许清空选项，默认为 `false`。\n 9. `multiple`：是否多选，默认为 `false`。\n 10. `maxCount`：多选时最大可选数量，默认为 `Infinity`。仅在多选时有效。\n 11. `sortable`：是否支持拖动排序，默认为 `false`。仅在多选时有效。\n 12. `searchable`：是否支持搜索内容，默认为 `false`。\n 13. `autoSelect`：当 value 不存在时，是否自动选择第一个选项，默认为 `true`。仅在单选时有效。\n\n在 Vue 单组件中使用：\n\n```vue\n\n\n\n```\n\n在 FormKit Schema 中使用（插件 / 主题设置表单定义）：\n\n```yaml\n- $formkit: menuRadio\n name: menus\n label: 底部菜单组\n```\n\n### select\n\nselect 是一个选择器类型的输入组件，使用者可以从一批待选数据中选择一个或多个选项。它支持单选、多选操作，并且支持静态数据及远程动态数据加载等多种方式。\n\n#### 在 Vue SFC 中以组件形式使用\n\n静态数据源：\n\n```vue\n\n\n```\n\n动态数据源：\n\n```vue\n\n\n```\n\n#### 在 FormKit Schema 中使用\n\n静态数据源：\n\n```yaml\n- $formkit: select\n name: countries\n label: What country makes the best food?\n sortable: true\n multiple: true\n clearable: true\n placeholder: Select a country\n options:\n - label: China\n value: cn\n - label: France\n value: fr\n - label: Germany\n value: de\n - label: Spain\n value: es\n - label: Italy\n value: ie\n - label: Greece\n value: gr\n```\n\n远程动态数据源：\n\n支持远程动态数据源，通过 `action` 和 `requestOption` 参数来指定如何获取数据。\n\n请求的接口将会自动拼接 `page`、`size` 与 `keyword` 参数，其中 `keyword` 为搜索关键词。\n\n```yaml\n- $formkit: select\n name: postName\n label: Choose an post\n clearable: true\n action: /apis/api.console.halo.run/v1alpha1/posts\n requestOption:\n method: GET\n pageField: page\n sizeField: size\n totalField: total\n itemsField: items\n labelField: post.spec.title\n valueField: post.metadata.name\n fieldSelectorKey: metadata.name\n```\n\n> [!NOTE]\n> 当远程数据具有分页时，可能会出现默认选项不在第一页的情况，此时 Select 组件将会发送另一个查询请求，以获取默认选项的数据。此接口会携带如下参数 `fieldSelector: ${requestOption.fieldSelectorKey}=(value1,value2,value3)`。\n\n> 其中，value1, value2, value3 为默认选项的值。返回值与查询一致，通过 `requestOption` 解析。\n\n### list\n\nlist 是一个数组类型的输入组件，可以让使用者可视化的操作数组。它支持动态添加、删除、上移、下移、插入数组项等操作。\n\n在 Vue SFC 中以组件形式使用：\n\n```vue\n\n\n\n```\n\n在 FormKit Schema 中使用：\n\n```yaml\n- $formkit: list\n name: users\n label: Users\n addLabel: Add User\n min: 1\n max: 3\n itemType: string\n children:\n - $formkit: text\n index: \"$index\"\n validation: required\n```\n\n> [!NOTE]\n> `list` 组件有且只有一个子节点，并且必须为子节点传递 `index` 属性。若想提供多个字段，则建议使用 `group` 组件包裹。\n\n最终得到的数据类似于：\n\n```json\n{\n \"users\": [\n \"Jack\",\n \"John\"\n ]\n}\n```\n\n### Repeater\n\nRepeater 是一个集合类型的输入组件，可以让使用者可视化的操作集合。\n\n在 Vue SFC 中以组件形式使用：\n\n```vue\n\n\n\n```\n\n在 FormKit Schema 中使用：\n\n```yaml\n- $formkit: repeater\n name: users\n label: Users\n addLabel: Add User\n min: 1\n max: 3\n items:\n - $formkit: text\n name: full_name\n label: Full Name\n validation: required\n - $formkit: email\n name: email\n label: Email\n validation: required|email\n```\n\n最终得到的数据类似于：\n\n```json\n[\n {\n \"full_name\": \"Jack\",\n \"email\": \"jack@example.com\"\n },\n {\n \"full_name\": \"John\",\n \"email\": \"john@example.com\"\n }\n]\n```\n" }, { "path": "ui/docs/extension-points/backup.md", "content": "# 备份页面选项卡扩展点\n\n## 原由\n\n在 Halo 2.8 中提供了基础备份和恢复的功能，此扩展点是为了提供给插件开发者针对备份扩展更多功能，比如定时备份设置、备份到第三方云存储等。\n\n## 定义方式\n\n```ts\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport BackupStorage from \"@/views/BackupStorage.vue\";\nimport { markRaw } from \"vue\";\n\nexport default definePlugin({\n components: {},\n routes: [],\n extensionPoints: {\n \"backup:tabs:create\": () => {\n return [\n {\n id: \"storage\",\n label: \"备份位置\",\n component: markRaw(BackupStorage),\n },\n ];\n },\n },\n});\n```\n\nBackupTab 类型：\n\n```ts\nimport type { Component, Raw } from \"vue\";\n\nexport interface BackupTab {\n id: string;\n label: string;\n component: Raw;\n permissions?: string[];\n}\n\n```\n" }, { "path": "ui/docs/extension-points/comment-content.md", "content": "# 评论列表内容显示扩展点\n\n用于替换 Halo 在 Console 的默认评论列表内容显示组件。\n\n> 注意：\n> 此扩展点并非通用扩展点，由于 Halo 早期设定，Halo 在前台的评论组件 UI 部分由 [评论组件插件](http://github.com/halo-dev/plugin-comment-widget) 提供，而在此插件的后续版本中提供了富文本渲染的功能，所以为了保持 Console 的评论列表内容显示与前台一致，所以专为此插件提供了替换输入框的扩展点。\n\n## 定义方式\n\n```ts\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport CommentContent from \"./components/CommentContent.vue\";\n\nexport default definePlugin({\n extensionPoints: {\n \"comment:list-item:content:replace\": () => {\n return {\n component: markRaw(CommentContent),\n };\n },\n },\n});\n```\n\n其中，组件需要包含的 props 如下：\n\n1. `content`：评论内容，`html` 格式。\n\n" }, { "path": "ui/docs/extension-points/comment-editor.md", "content": "# 评论编辑器扩展点\n\n用于替换 Halo 在 Console 的默认评论输入框。\n\n> 注意：\n> 此扩展点并非通用扩展点，由于 Halo 早期设定，Halo 在前台的评论组件 UI 部分由 [评论组件插件](http://github.com/halo-dev/plugin-comment-widget) 提供，而在此插件的后续版本中提供了富文本编辑器的功能，所以为了保持 Console 的评论输入框与前台一致，所以专为此插件提供了替换输入框的扩展点。\n\n## 定义方式\n\n```ts\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport CommentEditor from \"./components/CommentEditor.vue\";\n\nexport default definePlugin({\n extensionPoints: {\n \"comment:editor:replace\": () => {\n return {\n component: markRaw(CommentEditor),\n };\n },\n },\n});\n```\n\n其中，组件需要包含的 props 如下：\n\n1. `autoFocus`：是否自动聚焦，需要在组件中判断是否为 `true`，然后聚焦输入框。\n\n需要定义的 emit 如下：\n\n1. `(event: \"update\", value: { content: string; characterCount: number })`：向调用方传递内容和字符数更新的事件。\n" }, { "path": "ui/docs/extension-points/comment-subject-ref.md", "content": "# 评论来源显示拓展点\n\n在 Console 中，评论管理列表的评论来源默认仅支持显示来自文章和页面的评论，如果其他插件中的业务模块也使用了评论，那么就可以通过该拓展点来扩展评论来源的显示。\n\n## 定义方式\n\n假设以文章为例：\n\n```ts\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport type { CommentSubjectRefResult } from \"@halo-dev/ui-shared\";\nimport type { Extension } from \"@halo-dev/api-client\";\nimport type { Post } from \"./types\";\n\nexport default definePlugin({\n components: {},\n extensionPoints: {\n \"comment:subject-ref:create\": () => {\n return [\n {\n kind: \"Post\",\n group: \"post.halo.run\",\n resolve: (subject: Extension): CommentSubjectRefResult => {\n const post = subject as Post;\n return {\n label: \"文章\",\n title: post.spec.title,\n externalUrl: post.status.permalink,\n route: {\n name: \"PostEditor\",\n params: {\n name: post.metadata.name\n }\n },\n };\n },\n },\n ];\n },\n },\n});\n```\n\n类型定义如下：\n\n```ts\ntype CommentSubjectRefProvider = {\n kind: string; // 自定义模型的类型\n group: string; // 自定义模型的分组\n resolve: (subject: Extension) => CommentSubjectRefResult;\n}\n\ninterface CommentSubjectRefResult {\n label: string; // 来源名称（类型）\n title: string; // 来源标题\n route?: RouteLocationRaw; // Console 的路由，可以设置为来源的详情或者编辑页面\n externalUrl?: string; // 访问地址，可以设置为前台资源的访问地址\n}\n```\n" }, { "path": "ui/docs/extension-points/dashboard.md", "content": "# 仪表盘扩展点\n\n## 概述\n\n仪表盘扩展点允许插件为 Halo 的控制台仪表盘添加自定义小部件和快速操作项。通过这些扩展点，插件可以：\n\n- 创建自定义的仪表盘小部件来展示特定数据或功能\n- 为快速操作小部件添加自定义操作项\n\n## console:dashboard:widgets:create\n\n此扩展点用于创建自定义的仪表盘小部件。\n\n### 定义方式\n\n```ts\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport MyCustomWidget from \"./components/MyCustomWidget.vue\";\n\nexport default definePlugin({\n extensionPoints: {\n \"console:dashboard:widgets:create\": () => {\n return [\n {\n id: \"my-custom-widget\",\n component: markRaw(MyCustomWidget),\n group: \"my-plugin\",\n configFormKitSchema: [\n {\n $formkit: \"text\",\n name: \"title\",\n label: \"标题\",\n value: \"默认标题\",\n },\n {\n $formkit: \"number\",\n name: \"refresh_interval\",\n label: \"刷新间隔（秒）\",\n value: 30,\n min: 10,\n },\n ],\n defaultConfig: {\n title: \"我的自定义小部件\",\n refresh_interval: 30,\n },\n defaultSize: {\n w: 6,\n h: 8,\n minW: 3,\n minH: 4,\n maxW: 12,\n maxH: 16,\n },\n permissions: [\"plugin:my-plugin:view\"],\n },\n ];\n },\n },\n});\n```\n\n### DashboardWidgetDefinition 类型\n\n```ts\nexport interface DashboardWidgetDefinition {\n id: string; // 小部件唯一标识符\n component: Raw; // 小部件 Vue 组件\n group: string; // 小部件分组，用于在小部件库中分类显示\n configFormKitSchema?:\n | Record[]\n | (() => Promise[]>)\n | (() => Record[]); // 配置表单 FormKit 定义，支持异步函数\n defaultConfig?: Record; // 默认配置\n defaultSize: { // 默认尺寸\n w: number; // 宽度（网格单位），根据不同屏幕尺寸，网格单位不同，可参考：{ lg: 12, md: 12, sm: 6, xs: 4 }\n h: number; // 高度（网格单位）\n minW?: number; // 最小宽度\n minH?: number; // 最小高度\n maxW?: number; // 最大宽度\n maxH?: number; // 最大高度\n };\n permissions?: string[]; // 访问权限\n}\n```\n\n### 小部件组件开发\n\n```vue\n\n\n\n```\n\n**小部件组件的属性与事件：**\n\n| 属性 | 类型 | 说明 |\n|---------------|-------------------------|--------------|\n| `editMode` | boolean | 是否为编辑模式 |\n| `previewMode` | boolean | 是否为预览模式 |\n| `config` | Record | 小部件配置 |\n\n| 事件 | 说明 |\n|-----------------|------------------|\n| `update:config` | 小部件配置更新事件 |\n\n**WidgetCard 组件的属性与插槽：**\n\n| 属性 | 类型 | 说明 |\n|---------------|-------------------------|--------------|\n| `title` | string | 小部件标题 |\n| `bodyClass` | string[] | 小部件内容区域样式 |\n\n| 插槽 | 说明 |\n|-----------|------------|\n| `title` | 小部件标题 |\n| `default` | 小部件内容 |\n| `actions` | 小部件操作项 |\n\n**重要说明：**\n\n- 小部件组件必须使用 `WidgetCard` 作为根组件，此组件已经在全局注册，不需要导入\n- 支持 `editMode` 和 `previewMode` 两种模式，当仪表盘处于编辑页面时，`editMode` 为 `true`，在小组件选择列表时，`previewMode` 为 `true`。可以根据这两个属性来控制小部件的显示内容\n- `update:config` 事件通常不需要实现，已经在内部实现了打开配置表单的功能，此事件用于自行实现配置表单\n- 使用 `markRaw()` 包装组件以避免响应式转换\n\n## console:dashboard:widgets:internal:quick-action:item:create\n\n此扩展点用于为快速操作小部件添加自定义操作项。\n\n### 定义方式\n\n```ts\nimport { definePlugin } from \"@halo-dev/ui-shared\";\nimport { markRaw } from \"vue\";\nimport { IconPlug } from \"@halo-dev/components\";\nimport { useRouter } from \"vue-router\";\n\nexport default definePlugin({\n extensionPoints: {\n \"console:dashboard:widgets:internal:quick-action:item:create\": () => {\n return [\n {\n id: \"my-plugin-action\",\n icon: markRaw(IconPlug),\n title: \"我的插件操作\",\n action: () => {\n // do something\n },\n permissions: [\"plugin:my-plugin:manage\"],\n },\n ];\n },\n },\n});\n```\n\n### 自定义组件操作项\n\n你也可以提供自定义组件而不是标准的操作项：\n\n```ts\nimport CustomActionItem from \"./components/CustomActionItem.vue\";\n\nexport default definePlugin({\n extensionPoints: {\n \"console:dashboard:widgets:internal:quick-action:item:create\": () => {\n return [\n {\n id: \"custom-action\",\n component: markRaw(CustomActionItem),\n permissions: [\"plugin:my-plugin:view\"],\n },\n ];\n },\n },\n});\n```\n\n自定义组件：\n\n```vue\n\n\n\n```\n\n### DashboardWidgetQuickActionItem 类型\n\n```ts\ninterface DashboardWidgetQuickActionBaseItem {\n id: string; // 操作项唯一标识符\n permissions?: string[]; // 访问权限\n}\n\ninterface DashboardWidgetQuickActionComponentItem\n extends DashboardWidgetQuickActionBaseItem {\n component: Raw; // 自定义组件\n icon?: Raw; // 图标（可选）\n title?: string; // 标题（可选）\n action?: () => void; // 点击操作（可选）\n}\n\ninterface DashboardWidgetQuickActionStandardItem\n extends DashboardWidgetQuickActionBaseItem {\n component?: never; // 不使用自定义组件\n icon: Raw; // 图标（必需）\n title: string; // 标题（必需）\n action: () => void; // 点击操作（必需）\n}\n\ninterface DashboardWidgetQuickActionRouteItem\n extends DashboardWidgetQuickActionBaseItem {\n component?: never; // 不使用自定义组件\n action?: never; // 不使用 action 回调\n icon: Raw; // 图标组件（必需）\n title: string; // 标题文本（必需）\n route: RouteLocationRaw; // 导航目标路由（必需），可以是路由名称、路径或完整路由配置\n}\n\n\nexport type DashboardWidgetQuickActionItem =\n | DashboardWidgetQuickActionComponentItem\n | DashboardWidgetQuickActionStandardItem\n | DashboardWidgetQuickActionRouteItem;\n```\n\n## 权限控制\n\n两个扩展点都支持权限控制：\n\n- **小部件权限**：通过 `permissions` 字段控制小部件的显示\n- **操作项权限**：通过 `permissions` 字段控制快速操作项的显示\n\n权限检查会自动进行，用户只能看到有权限访问的小部件和操作项。\n" }, { "path": "ui/docs/extension-points/default-editor–extension.md", "content": "# 默认编辑器扩展点\n\n该扩展点用于扩展默认编辑器的功能，包括 Tiptap Extension，以及工具栏、悬浮工具栏、Slash Command。\n\n## 定义方式\n\n```ts\nimport ExtensionFoo from \"./tiptap/extension-foo.ts\"\n\nexport default definePlugin({\n extensionPoints: {\n \"default:editor:extension:create\": () => {\n return [ExtensionFoo];\n },\n },\n});\n```\n\n其中，`ExtensionFoo` 是一个 Tiptap Extension，可以参考 [Tiptap 文档](https://tiptap.dev/) 和 [https://github.com/halo-sigs/richtext-editor/blob/main/docs/extension.md](https://github.com/halo-sigs/richtext-editor/blob/main/docs/extension.md)。\n" }, { "path": "ui/docs/extension-points/editor.md", "content": "# 编辑器集成扩展点\n\n## 定义方式\n\n```ts\nimport MarkdownEditor from \"./components/MarkdownEditor.vue\"\n\nexport default definePlugin({\n extensionPoints: {\n \"editor:create\": () => {\n return [\n {\n name: \"markdown-editor\",\n displayName: \"Markdown\",\n logo: \"logo.png\"\n component: markRaw(MarkdownEditor),\n rawType: \"markdown\",\n },\n ];\n },\n },\n});\n```\n\n- name: 编辑器名称，用于标识编辑器\n- displayName: 编辑器显示名称\n- component: 编辑器组件\n- rawType: 编辑器支持的原始类型，可以完全由插件定义。但必须保证最终能够将渲染后的 html 设置到 content 中。\n\n## 组件\n\n组件必须设置两个 `v-model` 绑定。即 `v-model:raw` 和 `v-model:content`，以下是示例：\n\n```vue\n