roles_server.go

/*
Copyright (c) 2019 Red Hat, Inc.

Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

// IMPORTANT: This file has been generated automatically, refrain from modifying it manually as all
// your changes will be lost when the file is generated again.

package v1 // github.com/openshift-online/ocm-sdk-go/accountsmgmt/v1

import (
	"context"
	"encoding/json"
	"io"
	"net/http"

	"github.com/golang/glog"
	"github.com/openshift-online/ocm-sdk-go/errors"
	"github.com/openshift-online/ocm-sdk-go/helpers"
)

// RolesServer represents the interface the manages the 'roles' resource.
type RolesServer interface {

	// Add handles a request for the 'add' method.
	//
	// Creates a new role.
	Add(ctx context.Context, request *RolesAddServerRequest, response *RolesAddServerResponse) error

	// List handles a request for the 'list' method.
	//
	// Retrieves a list of roles.
	List(ctx context.Context, request *RolesListServerRequest, response *RolesListServerResponse) error

	// Role returns the target 'role' server for the given identifier.
	//
	// Reference to the service that manages a specific role.
	Role(id string) RoleServer
}

// RolesAddServerRequest is the request for the 'add' method.
type RolesAddServerRequest struct {
	body *Role
}

// Body returns the value of the 'body' parameter.
//
// Role data.
func (r *RolesAddServerRequest) Body() *Role {
	if r == nil {
		return nil
	}
	return r.body
}

// GetBody returns the value of the 'body' parameter and
// a flag indicating if the parameter has a value.
//
// Role data.
func (r *RolesAddServerRequest) GetBody() (value *Role, ok bool) {
	ok = r != nil && r.body != nil
	if ok {
		value = r.body
	}
	return
}

// unmarshal is the method used internally to unmarshal request to the
// 'add' method.
func (r *RolesAddServerRequest) unmarshal(reader io.Reader) error {
	var err error
	decoder := json.NewDecoder(reader)
	data := new(roleData)
	err = decoder.Decode(data)
	if err != nil {
		return err
	}
	r.body, err = data.unwrap()
	if err != nil {
		return err
	}
	return err
}

// RolesAddServerResponse is the response for the 'add' method.
type RolesAddServerResponse struct {
	status int
	err    *errors.Error
	body   *Role
}

// Body sets the value of the 'body' parameter.
//
// Role data.
func (r *RolesAddServerResponse) Body(value *Role) *RolesAddServerResponse {
	r.body = value
	return r
}

// Status sets the status code.
func (r *RolesAddServerResponse) Status(value int) *RolesAddServerResponse {
	r.status = value
	return r
}

// marshall is the method used internally to marshal responses for the
// 'add' method.
func (r *RolesAddServerResponse) marshal(writer io.Writer) error {
	var err error
	encoder := json.NewEncoder(writer)
	data, err := r.body.wrap()
	if err != nil {
		return err
	}
	err = encoder.Encode(data)
	return err
}

// RolesListServerRequest is the request for the 'list' method.
type RolesListServerRequest struct {
	page   *int
	search *string
	size   *int
	total  *int
}

// Page returns the value of the 'page' parameter.
//
// Index of the requested page, where one corresponds to the first page.
//
// Default value is `1`.
func (r *RolesListServerRequest) Page() int {
	if r != nil && r.page != nil {
		return *r.page
	}
	return 0
}

// GetPage returns the value of the 'page' parameter and
// a flag indicating if the parameter has a value.
//
// Index of the requested page, where one corresponds to the first page.
//
// Default value is `1`.
func (r *RolesListServerRequest) GetPage() (value int, ok bool) {
	ok = r != nil && r.page != nil
	if ok {
		value = *r.page
	}
	return
}

// Search returns the value of the 'search' parameter.
//
// Search criteria.
//
// The syntax of this parameter is similar to the syntax of the _where_ clause
// of an SQL statement, but using the names of the attributes of the role
// instead of the names of the columns of a table. For example, in order to
// retrieve roles named starting with `Organization`:
//
// [source,sql]
// ----
// name like 'Organization%'
// ----
//
// If the parameter isn't provided, or if the value is empty, then all the
// items that the user has permission to see will be returned.
func (r *RolesListServerRequest) Search() string {
	if r != nil && r.search != nil {
		return *r.search
	}
	return ""
}

// GetSearch returns the value of the 'search' parameter and
// a flag indicating if the parameter has a value.
//
// Search criteria.
//
// The syntax of this parameter is similar to the syntax of the _where_ clause
// of an SQL statement, but using the names of the attributes of the role
// instead of the names of the columns of a table. For example, in order to
// retrieve roles named starting with `Organization`:
//
// [source,sql]
// ----
// name like 'Organization%'
// ----
//
// If the parameter isn't provided, or if the value is empty, then all the
// items that the user has permission to see will be returned.
func (r *RolesListServerRequest) GetSearch() (value string, ok bool) {
	ok = r != nil && r.search != nil
	if ok {
		value = *r.search
	}
	return
}

// Size returns the value of the 'size' parameter.
//
// Maximum number of items that will be contained in the returned page.
//
// Default value is `100`.
func (r *RolesListServerRequest) Size() int {
	if r != nil && r.size != nil {
		return *r.size
	}
	return 0
}

// GetSize returns the value of the 'size' parameter and
// a flag indicating if the parameter has a value.
//
// Maximum number of items that will be contained in the returned page.
//
// Default value is `100`.
func (r *RolesListServerRequest) GetSize() (value int, ok bool) {
	ok = r != nil && r.size != nil
	if ok {
		value = *r.size
	}
	return
}

// Total returns the value of the 'total' parameter.
//
// Total number of items of the collection that match the search criteria,
// regardless of the size of the page.
func (r *RolesListServerRequest) Total() int {
	if r != nil && r.total != nil {
		return *r.total
	}
	return 0
}

// GetTotal returns the value of the 'total' parameter and
// a flag indicating if the parameter has a value.
//
// Total number of items of the collection that match the search criteria,
// regardless of the size of the page.
func (r *RolesListServerRequest) GetTotal() (value int, ok bool) {
	ok = r != nil && r.total != nil
	if ok {
		value = *r.total
	}
	return
}

// RolesListServerResponse is the response for the 'list' method.
type RolesListServerResponse struct {
	status int
	err    *errors.Error
	items  *RoleList
	page   *int
	size   *int
	total  *int
}

// Items sets the value of the 'items' parameter.
//
// Retrieved list of roles.
func (r *RolesListServerResponse) Items(value *RoleList) *RolesListServerResponse {
	r.items = value
	return r
}

// Page sets the value of the 'page' parameter.
//
// Index of the requested page, where one corresponds to the first page.
//
// Default value is `1`.
func (r *RolesListServerResponse) Page(value int) *RolesListServerResponse {
	r.page = &value
	return r
}

// Size sets the value of the 'size' parameter.
//
// Maximum number of items that will be contained in the returned page.
//
// Default value is `100`.
func (r *RolesListServerResponse) Size(value int) *RolesListServerResponse {
	r.size = &value
	return r
}

// Total sets the value of the 'total' parameter.
//
// Total number of items of the collection that match the search criteria,
// regardless of the size of the page.
func (r *RolesListServerResponse) Total(value int) *RolesListServerResponse {
	r.total = &value
	return r
}

// Status sets the status code.
func (r *RolesListServerResponse) Status(value int) *RolesListServerResponse {
	r.status = value
	return r
}

// marshall is the method used internally to marshal responses for the
// 'list' method.
func (r *RolesListServerResponse) marshal(writer io.Writer) error {
	var err error
	encoder := json.NewEncoder(writer)
	data := new(rolesListServerResponseData)
	data.Items, err = r.items.wrap()
	if err != nil {
		return err
	}
	data.Page = r.page
	data.Size = r.size
	data.Total = r.total
	err = encoder.Encode(data)
	return err
}

// rolesListServerResponseData is the structure used internally to write the request of the
// 'list' method.
type rolesListServerResponseData struct {
	Items roleListData "json:\"items,omitempty\""
	Page  *int         "json:\"page,omitempty\""
	Size  *int         "json:\"size,omitempty\""
	Total *int         "json:\"total,omitempty\""
}

// RolesAdapter is an HTTP handler that knows how to translate HTTP requests
// into calls to the methods of an object that implements the RolesServer
// interface.
type RolesAdapter struct {
	server RolesServer
}

// NewRolesAdapter creates a new adapter that will translate HTTP requests
// into calls to the given server.
func NewRolesAdapter(server RolesServer) *RolesAdapter {
	return &RolesAdapter{
		server: server,
	}
}

// ServeHTTP is the implementation of the http.Handler interface.
func (a *RolesAdapter) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	dispatchRolesRequest(w, r, a.server, helpers.Segments(r.URL.Path))
}

// dispatchRolesRequest navigates the servers tree rooted at the given server
// till it finds one that matches the given set of path segments, and then invokes
// the corresponding server.
func dispatchRolesRequest(w http.ResponseWriter, r *http.Request, server RolesServer, segments []string) {
	if len(segments) == 0 {
		switch r.Method {
		case http.MethodPost:
			adaptRolesAddRequest(w, r, server)
		case http.MethodGet:
			adaptRolesListRequest(w, r, server)
		default:
			errors.SendMethodNotSupported(w, r)
		}
	} else {
		switch segments[0] {
		default:
			target := server.Role(segments[0])
			dispatchRoleRequest(w, r, target, segments[1:])
		}
	}
}

// readRolesAddRequest reads the given HTTP requests and translates it
// into an object of type RolesAddServerRequest.
func readRolesAddRequest(r *http.Request) (*RolesAddServerRequest, error) {
	var err error
	result := new(RolesAddServerRequest)
	err = result.unmarshal(r.Body)
	if err != nil {
		return nil, err
	}
	return result, err
}

// writeRolesAddResponse translates the given request object into an
// HTTP response.
func writeRolesAddResponse(w http.ResponseWriter, r *RolesAddServerResponse) error {
	w.Header().Set("Content-Type", "application/json")
	w.WriteHeader(r.status)
	err := r.marshal(w)
	if err != nil {
		return err
	}
	return nil
}

// adaptRolesAddRequest translates the given HTTP request into a call to
// the corresponding method of the given server. Then it translates the
// results returned by that method into an HTTP response.
func adaptRolesAddRequest(w http.ResponseWriter, r *http.Request, server RolesServer) {
	request, err := readRolesAddRequest(r)
	if err != nil {
		glog.Errorf(
			"Can't read request for method '%s' and path '%s': %v",
			r.Method, r.URL.Path, err,
		)
		errors.SendInternalServerError(w, r)
		return
	}
	response := new(RolesAddServerResponse)
	response.status = http.StatusOK
	err = server.Add(r.Context(), request, response)
	if err != nil {
		glog.Errorf(
			"Can't process request for method '%s' and path '%s': %v",
			r.Method, r.URL.Path, err,
		)
		errors.SendInternalServerError(w, r)
		return
	}
	err = writeRolesAddResponse(w, response)
	if err != nil {
		glog.Errorf(
			"Can't write response for method '%s' and path '%s': %v",
			r.Method, r.URL.Path, err,
		)
		return
	}
}

// readRolesListRequest reads the given HTTP requests and translates it
// into an object of type RolesListServerRequest.
func readRolesListRequest(r *http.Request) (*RolesListServerRequest, error) {
	var err error
	result := new(RolesListServerRequest)
	query := r.URL.Query()
	result.page, err = helpers.ParseInteger(query, "page")
	if err != nil {
		return nil, err
	}
	result.search, err = helpers.ParseString(query, "search")
	if err != nil {
		return nil, err
	}
	result.size, err = helpers.ParseInteger(query, "size")
	if err != nil {
		return nil, err
	}
	result.total, err = helpers.ParseInteger(query, "total")
	if err != nil {
		return nil, err
	}
	return result, err
}

// writeRolesListResponse translates the given request object into an
// HTTP response.
func writeRolesListResponse(w http.ResponseWriter, r *RolesListServerResponse) error {
	w.Header().Set("Content-Type", "application/json")
	w.WriteHeader(r.status)
	err := r.marshal(w)
	if err != nil {
		return err
	}
	return nil
}

// adaptRolesListRequest translates the given HTTP request into a call to
// the corresponding method of the given server. Then it translates the
// results returned by that method into an HTTP response.
func adaptRolesListRequest(w http.ResponseWriter, r *http.Request, server RolesServer) {
	request, err := readRolesListRequest(r)
	if err != nil {
		glog.Errorf(
			"Can't read request for method '%s' and path '%s': %v",
			r.Method, r.URL.Path, err,
		)
		errors.SendInternalServerError(w, r)
		return
	}
	response := new(RolesListServerResponse)
	response.status = http.StatusOK
	err = server.List(r.Context(), request, response)
	if err != nil {
		glog.Errorf(
			"Can't process request for method '%s' and path '%s': %v",
			r.Method, r.URL.Path, err,
		)
		errors.SendInternalServerError(w, r)
		return
	}
	err = writeRolesListResponse(w, response)
	if err != nil {
		glog.Errorf(
			"Can't write response for method '%s' and path '%s': %v",
			r.Method, r.URL.Path, err,
		)
		return
	}
}