package config import ( "encoding/json" "fmt" "os" "strings" ) // Load builds a representation of the configuration // The struct definition checks for most format errors // // path The path to the configuration // // @return The parsed configuration root controller // @return The error if occured // func Load(path string) (*Controller, error) { /* (1) Extract data ---------------------------------------------------------*/ /* (1) Open file */ file, err := os.Open(path) if err != nil { return nil, err } defer file.Close() /* (2) Init receiver dataset */ receiver := &Controller{} /* (3) Decode json */ decoder := json.NewDecoder(file) err = decoder.Decode(receiver) if err != nil { return nil, err } /* (4) Format result */ err = receiver.format("/") if err != nil { return nil, err } return receiver, nil } // Method returns a controller's method if exists // // @method The wanted method (case insensitive) // // @return<*Method> The requested method // NIL if not found // func (c Controller) Method(method string) *Method { method = strings.ToUpper(method) switch method { case "GET": return c.GET case "POST": return c.POST case "PUT": return c.PUT case "DELETE": return c.DELETE default: return nil } } // Browses tries to browse the controller childtree and // returns the farthest matching child // // @path the path to browse // // @return The index in 'path' used to find the controller // @return<*Controller> The farthest match func (c *Controller) Browse(path []string) (int, *Controller) { /* (1) initialise cursors */ current := c i := 0 // index in path /* (2) Browse while there is uri parts */ for i < len(path) { // 1. Try to get child for this name child, exists := current.Children[path[i]] // 2. Stop if no matching child if !exists { break } // 3. Increment cursors current = child i++ } /* (3) Return matches */ return i, current } // format checks for format errors and missing required fields // it also sets default values to optional fields func (c *Controller) format(controllerName string) error { /* (1) Check each method ---------------------------------------------------------*/ methods := []struct { Name string Ptr *Method }{ {"GET", c.GET}, {"POST", c.POST}, {"PUT", c.PUT}, {"DELETE", c.DELETE}, } for _, method := range methods { /* (1) ignore non-defined method */ if method.Ptr == nil { continue } /* (2) Fail on missing description */ if len(method.Ptr.Description) < 1 { return fmt.Errorf("Missing %s.%s description", controllerName, method.Name) } /* (3) stop if no parameter */ if method.Ptr.Parameters == nil || len(method.Ptr.Parameters) < 1 { method.Ptr.Parameters = make(map[string]*Parameter, 0) continue } /* check parameters */ for pName, pData := range method.Ptr.Parameters { if len(pData.Rename) < 1 { pData.Rename = pName } /* (5) Check for name/rename conflict */ for paramName, param := range method.Ptr.Parameters { // ignore self if pName == paramName { continue } // 1. Same rename field if pData.Rename == param.Rename { return fmt.Errorf("Rename conflict for %s.%s parameter '%s'", controllerName, method.Name, pData.Rename) } // 2. Not-renamed field matches a renamed field if pName == param.Rename { return fmt.Errorf("Name conflict for %s.%s parameter '%s'", controllerName, method.Name, pName) } // 3. Renamed field matches name if pData.Rename == paramName { return fmt.Errorf("Name conflict for %s.%s parameter '%s'", controllerName, method.Name, pName) } } /* (6) Manage invalid type */ if len(pData.Type) < 1 { return fmt.Errorf("Invalid type for %s.%s parameter '%s'", controllerName, method.Name, pName) } /* (7) Fail on missing description */ if len(pData.Description) < 1 { return fmt.Errorf("Missing description for %s.%s parameter '%s'", controllerName, method.Name, pName) } /* (8) Fail on missing type */ if len(pData.Type) < 1 { return fmt.Errorf("Missing type for %s.%s parameter '%s'", controllerName, method.Name, pName) } /* (9) Set optional + type */ if pData.Type[0] == '?' { pData.Optional = true pData.Type = pData.Type[1:] } } } /* (2) Check child controllers ---------------------------------------------------------*/ /* (1) Stop if no child */ if c.Children == nil || len(c.Children) < 1 { return nil } /* (2) For each controller */ for ctlName, ctl := range c.Children { /* (3) Invalid name */ if strings.Contains(ctlName, "/") { return fmt.Errorf("Controller '%s' must not contain any slash '/'", ctlName) } /* (4) Check recursively */ err := ctl.format(ctlName) if err != nil { return err } } return nil }