go-packages/iris
1
0
Fork 0
mirror of https://github.com/kataras/iris.git synced 2025-01-22 18:21:03 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

apps.Switch/Hosts minor doc improvement

Browse Source
This commit is contained in:
Gerasimos (Makis) Maropoulos 2023-11-16 03:06:06 +02:00
parent f29d690c5f
commit 4cbd9deff7
No known key found for this signature in database
GPG Key ID: B9839E9CD30B7B6B
3 changed files with 45 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
apps/README.md
View File

@ -121,9 +121,9 @@ Example Code:
```go
switcher := Switch(Hosts{
"mydomain.com": app,
"test.mydomain.com": testSubdomainApp,
"otherdomain.com": "appName",
{Pattern: "mydomain.com", Target: app},
{Pattern: "test.mydomain.com", Target: testSubdomainApp},
{Pattern: "otherdomain.com", Target: "appName"},
})
switcher.Listen(":80")
```
@ -211,7 +211,7 @@ Switch(Join{
App: myapp,
},
Hosts{
{"^test.*$", myapp},
{Pattern: "^test.*$", Target: myapp},
},
})
```

28
apps/switch.go
View File

@ -15,9 +15,9 @@ import (
// Example Code:
//
// switcher := Switch(Hosts{
// "mydomain.com": app,
// "test.mydomain.com": testSubdomainApp,
// "otherdomain.com": "appName",
// { Pattern: "mydomain.com", Target: app },
// { Pattern: "test.mydomain.com", Target: testSubdomainApp },
// { Pattern: "otherdomain.com", "Target: appName" },
// })
// switcher.Listen(":80")
//
@ -35,6 +35,28 @@ import (
//
// Wrap with the `Join` slice to pass
// more than one provider at the same time.
//
// An alternative way for manually embedding an Iris Application to another one is:
//
// app := iris.New() // root app.
// myOtherApp := api.NewServer(otherServerConfiguration) // embedded app.
// // myOtherApp.Logger().SetLevel("debug")
//
// if err := myOtherApp.Build(); err != nil {
// panic(err)
// }
//
// app.Any("/api/identity/{p:path}", func(ctx iris.Context) {
// apiPath := "/" + ctx.Params().Get("p")
// r := ctx.Request()
// r.URL.Path = apiPath
// r.URL.RawPath = apiPath
// ctx.Params().Remove("p")
//
// myOtherApp.ServeHTTPC(ctx)
// })
//
// app.Listen(":80")
func Switch(provider SwitchProvider, options ...SwitchOption) *iris.Application {
cases := provider.GetSwitchCases()
if len(cases) == 0 {

16
apps/switch_hosts.go
View File

@ -36,6 +36,22 @@ type (
var _ SwitchProvider = Hosts{}
// AnyDomain is a regexp that matches any domain.
// It can be used as the Pattern field of a Host.
//
// Example:
//
// apps.Switch(apps.Hosts{
// {
// Pattern: "^id.*$", Target: identityApp,
// },
// {
// Pattern: apps.AnyDomain, Target: app,
// },
// }).Listen(":80")
const AnyDomain = `^(([a-zA-Z]{1})|([a-zA-Z]{1}[a-zA-Z]{1})|([a-zA-Z]{1}[0-9]{1})|([0-9]{1}[a-zA-Z]{1})|([a-zA-Z0-9][a-zA-Z0-9-_]{1,61}[a-zA-Z0-9]))\.([a-zA-Z]{2,6}|[a-zA-Z0-9-]{2,30}\.[a-zA-Z
]{2,3})$`
// GetSwitchCases completes the SwitchProvider.
// It returns a slice of SwitchCase which
// if passed on `Switch` function, they act