GITBOOK-112: No subject

Author: mouuii

k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/di-wu-zhang-apimachinery/5.8-event.md

@@ -120,13 +120,14 @@ type Event struct {
 
 ###  EventBroadcaster源码分析
 
-#### 4.1  EventRecorder记录事件（事件生产者/事件记录器）
+#### 4.1  EventRecorder记录事件（事件生产者）
 
 * EventRecorder
 
-在client-go中的 staging/src/k8s.io/client-go/tools/record/event.go 中定义的EventRecorder接口：
+在 client-go 中的 staging/src/k8s.io/client-go/tools/record/event.go 中定义的 EventRecorder 接口：
 
 ```go
+// EventRecorder 知道如何记录事件源产生的时间
 // EventRecorder knows how to record events on behalf of an EventSource.
 type EventRecorder interface {
 	// Event constructs an event from the given information and puts it in the queue for sending.
@@ -151,7 +152,7 @@ type EventRecorder interface {
 
 ```
 
-EventRecorder定义了记录Event的三种方法，用以帮助kubernetes组件记录Event。其中Event是可以用来记录刚发生的事件；Eventf通过使用fmt.Sprintf格式化输出事件的格式；AnnotatedEventf功能和Eventf一致，但是附加了注释字段。
+EventRecorder 接口定义了记录 Event 的三种方法，用以帮助kubernetes组件记录Event。其中Event是以来记录刚发生的事件；Eventf通过使用fmt.Sprintf格式化输出事件的格式；AnnotatedEventf功能和Eventf一致，但是附加了注释字段。
 
 * recordImpl
 
@@ -272,7 +273,7 @@ func (recorder *recorderImpl) makeEvent(ref *v1.ObjectReference, annotations map
 
 generateEvent方法调用ActionOrDrop方法，将事件写入到incoming中：
 
-#### 4.2 EventBroadcaster事件广播（事件消费者/事件广播器）
+#### 4.2 EventBroadcaster事件广播（事件消费者）
 
 *   EventBroadcaster
 
@@ -283,31 +284,35 @@ generateEvent方法调用ActionOrDrop方法，将事件写入到incoming中：
 ```go
 // EventBroadcaster knows how to receive events and send them to any EventSink, watcher, or log.
 type EventBroadcaster interface {
-	// StartRecordingToSink starts sending events received from the specified eventBroadcaster.
-	StartRecordingToSink(stopCh <-chan struct{})
+	// StartEventWatcher starts sending events received from this EventBroadcaster to the given
+	// event handler function. The return value can be ignored or used to stop recording, if
+	// desired.
+	StartEventWatcher(eventHandler func(*v1.Event)) watch.Interface
 
-	// NewRecorder returns an EventRecorder that can be used to send events to this EventBroadcaster
-	// with the event source set to the given event source.
-	NewRecorder(scheme *runtime.Scheme, reportingController string) EventRecorder
+	// StartRecordingToSink starts sending events received from this EventBroadcaster to the given
+	// sink. The return value can be ignored or used to stop recording, if desired.
+	StartRecordingToSink(sink EventSink) watch.Interface
 
-	// StartEventWatcher enables you to watch for emitted events without usage
-	// of StartRecordingToSink. This lets you also process events in a custom way (e.g. in tests).
-	// NOTE: events received on your eventHandler should be copied before being used.
-	// TODO: figure out if this can be removed.
-	StartEventWatcher(eventHandler func(event runtime.Object)) func()
+	// StartLogging starts sending events received from this EventBroadcaster to the given logging
+	// function. The return value can be ignored or used to stop recording, if desired.
+	StartLogging(logf func(format string, args ...interface{})) watch.Interface
 
 	// StartStructuredLogging starts sending events received from this EventBroadcaster to the structured
 	// logging function. The return value can be ignored or used to stop recording, if desired.
-	StartStructuredLogging(verbosity klog.Level) func()
+	StartStructuredLogging(verbosity klog.Level) watch.Interface
+
+	// NewRecorder returns an EventRecorder that can be used to send events to this EventBroadcaster
+	// with the event source set to the given event source.
+	NewRecorder(scheme *runtime.Scheme, source v1.EventSource) EventRecorder
 
 	// Shutdown shuts down the broadcaster
 	Shutdown()
 }
 ```
 
-EventBroadcaster作为Event消费者和事件广播器，消费EventRecorder记录的事件并将其分发给目前所有已连接的broadcasterWatcher。
+EventBroadcaster作为 Event 消费者，消费 EventRecorder 记录的事件并将其分发给目前所有已连接的broadcasterWatcher。
 
-结构体eventBroadcasterImpl是其实现：
+结构体 eventBroadcasterImpl 是其实现：
 
 ```go