| # -*- Mode: perl; indent-tabs-mode: nil -*- |
| # |
| # The contents of this file are subject to the Mozilla Public |
| # License Version 1.1 (the "License"); you may not use this file |
| # except in compliance with the License. You may obtain a copy of |
| # the License at http://www.mozilla.org/MPL/ |
| # |
| # Software distributed under the License is distributed on an "AS |
| # IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or |
| # implied. See the License for the specific language governing |
| # rights and limitations under the License. |
| # |
| # The Original Code is the Bugzilla Bug Tracking System. |
| # |
| # Contributor(s): Marc Schumann <wurblzap@gmail.com> |
| # Max Kanat-Alexander <mkanat@bugzilla.org> |
| |
| package Bugzilla::WebService::Constants; |
| |
| use strict; |
| use base qw(Exporter); |
| |
| our @EXPORT = qw( |
| WS_ERROR_CODE |
| ERROR_UNKNOWN_FATAL |
| ERROR_UNKNOWN_TRANSIENT |
| XMLRPC_CONTENT_TYPE_WHITELIST |
| |
| WS_DISPATCH |
| ); |
| |
| # This maps the error names in global/*-error.html.tmpl to numbers. |
| # Generally, transient errors should have a number above 0, and |
| # fatal errors should have a number below 0. |
| # |
| # This hash should generally contain any error that could be thrown |
| # by the WebService interface. If it's extremely unlikely that the |
| # error could be thrown (like some CodeErrors), it doesn't have to |
| # be listed here. |
| # |
| # "Transient" means "If you resubmit that request with different data, |
| # it may work." |
| # |
| # "Fatal" means, "There's something wrong with Bugzilla, probably |
| # something an administrator would have to fix." |
| # |
| # NOTE: Numbers must never be recycled. If you remove a number, leave a |
| # comment that it was retired. Also, if an error changes its name, you'll |
| # have to fix it here. |
| use constant WS_ERROR_CODE => { |
| # Generic errors (Bugzilla::Object and others) are 50-99. |
| object_not_specified => 50, |
| reassign_to_empty => 50, |
| param_required => 50, |
| params_required => 50, |
| undefined_field => 50, |
| object_does_not_exist => 51, |
| param_must_be_numeric => 52, |
| number_not_numeric => 52, |
| param_invalid => 53, |
| number_too_large => 54, |
| number_too_small => 55, |
| illegal_date => 56, |
| # Bug errors usually occupy the 100-200 range. |
| improper_bug_id_field_value => 100, |
| bug_id_does_not_exist => 101, |
| bug_access_denied => 102, |
| bug_access_query => 102, |
| # These all mean "invalid alias" |
| alias_too_long => 103, |
| alias_in_use => 103, |
| alias_is_numeric => 103, |
| alias_has_comma_or_space => 103, |
| multiple_alias_not_allowed => 103, |
| # Misc. bug field errors |
| illegal_field => 104, |
| freetext_too_long => 104, |
| # Component errors |
| require_component => 105, |
| component_name_too_long => 105, |
| # Invalid Product |
| no_products => 106, |
| entry_access_denied => 106, |
| product_access_denied => 106, |
| product_disabled => 106, |
| # Invalid Summary |
| require_summary => 107, |
| # Invalid field name |
| invalid_field_name => 108, |
| # Not authorized to edit the bug |
| product_edit_denied => 109, |
| # Comment-related errors |
| comment_is_private => 110, |
| comment_id_invalid => 111, |
| comment_too_long => 114, |
| comment_invalid_isprivate => 117, |
| # See Also errors |
| bug_url_invalid => 112, |
| bug_url_too_long => 112, |
| # Insidergroup Errors |
| user_not_insider => 113, |
| # Note: 114 is above in the Comment-related section. |
| # Bug update errors |
| illegal_change => 115, |
| # Dependency errors |
| dependency_loop_single => 116, |
| dependency_loop_multi => 116, |
| # Note: 117 is above in the Comment-related section. |
| # Dup errors |
| dupe_loop_detected => 118, |
| dupe_id_required => 119, |
| # Bug-related group errors |
| group_invalid_removal => 120, |
| group_restriction_not_allowed => 120, |
| # Status/Resolution errors |
| missing_resolution => 121, |
| resolution_not_allowed => 122, |
| illegal_bug_status_transition => 123, |
| |
| # Authentication errors are usually 300-400. |
| invalid_username_or_password => 300, |
| account_disabled => 301, |
| auth_invalid_email => 302, |
| extern_id_conflict => -303, |
| auth_failure => 304, |
| password_current_too_short => 305, |
| |
| # Except, historically, AUTH_NODATA, which is 410. |
| login_required => 410, |
| |
| # User errors are 500-600. |
| account_exists => 500, |
| illegal_email_address => 501, |
| auth_cant_create_account => 501, |
| account_creation_disabled => 501, |
| account_creation_restricted => 501, |
| password_too_short => 502, |
| # Error 503 password_too_long no longer exists. |
| invalid_username => 504, |
| # This is from strict_isolation, but it also basically means |
| # "invalid user." |
| invalid_user_group => 504, |
| user_access_by_id_denied => 505, |
| user_access_by_match_denied => 505, |
| |
| # Attachment errors are 600-700. |
| file_too_large => 600, |
| invalid_content_type => 601, |
| # Error 602 attachment_illegal_url no longer exists. |
| file_not_specified => 603, |
| missing_attachment_description => 604, |
| # Error 605 attachment_url_disabled no longer exists. |
| zero_length_file => 606, |
| |
| # Product erros are 700-800 |
| product_blank_name => 700, |
| product_name_too_long => 701, |
| product_name_already_in_use => 702, |
| product_name_diff_in_case => 702, |
| product_must_have_description => 703, |
| product_must_have_version => 704, |
| product_must_define_defaultmilestone => 705, |
| |
| # Group errors are 800-900 |
| empty_group_name => 800, |
| group_exists => 801, |
| empty_group_description => 802, |
| invalid_regexp => 803, |
| |
| # Errors thrown by the WebService itself. The ones that are negative |
| # conform to http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php |
| xmlrpc_invalid_value => -32600, |
| unknown_method => -32601, |
| json_rpc_post_only => 32610, |
| json_rpc_invalid_callback => 32611, |
| xmlrpc_illegal_content_type => 32612, |
| json_rpc_illegal_content_type => 32613, |
| }; |
| |
| # These are the fallback defaults for errors not in ERROR_CODE. |
| use constant ERROR_UNKNOWN_FATAL => -32000; |
| use constant ERROR_UNKNOWN_TRANSIENT => 32000; |
| |
| use constant ERROR_GENERAL => 999; |
| |
| use constant XMLRPC_CONTENT_TYPE_WHITELIST => qw( |
| text/xml |
| application/xml |
| ); |
| |
| sub WS_DISPATCH { |
| # We "require" here instead of "use" above to avoid a dependency loop. |
| require Bugzilla::Hook; |
| my %hook_dispatch; |
| Bugzilla::Hook::process('webservice', { dispatch => \%hook_dispatch }); |
| |
| my $dispatch = { |
| 'Bugzilla' => 'Bugzilla::WebService::Bugzilla', |
| 'Bug' => 'Bugzilla::WebService::Bug', |
| 'User' => 'Bugzilla::WebService::User', |
| 'Product' => 'Bugzilla::WebService::Product', |
| 'Group' => 'Bugzilla::WebService::Group', |
| %hook_dispatch |
| }; |
| return $dispatch; |
| }; |
| |
| 1; |
