Safe Haskell | None |
---|---|
Language | Haskell2010 |
WAI (Web Application Interface) Application for static files and CGI.
Synopsis
- data ClassicAppSpec = ClassicAppSpec {}
- defaultClassicAppSpec :: ClassicAppSpec
- data StatusInfo
- data FileAppSpec = FileAppSpec {}
- defaultFileAppSpec :: FileAppSpec
- data FileRoute = FileRoute {}
- fileApp :: ClassicAppSpec -> FileAppSpec -> FileRoute -> Application
- data RedirectRoute = RedirectRoute {
- redirectSrc :: Path
- redirectDst :: Path
- redirectApp :: ClassicAppSpec -> RedirectRoute -> Application
- data CgiAppSpec = CgiAppSpec {}
- defaultCgiAppSpec :: CgiAppSpec
- data CgiRoute = CgiRoute {}
- cgiApp :: ClassicAppSpec -> CgiAppSpec -> CgiRoute -> Application
- data RevProxyAppSpec = RevProxyAppSpec {}
- data RevProxyRoute = RevProxyRoute {}
- revProxyApp :: ClassicAppSpec -> RevProxyAppSpec -> RevProxyRoute -> Application
- type Path = ByteString
- pathString :: Path -> String
- fromString :: IsString a => String -> a
- (</>) :: Path -> Path -> Path
- (<\>) :: Path -> Path -> Path
- (<.>) :: Path -> Path -> Path
- breakAtSeparator :: Path -> (Path, Path)
- hasLeadingPathSeparator :: Path -> Bool
- hasTrailingPathSeparator :: Path -> Bool
- isSuffixOf :: Path -> Path -> Bool
- redirectHeader :: Request -> ResponseHeaders
- hostPort :: Request -> (ByteString, ByteString)
Common
data ClassicAppSpec Source #
ClassicAppSpec | |
|
defaultClassicAppSpec :: ClassicAppSpec Source #
Default value for ClassicAppSpec
. softwareName
is "Classic". dater
calls epochTime
for every request. statusFileDir
is "/usr/local/share/html/status/".
data StatusInfo Source #
StatusByteString ByteString | HTTP status body is created from |
StatusFile Path Integer | HTTP status body is created from |
StatusNone | No HTTP status body. |
Instances
Eq StatusInfo Source # | |
Defined in Network.Wai.Application.Classic.Types (==) :: StatusInfo -> StatusInfo -> Bool # (/=) :: StatusInfo -> StatusInfo -> Bool # | |
Show StatusInfo Source # | |
Defined in Network.Wai.Application.Classic.Types showsPrec :: Int -> StatusInfo -> ShowS # show :: StatusInfo -> String # showList :: [StatusInfo] -> ShowS # |
Files
data FileAppSpec Source #
defaultFileAppSpec :: FileAppSpec Source #
Default value for defaultFileAppSpec
. indexFile
is "index.html". isHTML
matches "*.html" and "*.html".
fileApp :: ClassicAppSpec -> FileAppSpec -> FileRoute -> Application Source #
Handle GET and HEAD for a static file.
If pathInfo
ends with '/', indexFile
is automatically
added. In this case, "Acceptable-Language:" is also handled. Suppose
indexFile
is "index.html" and if the value is "ja,en", then
"index.html.ja", "index.html.en", and "index.html" are tried to be
opened in order.
If pathInfo
does not end with '/' and a corresponding index file
exist, redirection is specified in HTTP response.
Directory contents are NOT automatically listed. To list directory contents, an index file must be created beforehand.
The following HTTP headers are handled: Acceptable-Language:, If-Modified-Since:, Range:, If-Range:, If-Unmodified-Since:.
Redirect
data RedirectRoute Source #
RedirectRoute | |
|
Instances
Eq RedirectRoute Source # | |
Defined in Network.Wai.Application.Classic.Types (==) :: RedirectRoute -> RedirectRoute -> Bool # (/=) :: RedirectRoute -> RedirectRoute -> Bool # | |
Show RedirectRoute Source # | |
Defined in Network.Wai.Application.Classic.Types showsPrec :: Int -> RedirectRoute -> ShowS # show :: RedirectRoute -> String # showList :: [RedirectRoute] -> ShowS # |
redirectApp :: ClassicAppSpec -> RedirectRoute -> Application Source #
CGI
data CgiAppSpec Source #
Instances
Eq CgiAppSpec Source # | |
Defined in Network.Wai.Application.Classic.Types (==) :: CgiAppSpec -> CgiAppSpec -> Bool # (/=) :: CgiAppSpec -> CgiAppSpec -> Bool # | |
Show CgiAppSpec Source # | |
Defined in Network.Wai.Application.Classic.Types showsPrec :: Int -> CgiAppSpec -> ShowS # show :: CgiAppSpec -> String # showList :: [CgiAppSpec] -> ShowS # |
defaultCgiAppSpec :: CgiAppSpec Source #
Default value for defaultCgiAppSpec
. indexCgi
is "index.cgi".
cgiApp :: ClassicAppSpec -> CgiAppSpec -> CgiRoute -> Application Source #
Handle GET and POST for CGI.
The program to link this library must ignore SIGCHLD as follows:
installHandler sigCHLD Ignore Nothing
Reverse Proxy
data RevProxyAppSpec Source #
RevProxyAppSpec | |
|
data RevProxyRoute Source #
RevProxyRoute | |
|
Instances
Eq RevProxyRoute Source # | |
Defined in Network.Wai.Application.Classic.Types (==) :: RevProxyRoute -> RevProxyRoute -> Bool # (/=) :: RevProxyRoute -> RevProxyRoute -> Bool # | |
Show RevProxyRoute Source # | |
Defined in Network.Wai.Application.Classic.Types showsPrec :: Int -> RevProxyRoute -> ShowS # show :: RevProxyRoute -> String # showList :: [RevProxyRoute] -> ShowS # |
revProxyApp :: ClassicAppSpec -> RevProxyAppSpec -> RevProxyRoute -> Application Source #
Relaying any requests as reverse proxy.
Path
type Path = ByteString Source #
File path.
pathString :: Path -> String Source #
fromString :: IsString a => String -> a #
(</>) :: Path -> Path -> Path Source #
Appending with the file separator.
>>>
"/foo" </> "bar"
"/foo/bar">>>
"/foo/" </> "bar"
"/foo/bar">>>
"/foo" </> "/bar"
"/foo/bar">>>
"/foo/" </> "/bar"
"/foo/bar"
(<\>) :: Path -> Path -> Path Source #
Removing prefix. The prefix of the second argument is removed from the first argument.
>>>
"foobar" <\> "foo"
"bar">>>
"foo" <\> "foobar"
"">>>
"foobar" <\> "baz"
"bar"
breakAtSeparator :: Path -> (Path, Path) Source #
Breaking at the first path separator.
>>>
breakAtSeparator "/foo/bar/baz"
("","/foo/bar/baz")>>>
breakAtSeparator "foo/bar/baz"
("foo","/bar/baz")>>>
breakAtSeparator "foo"
("foo","")
hasLeadingPathSeparator :: Path -> Bool Source #
Checking if the path ends with the path separator.
>>>
hasLeadingPathSeparator "/foo/bar"
True>>>
hasLeadingPathSeparator "foo/bar"
False
hasTrailingPathSeparator :: Path -> Bool Source #
Checking if the path ends with the path separator.
>>>
hasTrailingPathSeparator "/foo/bar/"
True>>>
hasTrailingPathSeparator "/foo/bar"
False
Misc
hostPort :: Request -> (ByteString, ByteString) Source #