package rpc import ( "fmt" "reflect" "strings" "sync" "unicode" "unicode/utf8" ) var ( // Precompute the reflect.Type of error and http.Request typeOfError = reflect.TypeOf((*error)(nil)).Elem() ) // ---------------------------------------------------------------------------- // service // ---------------------------------------------------------------------------- type service struct { name string // name of service rcvr reflect.Value // receiver of methods for the service rcvrType reflect.Type // type of the receiver methods map[string]*serviceMethod // registered methods } type serviceMethod struct { method reflect.Method // receiver method paramTypes []reflect.Type // type of the request argument returnType reflect.Type // type of the response argument } func (sm *serviceMethod) getParams() (values []reflect.Value, instances []interface{}) { if nil == sm.paramTypes || 0 == len(sm.paramTypes) { return nil, nil } pCount := len(sm.paramTypes) values = make([]reflect.Value, pCount) instances = make([]interface{}, pCount) for indexI := 0; indexI < pCount; indexI++ { values[indexI] = reflect.New(sm.paramTypes[indexI]) instances[indexI] = values[indexI].Interface() } return } // ---------------------------------------------------------------------------- // serviceMap // ---------------------------------------------------------------------------- // serviceMap is a registry for services. type serviceMap struct { mutex sync.Mutex services map[string]*service } // register adds a new service using reflection to extract its methods. func (m *serviceMap) register(rcvr interface{}, name string) error { // Setup service. s := &service{ name: name, rcvr: reflect.ValueOf(rcvr), rcvrType: reflect.TypeOf(rcvr), methods: make(map[string]*serviceMethod), } if name == "" { s.name = reflect.Indirect(s.rcvr).Type().Name() if !isExported(s.name) { return fmt.Errorf("rpc: type %q is not exported", s.name) } } if s.name == "" { return fmt.Errorf("rpc: no service name for type %q", s.rcvrType.String()) } // Setup methods. Loop: for i := 0; i < s.rcvrType.NumMethod(); i++ { method := s.rcvrType.Method(i) mtype := method.Type // Method must be exported. if method.PkgPath != "" { continue } var paramTypes []reflect.Type mCount := mtype.NumIn() if 0 < mCount { paramTypes = make([]reflect.Type, mCount) for indexI := 0; indexI < mCount; indexI++ { param := mtype.In(indexI) if !isExportedOrBuiltin(param) { continue Loop } paramTypes[indexI] = param.Elem() } } var returnType reflect.Type switch mtype.NumOut() { case 1: if returnType := mtype.Out(0); returnType != typeOfError { continue Loop } case 2: if returnType := mtype.Out(0); !isExportedOrBuiltin(returnType) { continue Loop } if returnType := mtype.Out(1); returnType != typeOfError { continue Loop } returnType = mtype.Out(1).Elem() default: continue } s.methods[method.Name] = &serviceMethod{ method: method, paramTypes: paramTypes, returnType: returnType, } } if len(s.methods) == 0 { return fmt.Errorf("rpc: %q has no exported methods of suitable type", s.name) } // Add to the map. m.mutex.Lock() defer m.mutex.Unlock() if m.services == nil { m.services = make(map[string]*service) } else if _, ok := m.services[s.name]; ok { return fmt.Errorf("rpc: service already defined: %q", s.name) } m.services[s.name] = s return nil } // get returns a registered service given a method name. // // The method name uses a dotted notation as in "Service.Method". func (m *serviceMap) get(method string) (*service, *serviceMethod, error) { parts := strings.Split(method, ".") if len(parts) != 2 { err := fmt.Errorf("rpc: service/method request ill-formed: %q", method) return nil, nil, err } m.mutex.Lock() service := m.services[parts[0]] m.mutex.Unlock() if service == nil { err := fmt.Errorf("rpc: can't find service %q", method) return nil, nil, err } serviceMethod := service.methods[parts[1]] if serviceMethod == nil { err := fmt.Errorf("rpc: can't find method %q", method) return nil, nil, err } return service, serviceMethod, nil } // isExported returns true of a string is an exported (upper case) name. func isExported(name string) bool { rune, _ := utf8.DecodeRuneInString(name) return unicode.IsUpper(rune) } // isExportedOrBuiltin returns true if a type is exported or a builtin. func isExportedOrBuiltin(t reflect.Type) bool { for t.Kind() == reflect.Ptr { t = t.Elem() } // PkgPath will be non-empty even for an exported type, // so we need to check the type name as well. return isExported(t.Name()) || t.PkgPath() == "" }