comments

common/interfaces.go

@@ -1,17 +1,25 @@
 package common
 
+import "v2ray.com/core/common/errors"
+
 // Closable is the interface for objects that can release its resources.
+//
+// v2ray:api:beta
 type Closable interface {
 	// Close release all resources used by this object, including goroutines.
 	Close() error
 }
 
 // Interruptible is an interface for objects that can be stopped before its completion.
+//
+// v2ray:api:beta
 type Interruptible interface {
 	Interrupt()
 }
 
 // Close closes the obj if it is a Closable.
+//
+// v2ray:api:beta
 func Close(obj interface{}) error {
 	if c, ok := obj.(Closable); ok {
 		return c.Close()
@@ -20,6 +28,8 @@ func Close(obj interface{}) error {
 }
 
 // Interrupt calls Interrupt() if object implements Interruptible interface, or Close() if the object implements Closable interface.
+//
+// v2ray:api:beta
 func Interrupt(obj interface{}) error {
 	if c, ok := obj.(Interruptible); ok {
 		c.Interrupt()
@@ -43,15 +53,16 @@ type HasType interface {
 	Type() interface{}
 }
 
+// ChainedClosable is a Closable that consists of multiple Closable objects.
 type ChainedClosable []Closable
 
-func NewChainedClosable(c ...Closable) ChainedClosable {
-	return ChainedClosable(c)
-}
-
+// Close implements Closable.
 func (cc ChainedClosable) Close() error {
+	var errs []error
 	for _, c := range cc {
-		c.Close()
+		if err := c.Close(); err != nil {
+			errs = append(errs, err)
+		}
 	}
-	return nil
+	return errors.Combine(errs...)
 }