rest.go 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523
  1. // Copyright 2021-2022 EMQ Technologies Co., Ltd.
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. package server
  15. import (
  16. "encoding/json"
  17. "fmt"
  18. "github.com/gorilla/handlers"
  19. "github.com/gorilla/mux"
  20. "github.com/lf-edge/ekuiper/internal/conf"
  21. "github.com/lf-edge/ekuiper/internal/server/middleware"
  22. "github.com/lf-edge/ekuiper/pkg/api"
  23. "github.com/lf-edge/ekuiper/pkg/ast"
  24. "github.com/lf-edge/ekuiper/pkg/errorx"
  25. "github.com/lf-edge/ekuiper/pkg/infra"
  26. "io"
  27. "io/ioutil"
  28. "net/http"
  29. "os"
  30. "path/filepath"
  31. "runtime"
  32. "strings"
  33. "time"
  34. )
  35. const (
  36. ContentType = "Content-Type"
  37. ContentTypeJSON = "application/json"
  38. )
  39. var uploadDir string
  40. type statementDescriptor struct {
  41. Sql string `json:"sql,omitempty"`
  42. }
  43. func decodeStatementDescriptor(reader io.ReadCloser) (statementDescriptor, error) {
  44. sd := statementDescriptor{}
  45. err := json.NewDecoder(reader).Decode(&sd)
  46. // Problems decoding
  47. if err != nil {
  48. return sd, fmt.Errorf("Error decoding the statement descriptor: %v", err)
  49. }
  50. return sd, nil
  51. }
  52. // Handle applies the specified error and error concept tot he HTTP response writer
  53. func handleError(w http.ResponseWriter, err error, prefix string, logger api.Logger) {
  54. message := prefix
  55. if message != "" {
  56. message += ": "
  57. }
  58. message += err.Error()
  59. logger.Error(message)
  60. var ec int
  61. switch e := err.(type) {
  62. case *errorx.Error:
  63. switch e.Code() {
  64. case errorx.NOT_FOUND:
  65. ec = http.StatusNotFound
  66. default:
  67. ec = http.StatusBadRequest
  68. }
  69. default:
  70. ec = http.StatusBadRequest
  71. }
  72. http.Error(w, message, ec)
  73. }
  74. func jsonResponse(i interface{}, w http.ResponseWriter, logger api.Logger) {
  75. w.Header().Add(ContentType, ContentTypeJSON)
  76. enc := json.NewEncoder(w)
  77. err := enc.Encode(i)
  78. // Problems encoding
  79. if err != nil {
  80. handleError(w, err, "", logger)
  81. }
  82. }
  83. func createRestServer(ip string, port int, needToken bool) *http.Server {
  84. // Create upload path for upload api
  85. etcDir, err := conf.GetConfLoc()
  86. if err != nil {
  87. panic(err)
  88. }
  89. uploadDir = filepath.Join(etcDir, "uploads")
  90. err = os.MkdirAll(uploadDir, os.ModePerm)
  91. if err != nil {
  92. panic(err)
  93. }
  94. r := mux.NewRouter()
  95. r.HandleFunc("/", rootHandler).Methods(http.MethodGet, http.MethodPost)
  96. r.HandleFunc("/ping", pingHandler).Methods(http.MethodGet)
  97. r.HandleFunc("/streams", streamsHandler).Methods(http.MethodGet, http.MethodPost)
  98. r.HandleFunc("/streams/{name}", streamHandler).Methods(http.MethodGet, http.MethodDelete, http.MethodPut)
  99. r.HandleFunc("/tables", tablesHandler).Methods(http.MethodGet, http.MethodPost)
  100. r.HandleFunc("/tables/{name}", tableHandler).Methods(http.MethodGet, http.MethodDelete, http.MethodPut)
  101. r.HandleFunc("/rules", rulesHandler).Methods(http.MethodGet, http.MethodPost)
  102. r.HandleFunc("/rules/{name}", ruleHandler).Methods(http.MethodDelete, http.MethodGet, http.MethodPut)
  103. r.HandleFunc("/rules/{name}/status", getStatusRuleHandler).Methods(http.MethodGet)
  104. r.HandleFunc("/rules/{name}/start", startRuleHandler).Methods(http.MethodPost)
  105. r.HandleFunc("/rules/{name}/stop", stopRuleHandler).Methods(http.MethodPost)
  106. r.HandleFunc("/rules/{name}/restart", restartRuleHandler).Methods(http.MethodPost)
  107. r.HandleFunc("/rules/{name}/topo", getTopoRuleHandler).Methods(http.MethodGet)
  108. r.HandleFunc("/config/uploads", fileUploadHandler).Methods(http.MethodPost, http.MethodGet)
  109. r.HandleFunc("/config/uploads/{name}", fileDeleteHandler).Methods(http.MethodDelete)
  110. // Register extended routes
  111. for k, v := range components {
  112. logger.Infof("register rest endpoint for component %s", k)
  113. v.rest(r)
  114. }
  115. if needToken {
  116. r.Use(middleware.Auth)
  117. }
  118. server := &http.Server{
  119. Addr: fmt.Sprintf("%s:%d", ip, port),
  120. // Good practice to set timeouts to avoid Slowloris attacks.
  121. WriteTimeout: time.Second * 60 * 5,
  122. ReadTimeout: time.Second * 60 * 5,
  123. IdleTimeout: time.Second * 60,
  124. Handler: handlers.CORS(handlers.AllowedHeaders([]string{"Accept", "Accept-Language", "Content-Type", "Content-Language", "Origin", "Authorization"}), handlers.AllowedMethods([]string{"POST", "GET", "PUT", "DELETE", "HEAD"}))(r),
  125. }
  126. server.SetKeepAlivesEnabled(false)
  127. return server
  128. }
  129. type fileContent struct {
  130. Name string `json:"name"`
  131. Content string `json:"content"`
  132. }
  133. func fileUploadHandler(w http.ResponseWriter, r *http.Request) {
  134. switch r.Method {
  135. // Upload or overwrite a file
  136. case http.MethodPost:
  137. switch r.Header.Get("Content-Type") {
  138. case "application/json":
  139. fc := &fileContent{}
  140. defer r.Body.Close()
  141. err := json.NewDecoder(r.Body).Decode(fc)
  142. if err != nil {
  143. handleError(w, err, "Invalid body: Error decoding file json", logger)
  144. return
  145. }
  146. if fc.Content == "" || fc.Name == "" {
  147. handleError(w, nil, "Invalid body: name and content are required", logger)
  148. return
  149. }
  150. filePath := filepath.Join(uploadDir, fc.Name)
  151. dst, err := os.Create(filePath)
  152. defer dst.Close()
  153. if err != nil {
  154. handleError(w, err, "Error creating the file", logger)
  155. return
  156. }
  157. _, err = dst.Write([]byte(fc.Content))
  158. if err != nil {
  159. handleError(w, err, "Error writing the file", logger)
  160. return
  161. }
  162. w.WriteHeader(http.StatusCreated)
  163. w.Write([]byte(filePath))
  164. default:
  165. // Maximum upload of 1 GB files
  166. err := r.ParseMultipartForm(1024 << 20)
  167. if err != nil {
  168. handleError(w, err, "Error parse the multi part form", logger)
  169. return
  170. }
  171. // Get handler for filename, size and headers
  172. file, handler, err := r.FormFile("uploadFile")
  173. if err != nil {
  174. handleError(w, err, "Error Retrieving the File", logger)
  175. return
  176. }
  177. defer file.Close()
  178. // Create file
  179. filePath := filepath.Join(uploadDir, handler.Filename)
  180. dst, err := os.Create(filePath)
  181. defer dst.Close()
  182. if err != nil {
  183. handleError(w, err, "Error creating the file", logger)
  184. return
  185. }
  186. // Copy the uploaded file to the created file on the filesystem
  187. if _, err := io.Copy(dst, file); err != nil {
  188. handleError(w, err, "Error writing the file", logger)
  189. return
  190. }
  191. w.WriteHeader(http.StatusCreated)
  192. w.Write([]byte(filePath))
  193. }
  194. case http.MethodGet:
  195. // Get the list of files in the upload directory
  196. files, err := ioutil.ReadDir(uploadDir)
  197. if err != nil {
  198. handleError(w, err, "Error reading the file upload dir", logger)
  199. return
  200. }
  201. fileNames := make([]string, len(files))
  202. for i, f := range files {
  203. fileNames[i] = filepath.Join(uploadDir, f.Name())
  204. }
  205. jsonResponse(fileNames, w, logger)
  206. }
  207. }
  208. func fileDeleteHandler(w http.ResponseWriter, r *http.Request) {
  209. vars := mux.Vars(r)
  210. name := vars["name"]
  211. filePath := filepath.Join(uploadDir, name)
  212. e := os.Remove(filePath)
  213. if e != nil {
  214. handleError(w, e, "Error deleting the file", logger)
  215. return
  216. }
  217. w.WriteHeader(http.StatusOK)
  218. w.Write([]byte("ok"))
  219. }
  220. type information struct {
  221. Version string `json:"version"`
  222. Os string `json:"os"`
  223. Arch string `json:"arch"`
  224. UpTimeSeconds int64 `json:"upTimeSeconds"`
  225. }
  226. //The handler for root
  227. func rootHandler(w http.ResponseWriter, r *http.Request) {
  228. defer r.Body.Close()
  229. switch r.Method {
  230. case http.MethodGet, http.MethodPost:
  231. w.WriteHeader(http.StatusOK)
  232. info := new(information)
  233. info.Version = version
  234. info.UpTimeSeconds = time.Now().Unix() - startTimeStamp
  235. info.Os = runtime.GOOS
  236. info.Arch = runtime.GOARCH
  237. byteInfo, _ := json.Marshal(info)
  238. w.Write(byteInfo)
  239. }
  240. }
  241. func pingHandler(w http.ResponseWriter, _ *http.Request) {
  242. w.WriteHeader(http.StatusOK)
  243. }
  244. func sourcesManageHandler(w http.ResponseWriter, r *http.Request, st ast.StreamType) {
  245. defer r.Body.Close()
  246. switch r.Method {
  247. case http.MethodGet:
  248. content, err := streamProcessor.ShowStream(st)
  249. if err != nil {
  250. handleError(w, err, fmt.Sprintf("%s command error", strings.Title(ast.StreamTypeMap[st])), logger)
  251. return
  252. }
  253. jsonResponse(content, w, logger)
  254. case http.MethodPost:
  255. v, err := decodeStatementDescriptor(r.Body)
  256. if err != nil {
  257. handleError(w, err, "Invalid body", logger)
  258. return
  259. }
  260. content, err := streamProcessor.ExecStreamSql(v.Sql)
  261. if err != nil {
  262. handleError(w, err, fmt.Sprintf("%s command error", strings.Title(ast.StreamTypeMap[st])), logger)
  263. return
  264. }
  265. w.WriteHeader(http.StatusCreated)
  266. w.Write([]byte(content))
  267. }
  268. }
  269. func sourceManageHandler(w http.ResponseWriter, r *http.Request, st ast.StreamType) {
  270. defer r.Body.Close()
  271. vars := mux.Vars(r)
  272. name := vars["name"]
  273. switch r.Method {
  274. case http.MethodGet:
  275. content, err := streamProcessor.DescStream(name, st)
  276. if err != nil {
  277. handleError(w, err, fmt.Sprintf("describe %s error", ast.StreamTypeMap[st]), logger)
  278. return
  279. }
  280. jsonResponse(content, w, logger)
  281. case http.MethodDelete:
  282. content, err := streamProcessor.DropStream(name, st)
  283. if err != nil {
  284. handleError(w, err, fmt.Sprintf("delete %s error", ast.StreamTypeMap[st]), logger)
  285. return
  286. }
  287. w.WriteHeader(http.StatusOK)
  288. w.Write([]byte(content))
  289. case http.MethodPut:
  290. v, err := decodeStatementDescriptor(r.Body)
  291. if err != nil {
  292. handleError(w, err, "Invalid body", logger)
  293. return
  294. }
  295. content, err := streamProcessor.ExecReplaceStream(name, v.Sql, st)
  296. if err != nil {
  297. handleError(w, err, fmt.Sprintf("%s command error", strings.Title(ast.StreamTypeMap[st])), logger)
  298. return
  299. }
  300. w.WriteHeader(http.StatusOK)
  301. w.Write([]byte(content))
  302. }
  303. }
  304. //list or create streams
  305. func streamsHandler(w http.ResponseWriter, r *http.Request) {
  306. sourcesManageHandler(w, r, ast.TypeStream)
  307. }
  308. //describe or delete a stream
  309. func streamHandler(w http.ResponseWriter, r *http.Request) {
  310. sourceManageHandler(w, r, ast.TypeStream)
  311. }
  312. //list or create tables
  313. func tablesHandler(w http.ResponseWriter, r *http.Request) {
  314. sourcesManageHandler(w, r, ast.TypeTable)
  315. }
  316. func tableHandler(w http.ResponseWriter, r *http.Request) {
  317. sourceManageHandler(w, r, ast.TypeTable)
  318. }
  319. //list or create rules
  320. func rulesHandler(w http.ResponseWriter, r *http.Request) {
  321. defer r.Body.Close()
  322. switch r.Method {
  323. case http.MethodPost:
  324. body, err := ioutil.ReadAll(r.Body)
  325. if err != nil {
  326. handleError(w, err, "Invalid body", logger)
  327. return
  328. }
  329. r, err := ruleProcessor.ExecCreate("", string(body))
  330. var result string
  331. if err != nil {
  332. handleError(w, err, "Create rule error", logger)
  333. return
  334. } else {
  335. result = fmt.Sprintf("Rule %s was created successfully.", r.Id)
  336. }
  337. go func() {
  338. panicOrError := infra.SafeRun(func() error {
  339. //Start the rule
  340. rs, err := createRuleState(r)
  341. if err != nil {
  342. return err
  343. } else {
  344. err = doStartRule(rs)
  345. return err
  346. }
  347. })
  348. if panicOrError != nil {
  349. logger.Errorf("Rule %s start failed: %s", r.Id, panicOrError)
  350. }
  351. }()
  352. w.WriteHeader(http.StatusCreated)
  353. w.Write([]byte(result))
  354. case http.MethodGet:
  355. content, err := getAllRulesWithStatus()
  356. if err != nil {
  357. handleError(w, err, "Show rules error", logger)
  358. return
  359. }
  360. jsonResponse(content, w, logger)
  361. }
  362. }
  363. //describe or delete a rule
  364. func ruleHandler(w http.ResponseWriter, r *http.Request) {
  365. defer r.Body.Close()
  366. vars := mux.Vars(r)
  367. name := vars["name"]
  368. switch r.Method {
  369. case http.MethodGet:
  370. rule, err := ruleProcessor.GetRuleJson(name)
  371. if err != nil {
  372. handleError(w, err, "describe rule error", logger)
  373. return
  374. }
  375. w.Header().Add(ContentType, ContentTypeJSON)
  376. w.Write([]byte(rule))
  377. case http.MethodDelete:
  378. deleteRule(name)
  379. content, err := ruleProcessor.ExecDrop(name)
  380. if err != nil {
  381. handleError(w, err, "delete rule error", logger)
  382. return
  383. }
  384. w.WriteHeader(http.StatusOK)
  385. w.Write([]byte(content))
  386. case http.MethodPut:
  387. _, err := ruleProcessor.GetRuleByName(name)
  388. if err != nil {
  389. handleError(w, err, "not found this rule", logger)
  390. return
  391. }
  392. body, err := ioutil.ReadAll(r.Body)
  393. if err != nil {
  394. handleError(w, err, "Invalid body", logger)
  395. return
  396. }
  397. r, err := ruleProcessor.ExecUpdate(name, string(body))
  398. var result string
  399. if err != nil {
  400. handleError(w, err, "Update rule error", logger)
  401. return
  402. } else {
  403. result = fmt.Sprintf("Rule %s was updated successfully.", r.Id)
  404. }
  405. err = restartRule(name)
  406. if err != nil {
  407. handleError(w, err, "restart rule error", logger)
  408. return
  409. }
  410. w.WriteHeader(http.StatusOK)
  411. w.Write([]byte(result))
  412. }
  413. }
  414. //get status of a rule
  415. func getStatusRuleHandler(w http.ResponseWriter, r *http.Request) {
  416. defer r.Body.Close()
  417. vars := mux.Vars(r)
  418. name := vars["name"]
  419. content, err := getRuleStatus(name)
  420. if err != nil {
  421. handleError(w, err, "get rule status error", logger)
  422. return
  423. }
  424. w.Header().Set(ContentType, ContentTypeJSON)
  425. w.WriteHeader(http.StatusOK)
  426. w.Write([]byte(content))
  427. }
  428. //start a rule
  429. func startRuleHandler(w http.ResponseWriter, r *http.Request) {
  430. defer r.Body.Close()
  431. vars := mux.Vars(r)
  432. name := vars["name"]
  433. err := startRule(name)
  434. if err != nil {
  435. handleError(w, err, "start rule error", logger)
  436. return
  437. }
  438. w.WriteHeader(http.StatusOK)
  439. w.Write([]byte(fmt.Sprintf("Rule %s was started", name)))
  440. }
  441. //stop a rule
  442. func stopRuleHandler(w http.ResponseWriter, r *http.Request) {
  443. defer r.Body.Close()
  444. vars := mux.Vars(r)
  445. name := vars["name"]
  446. result := stopRule(name)
  447. w.WriteHeader(http.StatusOK)
  448. w.Write([]byte(result))
  449. }
  450. //restart a rule
  451. func restartRuleHandler(w http.ResponseWriter, r *http.Request) {
  452. defer r.Body.Close()
  453. vars := mux.Vars(r)
  454. name := vars["name"]
  455. err := restartRule(name)
  456. if err != nil {
  457. handleError(w, err, "restart rule error", logger)
  458. return
  459. }
  460. w.WriteHeader(http.StatusOK)
  461. w.Write([]byte(fmt.Sprintf("Rule %s was restarted", name)))
  462. }
  463. //get topo of a rule
  464. func getTopoRuleHandler(w http.ResponseWriter, r *http.Request) {
  465. defer r.Body.Close()
  466. vars := mux.Vars(r)
  467. name := vars["name"]
  468. content, err := getRuleTopo(name)
  469. if err != nil {
  470. handleError(w, err, "get rule topo error", logger)
  471. return
  472. }
  473. w.Header().Set(ContentType, ContentTypeJSON)
  474. w.Write([]byte(content))
  475. }