netty5/transport-native-epoll/src/main/java/io/netty/channel/epoll/EpollRegistration.java
Norman Maurer 1fe931b6e2
Make it possible to use a wrapped EventLoop with a Channel (#8677)
Motiviation:

Because of how we implemented the registration / deregistration of an EventLoop it was not possible to wrap an EventLoop implementation and use it with a Channel.

Modification:

- Introduce EventLoop.Unsafe which is responsible for the actual registration.
- Move validation of EventLoop / Channel combo to the EventLoop
- Add unit test that verifies that wrapping works

Result:

Be able to wrap an EventLoop and so add some extra functionality.
2019-01-17 09:17:51 +01:00

47 lines
1.3 KiB
Java

/*
* Copyright 2018 The Netty Project
*
* The Netty Project licenses this file to you under the Apache License,
* version 2.0 (the "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package io.netty.channel.epoll;
import io.netty.channel.unix.IovArray;
import java.io.IOException;
/**
* Registration with an {@link EpollEventLoop}.
*/
interface EpollRegistration {
/**
* Update the registration as some flags did change.
*/
void update() throws IOException;
/**
* Remove the registration. No more IO will be handled for it.
*/
void remove() throws IOException;
/**
* Returns an {@link IovArray} that can be used for {@code writev}.
*/
IovArray cleanIovArray();
/**
* Returns a {@link NativeDatagramPacketArray} that can used for {@code sendmmsg}.
*/
NativeDatagramPacketArray cleanDatagramPacketArray();
}