# Nifty

**Repository Path**: mirrors/Nifty

## Basic Information

- **Project Name**: Nifty
- **Description**: Nifty是facebook公司开源的，基于netty的thrift服务端和客户端实现
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/nifty
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2020-11-23
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Project Status: 🚨 Unmaintained 🚨

This project is archived and no longer maintained. At the time of archiving,
open issues and pull requests were closed and tagged with `2018-05-archive`.
For pre-existing users who need an open source alternative, we recommend taking
a look at [airlift/drift](https://github.com/airlift/drift).

# Nifty

Nifty is an implementation of [Thrift](http://thrift.apache.org/) clients and servers on [Netty](http://netty.io/).

It is also the implementation used by [Swift](https://github.com/facebook/swift).

# Examples

To create a basic Thrift server using Nifty, use the [Thrift 0.9.0](https://dist.apache.org/repos/dist/release/thrift/0.9.0/thrift-0.9.0.tar.gz) code generator to generate Java stub code, write a Handler for your service interface, and pass it to Nifty like this:

    public void startServer() {
        // Create the handler
        MyService.Iface serviceInterface = new MyServiceHandler();

        // Create the processor
        TProcessor processor = new MyService.Processor<>(serviceInterface);

        // Build the server definition
        ThriftServerDef serverDef = new ThriftServerDefBuilder().withProcessor(processor)
                                                                .build();

        // Create the server transport
        final NettyServerTransport server = new NettyServerTransport(serverDef,
                                                                     new NettyServerConfigBuilder(),
                                                                     new DefaultChannelGroup(),
                                                                     new HashedWheelTimer());

        // Create netty boss and executor thread pools
        ExecutorService bossExecutor = Executors.newCachedThreadPool();
        ExecutorService workerExecutor = Executors.newCachedThreadPool();

        // Start the server
        server.start(bossExecutor, workerExecutor);

        // Arrange to stop the server at shutdown
        Runtime.getRuntime().addShutdownHook(new Thread() {
            @Override
            public void run() {
                try {
                    server.stop();
                } catch (InterruptedException e) {
                    Thread.currentThread().interrupt();
                }
            }
        });
    }

Or the same thing using guice:

    public void startGuiceServer() {
        final NiftyBootstrap bootstrap = Guice.createInjector(
            Stage.PRODUCTION,
            new NiftyModule() {
                @Override
                protected void configureNifty() {
                    // Create the handler
                    MyService.Iface serviceInterface = new MyServiceHandler();

                    // Create the processor
                    TProcessor processor = new MyService.Processor<>(serviceInterface);

                    // Build the server definition
                    ThriftServerDef serverDef = new ThriftServerDefBuilder().withProcessor(processor)
                                                                            .build();

                    // Bind the definition
                    bind().toInstance(serverDef);
                }
            }).getInstance(NiftyBootstrap.class);

        // Start the server
        bootstrap.start();

        // Arrange to stop the server at shutdown
        Runtime.getRuntime().addShutdownHook(new Thread() {
            @Override
            public void run() {
                bootstrap.stop();
            }
        });
    }