rest.go 14 KB

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