/*
 * Copyright 2016 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.kqueue;

import io.netty.channel.DefaultSelectStrategyFactory;
import io.netty.channel.EventLoop;
import io.netty.channel.MultithreadEventLoopGroup;
import io.netty.channel.SelectStrategyFactory;
import io.netty.util.concurrent.EventExecutor;
import io.netty.util.concurrent.EventExecutorChooserFactory;
import io.netty.util.concurrent.RejectedExecutionHandler;
import io.netty.util.concurrent.RejectedExecutionHandlers;
import io.netty.util.internal.UnstableApi;

import java.util.concurrent.Executor;
import java.util.concurrent.ThreadFactory;

@UnstableApi
public final class KQueueEventLoopGroup extends MultithreadEventLoopGroup {
    {
        // Ensure JNI is initialized by the time this class is loaded by this time!
        KQueue.ensureAvailability();
    }
    
Create a new instance using the default number of threads and the default ThreadFactory.
/** * Create a new instance using the default number of threads and the default {@link ThreadFactory}. */
public KQueueEventLoopGroup() { this(0); }
Create a new instance using the specified number of threads and the default ThreadFactory.
/** * Create a new instance using the specified number of threads and the default {@link ThreadFactory}. */
public KQueueEventLoopGroup(int nThreads) { this(nThreads, (ThreadFactory) null); }
Create a new instance using the specified number of threads and the default ThreadFactory.
/** * Create a new instance using the specified number of threads and the default {@link ThreadFactory}. */
@SuppressWarnings("deprecation") public KQueueEventLoopGroup(int nThreads, SelectStrategyFactory selectStrategyFactory) { this(nThreads, (ThreadFactory) null, selectStrategyFactory); }
Create a new instance using the specified number of threads and the given ThreadFactory.
/** * Create a new instance using the specified number of threads and the given {@link ThreadFactory}. */
@SuppressWarnings("deprecation") public KQueueEventLoopGroup(int nThreads, ThreadFactory threadFactory) { this(nThreads, threadFactory, 0); } public KQueueEventLoopGroup(int nThreads, Executor executor) { this(nThreads, executor, DefaultSelectStrategyFactory.INSTANCE); }
Create a new instance using the specified number of threads and the given ThreadFactory.
/** * Create a new instance using the specified number of threads and the given {@link ThreadFactory}. */
@SuppressWarnings("deprecation") public KQueueEventLoopGroup(int nThreads, ThreadFactory threadFactory, SelectStrategyFactory selectStrategyFactory) { this(nThreads, threadFactory, 0, selectStrategyFactory); }
Create a new instance using the specified number of threads, the given ThreadFactory and the given maximal amount of epoll events to handle per epollWait(...).
Deprecated: Use KQueueEventLoopGroup(int) or KQueueEventLoopGroup(int, ThreadFactory)
/** * Create a new instance using the specified number of threads, the given {@link ThreadFactory} and the given * maximal amount of epoll events to handle per epollWait(...). * * @deprecated Use {@link #KQueueEventLoopGroup(int)} or {@link #KQueueEventLoopGroup(int, ThreadFactory)} */
@Deprecated public KQueueEventLoopGroup(int nThreads, ThreadFactory threadFactory, int maxEventsAtOnce) { this(nThreads, threadFactory, maxEventsAtOnce, DefaultSelectStrategyFactory.INSTANCE); }
Create a new instance using the specified number of threads, the given ThreadFactory and the given maximal amount of epoll events to handle per epollWait(...).
Deprecated: Use KQueueEventLoopGroup(int), KQueueEventLoopGroup(int, ThreadFactory), or KQueueEventLoopGroup(int, SelectStrategyFactory)
/** * Create a new instance using the specified number of threads, the given {@link ThreadFactory} and the given * maximal amount of epoll events to handle per epollWait(...). * * @deprecated Use {@link #KQueueEventLoopGroup(int)}, {@link #KQueueEventLoopGroup(int, ThreadFactory)}, or * {@link #KQueueEventLoopGroup(int, SelectStrategyFactory)} */
@Deprecated public KQueueEventLoopGroup(int nThreads, ThreadFactory threadFactory, int maxEventsAtOnce, SelectStrategyFactory selectStrategyFactory) { super(nThreads, threadFactory, maxEventsAtOnce, selectStrategyFactory, RejectedExecutionHandlers.reject()); } public KQueueEventLoopGroup(int nThreads, Executor executor, SelectStrategyFactory selectStrategyFactory) { super(nThreads, executor, 0, selectStrategyFactory, RejectedExecutionHandlers.reject()); } public KQueueEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, SelectStrategyFactory selectStrategyFactory) { super(nThreads, executor, chooserFactory, 0, selectStrategyFactory, RejectedExecutionHandlers.reject()); } public KQueueEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, SelectStrategyFactory selectStrategyFactory, RejectedExecutionHandler rejectedExecutionHandler) { super(nThreads, executor, chooserFactory, 0, selectStrategyFactory, rejectedExecutionHandler); }
Sets the percentage of the desired amount of time spent for I/O in the child event loops. The default value is 50, which means the event loop will try to spend the same amount of time for I/O as for non-I/O tasks.
/** * Sets the percentage of the desired amount of time spent for I/O in the child event loops. The default value is * {@code 50}, which means the event loop will try to spend the same amount of time for I/O as for non-I/O tasks. */
public void setIoRatio(int ioRatio) { for (EventExecutor e: this) { ((KQueueEventLoop) e).setIoRatio(ioRatio); } } @Override protected EventLoop newChild(Executor executor, Object... args) throws Exception { return new KQueueEventLoop(this, executor, (Integer) args[0], ((SelectStrategyFactory) args[1]).newSelectStrategy(), (RejectedExecutionHandler) args[2]); } }