95 lines
2.2 KiB
Plaintext
95 lines
2.2 KiB
Plaintext
note
|
|
description: "[
|
|
Request handler object which is called by a WSF_ROUTER
|
|
An handler should implement the method
|
|
|
|
execute (ctx, req, res)
|
|
|
|
The class is generic, this way one can use a custom WSF_HANDLER_CONTEXT if needed
|
|
]"
|
|
date: "$Date$"
|
|
revision: "$Revision$"
|
|
|
|
deferred class
|
|
WSF_HANDLER [C -> WSF_HANDLER_CONTEXT]
|
|
|
|
inherit
|
|
ANY
|
|
|
|
feature -- Status report
|
|
|
|
is_valid_context (req: WSF_REQUEST): BOOLEAN
|
|
-- Is `req' valid context for current handler?
|
|
do
|
|
Result := True
|
|
end
|
|
|
|
feature -- Execution
|
|
|
|
execute (ctx: C; req: WSF_REQUEST; res: WSF_RESPONSE)
|
|
-- Execute request handler
|
|
--
|
|
-- `ctx': contains advanced data related to request_uri
|
|
-- in the case of URI_TEMPLATE, it add support for "path_parameter"
|
|
-- `req': request data
|
|
-- `res': reponse stream
|
|
--| note `ctx' can also provide data coming from `req'
|
|
require
|
|
is_valid_context: is_valid_context (req)
|
|
deferred
|
|
ensure
|
|
response_status_set: res.status_is_set
|
|
end
|
|
|
|
feature -- Execution: report
|
|
|
|
url (req: WSF_REQUEST; a_base: detachable READABLE_STRING_8; args: detachable STRING; abs: BOOLEAN): STRING
|
|
-- Associated url based on `a_base' and `args'
|
|
-- if `abs' then return absolute url
|
|
local
|
|
s: detachable STRING
|
|
l_base: STRING
|
|
do
|
|
if a_base /= Void then
|
|
l_base := a_base
|
|
else
|
|
l_base := req.request_uri
|
|
end
|
|
s := args
|
|
if s /= Void and then s.count > 0 then
|
|
if s[1] /= '/' then
|
|
s := l_base + "/" + s
|
|
else
|
|
s := l_base + s
|
|
end
|
|
else
|
|
s := l_base
|
|
end
|
|
if abs then
|
|
Result := req.absolute_script_url (s)
|
|
else
|
|
Result := req.script_url (s)
|
|
end
|
|
ensure
|
|
result_attached: Result /= Void
|
|
end
|
|
|
|
feature {WSF_ROUTER} -- Routes change
|
|
|
|
on_handler_mapped (a_resource: READABLE_STRING_8; a_rqst_methods: detachable ARRAY [READABLE_STRING_8])
|
|
-- Callback called when a router map a route to Current handler
|
|
do
|
|
end
|
|
|
|
note
|
|
copyright: "2011-2012, Jocelyn Fiat, Javier Velilla, Eiffel Software and others"
|
|
license: "Eiffel Forum License v2 (see http://www.eiffel.com/licensing/forum.txt)"
|
|
source: "[
|
|
Eiffel Software
|
|
5949 Hollister Ave., Goleta, CA 93117 USA
|
|
Telephone 805-685-1006, Fax 805-685-6869
|
|
Website http://www.eiffel.com
|
|
Customer support http://support.eiffel.com
|
|
]"
|
|
end
|