Examples

This repository provides easy to understand code snippets on how to get started with web development with the Go programming language using the Iris web framework. This branch contains the latest iris master examples. For the stable's version examples navigate through the v12 branch.

To read the Iris documentation please navigate to the wiki pages instead.

Examples are tested using Windows 10, Ubuntu 20.04 with Microsoft's Visual Studio Code and built using the Go 1.15.0.

Table of Contents

• Serverless
• REST API for Apache Kafka
• URL Shortener
• Dropzone.js
• Caddy
• Database
  • MySQL, Groupcache & Docker
  • MongoDB
  • Sqlx
  • Xorm
  • Gorm
  • Reform
• HTTP Server
  • HOST:PORT
  • Public Test Domain
  • UNIX socket file
  • TLS
  • Letsencrypt (Automatic Certifications)
  • Socket Sharding (SO_REUSEPORT)
  • Graceful Shutdown
  • Notify on shutdown
  • Custom TCP Listener
    • Common net.Listener
  • Custom HTTP Server
    • Pass a custom Server
    • Use Iris as a single http.Handler
    • Multi Instances
    • HTTP/3 Quic
• Configuration
  • Functional
  • Configuration Struct
  • Import from YAML
    • Share Configuration across instances
  • Import from TOML
• Routing
  • Overview
  • Basic
  • Custom HTTP Errors
  • Not Found - Intelligence
    • Not Found - Suggest Closest Paths
  • Dynamic Path
    • Root Wildcard
    • Implement a Parameter Type
    • Same Path Pattern but Func
  • Middleware
    • Per Route
    • Globally
    • Handlers Execution Rule
    • Route Register Rule
    • Convert net/http Handlers
      • From func(w http.ResponseWriter, r *http.Request, next http.HandlerFunc)
      • From http.Handler or http.HandlerFunc
      • From func(http.HandlerFunc) http.HandlerFunc
  • Rewrite Middleware
  • Route State
  • Reverse Routing
  • Router Wrapper
  • Custom Router
  • Subdomains
    • Single
    • Multi
    • Wildcard
    • WWW
      • WWW Method
    • Redirection
      • Multi Instances
    • HTTP Errors View
  • HTTP Method Override
  • API Versioning
  • Sitemap
• Logging
  • Request Logger
    • AccessLog: simple example
    • AccessLog: log request & response and more
    • AccessLog: custom fields and template
    • AccessLog: CSV Format
    • AccessLog: listen to logs and render them
    • Log Requests to a JSON File
  • Application File Logger
  • Application JSON Logger
  • Rollbar
• API Documentation
  • Yaag
  • Swagger
• Testing
• Recovery
• Profiling
• File Server
  • File Server
  • HTTP/2 Push Targets
  • HTTP/2 Push Targets (Embedded)
  • HTTP/2 Push Targets (Gzipped Embedded)
  • Favicon
  • Basic
  • Embedding Files Into App Executable File
  • Embedding Gzipped Files Into App Executable File
  • Send Files (rate limiter included)
  • Single Page Applications
    • Basic SPA
    • Embedded Single Page Application
    • Embedded Single Page Application with other routes
  • Upload File
  • Upload Multiple Files
• View
  • Overview
  • Basic
  • A simple Layout
  • Layouts: yield and render tmpl funcs
  • The urlpath tmpl func
  • The url tmpl func
  • Inject Data Between Handlers
  • Inject Engine Between Handlers
  • Embedding Templates Into App Executable File
  • Write to a custom io.Writer
  • Parse a Template from Text
    • HTML, Pug and Ace
    • Django
    • Amber
    • Jet
    • Handlebars
  • Blocks
  • Blocks Embedded
  • Pug: Actions
  • Pug: Includes
  • Pug Embedded`
  • Ace
  • Django
  • Amber
  • Amber Embedded
  • Jet
  • Jet Embedded
  • Jet 'urlpath' tmpl func
  • Jet Template Funcs from Struct
  • Handlebars
  • Third-Parties
    • Render valyala/quicktemplate templates
    • Render shiyanhui/hero templates
• Request ID
• Request Rate Limit
• Request Referrer
• Webassembly
• Request Body
  • Bind JSON
  • • Struct Validation
  • Bind XML
  • Bind MsgPack
  • Bind YAML
  • Bind Form
    • Checkboxes
  • Bind Query
  • Bind Headers
  • Bind Params
  • Bind Body
  • Bind Custom per type
  • Bind Custom via Unmarshaler
  • Bind Many times
• Response Writer
  • Content Negotiation
  • Text, Markdown, YAML, HTML, JSON, JSONP, Msgpack, XML and Binary
  • Protocol Buffers
  • HTTP/2 Server Push
  • Stream Writer
  • Transactions
  • SSE
  • SSE (third-party package usage for server sent events)
  • Cache
    • Simple
    • Client-Side (304)
• Compression
  • Server-Side
  • Client-Side
  • Client-Side (using Iris)
• Localization and Internationalization
  • i18n
  • i18n templates and functions
• Authentication, Authorization & Bot Detection
  • Basic Authentication
  • CORS
  • JWT
  • JWT (community edition)
  • OAUth2
  • Manage Permissions
  • Google reCAPTCHA
  • hCaptcha
• Cookies
  • Basic
  • Options
  • Encode/Decode (with securecookie)
• Sessions
  • Overview: Config
    • Overview: Routes
  • Basic
  • Secure Cookie
  • Flash Messages
  • Databases
    • Badger
    • BoltDB
    • Redis
• Websocket
  • Gorilla FileWatch (3rd-party)
  • Basic
    • Server
    • Go Client
    • Browser Client
    • Browser NPM Client (browserify)
  • Native Messages
  • TLS
  • Online Visitors
• Dependency Injection
  • Overview (Movies Service)
  • Basic
    • Middleware
  • Sessions
  • Smart Contract
  • JWT
    • JWT (iris-contrib)
  • Register Dependency from Context
• MVC
  • Overview
  • Repository and Service layers
  • Hello world
  • Basic
    • Wildcard
  • Singleton
  • Regexp
  • Session Controller
  • Authenticated Controller
  • Versioned Controller
  • Websocket Controller
  • Register Middleware
  • gRPC
  • Login (Repository and Service layers)
  • Login (Single Responsibility)
  • Vue.js Todo App
  • HTTP Error Handler
  • Error Handler
  • Handle errors using mvc.Result
  • Handle errors using PreflightResult
  • Handle errors by hijacking the result
• Bootstrapper
• Desktop Applications
  • The blink package
  • The lorca package
  • The webview package
• Middlewares (Community)

Run

1. Install the Go Programming Language, version 1.15+ from here.
2. Install Iris: go get -u github.com/kataras/iris/v12@v12.2.0-alpha
3. Download the examples and copy-paste them to your $GOPATH/src/github.com/iris-contrib/examples

And run

$ cd $GOPATH/src/github.com/iris-contrib/examples/compression
$ go run main.go

Do not forget to star or watch the Iris project.

Any troubles with examples?

https://github.com/iris-contrib/examples/issues

Su, 04 June 2017

This repository is just a mirror of the https://github.com/kataras/iris/master/_examples folder.